在 Coding Agent 接入

Qwen Code 配置指南：API Key、Base URL 与文件读取限制

为 Qwen Code 配置 BetterToken API Key、Base URL 和 Responses 模型设置，验证文本请求，并了解测试中文件读取后最终回复不稳定的限制。

通过 ~/.qwen/settings.json 中的 modelProviders.openai 将 Qwen Code 接入 BetterToken。在 macOS 搭配 GPT 模型的测试中，Qwen Code 0.26.0 使用 Responses 和 Chat Completions 均完成了文本请求。

重点信息

字段	值
API Key	通过 `envKey` 引用 BetterToken API Key
Base URL	在 `baseUrl` 中设置 `https://bettertoken.ai/v1`
Model	`YOUR_MODEL_ID`
Provider 配置	`modelProviders.openai`
API 格式	`wireApi: "responses"`

准备工作

下方 npm 安装方式需要 Node.js 22 或更高版本
BetterToken API Key：注册并获取
从模型广场复制的 Model ID

安装

使用官方快速入门中的 npm 安装方式：

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

手动配置

在终端中设置 API Key，替换 YOUR_API_KEY：

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

将以下设置合并到 ~/.qwen/settings.json。将两处 YOUR_MODEL_ID 替换为同一个完整 Model ID：

{
  "modelProviders": {
    "openai": [
      {
        "id": "YOUR_MODEL_ID",
        "envKey": "BETTERTOKEN_API_KEY",
        "baseUrl": "https://bettertoken.ai/v1",
        "wireApi": "responses"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "YOUR_MODEL_ID"
  }
}

envKey 填写环境变量名，不是 API Key 本身。官方模型 provider 参考也支持 wireApi: "chat-completions"。本次测试中，Responses 的文件读取成功次数更多，但两种格式均未全部通过。

验证连接

在同一终端中运行以下纯文本检查：

qwen -p "Reply with only: OK" --output-format stream-json --max-session-turns 4

确认最终回复为 OK。文本请求成功不代表文件读取任务能返回正确的最终回复；选择工作流时请参考上述限制。

切换模型

在 modelProviders.openai 下添加模型条目，将 model.name 设为该条目的完整 id，然后启动新会话。

常见错误

现象	排查方式
认证失败	在运行 Qwen Code 的终端中导出 `envKey` 指定的环境变量。
接口地址错误	在 `baseUrl` 中使用 `https://bettertoken.ai/v1`；请求协议由 `wireApi` 选择。
找不到模型	让 `model.name` 与 `modelProviders.openai` 下的某个 `id` 一致。
读取文件后回复为空或错误	0.26.0 中，即使工具结果正确也出现过此问题。切换到 Responses 未能消除失败；文件读取任务请使用其他已通过测试的客户端。

技术说明

wireApi: "responses" 选择 /v1/responses；wireApi: "chat-completions" 选择 /v1/chat/completions。Qwen Code 0.26.0 测试中，两种文本请求路径均通过。文件读取的成功次数分别为 2/3 和 0/3。