Qwen Code 自定义 API 设置

Qwen Code 常用于代码生成、仓库阅读和终端内开发任务。Qwen Code 官方配置文档支持 OpenAI-compatible provider，TokenHub 应配置在 modelProviders.openai 下，并把 security.auth.selectedType 设为 openai。

适合场景

Qwen Code 适合偏中文的代码解释、脚本生成、项目阅读和快速修复。接入 TokenHub 后，你可以按项目需要选择 Qwen Coder、通用聊天模型或其他代码模型。

安装 Qwen Code

先参考 Qwen Code 官方仓库 和 Qwen Code Model Providers 官方文档。常见安装方式：

npm install -g @qwen-code/qwen-code

确认安装成功：

qwen --version

如果你的环境中命令名称不是 qwen，以当前官方仓库 README 中的启动命令为准。

准备 TokenHub 凭证

export TOKENHUB_API_KEY="sk-..."

选择 TokenHub 中可用的 Qwen Coder、通用聊天或代码模型。代码任务建议选择上下文长度足够的模型。

推荐方式：写入 Qwen Code 设置文件

优先使用 Qwen Code 的用户级设置文件或项目设置文件：

写入如下配置。注意 provider key 使用官方的 openai，不是自定义 tokenhub；密钥通过 envKey 读取本机 TOKENHUB_API_KEY，不要把真实 Key 写进 JSON：

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "id": "qwen3-coder-plus",
          "name": "TokenHub / qwen3-coder-plus",
          "baseUrl": "__API_BASE_URL__/v1",
          "envKey": "TOKENHUB_API_KEY"
        }
      ]
    }
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

如果你安装的版本通过交互式设置生成不同 schema，就在交互式 provider 设置里选择 OpenAI Compatible，然后检查 ~/.qwen/settings.json 中是否保留同样的 Base URL、envKey、模型 ID 和 security.auth.selectedType = "openai" 等价字段。

使用交互式 Provider 配置

如果你的 Qwen Code 版本通过交互式设置选择供应商，选择 OpenAI Compatible，并填写：

如果工具询问是否使用默认 Qwen 服务，选择自定义或 OpenAI Compatible。

临时环境变量验证

环境变量适合快速排查 Key、网络或模型名：

优先使用 OpenAI 兼容配置：

export TOKENHUB_API_KEY="sk-..."
export OPENAI_API_KEY="$TOKENHUB_API_KEY"
export OPENAI_BASE_URL="__API_BASE_URL__/v1"
export OPENAI_MODEL="qwen3-coder-plus"

qwen

如果当前版本不读取 OPENAI_MODEL，就在交互式设置或命令行参数中选择同一个 TokenHub Model ID。

临时环境变量只对当前终端有效。验证通过后，仍建议把 provider 固化到 ~/.qwen/settings.json 或项目 .qwen/settings.json。

验证

让 Qwen Code 执行一次只读任务：

请阅读当前目录，并说明这个项目最可能使用的包管理器。不要修改文件。

如果能正常回答，再继续让它生成或修改代码。

故障排查