Qwen Code

安装 Qwen Code，并在支持 OpenAI Compatible 的环境中使用 TokenHub 模型。

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 认证配置文档。常见安装方式：

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

确认安装成功：

qwen --version

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

准备 TokenHub 凭证

export TOKENHUB_API_KEY="sk-..."

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

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

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

配置位置	适合场景
`~/.qwen/settings.json`	当前用户长期使用 TokenHub。
项目内 `.qwen/settings.json`	团队共享非密钥默认值，例如 provider、Base URL、模型和 `envKey`。

写入如下配置。注意 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，并填写：

字段	值
Provider	OpenAI Compatible
Base URL	`https://us-api.tokenhub.com/v1`
API Key	`TOKENHUB_API_KEY` 对应的密钥值
Model	TokenHub 模型列表中的 Qwen 或代码模型

如果工具询问是否使用默认 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 执行一次只读任务：

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

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

常见问题

现象	处理方式
启动后仍使用默认供应商	检查 `security.auth.selectedType` 是否为 `openai`。
401	确认 `TOKENHUB_API_KEY` 有效；使用临时变量时再确认 `OPENAI_API_KEY` 指向它。
模型不可用	将 `OPENAI_MODEL` 改成 TokenHub 模型列表中真实存在的 Model ID。
输出语言不符合预期	在系统提示或首轮消息中明确要求中文或英文。
命令执行权限过高	先要求只读分析，再让它给出计划，最后逐步授权执行。

本页目录