用一个 .qwen/.env 文件或一条 modelProviders 条目把 Qwen Code 接到 Router One

安装 Qwen Code 并单独建一把 Key

用 npm 安装需要 Node.js 22 或更新版本；README 还提供 Linux/macOS/Windows 的独立安装脚本和 Homebrew 包。安装后在项目目录里启动 qwen：首次运行会打开 /auth 菜单，其中 Custom Provider 选项面向 OpenAI 兼容端点，但本指南的两个文件不经过菜单也能完成同样的配置；随时可以用 /doctor 查看认证和环境检查。动手之前，先为 Qwen Code 单独创建一把设了 maxSpend 的 Router One Key：agent 会话每一轮模型调用、每次工具结果回传都是一次请求，这个上限就是硬性止损。Key 只写进下面的 .qwen/.env，不写进 settings.json。

npm install -g @qwen-code/qwen-code@latest
cd /path/to/your-project
qwen

把 Qwen Code 配置到 Router One base URL

在项目根目录创建 .qwen/.env，写入下面三个变量；这是 Qwen Code 文档推荐存放项目级密钥的文件，要排除在 git 之外。OPENAI_API_KEY 填 Router One Key——按身份验证文档的说法，只用环境变量时，正是导出 OPENAI_API_KEY 这一步选中了 OpenAI 兼容认证，provider 专属的变量名不会。OPENAI_BASE_URL 填带 /v1 的 https://api.router.one/v1：openai auth type 用这个值构造官方 OpenAI Node.js SDK 客户端，SDK 在它后面拼 /chat/completions，所以每一轮模型调用就是一个 POST /v1/chat/completions。OPENAI_MODEL（别名 QWEN_MODEL）填精确的目录模型 ID，它就是每次请求 model 字段的值；--model <id> 可以在单次会话里覆盖它。Qwen Code 只加载找到的第一个 .env 文件——从当前目录向上依次找 .qwen/.env 和 .env，找不到再回退到 ~/.qwen/.env 和 ~/.env——而且不会覆盖 shell 里已经导出的变量，所以 ~/.zshrc 里一个过期的 OPENAI_BASE_URL 会压过这个文件。这种形式创建的是文档所说的 Runtime Model：只有一个模型，选择器里没有条目；如果 qwen 仍然弹出 /auth 菜单，按下一节加上 security.auth.selectedType。启动 qwen，运行 /doctor，发一条简短提示，再到 Logs 里核对它的 Trace。文件内容如下，替换掉 Key 和模型 ID：

# <project>/.qwen/.env — the first .env file Qwen Code finds; keep it out of git
OPENAI_API_KEY=sk-your-router-one-key
OPENAI_BASE_URL=https://api.router.one/v1
OPENAI_MODEL=<exact-model-id-from-/models>

把 Router One 登记进 modelProviders，进入 /model 选择器

想在会话里切换多个目录模型，就把它们声明在 ~/.qwen/settings.json——这是文档推荐的用户级作用域，因为项目级设置会整体替换 modelProviders 对象而不是合并。键名 openai 就是 auth type，决定了传输方式；写错成 openai-custom 之类的键会被跳过并给出警告，它下面的模型不会出现在 /model 里。每个条目必须有 id，即作为 model 字段发送的精确目录 ID；name 只是选择器里的显示名；envKey 填保存 Key 的环境变量名——运行时读取 process.env[envKey]，从不保存凭据本身——所以把 ROUTER_ONE_API_KEY=sk-your-router-one-key 写进 .qwen/.env 或 ~/.qwen/.env，或者直接 export；baseUrl 填同一个带 /v1 的地址，同一 auth type 内条目按 id 加 baseUrl 识别，重复的组合会被跳过。generationConfig 可选且封闭：选中 provider 模型时它的值整体生效，顶层 model.generationConfig 被忽略；源码里 timeout 默认 120000 毫秒、maxRetries 默认 3。security.auth.selectedType 设为 openai 后，qwen 启动不再弹 /auth 菜单，model.name 必须等于其中一个 id。运行中的会话会自动读取 modelProviders 的改动（重新打开 /model 即可）；/model 和 /auth 会把 model.name 和 selectedType 写回定义了 modelProviders 的那个作用域。选中 provider 条目后，它的 baseUrl 和 envKey 优先于 --openai-base-url、OPENAI_BASE_URL 和 OPENAI_API_KEY。

{
  "modelProviders": {
    "openai": [
      {
        "id": "<exact-model-id-from-/models>",
        "name": "<在 /model 里显示的名字>",
        "envKey": "ROUTER_ONE_API_KEY",
        "baseUrl": "https://api.router.one/v1",
        "generationConfig": { "timeout": 120000, "maxRetries": 3 }
      },
      {
        "id": "<another-model-id-from-/models>",
        "envKey": "ROUTER_ONE_API_KEY",
        "baseUrl": "https://api.router.one/v1"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "<exact-model-id-from-/models>" }
}

每个值填在哪里，怎么验证

Router One 需要的只有三个变量或一条 provider 条目；下表给出每个值，以及证明它已生效的检查方法。看实际请求最快的办法是 Qwen Code 自己的日志：打开 model.enableOpenAILogging（或加 --openai-logging 参数），每次请求和响应都会以 JSON 写到工作目录的 logs/openai 下。

给一次 Qwen Code 会话定预算，并与 Logs 对账

在 Qwen Code 里一条提示很少只对应一次请求。每一轮模型调用是一次请求，agent 每回传一次工具结果又是一轮；model.maxToolCallsPerTurn 默认把一轮限制在 100 次工具调用，按自适应方式执行，硬性上限 1000；用 /model --fast、--compaction、--vision 指定的辅助模型也各自发请求。openai 传输还会把 timeout（默认 120000 毫秒）和 maxRetries（默认 3）传给 OpenAI SDK，每一次真正到达网关的尝试都是独立请求，有各自的 request_id 和费用。给 Qwen Code 单独一把设了 maxSpend 的 Key：会话触到上限会收到 HTTP 402 并停下，钱包和其他 Key 不受影响。客户端一侧，model.maxSessionTurns 和 model.sessionTokenLimit 限制对话长度；客户端取消的流会记为 HTTP 499 client_cancelled，只按已上报的用量计费。对账用 /stats model：它显示 Qwen Code 自己统计的分模型 token 用量和它自己的费用估算；Dashboard → Logs 才是逐请求的实际费用，带模型、tokens、成本、延迟、状态和 request_id；/stats export 可以把客户端这一侧导出为 CSV 或 JSON。Router One 只记录模型调用元数据；工具、审批、会话和子 agent 都在 Qwen Code 里运行。

Qwen Code 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 Qwen Code 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个工具单独建 API Key，并设置 maxSpend 消费上限。

Qwen Code 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

在 trace 里验证 Qwen Code 的调用

先在 Qwen Code 发出一次简单文本请求，再到 Dashboard → Logs 按时间、模型和 request_id 核对 trace：tokens、花费、延迟和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，先查客户端配置和网络，不能仅凭客户端报错认定是网关或上游故障。

常见问题