本文介绍如何把通义千问（Qwen）接入 Claude Code，让你在 Claude Code 的 Agent 工作流里，用上国内直连、上下文高达 1M 的千问编程模型。全文基于官方文档与实时查询的数据整理，Windows / macOS / Linux 均适用。

一、为什么是”千问 + Claude Code”

Claude Code 是目前体验最好的命令行编程 Agent 之一：能读代码库、改文件、跑命令、多轮自主规划。但它默认连接 Anthropic 官方模型，对国内开发者来说有两个不便：网络门槛和计费方式。

阿里云百炼提供了 Anthropic 兼容接口，只需要改几个环境变量，Claude Code 就能无缝切换到千问模型，体验上几乎没有差别。这样做的好处：

• 国内直连：不需要任何网络代理；
• 计费灵活：按量计费 / Coding Plan / Token Plan（个人版、团队版）四种方式任选；
• 大上下文：旗舰编程模型支持 1M token 上下文，大型代码仓库也能整体装下；
• 中文友好：千问对中文需求和中文注释的理解天然更好。

原理一句话：Claude Code 支持通过 ANTHROPIC_BASE_URL 把请求指向任意 Anthropic 兼容端点，百炼的网关负责把请求翻译给千问模型。

二、准备工作

开始之前，确认以下条件：

1. 阿里云账号：需要开通阿里云百炼（Model Studio）；
2. Node.js ≥ 18：Claude Code 基于 Node.js 运行，node -v 检查版本；
3. Windows 用户特别注意：先安装 WSL 或 Git for Windows，后续命令在 WSL 或 Git Bash 中执行（CMD/PowerShell 也能配置，但官方推荐 WSL/Git Bash 环境）。

三、选择计费方案，拿到 Key

百炼为 Claude Code 提供四种计费方案，每种方案有专属的接入端点和 Key 获取入口，先选定方案再配置：

方案	适合人群	接入端点（ANTHROPIC_BASE_URL）	Key 获取入口
Token Plan 个人版	个人开发者，包月使用多款模型	https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic	百炼控制台 · 个人订阅
Token Plan 团队版	团队统一采购、分配席位	同上	百炼控制台 · 团队管理
Coding Plan	重度编程场景	https://coding.dashscope.aliyuncs.com/apps/anthropic	百炼控制台 · Coding Plan
按量计费	灵活按 token 付费、可自由指定模型	北京：https://{WorkspaceId}.http://cn-beijing.maas.aliyuncs.com/apps/anthropic
新加坡：https://{WorkspaceId}.http://ap-southeast-1.maas.aliyuncs.com/apps/anthropic	按量计费 API Key 申请指引

按量计费端点 URL 中的 {WorkspaceId} 需替换为你在百炼控制台看到的实际工作空间 ID。

选型建议：

• 日常个人写代码、用量稳定 → Token Plan 个人版（包月，包含 qwen3.8-max 等多款模型）；
• 预算敏感、主要做编程任务 → Coding Plan；
• 用量波动大，或想自由切换不同模型（包括 coder 系列）→ 按量计费；
• 多人协作 → Token Plan 团队版。

⚠️ 注意：订阅制 Key（Token Plan / Coding Plan）仅限在 Claude Code、Cursor 等交互式编程工具中使用，不要写进自动化脚本或应用后端，违规可能导致订阅被暂停或 Key 被吊销。

四、五步完成接入

第 1 步：安装 Claude Code

在 WSL / Git Bash / 终端中执行：

npm install -g @anthropic-ai/claude-code

安装完成后验证：

第 2 步：跳过 Anthropic 官方登录

在用户主目录创建（或编辑）.claude.json 文件（Windows 为 C:\Users\<用户名>\.claude.json），写入：

{
  "hasCompletedOnboarding": true
}

这个开关让 Claude Code 跳过 Anthropic 官方账号登录流程——我们用自己的 Key 登录百炼，不需要 Anthropic 账号。

第 3 步：配置 settings.json

在用户主目录的 .claude/settings.json（Windows 为 C:\Users\<用户名>\.claude\settings.json）中写入配置。以 Token Plan 个人版为例： （当前文章写下的时间为2026年8月16日，请根据实际情况修改）

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的百炼API-KEY",
    "ANTHROPIC_BASE_URL": "https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_MODEL": "qwen3.8-max",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-max",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash"
  }
}

换成其他方案时，只需改 ANTHROPIC_BASE_URL（用第三节的表格对照），并把 Key 换成对应方案控制台里获取的 Key。

几个要点：

• 用 ANTHROPIC_AUTH_TOKEN（发送 Authorization: Bearer 头），这是百炼各端点要求的认证形式；
• 模型映射：Claude Code 内部有 sonnet / opus / haiku 等别名，通过 ANTHROPIC_DEFAULT_*_MODEL 把它们映射到千问模型。上面是官方文档给出的 Token Plan 模板（主力模型用 qwen3.8-max，轻量任务用 qwen3.6-flash）。按量计费方案的官方模板则是主力模型用 qwen3.7-max、轻量任务用 qwen3.6-flash；
• settings.json 的 env 会覆盖 shell 环境变量：如果同一变量两处都设了，以 settings.json 为准，调试时注意这个优先级；
• 不要把 Key 放进项目的 .claude/settings.json（会被提交到 Git）。放在用户级配置，或项目内的 .claude/settings.local.json（自动被 gitignore）。

第 4 步：重新打开终端

修改配置后，关闭当前终端、新开一个窗口再启动 Claude Code，否则新配置不生效。

第 5 步：验证

能正常回复即接入成功。进入交互会话后，再执行：

