Claude Code + cc-switch + Git + Node.js 一站式完整安装配置教程（2026最新·国内可用版）

Claude Code + cc-switch + Git + Node.js 一站式完整安装配置教程（2026最新·国内可用版）

整体安装顺序（严格按此执行，避免依赖报错）

1. Node.js（必须前置，Claude Code、cc-switch均依赖npm）
2. Git（版本管理+项目上下文读取）
3. Claude Code CLI 命令行工具
4. cc-switch（可视化多API/模型切换管理器）
5. VSCode Claude Code插件集成
6. cc-switch配置API密钥、模型路由、全局生效
7. 最终全链路验证+常见报错修复

---

---

一、 国内备用（高速下载）

🚀 https://pan.quark.cn/s/d6152047213b （全平台包）

---

一、第一步：安装 Node.js（≥18 LTS，强制要求）

1.1 下载安装

官网：https://nodejs.org/ 选择 LTS长期支持版

• Windows：双击安装包，全程默认勾选Add to PATH（自动配置环境变量）
• macOS：.pkg 一路下一步；或Homebrew：brew install node
• Linux：sudo apt install nodejs npm

1.2 校验安装（新开终端执行）

node -v
npm -v

输出版本号即成功，建议≥18.17.0。

1.3 国内npm加速（必做，避免安装超时失败）

# 设置淘宝镜像源
npm config set registry https://registry.npmmirror.com
# 验证
npm config get registry

可选：多Node版本管理 nvm（开发者推荐）

Windows：nvm-windows；Mac/Linux：nvm-sh，可随意切换Node版本。

---

二、第二步：安装 Git 版本控制系统

2.1 下载安装

官网：https://git-scm.com/downloads

• Windows：安装时默认选项，勾选Git Bash Here
• Mac：brew install git
• Linux：sudo apt install git

2.2 基础配置+校验

# 校验安装
git --version

# 全局用户名邮箱（Git提交必填）
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

# 查看配置
git config --global --list

作用：Claude Code可自动读取Git变更、diff、提交记录做代码分析。

---

三、第三步：全局安装 Claude Code（Anthropic官方CLI工具）

3.1 npm全局安装（管理员终端执行，Windows必须PowerShell管理员）

通用命令（国内镜像加速安装，解决官方源404）

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

Mac/Linux权限不足加sudo

sudo npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

3.2 验证Claude Code是否安装成功

claude --version

输出版本号（如2.1.139）代表完成。

3.3 初次初始化（生成配置文件夹）

终端直接输入：

claude

随便选一项退出即可，会自动在用户目录生成.claude配置文件夹，为后续cc-switch接管做准备。

---

四、第四步：安装 cc-switch 可视化配置工具（核心）

4.1 cc-switch 作用一句话解释

可视化一键切换Claude Code的API地址、密钥、模型，无需手动改json配置文件，托盘常驻，支持接入DeepSeek、智谱、MiniMax等国产兼容Anthropic协议大模型。

4.2 下载对应系统安装包

GitHub Releases地址：https://github.com/farion1231/cc-switch/releases

• Windows：下载 .msi 安装包
• macOS：.dmg
• Linux：.deb/.AppImage

4.3 Windows安装步骤

1. 双击msi安装包 → Next
2. 自定义安装路径（建议非C盘中文路径）→ Next
3. 完成安装，桌面启动CC Switch

4.4 命令行校验（可选）

cc-switch --version

4.5 cc-switch首次初始化

打开软件 → 顶部菜单栏执行：

Init → Initialize Claude Env

自动关联本地.claude配置目录，接管Claude Code环境变量。

---

五、第五步：VSCode 集成 Claude Code 插件

5.1 安装VSCode

官网：https://code.visualstudio.com/，建议版本≥1.98.0

5.2 安装官方插件

1. 快捷键 Ctrl+Shift+X（Mac Cmd+Shift+X）打开扩展市场
2. 搜索 Claude Code for VS Code（发布者Anthropic官方认证）
3. 点击Install → Reload Window重启窗口

5.3 插件生效判断

重启后VSCode右上角出现⚡Claude图标，左侧活动栏出现Claude入口即为成功。

重要规则：必须用File → Open Folder打开项目文件夹，单个文件无法读取Git上下文与项目结构。

---

六、第六步：cc-switch核心配置（API+模型路由，国内可用）

6.1 提前准备API Key（二选一）

1. 官方Claude API Key：Anthropic控制台申请（国内访问受限）
2. 国产兼容模型（推荐） ：DeepSeek、智谱GLM、MiniMax，均兼容Anthropic协议
   以DeepSeek为例：平台https://platform.deepseek.com/ 创建API Key，复制保存。

6.2 在cc-switch添加模型服务商

1. 打开CC Switch，切换到Claude Code标签页
2. 右上角点击 + Add Provider
3. 选择模板：DeepSeek / Custom自定义
4. 填写参数（DeepSeek示例）：
   • Provider Name：DeepSeek V4 Pro
   • Base URL：https://api.deepseek.com/anthropic
   • API Key：粘贴你的sk-xxx密钥
   • 默认模型：deepseek-v4-pro

6.3 启用配置并全局生效

1. 选中添加好的服务商，点击Activate激活
2. 软件自动写入系统环境变量：ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN
3. 勾选 Auto Export Env 开机自动挂载配置

6.4 验证链路是否打通

终端测试

# 让Claude Code读取cc-switch配置调用模型
claude chat "输出Hello World"

VSCode测试

打开项目 → 点击右上角Claude图标 → 发送指令修改代码，能正常返回代码即为全链路通。

---

七、第七步：Git + Claude Code 联动使用

1. 项目根目录执行git init初始化仓库，做初次提交

2. 在Claude Code对话中直接输入指令：

   查看当前Git改动，优化代码并自动生成commit提交信息

3. Claude可直接读取diff、修改文件、执行git add/commit/push命令。

---

八、全栈最终环境校验命令（逐条运行全部通过即完工）

# 1. Node+npm
node -v
npm -v

# 2. Git
git --version

# 3. Claude Code CLI
claude --version

# 4. cc-switch
cc-switch --version

# 5. Claude调用测试
claude chat "测试连通性"

---

九、高频报错&解决方案

报错1：claude: command not found

原因：npm全局路径未加入系统PATH

修复：

• Windows：重启终端/重启电脑；检查Node.js安装时是否勾选Add to PATH
• Mac/Linux：echo "export PATH=$HOME/.npm-global/bin:$PATH" >> ~/.zshrc && source ~/.zshrc

报错2：npm安装权限报错

Windows：右键PowerShell以管理员身份 运行

Mac/Linux：命令前加sudo

报错3：VSCode插件无响应、无法调用模型

1. 关闭所有终端，彻底退出cc-switch重新激活Provider
2. VSCode执行 Reload Window
3. 删除用户目录.claude文件夹，重新执行claude初始化

报错4：模型调用401/密钥无效

1. 确认cc-switch内已点Activate激活当前服务商
2. API Key复制无空格、未过期
3. Base URL填写正确，国产模型必须带/anthropic后缀

报错5：cc-switch无法读取Claude配置

终端执行一次claude生成初始化文件，再回到cc-switch执行cc-switch init。

---

十、日常工作流总结

1. 开机启动cc-switch，托盘选择要使用的模型一键切换
2. VSCode打开项目文件夹，使用Claude Code写代码、重构、Debug
3. Claude直接操作Git完成版本提交、分支管理
4. Node.js环境用于运行AI生成的后端/前端代码