国内使用 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是否绑定了特定的模型分组。