身份验证

Qwen Code 首次运行时的 /auth 菜单包含三个顶级选项。请根据你运行 CLI 的方式选择对应的选项：

• Alibaba ModelStudio：官方推荐的配置方式。打开子菜单后可选择 Coding Plan（面向个人开发者 · 包含每周配额）、Token Plan（面向团队和企业 · 按量计费并提供专属 endpoint）或 Standard API Key（使用现有的 ModelStudio API key 进行连接）。
• Third-party Providers：选择内置的 provider 并使用 API key 进行连接（DeepSeek、MiniMax、Z.AI、Idealab、ModelScope、OpenRouter、Requesty）。
• Custom Provider：手动连接本地服务器、代理或不支持的 provider —— 支持 OpenAI、Anthropic、Gemini 及其他兼容的 endpoint。

选项 1：Qwen OAuth（已停用）

• 工作原理：首次启动时，Qwen Code 会打开浏览器登录页面。完成登录后，凭据会被缓存在本地，通常无需再次登录。
• 要求：一个 qwen.ai 账号 + 网络连接（至少首次登录时需要）。
• 优势：无需管理 API key，凭据自动刷新。
• 费用与配额：免费套餐已于 2026-04-15 停用。

启动 CLI 并按照浏览器流程操作：

qwen

Qwen OAuth 已不再作为 /auth 对话框中的可选条目；请运行 /auth 并选择当前的可用选项（Alibaba ModelStudio、Third-party Providers 或 Custom Provider）。

💳 选项 2：Alibaba Cloud Coding Plan

如果你希望成本可预测，同时拥有丰富的模型选项和更高的使用配额，请使用此选项。

• 工作原理：以固定月费订阅 Coding Plan，然后配置 Qwen Code 使用专属 endpoint 和你的订阅 API key。
• 要求：根据你账号所在的区域，从 Alibaba Cloud ModelStudio(Beijing)  或 Alibaba Cloud ModelStudio(intl)  获取有效的 Coding Plan 订阅。
• 优势：丰富的模型选项、更高的使用配额、可预测的月度成本，以及访问广泛的模型（Qwen、GLM、Kimi、Minimax 等）。
• 费用与配额：查看阿里云 ModelStudio Coding Plan 文档 Beijing  intl 。

Alibaba Cloud Coding Plan 在两个区域可用：

交互式配置

在终端中输入 qwen 启动 Qwen Code，然后运行 /auth 命令，选择 Alibaba ModelStudio，并在子菜单中选择 Coding Plan。选择你的区域，然后输入你的 sk-sp-xxxxxxxxx key。

身份验证完成后，使用 /model 命令在所有 Alibaba Cloud Coding Plan 支持的模型之间切换（包括 qwen3.5-plus、qwen3.6-plus、qwen3.7-plus、qwen3-coder-plus、qwen3-coder-next、qwen3-max-2026-01-23、glm-5、glm-4.7、kimi-k2.5 和 MiniMax-M2.5）。

无头或脚本化配置

对于 CI、容器或脚本，请使用环境变量或 settings.json 来配置 Coding Plan，而不是使用已移除的 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"

中国（北京）endpoint 使用 https://coding.dashscope.aliyuncs.com/v1，国际 endpoint 使用 https://coding-intl.dashscope.aliyuncs.com/v1。

替代方案：通过 settings.json 配置

如果你希望跳过交互式 /auth 流程，请将以下内容添加到 ~/.qwen/settings.json 中：

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "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"
  }
}

🚀 选项 3：API Key（灵活）

如果你希望连接到 OpenAI、Anthropic、Google、Azure OpenAI、OpenRouter、Requesty、ModelScope 等第三方 provider 或自托管 endpoint，请使用此选项。支持多种协议和 provider。

推荐：通过 settings.json 进行单文件配置

开始使用 API Key 身份验证的最简单方法是将所有配置放在单个 ~/.qwen/settings.json 文件中。以下是一个完整且可直接使用的示例：

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "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"
  }
}

各字段的作用：

保存文件后，直接运行 qwen 即可 —— 无需进行交互式 /auth 配置。