检查输出中的 Base URL 是否指向百炼地址、认证方式是否正确。如果发现请求还在连 Anthropic 官方服务，回到第 3 步检查变量名和 URL 拼写。

五、模型怎么选

编程专用：coder 系列（按量计费可选）

通过按量计费接入时，可以在 ANTHROPIC_MODEL 里直接指定千问的 coder 系列编程模型。以下是实时查询到的数据（2026-08）：

模型	上下文	输入价格（≤32K 档）	输出价格（≤32K 档）	特点
qwen3-coder-plus	1M	¥4 / 1M tokens	¥16 / 1M tokens	旗舰代码模型，Coding Agent 能力强，支持工具调用与上下文缓存（缓存读取仅 ¥0.4/1M）
qwen3-coder-next	256K	¥1 / 1M tokens	¥4 / 1M tokens	新一代均衡之选：效果接近 plus、速度更快，重点优化仓库级理解与 agentic 工具适配
qwen3-coder-flash	1M	¥1 / 1M tokens	¥4 / 1M tokens	轻量快速，支持缓存（缓存读取 ¥0.1/1M），适合高频简单任务

注意两点：

• 阶梯定价：输入超过 32K / 128K / 256K 后单价会逐级上浮，长上下文任务请在控制台确认当前档位价格；
• 免费额度：查询时 coder 系列均显示有 100 万 token 免费额度（有效期至 2026-11-11），但免费额度可能随时调整或已用完，请以控制台实时数据为准，不要假设一定免费。

选择建议：复杂重构、跨文件大改动 → qwen3-coder-plus；日常开发、性价比优先 → qwen3-coder-next；批量小任务 → qwen3-coder-flash。

通用旗舰：订阅方案里的主力

Token Plan / Coding Plan 的官方配置模板使用通用旗舰模型，编程能力同样很强：

模型	上下文	定位
qwen3.8-max	1M	最强旗舰，多模态，默认开启思考模式
qwen3.7-max	1M	纯文本旗舰，长程 agentic 编程能力突出
qwen3.7-plus	1M	均衡多模态，Agent 与编码增强（Coding Plan 模板主力）
qwen3.6-flash	1M	快速轻量，适合做 haiku 角色的后台小任务

关键提醒：使用自定义 Base URL 时，Claude Code 不会校验模型名，会原样传给服务端。模型名写错会在第一次请求时报 “There’s an issue with the selected model”，此时检查 ANTHROPIC_MODEL 是否是该端点真实支持的模型名。

六、日常使用技巧

接入完成后，这些 Claude Code 原生能力配合千问一样好用：

• /model：会话内切换模型。不带参数打开选择器；在自定义端点下价格信息不会显示（价格由百炼侧决定），属正常现象；
• /status：随时确认当前 Base URL、认证方式、模型；
• CLAUDE.md：在项目根目录放一个 CLAUDE.md，写清楚项目结构、构建命令、编码规范，Claude 每次会话都会自动读取，输出质量提升明显；
• 计划模式：复杂需求先让 Claude 出方案再动手（Shift+Tab 切换模式），避免它一上来就大刀阔斧改代码；
• 善用大上下文：qwen3-coder-plus 有 1M 上下文，可以让它通读整个仓库再动手，”先读懂再改”是 Agent 编程质量的分水岭；
• 控制成本的工程习惯：会话太长时用 /clear 清理上下文；重复性大项目利用好 coder-plus / coder-flash 的上下文缓存（缓存读取价格是正常输入的 1/10）；简单任务交给 flash 档模型。

七、常见问题排查

现象	原因与解决
配置后不生效	修改 settings.json 后必须新开终端窗口再启动；另外 settings.json 的 env 优先于 shell export，检查是否被覆盖
报错提示正在连接 Anthropic 官方服务	ANTHROPIC_BASE_URL 没生效或拼错。执行 /status 确认 Base URL 是否指向百炼地址
“There’s an issue with the selected model”	模型名不是该端点支持的名称，核对 ANTHROPIC_MODEL（见第五节）
401 / 认证失败	Key 错误或过期，去对应方案的控制台重新获取；确认用的是 ANTHROPIC_AUTH_TOKEN
启动时仍要求登录 Anthropic 账号	检查 ~/.claude.json 中 hasCompletedOnboarding 是否为 true
扫描模型列表的端点报 404	不影响正常使用，可忽略——模型由配置中的映射直接指定
其他怪异报错	先升级：npm update -g @anthropic-ai/claude-code，老版本常有兼容性问题

另外两个已知行为：使用自定义端点后，Remote Control 功能会自动禁用，语音输入不可用；MCP 工具搜索默认禁用（如需要可显式设置 ENABLE_TOOL_SEARCH=true）。

八、费用说明

⚠️ 费用说明：以上费用为基于官方公示单价的预估价格，仅供参考。实际费用受 Token 消耗量、上下文长度阶梯定价、Batch/缓存折扣及计费策略调整等因素影响，请以控制台的实际账单为准：按量付费账单 | Token Plan 订阅 | 用量分析。部分模型可能提供限时免费额度，但免费额度的可用性、额度量及有效期随时可能调整，请在控制台确认您的账户是否仍有剩余额度，切勿假设本次调用免费。最新定价详见模型定价页。

参考资料

• 阿里云百炼官方文档：Claude Code
• 百炼 Anthropic 兼容接口说明
• Claude Code 官方文档：环境变量
• Claude Code 官方文档：连接 LLM 网关
• 模型详情页：qwen3-coder-plus · qwen3-coder-next · qwen3-coder-flash

写于 2026-08-16。模型能力与价格随时间变化，动手前建议对照官方文档复核一遍。