1.2f 通义千问(阿里云)
目标:把阿里云百炼平台的 API Key 配进 Claude Code,完成第一次对话验证。
本关任务简报
这条路线适合你,如果:
- 你已经是阿里云用户,或更倾向于使用阿里生态的服务
- 你想在国内直连的前提下使用能力全面的大模型
- 通义千问(Qwen3 系列)在代码、推理、中文方面均有较好表现
通关奖励:解锁以下技能
- 在阿里云百炼控制台完成实名、开通服务并拿到 API Key
- 把通义千问配进 Claude Code,并选对大陆 / 国际节点
- 用
/doctor+/model验证接入,按场景在 Qwen 各模型间选型
机制解析
可用模型
阿里云百炼(DashScope)提供的模型,接入 Claude Code 后可用:
| 模型 | 定位 |
|---|---|
| qwen3.6-plus | 最新旗舰,综合能力强 |
| qwen3.6-flash | 轻量快速,性价比高 |
| qwen3-coder | 代码专用,工具调用能力强 |
| qwq-plus | 深度推理,适合复杂分析 |
ℹ️ 网站内容不定期更新,表格里不一定是平台最新模型;作者会尽量确保模型信息准确,请以平台官网和
/model实际显示为准。
平台提供的具体模型以百炼控制台为准,会持续更新。
大陆 / 国际节点别用混
阿里云百炼分大陆和国际两个节点,API Key 与 Base URL 必须同属一个节点,跨节点会连接超时:
- 中国大陆:
https://dashscope.aliyuncs.com/apps/anthropic(本页默认) - 国际地区:
https://dashscope-intl.aliyuncs.com/apps/anthropic
开始闯关
第 1 步:注册并开通服务
访问阿里云百炼控制台:https://bailian.console.aliyun.com
- 没有阿里云账号的话,按页面提示注册并完成实名认证(阿里云要求)
- 登录后开通百炼(Model Studio)服务,按提示同意服务协议
第 2 步:获取 API Key
- 进入 API Key 管理页:bailian.console.aliyun.com/#/api-key
- 点击 创建 API Key
- 立刻复制保存,关闭弹窗后看不到完整 Key
Key 只显示一次
创建后立刻保存,关掉弹窗再打开就看不到完整字符串了。
第 3 步:配置 Claude Code
阿里云百炼提供 Anthropic 格式的兼容接口,中国大陆用户使用以下地址:
Windows PowerShell
$env:ANTHROPIC_API_KEY = "你的阿里云百炼 API Key"
$env:ANTHROPIC_BASE_URL = "https://dashscope.aliyuncs.com/apps/anthropic"
claudemacOS / Linux
export ANTHROPIC_API_KEY="你的阿里云百炼 API Key"
export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/apps/anthropic"
claude海外 / 国际地区
如果你在中国大陆以外的地区,使用国际节点:
ANTHROPIC_BASE_URL="https://dashscope-intl.aliyuncs.com/apps/anthropic"长期使用可以写进 Claude Code 配置文件(~/.claude/settings.json):
{
"env": {
"ANTHROPIC_API_KEY": "你的阿里云百炼 API Key",
"ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic"
}
}通关检定
进入 Claude Code 后:
> /doctor确认没有连接报错,然后切换模型:
> /model选择 qwen3.6-plus 或 qwen3-coder,发一句话:
> 你好,请用中文介绍一下你自己自查清单:
- [ ] 已完成阿里云实名、开通百炼服务并拿到 Key
- [ ] Base URL 节点(大陆 / 国际)与账号一致,没选错
- [ ]
/doctor无报错,/model看到 Qwen 系列 - [ ] 发一句话能稳定收到回复
全部点亮就算通关 ✓
卡关了?翻车指南在这
| 现象 | 原因 | 解决 |
|---|---|---|
| 提示需要实名认证 | 阿里云强制要求 | 完成阿里云实名认证后重试 |
| 连接超时 | 可能选了国际节点 | 中国大陆用 dashscope.aliyuncs.com,确认节点选择正确 |
| API key invalid | Key 错误或服务未开通 | 确认已开通百炼服务,重新获取 Key |
| 某些模型不支持工具调用 | 并非所有模型都支持 | 换用 qwen3-coder 或 qwen3.6-plus |
这条路线的优点和代价
优点:国内直连,稳定;模型种类丰富(通用、代码、推理、视觉),适合不同场景;阿里云生态支撑,服务稳定性有保障。
代价:Anthropic 格式兼容层,部分高级能力可能受限;需要持续关注模型更新和计费变化。
💬 还是搞不定?
配置过程中遇到困难?加入群聊与众多战友探讨交流,寻找高效解决方案。
下一关
接入跑通后,回到 1.2 接入模型 → 选择其他路线,或直接进入 1.3 第一次对话 →。