AI编程：Claude Code + VSCode + CC-Switch

国内使用 Claude Code 需要解决访问和支付问题，而 Claude Code + VSCode + CC-Switch 的组合方案，恰好能通过接入 DeepSeek 等国产模型来完美避开这两道门槛。

为了让整个过程简单清晰，下面我把安装和配置步骤拆解成了四个部分，你可以跟着一步步来。

在开始之前，需要先装好下面这几样基础工具。

1.1 安装 VSCode
- 访问 Visual Studio Code 官网下载并安装。
- 安装完成后，可以在扩展市场搜索并安装 Chinese (Simplified) Language Pack 中文插件。
1.2 安装 Node.js
- Claude Code 需要通过 Node.js 来安装，可以从 Node.js 官网下载 LTS版本（如 v20.x 或 v22.x）。
- 安装时一路点"下一步"即可。安装完成后，请重启你的命令提示符或PowerShell。
- 验证：打开一个新的终端（Terminal），输入以下命令，如果能看到版本号就说明安装成功了：
  
  bash
  复制代码
```
node -v
npm -v
```
- 特别说明 ：如果后面 claude 命令找不到，也优先尝试重启终端，这能解决大多数环境变量未刷新的问题。

2.1 安装 Claude Code CLI
- 在VSCode的终端里运行下面这条命令即可。加上--registry参数是使用国内的npm镜像源，下载会更快更稳。
  
  bash
  复制代码
```
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
```
- 验证：安装完成后，输入 claude --version，如果正常显示版本号就说明CLI安装成功了。
2.2 安装 CC-Switch 桌面端
- 访问 CC-Switch Releases 页面，下载最新版的Windows安装包（如 CC-Switch-vX.X.X-Windows-Setup.exe 或 .msi 文件）。
- 下载后双击安装，过程很简单，一直点"下一步"就行。
- 安装完成后，可以在桌面上找到并启动 CC-Switch。
2.3 在VSCode中安装 Claude Code 插件
- 回到VSCode，点击左侧活动栏的"扩展"图标（或按 Ctrl+Shift+X），在搜索框输入 Claude Code，找到后点击"安装"。
- 插件安装完成后，VSCode右侧边栏会出现Claude Code的图标，但先别急着用，我们还要通过CC-Switch给它配置模型。

这是最关键的一步，核心是告诉Claude Code去调用DeepSeek的接口，而不是被封堵的Anthropic官方接口。

3.1 获取 DeepSeek API Key
- 打开 DeepSeek 开放平台，注册/登录你的账号。
- 进入"API Keys"页面，点击"创建API Key"，并给它起个名字。创建成功后，复制并妥善保存 这个以 sk- 开头的Key，它只显示一次。

3.2 在 CC-Switch 中添加供应商

填写关键信息（这是接入DeepSeek的核心参数）：

配置项	填写内容	说明
提供商名称	`DeepSeek` (可自定义)	方便你识别就行。
Base URL	`https://api.deepseek.com/anthropic`	必须填这个，这是DeepSeek为兼容Claude Code提供的接口地址。
API Key	`sk-...`	粘贴你刚从DeepSeek平台复制过来的API Key。
主力模型	`deepseek-v4-pro[1m]`	推荐使用V4模型，`[1m]`表示启用100万token的超长上下文。

3.3 重启终端并验证
- 配置完成后，请关闭并重新打开 VSCode 的终端（Terminal）。这一步是必须的，目的是让新的环境变量生效。
- 在全新的终端里输入 claude 命令。
- 恭喜！ 如果成功进入了一个可以直接对话的界面，而不是跳出一个要求你登录Anthropic账号的网页，就说明整个链路已经成功跑通了！

现在就可以愉快地使用了。

在VSCode插件中使用：点击VSCode右侧边栏的Claude Code图标（通常是一个闪电影或小星星的图标），就能直接开始对话了。
在终端中使用 ：在任何项目的目录下，打开终端，输入 claude 并回车，就能启动一个智能体对话环境，你可以让它帮你读代码、写文件等。
一个小技巧 ：如果你觉得Claude Code在执行操作时每次都需要手动确认很麻烦，可以尝试用 claude --dangerously-skip-permissions 命令启动，它会自动批准所有操作请求（相当于"YOLO模式"），能极大提升流畅度。

claude command not found ：通常是环境变量没刷新。解决方法：重启终端。如果还不行，可以重启电脑。
启动后仍跳转到Anthropic登录页 ：说明CC-Switch没有生效。解决方法 ：①检查CC-Switch里DeepSeek供应商是否已启用；②确认完全关闭并重新打开了终端窗口；③检查Base URL是否填写正确。
401 Unauthorized 错误 ：API Key无效或错误。解决方法：检查DeepSeek的API Key是否复制完整且准确。
403 Forbidden 错误 ：通常出现在使用某些中转服务时。解决方法：检查你的API Key是否绑定了特定的模型分组。