本文将手把手教你如何在 Windows 环境下，通过本地代理工具 cc-switch，将 Claude Code 完美“偷梁换柱”，接入阿里云通义千问大模型。

---

🛠️ 准备工作

1. Node.js: 确保已安装 (v18+)，并配置好环境变量，虽然暂时不知道啥用，装就完了，一路默认配置安装结束即可。Node.js 中文网 — 下载 Node.js，

2. Git Bash: Windows 下运行 Claude Code 的必备依赖，默认路径安装。Git - Install for Windows

3. cc-switch: 一款优秀的桌面端 AI 代理转发工具（可在 GitHub 搜索下载）。Release CC Switch v3.13.0 · farion1231/cc-switch
   

4. 阿里云百炼 API Key: 登录阿里云百炼控制台获取（目前新用户赠送海量 Token）。最开始用了b站一些视频博主的mini-max，但是我里面没钱，换用了阿里的，目前测试成功也没管了就https://bailian.console.aliyun.com/cn-beijing?spm=5176.29619931.J_PvCec88exbQTi-U433Fxg.5.74cd10d7f7F2iT&tab=model#/api-key

---

🚀 核心配置步骤

第一步：安装官方 Claude Code 工具

打开 PowerShell 或 CMD，全局安装：

PowerShell

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

(注意：如果你在 Windows 下运行 claude 提示找不到 git-bash，搜索安装即可：$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe")

第二步：配置 cc-switch (核心中转站)

我们要让 cc-switch 充当翻译官，把 Claude 的独家协议翻译成通用的 OpenAI 协议。

1. 打开 cc-switch，点击右上角 + 号新建节点。

2. Provider / 协议：🚨 极其关键！必须选择 OpenAI 或 OpenAI Compatible（千万别选 Claude）。

3. 接口地址 (Base URL)：填入百炼的兼容地址：https://dashscope.aliyuncs.com/compatible-mode/v1

4. API Key：填入你真实的百炼密钥（sk-xxxxxxxxxxxx）。

5. 模型 (Model)：选自己喜欢的。

6. 保存后，点击激活该节点（确保它显示“使用中”）。

7. 进入设置页面，打开“代理总开关”，并记下监听端口（例如：15721）。

第三步：配置 VS Code 终端并启动

这是最容易晕的一步，请记住这个口诀：真密钥给代理，假密钥骗终端。

在你的 VS Code 集成终端 (PowerShell) 中，依次执行以下命令：

PowerShell

# 1. 强制 Claude Code 把请求发给本地的 cc-switch
$env:ANTHROPIC_BASE_URL="http://127.0.0.1:15721"

# 2. 伪造一个官方格式的假密钥，用来绕过 CLI 的本地强制校验
$env:ANTHROPIC_API_KEY="sk-ant-dummykey1234567890abcdefg"

# 3. 启动 Claude Code
claude

只要界面出现 Opus 4.6 (1M context)（这是代理伪装的代号），就说明你成功了！直接在终端里输入你的编程需求即可。

---

💣 踩坑记录 (Troubleshooting)

在配置过程中，我踩了无数个坑，如果你也遇到了下面的报错，请直接对号入座：

❌ 报错 1：一直卡在 Wibbling... 或 Brewing... 然后提示 ECONNREFUSED

原因：你的本地代理没开机，终端把请求发到 127.0.0.1 没人理。

解决：打开 cc-switch 设置页面，把**“代理总开关”**打开。

❌ 报错 2：403 Forbidden 且提示 Please run /login

原因：你在 PowerShell 的环境变量里，把 $env:ANTHROPIC_API_KEY 设置成了你真实的通义千问 Key。官方工具在本地检测到 Key 不是以 sk-ant- 开头，直接把你拦截了。

解决：终端里必须用假 Key（见第三步），真 Key 只能填在 cc-switch 软件里。

❌ 报错 3：{"message":"配置错误: Claude Provider 缺少 base_url 配置","type":"proxy_error"}

原因：终端和代理连通了，但是 cc-switch 里的节点协议选错了。你把百炼的节点选成了 Claude 协议。

解决：在 cc-switch 中编辑节点，把 Provider 改为 OpenAI Compatible。

❌ 报错 4：Cannot read properties of null (reading 'output_tokens')

原因：这是官方插件的“算账”Bug。官方插件每次回复完都要找代理要 output_tokens 这个字段来算你花了多少钱，但第三方模型（如 Qwen）返回的收据格式不一样，导致它读不到数据而报错。

解决：这个报错完全不影响代码生成，可以无视直接关掉。如果实在强迫症，建议放弃官方 CLI，在 VS Code 插件市场安装 Roo Code (原 Claude Dev) 扩展，原生支持 OpenAI 协议，体验更佳且0报错。