Skip to content

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

  1. 没有阿里云账号的话,按页面提示注册并完成实名认证(阿里云要求)
  2. 登录后开通百炼(Model Studio)服务,按提示同意服务协议

第 2 步:获取 API Key

  1. 进入 API Key 管理页:bailian.console.aliyun.com/#/api-key
  2. 点击 创建 API Key
  3. 立刻复制保存,关闭弹窗后看不到完整 Key

Key 只显示一次

创建后立刻保存,关掉弹窗再打开就看不到完整字符串了。


第 3 步:配置 Claude Code

阿里云百炼提供 Anthropic 格式的兼容接口,中国大陆用户使用以下地址:

Windows PowerShell

powershell
$env:ANTHROPIC_API_KEY  = "你的阿里云百炼 API Key"
$env:ANTHROPIC_BASE_URL = "https://dashscope.aliyuncs.com/apps/anthropic"
claude

macOS / Linux

bash
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):

json
{
  "env": {
    "ANTHROPIC_API_KEY": "你的阿里云百炼 API Key",
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic"
  }
}

通关检定

进入 Claude Code 后:

text
> /doctor

确认没有连接报错,然后切换模型:

text
> /model

选择 qwen3.6-plusqwen3-coder,发一句话:

text
> 你好,请用中文介绍一下你自己

自查清单:

  • [ ] 已完成阿里云实名、开通百炼服务并拿到 Key
  • [ ] Base URL 节点(大陆 / 国际)与账号一致,没选错
  • [ ] /doctor 无报错,/model 看到 Qwen 系列
  • [ ] 发一句话能稳定收到回复

全部点亮就算通关 ✓


卡关了?翻车指南在这

现象原因解决
提示需要实名认证阿里云强制要求完成阿里云实名认证后重试
连接超时可能选了国际节点中国大陆用 dashscope.aliyuncs.com,确认节点选择正确
API key invalidKey 错误或服务未开通确认已开通百炼服务,重新获取 Key
某些模型不支持工具调用并非所有模型都支持换用 qwen3-coderqwen3.6-plus

这条路线的优点和代价

优点:国内直连,稳定;模型种类丰富(通用、代码、推理、视觉),适合不同场景;阿里云生态支撑,服务稳定性有保障。

代价:Anthropic 格式兼容层,部分高级能力可能受限;需要持续关注模型更新和计费变化。


💬 还是搞不定?

配置过程中遇到困难?加入群聊与众多战友探讨交流,寻找高效解决方案。

下一关

接入跑通后,回到 1.2 接入模型 → 选择其他路线,或直接进入 1.3 第一次对话 →

面向公开用户维护,内容基于 Claude Code 官方文档与真实使用经验整理