认证与模型服务

套餐、模型、端点和价格会随时变化，下文涉及的具体模型名与区域端点以官方为准。接入自定义模型（任何 OpenAI/Anthropic/Gemini 兼容端点）就在本页的「API Key（灵活）」一节里讲。

Qwen Code 首次运行的 /auth 菜单有三个顶层选项，选与你想运行 CLI 的方式匹配的那个：Alibaba ModelStudio（官方推荐的设置，打开子菜单：Coding Plan（面向个人开发者，含每周配额）、Token Plan（面向团队和公司，按用量计费、带专用端点）或 Standard API Key（用现有的 ModelStudio API key 连接）；Token Plan 和 Standard API Key 还会启用内置的 web_search 工具）；Third-party Providers（选内置提供商并用 API key 连接：DeepSeek、Grok、MiniMax、Z.AI、Kimi、Idealab、ModelScope、OpenRouter、Requesty）；Custom Provider（手动连接本地服务器、代理或不受支持的提供商，支持 OpenAI、Anthropic、Gemini 和其他兼容端点）。注意：Qwen OAuth 不再是可选的对话框条目，它的免费层已于 2026-04-15 停用，只作为硬编码的、已停用的提供商保留在文档里；已缓存的令牌可能短暂继续有效，但新请求会被拒绝；在非交互或无头环境（CI、SSH、容器）里通常无法完成 OAuth 浏览器登录流程。

阿里云 Coding Plan

适合想要可预测成本、多样的模型选项和更高使用配额的场景。工作方式：以固定月费订阅 Coding Plan，然后配置 Qwen Code 使用专用端点和你的订阅 API key。要求：从阿里云百炼（北京）或阿里云（国际）获得有效的 Coding Plan 订阅，取决于你账号所在的区域。好处：多样的模型选项（Qwen、GLM、Kimi、Minimax 等）、更高的使用配额、可预测的月成本。交互式设置：输入 qwen 启动，运行 /auth，选 Alibaba ModelStudio，从子菜单选 Coding Plan，选择区域，然后输入你的 sk-sp-xxxxxxxxx key。认证后用 /model 在 Coding Plan 支持的所有模型之间切换。无头或脚本化设置：用于 CI、容器或脚本，用环境变量或 settings.json 配置，而不是已移除的 qwen auth coding-plan 命令：

export BAILIAN_CODING_PLAN_API_KEY="sk-sp-xxxxxxxxx"
export OPENAI_BASE_URL="https://coding.dashscope.aliyuncs.com/v1"
export OPENAI_MODEL="qwen3-coder-plus"

中国（北京）端点用 https://coding.dashscope.aliyuncs.com/v1，国际端点用 https://coding-intl.dashscope.aliyuncs.com/v1。或者跳过交互式 /auth 流程，在 ~/.qwen/settings.json 里配置：

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3-coder-plus from Alibaba Cloud Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

注意：Coding Plan 使用与标准 DashScope 端点不同的专用端点，确保使用正确的 baseUrl。

阿里云 Token Plan

适合你的团队或公司更喜欢在专用 ModelStudio 端点上按用量计费的场景。工作方式：在阿里云 ModelStudio 订阅 Token Plan，然后配置 Qwen Code 使用区域特定的 Token Plan 端点和你的 API key；你按实际 token 用量而不是固定月费计费。好处：为团队和公司的按用量计费、专用的区域端点、可访问广泛的模型（Qwen、DeepSeek、GLM、Kimi、Minimax 等）。两个区域各有专用端点：中国（北京）https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1；新加坡（国际）https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1。交互式设置：启动 qwen，运行 /auth，选 Alibaba ModelStudio，从子菜单选 Token Plan，选区域并输入你的 API key；向导随后显示最后一步（Step 3/3 · Model IDs），让你选择要配置的模型 ID（你端点服务的模型在那里提供，必须显式选择）。认证后用 /model 浏览和切换为你的 Token Plan 配置的模型（模型阵容会随时间演变，所以没有在文档里列出）。无头或脚本化设置：

export BAILIAN_TOKEN_PLAN_API_KEY="your-api-key"
export OPENAI_BASE_URL="https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3.7-plus"

BAILIAN_TOKEN_PLAN_API_KEY 是提供商特定的 key：下一节 settings.json 的提供商条目存在时它才生效（因为该条目把它声明为 envKey）；要只用环境变量选择 OpenAI 兼容认证，改为导出 OPENAI_API_KEY，提供商特定的 key 本身不会选择认证类型。settings.json 的配置形状与 Coding Plan 相同，把 baseUrl 换成你区域的 Token Plan 端点、envKey 换成 BAILIAN_TOKEN_PLAN_API_KEY；Token Plan 使用专用的区域端点（*.maas.aliyuncs.com），确保 baseUrl 与你订阅的区域匹配。

API Key（灵活）

适合想连接 OpenAI、Anthropic、Google、Azure OpenAI、OpenRouter、Requesty、ModelScope 或自托管端点等第三方提供商的场景，支持多种协议和提供商。推荐：通过 settings.json 一个文件完成设置：最简单的办法是把所有东西放进单个 ~/.qwen/settings.json，一个完整可用的例子：

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "description": "Qwen3-Coder via Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

各字段作用：modelProviders 声明哪些模型可用以及如何连接（键 openai、anthropic、gemini 代表 API 协议）；env 把 API key 直接存在 settings.json 里作为后备（优先级最低，shell 的 export 和 .env 文件优先）；security.auth.selectedType 告诉 Qwen Code 启动时用哪种协议（如 openai、anthropic、gemini，没有它你就需要交互式运行 /auth）；model.name 是 Qwen Code 启动时激活的默认模型，必须匹配你 modelProviders 里某个 id。保存后直接运行 qwen，不需要交互式 /auth 设置。关键概念是模型提供商（modelProviders）：Qwen Code 支持多种 API 协议，不只是 OpenAI；你通过编辑 ~/.qwen/settings.json 配置哪些提供商和模型可用，然后用 /model 命令在运行时切换。

为每种协议定义哪些模型可用。每个模型条目至少需要一个 id；envKey（保存你 API key 的环境变量名）是可选且推荐的，省略时回退到该认证类型的默认环境键（如 openai 的 OPENAI_API_KEY）。建议在用户作用域的 ~/.qwen/settings.json 里定义 modelProviders，避免项目和用户设置之间的合并冲突；你可以在单个文件里混合多种协议。自定义 OpenAI 兼容端点（包括本地自托管模型）的写法就是 modelProviders.openai 里一个带自己 baseUrl 的条目；每个模型条目还能用 generationConfig 配置超时、重试、上下文窗口大小、模态、自定义头、extra_body 和采样参数等（详见官方的模型提供商文档，其中还讲了 OpenAI Responses API、自托管模型、推理/思考配置和解析层次）。

安全提示

API key 优先通过 shell 环境变量或 .env 文件提供，settings.json 里 env 字段是优先级最低的后备；不要把含密钥的 settings.json 提交到仓库。用 /doctor 随时检查当前认证配置，认证失败后 UI 卡住的问题见「沙盒与排障」。