 本地化配置实战)
🚀 国内极速版：Claude Code + 通义千问 (Qwen) 本地化配置实战
要在国内顺畅使用 Claude Code，最推荐的方式是将其配置为调用国内的大模型 API（如 Qwen）。这种方式无需处理复杂的网络代理，速度快且成本低。
以下是完整的安装、配置与使用流程。
🛠️ 第一步：环境准备
Claude Code 是基于 Node.js 开发的，因此我们需要先安装 Node.js 环境。
- 下载安装：访问 Node.js 官网，下载并安装LTS (长期支持版)。
- 验证安装：打开 PowerShell 或 CMD，输入以下命令：
如果能正常显示版本号，说明环境已就绪。node--versionnpm--version
一般如下：
📦 第二步：安装 Claude Code
请务必注意包名，避免安装到非官方的仿冒包。
- 执行安装：
npminstall-g@anthropic-ai/claude-code - 验证安装：
安装完成后，重启终端，输入：
显示类似claude--version2.1.x (Claude Code)即为成功。
⚙️ 第三步：核心配置（阿里云 + 通义千问）
这是最关键的一步。我们需要将 Claude Code 的请求转发到阿里云的百炼平台，利用其兼容 Anthropic 的接口来调用通义千问。
1. 获取阿里云 API Key
- 访问地址：阿里云百炼控制台
- 操作步骤：
- 登录后，在左侧菜单找到“API-KEY管理”。
- 点击“创建新的API-KEY”。
- 复制生成的 Key（格式为
sk-...），请务必妥善保管。
2. 配置环境变量 (Windows)
⚠️ 重要踩坑修正：
在查阅资料和实测过程中，我发现如果使用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🚀 第四步：启动与使用
配置完成后，让我们来测试一下是否成功。
- 进入项目目录：
成功后如下：cdD:\你的代码项目路径 claude - 授权信任：
首次运行会询问是否信任该文件夹，输入1并回车。 - 验证状态：
启动后，在对话框中输入/status，你应该能看到当前模型为qwen3.5-plus，且 API 状态正常。
📝 常用命令速查表
为了方便大家使用，我整理了 Claude Code 的常用交互命令：
| 命令 | 说明 |
|---|---|
/model <模型名> | 切换当前使用的模型 |
/status | 查看当前 API 和模型的配置状态 |
/clear | 清空当前对话历史 |
/plan | 进入规划模式，只分析不修改代码 |
/init | 在项目根目录生成 CLAUDE.md，用于定义项目上下文 |
总结：
通过以上配置，我们成功利用国内的大模型资源（通义千问）替代了昂贵的海外服务，不仅解决了网络问题，还大幅降低了使用成本。如果你在南京或其他地区遇到类似问题，希望这篇教程能帮到你！
