掘金文章归档 · 第 32 篇 AI / Agent 系列 3/8 Claude Code · VS Code

VS Code 集成 claude-code 教程

告别海外限制,cc-switch 对接国内 DeepSeek / MiniMax

原文作者:随意_(掘金) | juejin.cn/post/7612456290955018291 | 发布于 2026-03-02 | 阅读 26,482 · 约 4 分钟

0引言

claude-code 是一款强大的终端智能开发工具,能在 VS Code 中为我们提供实时的代码辅助、问题解答和逻辑优化能力。但官方默认对接 Anthropic 的 Claude 模型,存在网络访问、账号注册、付费等诸多门槛。

本文将手把手教你完成 claude-code 的安装、VS Code 插件配置,并重点讲解如何通过 cc-switch 对接国内 DeepSeek 大模型,享受更便宜、更快速的本地化智能开发体验。

📌 Claude Code 官方现已明确弃用 npm 安装方式,2026 年推荐使用原生安装包(二进制)方式,无需依赖 Node.js,启动更快、更新更稳定(但是国内尝试很多次,即使科学上网也无法下载),同时也支持包管理器一键安装。

1一、安装 claude-code

官方提供的安装方式如下:

平台安装命令
macOS / Linux / WSLcurl -fsSL https://claude.ai/install.sh | bash
Windows PowerShellirm https://claude.ai/install.ps1 | iex
Windows CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGetwinget install Anthropic.ClaudeCode
⚠️ 在 Windows 环境下,即使开启了科学上网,使用 PowerShell / CMD 等安装还是无法下载安装,作者改用 WinGet 安装方式成功。

WinGet 方式简单多了,Windows 11 和部分 Windows 10 都自带。重启 PowerShell 之后输入:

claude --version

后续如果想升级 claude-code 可使用命令:

winget upgrade Anthropic.ClaudeCode

如果 winget 也损坏:使用 PowerShell 安装(需科学上网)

首先开启代理,打开 PowerShell 管理员运行:

$env:HTTP_PROXY="http://127.0.0.1:7897"
$env:HTTPS_PROXY="http://127.0.0.1:7897"

这里的 7897 就是你科学上网本地代理的端口。接着执行:

irm https://claude.ai/install.ps1 | iex

按照提示增加环境变量:

$env:PATH += ";C:\Users\PC\.local\bin"
[Environment]::SetEnvironmentVariable("PATH", $env:PATH, "User")

也可以安装成功。更新版本的话执行 claude update(注意设置你的代理端口)。

2二、安装 VS Code 插件

  1. 打开 VS Code,点击左侧「扩展」图标(快捷键 Ctrl+Shift+X);
  2. 在搜索框输入 Claude Code for VS Code
  3. 找到插件后点击「安装」,安装完成后会显示「已安装」状态;
  4. 可选:重启 VS Code 确保插件生效。
⚠️ 安装成功后,点击文档右侧会出现对应标志。此时默认模型是官方模型,且需要你登录授权,此时先不动,不做任何登录授权处理。

3三、对接国内大模型(cc-switch)

官方默认的 Anthropic Claude 模型存在诸多限制,我们通过 cc-switch 工具替换为国内 DeepSeek 模型。

3.1 安装 cc-switch 工具

3.2 注册 DeepSeek API 密钥

3.3 配置 cc-switch 对接 DeepSeek

  1. 打开终端,执行 cc-switch 命令启动配置工具;
  2. 按照提示选择「切换模型为 DeepSeek」;
  3. 输入你复制的 DeepSeek API 密钥,确认后保存配置;
  4. 验证配置:执行 cc-switch test,若提示「连接成功」则说明配置生效。

3.4 配置 cc-switch 对接 MiniMax

同样通过 cc-switch 的模型切换功能,可以继续添加 MiniMax 等国内大模型作为备选,操作流程与 DeepSeek 一致。

4四、在 VS Code 中使用 claude-code

  1. 点击打开 Claude 对话;
  2. 注意此处可以点击切换模式,优先使用 plan 模式。cc-switch 切换后需要重启下 VS Code,模型会切换;
  3. 输入斜杠 / 会调出快捷键,注意使用;
  4. 切换模型需要在 cc-switch 中操作,有时候需要重启 VS Code 生效。
✅ 总结:通过以上步骤,你已完成 claude-code 在 VS Code 中的安装、配置,并成功对接国内 DeepSeek / MiniMax 模型,摆脱了海外服务的限制。claude-code 结合国内大模型,既能享受智能代码辅助的便利,又能获得更快的响应速度和更低的使用成本。