首页 / 编程工具 / Qwen Code

Qwen Code

通义千问官方开源 CLI,终端里读写代码

Qwen (Alibaba) OpenAI 兼容格式 macOSLinuxWindows

Qwen Code 是通义千问团队开源的终端编程助手,能读取项目、编辑文件、运行命令并自检。除它自带的默认通道外,它支持用 OPENAI_BASE_URL / OPENAI_API_KEY 指向任意 OpenAI 兼容端点,因此可以直接接本站网关:一把 Key 同时调 qwen3.8-max、deepseek-v4-pro 等模型。

网关 base_url(国内站)https://api.shinloo.com/v1填到 OPENAI_BASE_URL。OpenAI 线路填 /v1;Anthropic / Gemini 线路填网关根 https://api.shinloo.com。
OpenAI 兼容调用路径https://api.shinloo.com/v1/chat/completionsQwen Code 用这个地址(GET /v1/models 可查你的 Key 可用模型)。
推荐模型(国内站已开通)qwen3.8-maxqwen3.8-flashdeepseek-v4-pro以上为本站公示的模型名,实际可用清单以你的 Key 调 GET /v1/models 返回为准。

省事版 — 一键接入

脚本从官方 npm 源安装 Qwen Code,把网关配置写进工具自己的配置文件 ~/.qwen/settings.json 与 ~/.qwen/.env(写之前都先备份原文件),并装一个 qwen-shinloo 启动器确保请求走本站,再发一次真请求验证。会提示你粘贴网关 Key(也可用 --key 传入); --uninstall 只还原它写进去的内容。

shell
curl -fsSL https://api.shinloo.com/agents/qwen-code/setup | bash

1 · 安装

从官方 npm 源安装(本包要求 Node.js 22 或更高)。

安装
node -v                          # 需要 v22 或更高
npm install -g @qwen-code/qwen-code
qwen --version

2 · 配置 — 指向国内站网关

网关 base URL https://api.shinloo.com/v1;Key 在 控制台创建。

配置
1) 写入 ~/.qwen/settings.json(指定通道、端点与默认模型;你原有的其它 provider 条目会保留):

{
  "modelProviders": { "openai": [ { "id": "qwen3.8-max", "baseUrl": "https://api.shinloo.com/v1", "envKey": "OPENAI_API_KEY" } ] },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3.8-max" }
}

2) 写入 ~/.qwen/.env 放 Key(没有该文件就新建;本脚本写的段落带 managed 标记,卸载时只删这段):

OPENAI_API_KEY="YOUR_API_KEY"
OPENAI_BASE_URL="https://api.shinloo.com/v1"
OPENAI_MODEL="qwen3.8-max"

3) 装一个 qwen-shinloo 启动器(~/.local/bin/):它先把这把 Key 和端点导出,再启动 qwen。
4) 重新打开终端后运行 qwen(或 qwen-shinloo);会话里用 /model 换模型。

3 · 验证

发一次请求,能返回就说明走的是国内站网关。

验证
qwen-shinloo -p "reply with OK"   # 推荐:显式走本站通道
qwen -p "reply with OK"             # 也可以(配置文件已写好)

4 · 常见坑

  • 必须先有 Node.js 22+:该 npm 包 engines 限定 >=22,低版本会直接装不上,先 node -v 确认。
  • OPENAI_BASE_URL 末尾要带 /v1;写成网关根会 404。
  • settings.json 与 .env 在启动时读取,改完要重开终端才生效。
  • 机器上若已经存在 OPENAI_API_KEY 环境变量(或该工具自带的默认通道),它的优先级高于配置文件,请求会被带走 — 这种情况用 qwen-shinloo 启动即可锁定本站通道。
  • 文件里如果本来就有 OPENAI_* 行,可能有覆盖冲突:本脚本会把旧行注释掉并写明原值。
  • 模型名以 GET /v1/models 返回为准,站点公示名会随上游调整。

工具侧步骤的官方来源: github.com/QwenLM/qwen-code qwenlm.github.io/qwen-code-docs