在Claude Code中配置使用qwen3-coder-plus模型_大模型服务平台百炼(Model Studio)-阿里云帮助中心

阿里云百炼的通义千问系列模型支持 Anthropic API 兼容接口。通过修改以下参数，即可在 Claude Code 中调用通义千问系列模型。

ANTHROPIC_API_KEY（或 ANTHROPIC_AUTH_TOKEN）：替换为百炼 API Key。
ANTHROPIC_BASE_URL：替换为百炼的兼容端点地址 https://dashscope.aliyuncs.com/apps/anthropic。
模型名称：替换为百炼支持的模型名称（例如 qwen-plus），详情请参考支持的模型。

重要

本文档仅适用于中国大陆版（北京地域）。

支持的模型

百炼提供的 Anthropic API 兼容服务支持通义千问系列的部分模型：

模型系列	支持的模型名称（model）
通义千问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 查看更多

模型参数及计费规则请参考模型列表与价格。

前提条件

开通阿里云百炼
如果您是首次访问阿里云百炼服务平台，请按照以下步骤进行开通。
1. 登录阿里云百炼控制台。
2. 若页面顶部显示，需开通阿里云百炼的模型服务，并获得免费额度。如果未显示该消息，则表示您已经开通。
首次开通百炼后，您可领取新人免费额度（有效期：百炼开通后90天内），用于模型推理服务。免费额度领取方法和详情，请查看新人免费额度页面。
说明
1. 超出额度或期限将产生费用，开启免费额度用完即停功能将避免此情况下产生费用，具体费用请以控制台的实际报价和最终账单为准。
2. Claude Code 无法使用Qwen Code 每日 2000 次免费额度。

详细步骤

安装 Claude Code

macOS

在终端中执行下列命令，安装 Claude Code。

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

Windows

在 Windows 上使用 Claude Code，需要安装 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 中执行以下命令。

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

详情可以参考Claude Code官方文档的Windows安装教程。

配置环境变量

要通过兼容 Anthropic API 的方式，来接入阿里云百炼的模型服务，需要配置以下两个环境变量。

ANTHROPIC_BASE_URL：设置为 https://dashscope.aliyuncs.com/apps/anthropic。
ANTHROPIC_API_KEY或ANTHROPIC_AUTH_TOKEN：设置为阿里云百炼 API Key。
ANTHROPIC_API_KEY或ANTHROPIC_AUTH_TOKEN均可作为接入认证，只需要设置其一即可。本文以ANTHROPIC_API_KEY为例。

macOS

在终端中执行以下命令，查看默认 Shell 类型。
```
echo $SHELL
```

根据 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

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

在终端中执行下列命令，使环境变量生效。
Zsh
```
source ~/.zshrc
```
Bash
```
source ~/.bash_profile
```
打开一个新的终端，执行下列命令，查看环境变量是否生效。
```
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
```

Windows

在 Windows 中，可以通过 CMD 或 PowerShell 将阿里云百炼提供的 Base URL 和API Key设置为环境变量。

CMD

在 CMD 中运行以下命令，设置环境变量。

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

打开一个新的 CMD 窗口，运行以下命令，检查环境变量是否生效。
```
echo %ANTHROPIC_API_KEY%
echo %ANTHROPIC_BASE_URL%
```

PowerShell

在 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)

打开一个新的 PowerShell 窗口，运行以下命令，检查环境变量是否生效。
```
echo $env:ANTHROPIC_API_KEY
echo $env:ANTHROPIC_BASE_URL
```

在 Claude Code 中接入通义千问系列模型

配置模型
1. 对话期间：执行/model <模型名称>命令切换模型。
```
/model qwen-plus
```
2. 启动时：执行claude --model <模型名称>指定模型。
```
claude --model qwen-plus
```
3. 设置环境变量：设置ANTHROPIC_MODEL=<模型名称>。
```
export ANTHROPIC_MODEL="qwen-plus"
export ANTHROPIC_SMALL_FAST_MODEL="qwen-flash"
```
  说明
  Claude Code 可根据任务复杂度自动选择模型。通过设置以下两个环境变量，可以分别指定主模型和快速模型：
  - ANTHROPIC_MODEL：主模型。用于代码编写、推理等复杂任务。建议使用 Qwen-Max、Qwen-Plus、Qwen-Coder 系列模型。
  - ANTHROPIC_SMALL_FAST_MODEL：快速模型。用于语法检查、文件搜索等简单任务。建议使用 Qwen-flash、Qwen-Turbo 系列模型。
4. 在配置文件中永久设置：在项目根目录创建.claude/settings.json文件中，并写入模型配置信息。
```
{
  "env": {
    "ANTHROPIC_MODEL": "qwen-plus",
    "ANTHROPIC_SMALL_FAST_MODEL": "qwen-flash"
  }
}
```
运行 Claude Code
进入项目目录，执行claude命令。
```
cd my-project
claude
```

错误码

HTTP状态码	接口错误码	说明
400	invalid_request_error	请求格式或内容存在问题。具体原因可能包括：缺少必要的请求参数、参数值的数据类型不正确等。
401	authentication_error	API Key 存在问题。具体原因可能包括：请求头中未提供 API Key、提供的 API Key 不正确等。
403	permission_error	API Key 没有使用指定资源的权限。具体原因可能包括：使用的 API Key 所属的账户等级无权访问某个特定的模型，或者执行了一个账户权限不允许的操作。
404	not_found_error	未找到请求的资源。具体原因可能包括：兼容接口拼写有误、请求头中的模型不存在等。
413	request_too_large	请求超过了允许的最大字节数。标准 API 端点的最大请求大小为 32 MB。
429	rate_limit_error	账户达到了速率限制，建议降低请求频率。
500	api_error	发生了一个通用的服务器内部错误，建议稍后重试。
529	overloaded_error	API 服务器当前负载过高，暂时无法处理新的请求。

常见问题

如何节省 Token？

减少无关文件：为避免扫描不相关文件而造成 Token 消耗，建议在具体的项目目录中启动 Claude Code，同时仅保留必要的项目文件。
总结对话：Claude Code 会将历史对话内容作为上下文，当对话长度达到上下文窗口的 95% 时，Claude Code 会自动地总结对话内容。也可以通过执行/compact命令来手动地总结对话内容。
精确指令：模糊的请求会触发非必要的文件扫描，消耗更多的 Token。请在使用 Claude Code 时提出更明确、具体的问题或指令。
分解任务：在处理复杂任务时，可以将其分解为若干简单任务。
重置上下文：在开启一个全新的任务之前，使用/clear命令重置上下文，避免无关信息消耗 Token。

可以参考 Claude Code 官方文档了解更多节省 Token 的技巧。