VS Code 集成 claude-code 教程：告别海外限制，使用国内大模型

随意_
5,258 阅读3分钟

引言

claude-code 是一款强大的终端智能开发工具，能在 VS Code 中为我们提供实时的代码辅助、问题解答和逻辑优化能力。但官方默认对接 Anthropic 的 Claude 模型，存在网络访问、账号注册、付费等诸多门槛。本文将手把手教你完成 claude-code 的安装、VS Code 插件配置，并重点讲解如何通过 cc-switch 对接国内 DeepSeek 大模型，享受更便宜、更快速的本地化智能开发体验。

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

本来是一篇记录自己操作的笔记，没想到这么多人看到了，我就重新整理下，按需取用。

一、安装

目前官方弃用npm全局安装的方式，提供的新的安装方式 官网地址可查看详情

官方提供安装方式如下：

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

WinGet:

winget install Anthropic.ClaudeCode

在windows环境下 即使我开启了 科学上网 使用powershell cmd等安装还是无法下载安装，随即我是用的是 WinGet安装方式，你们可是尝试下 科学上网是否可以安装

WinGet 方式就简单多了，Windows 11 和部分 Windows 10 都自带：

image.png

重启 powershell之后 输入

claude --version

image.png

后续如果想升级 calude code 可使用命令

winget upgrade Anthropic.ClaudeCode

二、安装 VS Code 插件

为了在 VS Code 中便捷使用 claude-code，需安装对应的插件：

  1. 打开 VS Code，点击左侧「扩展」图标（快捷键 Ctrl+Shift+X）；
  2. 在搜索框输入 Claude Code for VS Code；
  3. 找到插件后点击「安装」，安装完成后会显示「已安装」状态；
  4. 可选：重启 VS Code 确保插件生效。

image.png

安装成功后 点击文档 右侧会出现 对应标志

image.png

此时默认模型是官方模型 且需要你登录授权，此时先不动不做任何登录授权处理

三：解决核心痛点 —— 对接国内大模型（DeepSeek）

官方默认的 Anthropic Claude 模型存在诸多限制，我们通过 cc-switch 工具替换为国内 DeepSeek 模型，步骤如下：

3.1 安装 cc-switch 工具

  1. 访问 cc-switch 官方发布页：github.com/farion1231/…；
  2. 根据你的系统（Windows/Mac/Linux）下载对应的安装包（如 Windows 下载 .exe，Mac 下载 .dmg）；
  3. 双击安装包完成安装，过程中按提示确认即可。

3.2 注册 DeepSeek API 密钥

  1. 访问 DeepSeek 官网：platform.deepseek.com/；
  2. 点击「注册 / 登录」，完成账号注册（支持手机号 / 邮箱）；
  3. 登录后进入「API 密钥」页面，点击「创建密钥」，复制生成的密钥（务必保存好，不要泄露）。

3.3 配置 cc-switch 对接 DeepSeek

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

image.png

image.png

3.4 配置 cc-switch 对接 MiniMax

image.png

image.png

四、在 VS Code 中使用 claude-code

配置完成后，即可在 VS Code 中体验 claude-code 的功能：

点击打开 claude对话

image.png

image.png

image.png

注意此处可以点击切换模式 ，优先使用 plan模式， cc switch切换后 需要重启下 vscode 模型会切换

image.png

image.png

输入斜杠 / 回调出快捷键 注意使用

image.png

切换模型 需要在 cc-switch中，有时候需要重启vs code生效

总结

通过以上步骤，你已完成 claude-code 在 VS Code 中的安装、配置，并成功对接国内 DeepSeek MiniMax 模型，摆脱了海外服务的限制。claude-code 结合国内大模型，既能享受智能代码辅助的便利，又能获得更快的响应速度和更低的使用成本，是提升开发效率的优质工具。

avatar
文章
阅读
粉丝