千问 API 配置

本文档指导如何在 Claude Code 中配置阿里 DashScope 千问 API。Claude Code 官方 API（api.anthropic.com）在国内无法直接访问，推荐使用国内兼容 API。

架构

Claude Code CLI
  -> https://coding.dashscope.aliyuncs.com/apps/anthropic
  -> DashScope Qwen Anthropic 兼容接口

获取 API 资料

进入百炼控制台开通套餐
在 API Key 管理页面创建 Key
记录以下信息：

项目	值
API Key	`sk-sp-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
Anthropic Base URL	`https://coding.dashscope.aliyuncs.com/apps/anthropic`
推荐模型	`qwen3.5-plus`

套餐专属 Base URL

接口协议	Base URL
OpenAI	`https://coding.dashscope.aliyuncs.com/v1`
Anthropic	`https://coding.dashscope.aliyuncs.com/apps/anthropic`

Claude Code 走的是 Anthropic 兼容接口，统一使用 Anthropic 的 Base URL。

可用模型

平台	模型	说明
千问	`qwen3.5-plus`	通用，性价比高
千问	`qwen3-max`	能力更强
千问	`qwen-coder-plus`	代码专用

[!TIP] Coding Plan 套餐目前仅支持 qwen3.5-plus 模型，其他模型可能不可用。

WSL / Linux 配置

环境变量（推荐）

编辑 shell 配置文件：

vim ~/.bashrc   # 或 ~/.zshrc

追加到文件末尾：

export ANTHROPIC_AUTH_TOKEN="sk-sp-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://coding.dashscope.aliyuncs.com/apps/anthropic"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

[!IMPORTANT] 使用 ANTHROPIC_AUTH_TOKEN 而非 ANTHROPIC_API_KEY DashScope 兼容网关在交互模式下更认 ANTHROPIC_AUTH_TOKEN。实测只写 ANTHROPIC_API_KEY 时，claude -p 非交互模式可用，但 claude 交互模式可能仍尝试连接 api.anthropic.com。

生效配置：

source ~/.bashrc

配置默认模型

mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "model": "qwen3.5-plus"
}
EOF

配置完成后，重新打开终端即可直接运行 claude 进入交互模式。

Windows 配置

用户级环境变量

以管理员身份打开 PowerShell，执行：

[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', $null, 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-sp-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://coding.dashscope.aliyuncs.com/apps/anthropic', 'User')
[Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS', '1', 'User')

重新打开终端后生效。

配置文件

编辑 %USERPROFILE%\.claude\settings.json：

mkdir "$env:USERPROFILE\.claude" -Force
notepad "$env:USERPROFILE\.claude\settings.json"

写入：

{
  "model": "qwen3.5-plus"
}

验证

非交互模式

claude -p "请只回复：连接成功" --model qwen3.5-plus

返回 连接成功 则说明配置正确。

交互模式

claude

能进入交互界面即成功。

诊断命令

claude doctor         # 检查配置和 API 连通性
claude auth status    # 查看认证状态

切换模型

单次指定

claude -p "你好" --model qwen3-max

修改默认模型

编辑 ~/.claude/settings.json（WSL）或 %USERPROFILE%\.claude\settings.json（Windows）：

{
  "model": "qwen3-max"
}

交互模式内切换

> /model qwen3-max

常见问题

交互模式报错 `Unable to connect to Anthropic services`

确保使用 ANTHROPIC_AUTH_TOKEN 而非 ANTHROPIC_API_KEY：

unset ANTHROPIC_API_KEY
export ANTHROPIC_AUTH_TOKEN="sk-sp-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://coding.dashscope.aliyuncs.com/apps/anthropic"

切换配置后仍连接旧 API

# 检查当前环境变量
echo $ANTHROPIC_BASE_URL

# 重新加载配置
source ~/.bashrc

Windows PowerShell 检查用户变量：

$names = 'ANTHROPIC_API_KEY','ANTHROPIC_AUTH_TOKEN','ANTHROPIC_BASE_URL'
foreach ($name in $names) {
  $value = [Environment]::GetEnvironmentVariable($name, 'User')
  if ([string]::IsNullOrEmpty($value)) { "$name=<not set>" } else { "$name=<set>" }
}

settings.json 残留旧配置

如果以前用过 LiteLLM、本地代理等，检查是否残留：

http://127.0.0.1:4000
sk-local-litellm-key
旧的自定义模型映射

这些残留配置会导致环境变量已正确但 Claude 仍走旧链路。

交互模式报错 `Raw mode is not supported`

当前终端不是真正的 TTY。解决方法：

使用 Windows Terminal 打开 WSL：Win + R → wt → wsl
或在非 TTY 环境中使用非交互模式：claude -p "你的问题"

网络连通性测试

# WSL / Linux
curl -I https://coding.dashscope.aliyuncs.com/apps/anthropic

# Windows PowerShell
curl.exe -I https://coding.dashscope.aliyuncs.com/apps/anthropic