Qwen Code 和 CodeWhale 接入指南

适用角色：开发者、主用户、子用户 更新日期：2026-08-06

两款工具的配置方式不同。Qwen Code 当前版本支持在 modelProviders 中增加自定义 Provider；CodeWhale 的字段结构可能随发行版本变化，配置前应先查看本机版本提供的帮助和示例文件。

Qwen Code

安装并设置 Key：

npm install -g @qwen-code/qwen-code@latest
export CUSTOM_API_KEY="YOUR_API_KEY"

在 ~/.qwen/settings.json 中把本平台注册为 OpenAI Compatible Provider：

{
  "modelProviders": {
    "myplatform": [
      {
        "id": "deepseek-v4-flash",
        "name": "DeepSeek V4 Flash",
        "envKey": "CUSTOM_API_KEY",
        "baseUrl": "https://<接口地址>"
      }
    ]
  },
  "providerProtocol": {
    "myplatform": "openai"
  }
}

当前规范要求 Provider 的值是模型数组；旧版教程中把 Provider 写成带 models 字段的对象，在新版中可能被跳过。需要增加模型时，在 myplatform 数组内添加同级条目。

以控制台「API Key」页展示的接口地址为准。

启动后使用 /model 选择对应模型。API Key 不应直接写进设置文件，envKey 指向的环境变量由运行时读取。

CodeWhale

先查看 CodeWhale 当前版本是否提供 OpenAI Compatible 或 Custom Provider。能够填写以下三项时，使用：

Base URL: https://<接口地址>
API Key: YOUR_API_KEY
Model: deepseek-v4-flash

如果官方示例明确使用 TOML，可以按其字段名填入相同值。不要直接套用其他版本的配置路径或环境变量名，因为工具可能无法读取且不会给出明显提示。

验证顺序

先在模型选择器中确认调用名，再发送短消息并查看控制台使用记录。模型不显示通常是本地配置结构或文件位置问题；模型可选但请求失败，则检查 Key、Base URL 和分组权限。