国内极速版：Claude Code + 通义千问 (Qwen) 本地化配置实战(完整避坑指南)

柒@宝儿姐

883人浏览 · 2026-05-07 11:24:14

柒@宝儿姐 · 2026-05-07 11:24:14 发布

🚀 国内极速版：Claude Code + 通义千问 (Qwen) 本地化配置实战(完整避坑指南)

要在国内顺畅使用 Claude Code，最推荐的方式是将其配置为调用国内的大模型 API（如 Qwen）。这种方式无需处理复杂的网络代理，速度快且成本低。
以下是完整的安装、配置与故障排查实战流程。

🛠️ 第一步：环境准备

Claude Code 是基于 Node.js 开发的，因此我们需要先安装 Node.js 环境。

下载安装： 访问 Node.js 官网，下载并安装 LTS (长期支持版)。
验证安装： 打开 PowerShell 或 CMD，输入以下命令：
```
node --version
npm --version
```
如果能正常显示版本号，说明环境已就绪。
一般如下：

📦 第二步：安装 Claude Code

请务必注意包名，避免安装到非官方的仿冒包。

执行安装：

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

验证安装：
安装完成后，重启终端，输入：
```
claude --version
```
显示类似 2.1.x (Claude Code) 即为成功。

⚙️ 第三步：核心配置（阿里云 + 通义千问）

这是最关键的一步。我们需要将 Claude Code 的请求转发到阿里云的百炼平台，利用其兼容 Anthropic 的接口来调用通义千问。

1. 获取阿里云 API Key

访问地址： 阿里云百炼控制台
操作步骤：
1. 登录后，在左侧菜单找到 “API-KEY管理”。
2. 点击 “创建新的API-KEY”。
3. 复制生成的 Key（格式为 sk-...），请务必妥善保管。

2. 配置环境变量 (Windows)—— 推荐 GUI 方式

⚠️ 重要踩坑修正：
在查阅资料和实测过程中，我发现如果使用 ANTHROPIC_API_KEY 变量名在某些环境下可能无法生效。请务必使用 ANTHROPIC_AUTH_TOKEN，这是经过验证的稳定写法。

按 Win键，搜索 “编辑系统环境变量” 并打开。
点击 “环境变量” 按钮。
在 “用户变量” 区域点击 “新建”，添加以下 3 条配置：

变量名	变量值	说明
`ANTHROPIC_BASE_URL`	`https://dashscope.aliyuncs.com/apps/anthropic`	阿里云兼容接口地址
`ANTHROPIC_AUTH_TOKEN`	`sk-你的真实APIKey`	注意：这里使用 Token 而非 Key
`ANTHROPIC_MODEL`	`qwen3.5-plus`	指定使用的模型（通义千问）

3. 跳过登录检查 (Hack)

由于我们使用的是第三方接口，无法通过官方的 claude login 验证。我们需要手动创建一个配置文件，让它以为已经登录过了。

在 PowerShell 中执行以下命令：

# 1. 创建配置目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

# 2. 创建并写入配置文件
'{"hasCompletedOnboarding": true}' | Out-File -FilePath "$env:USERPROFILE\.claude\settings.json" -Encoding utf8

🚨 故障排查：如果配置后依然报错

如果你严格按照上述 GUI 步骤操作，但在终端输入 claude 后依然报错（如 400 错误或提示找不到模型），请不要慌张。这通常是因为 Windows 系统的环境变量并没有真正写入或者未生效。

请使用最稳妥的 PowerShell 命令强制写入系统：

强制写入变量：
直接在当前的 PowerShell 窗口中，依次复制并运行以下三行命令（记得把里面的你的真实值替换成你实际的阿里云 API 信息）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的真实Key", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://dashscope.aliyuncs.com/apps/anthropic", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "qwen-plus", [System.EnvironmentVariableTarget]::User)

💡 原理说明： 这里的 [System.EnvironmentVariableTarget]::User 意思是把变量永久保存在当前用户的系统设置里，比修改系统 Path 更稳定。

验证是否生效：
输入以下命令并回车：
```
$env:ANTHROPIC_BASE_URL
```
预期输出： https://dashscope.aliyuncs.com/apps/anthropic
如果能看到输出，说明配置成功了！
注意模型名称：
请务必使用官方标准的模型名称，如 qwen-plus 或 qwen-turbo。不要使用 qwen3.5-plus 这种非标准名称，否则会报 400 错误。

🚀 第四步：启动与使用

配置完成后，让我们来测试一下是否成功。

进入项目目录：
```
cd 你的项目路径
claude
```

成功后应该如下：
在这里插入图片描述

初始化项目：
启动后，输入 /init。
- 如果报错 AccessDenied.Unpurchased： 说明你没有额度。请去阿里云百炼控制台的“模型广场”，找到 qwen-plus，点击“开通”或“领取免费额度”。
- 如果报错 Model Not Found： 说明你模型名称写错了。请检查第三步中的模型名是否为标准名称。
  正常应该如下图：
验证状态：
输入 /status，你应该能看到当前模型为 qwen-plus，且 API 状态正常。

📝 常用命令速查表

为了方便大家使用，我整理了 Claude Code 的常用交互命令：

命令	说明
`/model <模型名>`	切换当前使用的模型
`/status`	查看当前 API 和模型的配置状态
`/clear`	清空当前对话历史
`/plan`	进入规划模式，只分析不修改代码
`/init`	在项目根目录生成 CLAUDE.md，用于定义项目上下文