认证

Qwen Code 支持两种认证方式。选择与你运行 CLI 方式相匹配的一种：

• Qwen OAuth（推荐）：在浏览器中使用你的 qwen.ai 账户登录。
• API-KEY：使用 API 密钥连接到任何支持的提供商。更加灵活——支持 OpenAI、Anthropic、Google GenAI、阿里云百炼和其他兼容的端点。

👍 选项 1：Qwen OAuth（推荐且免费）

如果你想要最简单的设置并且正在使用 Qwen 模型，请选择此方式。

• 工作原理：首次启动时，Qwen Code 会打开浏览器登录页面。完成登录后，凭证将被缓存在本地，因此通常你无需再次登录。
• 要求：一个 qwen.ai 账户 + 网络访问权限（至少首次登录时需要）。
• 优势：无需管理 API 密钥，自动刷新凭证。
• 费用和配额：免费，配额为 每分钟 60 次请求 和 每天 1,000 次请求。

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

qwen

🚀 选项 2：API-KEY（灵活）

如果你希望更灵活地选择提供商和模型，请使用此选项。支持多种协议和提供商，包括 OpenAI、Anthropic、Google GenAI、阿里云百炼、Azure OpenAI、OpenRouter、ModelScope 或自托管兼容端点。

推荐：通过 settings.json 单文件设置

开始使用 API-KEY 认证的最简单方法是将所有内容放在一个单独的 ~/.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"
  }
}

各个字段的作用：

保存文件后，只需运行 qwen —— 无需交互式 /auth 设置。

选项1：编码计划（阿里云百炼）

如果你希望为 qwen3-coder-plus 模型获得可预测的成本和更高的使用配额，请使用此选项。

• 工作原理：订阅固定月费的编码计划，然后配置 Qwen Code 使用专用端点和你的订阅 API 密钥。
• 要求：从 阿里云百炼  获取有效的编码计划订阅。
• 优势：更高的使用配额、可预测的月度成本、访问最新的 qwen3-coder-plus 模型。
• 费用和配额：查看 阿里云百炼编码计划文档 。

在终端中输入 qwen 启动 Qwen Code，然后输入 /auth 命令并选择 API-KEY

输入后，选择 编码计划：

输入你的 sk-sp-xxxxxxxxx 密钥，然后使用 /model 命令在所有百炼 编码计划 支持的模型之间切换（包括 qwen3.5-plus、qwen3-coder-plus、qwen3-coder-next、qwen3-max、glm-4.7 和 kimi-k2.5）：

替代方案：通过 settings.json 配置编码计划

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

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus (编码计划)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "来自百炼编码计划的 qwen3-coder-plus",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

选项2：第三方 API-KEY

如果你想要连接到第三方提供商，例如 OpenAI、Anthropic、Google、Azure OpenAI、OpenRouter、ModelScope 或自托管端点，请使用此选项。

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

支持的协议

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

定义每个协议可用的模型。每个模型条目至少需要一个 id 和一个 envKey（保存你的 API 密钥的环境变量名）。

编辑 ~/.qwen/settings.json（如果不存在则创建）。你可以在单个文件中混合多个协议——这里是一个仅显示 modelProviders 部分的多提供商示例：

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

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

关于完整的 modelProviders 模式和高级选项，如 generationConfig、customHeaders 和 extra_body，请参见模型提供商参考。

步骤 2：设置环境变量

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

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 密钥。这些会被作为最低优先级的后备加载 — 只有当变量未通过系统环境或 .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）进行分组。你的选择会在会话间保持。

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

 
# 在一个终端中
 
qwen --model "qwen3-coder-plus"
 
# 在另一个终端中
 
qwen --model "qwen3-coder-next"

安全注意事项

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