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 中添加供应商
打开已安装好的 CC-Switch 桌面应用。
点击界面上的“+”按钮来添加一个新的供应商（Provider）。
在弹出的窗口中找到并选择DeepSeek的预设，或者手动选择“自定义”。
填写关键信息（这是接入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的超长上下文。填写完成后，点击“保存”或“添加”。最重要的是，在CC-Switch主界面上，确保你刚刚添加的DeepSeek供应商处于“启用”状态。
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是否绑定了特定的模型分组。