配置通义千问

通义千问是阿里巴巴推出的中文大模型，阿里云百炼提供 Anthropic API 兼容服务，可在 Claude Code 中使用。

参考文档：https://help.aliyun.com/zh/model-studio/claude-code

前提条件

步骤 1：开通阿里云百炼服务

登录百炼控制台：https://bailian.console.aliyun.com/
点击开通模型服务
新用户可领取 90 天免费额度
建议开启“免费额度用完即停”

步骤 2：获取 API Key

进入“API-KEY 管理”
点击“创建新的 API-KEY”
保存 API Key（仅显示一次）

安装 Claude Code

macOS

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

Windows

在 WSL 或 Git Bash 中执行：

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

配置环境变量

需要配置：

ANTHROPIC_BASE_URL: https://dashscope.aliyuncs.com/apps/anthropic
ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN: 百炼 API Key

macOS

查看默认 Shell：

echo $SHELL

Zsh 配置：

# 用百炼 API Key 替换 YOUR_DASHSCOPE_API_KEY
echo 'export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/apps/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="YOUR_DASHSCOPE_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Bash 配置：

# 用百炼 API Key 替换 YOUR_DASHSCOPE_API_KEY
echo 'export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/apps/anthropic"' >> ~/.bash_profile
echo 'export ANTHROPIC_API_KEY="YOUR_DASHSCOPE_API_KEY"' >> ~/.bash_profile
source ~/.bash_profile

验证环境变量：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

Windows CMD

REM 用百炼 API Key 替换 YOUR_DASHSCOPE_API_KEY
setx ANTHROPIC_API_KEY "YOUR_DASHSCOPE_API_KEY"
setx ANTHROPIC_BASE_URL "https://dashscope.aliyuncs.com/apps/anthropic"

验证：

echo %ANTHROPIC_API_KEY%
echo %ANTHROPIC_BASE_URL%

Windows PowerShell

# 用百炼 API Key 替换 YOUR_DASHSCOPE_API_KEY
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://dashscope.aliyuncs.com/apps/anthropic", [EnvironmentVariableTarget]::User)

验证：

echo $env:ANTHROPIC_API_KEY
echo $env:ANTHROPIC_BASE_URL

支持的模型

通义千问 Max

qwen3-max
qwen3-max-2025-09-23
qwen3-max-preview（支持思考模式）

通义千问 Plus

qwen-plus
qwen-plus-latest
qwen-plus-2025-09-11

通义千问 Flash

qwen-flash
qwen-flash-2025-07-28

通义千问 Turbo

qwen-turbo
qwen-turbo-latest

通义千问 Coder（不支持思考模式）

qwen3-coder-plus
qwen3-coder-plus-2025-09-23
qwen3-coder-flash

通义千问 VL（不支持思考模式）

qwen-vl-max
qwen-vl-plus

测试连接

步骤 1：启动 Claude Code

claude-code

步骤 2：配置模型

/mode qwen-plus

步骤 3：发送测试消息

你好，请用一句话介绍一下你自己。

步骤 4：验证结果

回复应流畅自然
响应时间在几秒内
无错误提示

模型版本说明

Max：最强版本，适合复杂任务，价格较高
Plus：能力较强，适合大多数复杂任务
Flash：响应快、成本低，适合日常对话
Turbo：最快、成本最低，适合新手
Coder：编程任务优化，不支持思考模式
VL：支持视觉理解，不支持思考模式

重要提示

旧版接口已弃用：https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy
免费额度限制：Claude Code 无法使用 Qwen Code 每日 2000 次免费额度
地域限制：仅适用于中国内地版（北京地域）
思考模式：仅 qwen3-max-preview 支持

常见问题

Q：API Key 泄露了怎么办？ A：删除旧密钥并创建新密钥。

Q：提示“鉴权失败”？ A：检查 API Key、Base URL 是否正确，确认没有多余空格。

Q：如何选择模型版本？ A：新手可用 qwen-turbo 或 qwen-flash，编程任务推荐 qwen3-coder-plus。

Q：通义千问和文心一言哪个更好？ A：两者都优秀，可根据具体任务选择。

Q：如何查看模型参数及计费规则？ A：查看阿里云百炼控制台模型列表。

Q：环境变量配置后不生效怎么办？ A：执行 source 命令并打开新终端窗口再测试。

配置通义千问

On this page