核心概念是 Model Providers（modelProviders）：Qwen Code 支持多种 API 协议，而不仅仅是 OpenAI。你可以通过编辑 ~/.qwen/settings.json 来配置可用的 provider 和模型，然后在运行时使用 /model 命令在它们之间切换。

支持的协议

步骤 1：在 ~/.qwen/settings.json 中配置模型和 provider

定义每种协议可用的模型。每个模型条目至少需要一个 id；envKey（保存 API key 的环境变量名）是可选但推荐的 —— 如果省略，它将回退到该身份验证类型的默认环境变量（例如 openai 的 OPENAI_API_KEY）。

编辑 ~/.qwen/settings.json（如果不存在则创建）。你可以在单个文件中混合使用多种协议 —— 以下是一个多 provider 示例，仅展示 modelProviders 部分：

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "id": "gpt-4o",
          "name": "GPT-4o",
          "envKey": "OPENAI_API_KEY",
          "baseUrl": "https://api.openai.com/v1"
        }
      ]
    },
    "anthropic": {
      "protocol": "anthropic",
      "models": [
        {
          "id": "claude-sonnet-4-20250514",
          "name": "Claude Sonnet 4",
          "envKey": "ANTHROPIC_API_KEY"
        }
      ]
    },
    "gemini": {
      "protocol": "gemini",
      "models": [
        {
          "id": "gemini-2.5-pro",
          "name": "Gemini 2.5 Pro",
          "envKey": "GEMINI_API_KEY"
        }
      ]
    }
  }
}

ModelConfig 字段（modelProviders 中的每个条目）：

有关完整的 modelProviders schema 以及 generationConfig、customHeaders 和 extra_body 等高级选项，请参阅 Model Providers Reference。

步骤 2：设置环境变量

Qwen Code 从环境变量（由模型配置中的 envKey 指定）读取 API key。有多种方式提供这些变量，以下按优先级从高到低列出：

1. Shell 环境 / export（最高优先级）

直接在 shell 配置文件（~/.zshrc、~/.bashrc 等）中设置，或在启动前内联设置：

 
# Alibaba Dashscope
export DASHSCOPE_API_KEY="sk-..."
 
# OpenAI / OpenAI-compatible
export OPENAI_API_KEY="sk-..."
 
# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
 
# Google GenAI
export GEMINI_API_KEY="AIza..."

2. .env 文件

Qwen Code 会自动加载它找到的第一个 .env 文件（变量不会在多个文件之间合并）。仅加载 process.env 中尚不存在的变量。

搜索顺序（从当前目录开始，向上查找至 /）：

1. .qwen/.env（推荐 —— 保持 Qwen Code 变量与其他工具隔离）
2. .env

如果未找到，则回退到你的主目录：

3. ~/.qwen/.env
4. ~/.env

3. settings.json → env 字段（最低优先级）

你也可以直接在 ~/.qwen/settings.json 的 env 键下定义 API key。这些将作为最低优先级的后备方案加载 —— 仅在系统环境或 .env 文件未设置该变量时应用。

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-...",
    "OPENAI_API_KEY": "sk-...",
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

这就是上面单文件配置示例中使用的方法。将所有内容保存在一个地方很方便，但请注意 settings.json 可能会被共享或同步 —— 对于敏感密钥，建议使用 .env 文件。

优先级总结：

步骤 3：使用 /model 切换模型

启动 Qwen Code 后，使用 /model 命令在所有已配置的模型之间切换。模型按协议分组：

/model

选择器将显示 modelProviders 配置中的所有模型，并按协议（例如 openai、anthropic、gemini）分组。你的选择会在各个会话之间持久化。

你也可以直接通过命令行参数切换模型，这在跨多个终端工作时非常方便。

# In one terminal
 
qwen --model "qwen3-coder-plus"
 
# In another terminal
 
qwen --model "qwen3.5-plus"

已移除的 qwen auth CLI 命令

独立的 qwen auth CLI 命令已被移除。请使用以下替代方案：

像 qwen auth status 这样的旧版调用现在会打印移除通知及这些迁移路径。

安全注意事项

• 不要将 API key 提交到版本控制中。
• 优先使用 .qwen/.env 存储项目本地密钥（并将其排除在 git 之外）。
• 如果终端输出打印了用于验证的凭据，请将其视为敏感信息。