Qwen Code 自定义 API：认证菜单、模型登记与协议选择

这里配置的是 Qwen Code

Qwen 是模型与应用名称，Qwen Code 才是本页讨论的编程客户端。官方仓库介绍终端 Agent，并链接到认证配置文档。 在 CLI 中使用 Qwen 模型，既可能走阿里云服务，也可能走其他兼容服务，不能只按模型名称判断认证方式。本文核验资料来源，未安装客户端或完成本站接入实测。

当前认证菜单与旧教程不同

启动 qwen 后运行 /auth，当前官方菜单分 Alibaba ModelStudio、Third-party Providers 和 Custom Provider。需要自建或未列出的兼容服务时，使用 Custom Provider。

官方说明 Qwen OAuth 免费层已于 2026 年 4 月 15 日停用；旧教程里的免费网页登录流程不能作为当前默认方案。独立的 qwen auth 命令也已移除，交互配置用会话内的 /auth，认证诊断用 /doctor。 套餐名称、地区和专用端点必须按账号的正式规格匹配，不凭名称推断任意 Key 都能用。

在用户配置里登记一个模型

官方建议在 ~/.qwen/settings.json 定义 modelProviders。模型的 id 是请求 ID，baseUrl 覆盖端点，envKey 绑定密钥变量；默认模型与认证协议也应明确选择。

以下全是纯占位，不是真实 API；本站未以示例提供登录、Key 创建或充值服务。将结构与已有配置合并，不整份覆盖其他设置。

{
  "modelProviders": {"openai": [{
    "id": "YOUR_MODEL_ID",
    "baseUrl": "https://80321.cn/v1",
    "envKey": "OPENAI_API_KEY",
    "wireApi": "chat-completions"
  }]},
  "security": {"auth": {"selectedType": "openai"}},
  "model": {"name": "YOUR_MODEL_ID"}
}

为所绑定的环境变量提供你合法持有的密钥；YOUR_API_KEY 只是示意值，不能用于真实认证。官方支持环境变量供 Key，配置内 env 则是明文的低优先级回退来源。

协议与最小联调各自验证

modelProviders 按协议组织，官方列出 OpenAI 兼容、Anthropic 和 Google GenAI 等路径。OpenAI 条目的 wireApi 可选 chat-completions 或 responses。 示例明确选择前者，不能拿只有 Responses 的端点来验证它。

重启后用 /model 核对目标条目，再在小型测试目录要求“仅解释 README，不修改文件”。先确认一轮文本，然后测试工具与流式行为。接口能聊天不代表具备可靠工具调用，Qwen 网页应用中的账号也不自动变成这条 API 路径的凭据。

配置覆盖与 Agent 权限排错

地址没变化时，检查启动参数和进程环境是否覆盖用户配置；模型不存在时检查 model.name 是否对应已登记的 id，不要填界面昵称。认证失败先分清通用 Key、Coding Plan 和 Token Plan 的端点，不通过换地区或借用令牌猜权限。

密钥不进入仓库、终端截图或共享设置。首次联调保留命令审批，只给测试目录访问权限；不要为让任务继续运行开启无条件执行。只在接口与账户授权都确认后，再处理业务代码和敏感资料。