跳转到主要内容

Qwen Code 是什么

Qwen Code 是面向终端的开源编程代理。它的 modelProviders 设置会列出你可以使用的模型以及每个模型的 API 协议。这套配置把 Capriole AI 模型添加到该列表中。

前置条件

开始前请确保你已经拥有以下内容。

安装

使用 npm 安装 Qwen Code(需要 Node.js 22 或更高版本)。
也可以使用 Homebrew 安装。
验证安装。

配置

模型验证

使用下方配置,Qwen Code 0.25.3 经 Capriole AI 调用“支持的模型”一节中的每个模型,都通过了文件读取、文件写入和最终答案检查。 把 API Key 写入 ~/.qwen/.env。
创建或更新 ~/.qwen/settings.json。
各项设置的作用如下。
  • openai 下的模型使用 Chat Completions。GPT 模型额外添加 wireApi: "responses",以使用 Responses API。
  • anthropic 下的模型使用 Anthropic Messages。它们的 baseUrl 不含 /v1。
  • envKey 指定保存 API Key 的环境变量名。Qwen Code 会以 Bearer Token 形式把 Key 发送给 Capriole AI。
  • contextWindowSize 告诉 Qwen Code 每个模型的上下文窗口。
  • security.auth.selectedType 和 model.name 设置默认模型。使用 /model 切换时,这两项会同时更新。

运行 Qwen Code

在项目目录中启动 Qwen Code。
使用 /model 切换模型。如需一次性运行,请传入提示词、模型以及该模型所在分组的身份验证类型。

支持的模型

openai-latest 和 claude-latest 始终指向各自系列中我们最新的旗舰模型。

故障排除

为什么 Qwen Code 返回身份验证错误

确认 ~/.qwen/.env 设置了 CAPRIOLE_AI_API_KEY,或者在同一个 Shell 中导出该变量。

为什么模型出现协议错误

使用模型所在分组的身份验证类型运行它:openai 下的模型使用 --auth-type openai,anthropic 下的模型使用 --auth-type anthropic。/model 会自动完成这项设置。

为什么 Claude 请求因 Unsupported Claude Messages model 失败

anthropic 下的 Claude 模型需要不带前缀的 Claude ID,例如 claude-opus-5-5。

说明

  • 把 API Key 保存在 ~/.qwen/.env 中,不要写入 settings.json。
  • 如需添加其他 Capriole AI 模型,请复制同一系列中某个模型的条目并修改 ID。GET https://api.caprioletech.com/v1/models 会列出所有模型 ID。
  • 官方参考资料包括 Qwen Code和 Qwen Code 模型提供商。
最后修改于 2026年10月20日