Claude Code + cc-switch + Git + Node.js 全套下载+安装+配置完整版

Claude Code + cc-switch + Git + Node.js 全套下载+安装+配置完整版

整体安装顺序（必须按这个来）

Node.js → Git → Claude Code（CLI+VSCode插件）→ CC-Switch（核心代理切换）→ 联动配置测试

国内网络全程使用 DeepSeek 兼容Anthropic协议 绕开官方直连限制

---

🚀 国内备用（高速下载）

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

---

一、第一步：安装 Node.js（强制≥18 LTS，运行依赖）

1. 官方下载地址

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

Windows 安装要点

1. 双击安装包，务必勾选 Add to PATH（自动写入系统环境变量）
2. 一路默认下一步完成
3. 关闭所有旧终端，新开 PowerShell/CMD 验证：

node -v
npm -v

输出版本号即成功。

macOS（Homebrew一键）

brew install node
node -v && npm -v

Linux Ubuntu/Debian

sudo apt update
sudo apt install nodejs npm
# 升级到稳定LTS
sudo npm install -g n
sudo n lts

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

Windows：nvm-windows；Mac/Linux：nvm，命令统一：

nvm install lts
nvm use lts
nvm alias default lts

---

二、第二步：安装 Git（版本管理+项目依赖）

下载地址

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

Windows

1. 下载Windows安装包，默认配置安装，编辑器选VSCode，终端用Git Bash
2. 验证：

git --version

3. 首次全局配置（必做）

git config --global user.name "你的昵称"
git config --global user.email "你的邮箱"

macOS

brew install git
# 同上配置用户名邮箱

Linux

sudo apt install git
git config --global user.name "Name"
git config --global user.email "xxx@xxx.com"

---

三、第三步：安装 Claude Code（命令行CLI + VSCode插件）

3.1 全局安装 CLI 命令（终端直接调用 claude）

Windows：管理员身份打开PowerShell执行（用淘宝npm镜像加速）

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

Mac/Linux

sudo npm install -g @anthropic-ai/claude-code

验证安装

claude --version
# 出现 v2.x.x 版本号=安装成功

报错修复：提示claude不是内部命令

1. 查看npm全局路径：npm config get prefix
2. Windows把输出路径（一般是C:\Users\用户名\AppData\Roaming\npm）添加到系统PATH环境变量，重启终端

3.2 VSCode 安装 Claude Code 官方插件

1. VSCode快捷键 Ctrl+Shift+X 打开扩展商店
2. 搜索 Claude Code（Anthropic官方蓝色机器人图标）安装
3. Ctrl+Shift+P → 输入 Reload Window 重载窗口
4. 侧边栏出现Claude图标即为完成

VSCode基础避坑配置

打开设置settings.json粘贴：

{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.autoOpenChatOnActivate": true
}

---

四、---

四、第四步：CC-Switch 下载+安装（重中之重，国内可用核心）

4.1 官方下载地址（GitHub Releases）

发布页：https://github.com/farion1231/cc-switch/releases

各系统安装包选择

1. Windows（推荐） ：下载 xxx-Windows-x64.msi 安装包

   双击一路Next默认安装；也可下载Portable.zip绿色解压版直接运行

2. macOS 一键brew安装

brew tap farion1231/ccswitch
brew install --cask cc-switch

3. Linux ：下载deb包或AppImage，AppImage需授权chmod +x xxx.AppImage运行

4.2 CC-Switch 可视化核心配置（接入DeepSeek，国内稳定）

前置准备

去DeepSeek平台 https://platform.deepseek.com/ 注册实名认证，新建API Key（sk-开头）保存好

步骤1：新增模型服务商

1. 打开CC-Switch，右上角 + Add Provider
2. 预设模板选择 DeepSeek ，自动填充地址：
   https://api.deepseek.com/anthropic
3. 粘贴你的DeepSeek API Key
4. 默认模型填写：deepseek-v4-pro[prm]（2026最新可用模型）
5. 保存 → 设为默认激活供应商

步骤2：开启本地路由接管Claude Code

1. 左上角齿轮「设置」→「路由」标签
2. 打开 启用本地请求路由总开关，保存
3. CC-Switch最小化到系统托盘后台常驻

步骤3：绑定Claude Code程序（自动注入环境变量）

1. 左侧菜单【CLI绑定】→ 勾选 Claude Code
2. 开启自动注入环境变量 ，一键接管ANTHROPIC_BASE_URL/TOKEN/MODEL
3. 冲突提示处理：如果弹出环境变量冲突，全选删除旧手动配置，避免覆盖失效

进阶玩法

重复添加智谱GLM、其他兼容Anthropic接口模型，托盘右键一键切换服务商，无需改任何配置文件。

---

五、全套工具联动最终测试

5.1 终端测试Claude CLI

新开终端执行：

# 直接对话
claude
# 读取当前项目代码分析
claude "帮我检查这个Node项目代码问题"

CC-Switch面板请求计数上涨=链路完全通。

5.2 VSCode插件测试

1. 用VSCode打开项目文件夹（必须Open Folder，单个文件无项目上下文）
2. 侧边栏打开Claude Code对话窗口，提问代码重构、写接口、排查bug
3. 选中代码快捷键快速交由AI处理

5.3 Git + Claude 开发联动（实用工作流）

# 1. 根据代码改动自动生成规范Git提交备注
git diff | claude "生成符合Angular规范的git commit message"

# 2. 让AI解决Git合并冲突命令
claude "git merge冲突完整解决步骤"

---

六、高频报错排查

1. Claude请求401/超时
   • CC-Switch路由开关是否打开
   • DeepSeek Key是否有效、账户是否有余额
   • Base地址必须带后缀/anthropic
2. CC-Switch不生效
   删除系统手动设置的ANTHROPIC系列环境变量，CC-Switch自动管理优先级更高
3. Node版本过低报错
   升级至20 LTS版本，最低不能低于18
4. npm安装卡住
   全程使用淘宝镜像--registry=https://registry.npmmirror.com

---

七、日常标准工作流

1. 开机自启CC-Switch（后台托盘运行，默认DeepSeek模型）
2. VSCode打开项目，使用Claude Code插件编码辅助
3. Git做版本提交、分支管理
4. 终端用claude命令批量生成脚本、分析代码、生成Git指令
5. 需要换模型时，托盘右键CC-Switch一键切换API服务商