Qwen Code

Qwen Code 从 ~/.qwen/settings.json 的 modelProviders 读取端点 — 一个包含 baseUrl 和 envKey 的条目即可让 Claude 与 GPT 出现在其 /model 选择器中。

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-compatible",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": {
    "KUNAVO_API_KEY": "sk-kn-..."
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

分步操作

1. 在 /app/keys 创建密钥并复制——它只会显示一次。
2. 打开 ~/.qwen/settings.json（如果不存在则创建），并将上方四个配置块合并进去。文档建议在用户级文件中声明 modelProviders，“以避免项目设置与用户设置之间的合并冲突”。
3. 如果可以，请把密钥放在比 env 更妥当的位置。Qwen Code 会从 process.env[envKey] 读取密钥，文档按优先级从高到低列出了密钥来源：shell export、.env 文件，然后是 settings.json 中的 env 块——文档指出这是明文存储。上面的 env 块是能运行的最简配置，并不是最适合长期保存的配置。
4. 运行 qwen。将 security.auth.selectedType 设为 openai，并确保 model.name 与你声明的某个 id 相符后，就不需要交互式的 /auth 步骤——单文件示例之后的文档对此有明确说明。
5. 给它一个需要读取并编辑文件的任务，而不是简单问候。Qwen Code 是一个智能体：工具调用和流式传输是首次运行应该验证的功能，也是面对兼容性不完整的端点时最先会出问题的地方。
6. 在 modelProviders.openai 下添加更多条目，即可通过 /model 在运行时切换模型。这些修改会在正在运行的会话中热重载；providerProtocol 只在启动时读取，修改后需要重启。

已于 2026年9月21日 对照 Qwen Code 身份验证页面，选项 4：API Key（灵活） 检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 Qwen Code 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models，包含价格的目录见模型页面。费率单位为每 1M token 的美元，格式为输入 / 输出。

文档明确说明的三个常见误区

这些信息来自上文链接的身份验证页面和模型提供商参考文档。如果只凭猜测而不查阅文档，每一项都可能耗费大量调试时间。

1. modelProviders 条目的优先级高于 CLI 标志。文档列出的优先级从高到低依次为：在运行会话中通过 /auth 设置的覆盖项、所选模型提供商的 envKey、--openai-api-key 等 CLI 参数、环境变量，最后是设置中的 security.auth.apiKey。大多数人以为标志的优先级最高，但事实并非如此——这就是 --openai-base-url 看起来可能被忽略的原因。
2. security.auth.apiKey 和 security.auth.baseUrl 已弃用。参考文档对此有明确说明，并建议迁移到 modelProviders。如果较早的教程让你编辑这两个键，那么你修改的是即将淘汰的配置路径。
3. wireApi 用于选择请求格式，且不会检测格式是否不匹配。省略该项时会使用 Chat Completions，也就是上方配置块所用的格式。设置 "wireApi": "responses" 则要求端点确实兼容 Responses；文档明确指出，请求失败时不会检测端点，也不会自动回退。Kunavo 同时支持 /v1/responses 和 /v1/chat/completions，但本页尚未测试这两种搭配，因此请从默认设置开始。

如果你来这里是想找免费套餐

许多仍在流传的 Qwen Code 说明都在介绍通过 Qwen OAuth 登录并获得每日免费额度。此选项已取消：文档记载其免费套餐于 2026 年 4 月 15 日停止提供，并指出 Qwen OAuth 已不再是 /auth 对话框中的可选项。文档现在列出三项：阿里云 ModelStudio——其子菜单包含 Coding Plan、Token Plan 和 Standard API Key；第三方提供商；以及 自定义提供商，其描述为连接“本地服务器、代理或不受支持的提供商”。Kunavo 属于第三项。还要注意，ModelStudio 子菜单中的选项并不是同一笔账单的三种付款方式：每种方式都有自己的主机和密钥，在 Token Plan 主机上使用 Coding Plan 密钥将无法工作。