Claude Code + cc-switch + Git + Node.js 一站式完整安装配置教程【8.3】

Claude Code + cc-switch + Git + Node.js 一站式完整安装配置教程

整体架构说明

整套工具依赖关系：

Node.js（运行环境）→ Git（代码版本/仓库依赖）→ Claude Code（AI编程CLI+VSCode插件）→ CC-Switch（可视化API服务商切换、代理路由管理）

适用系统：Windows 10/11、macOS、Linux；国内环境优先使用CC-Switch对接兼容Anthropic协议的国产大模型（DeepSeek、智谱GLM等）绕开官方访问限制。

🚀 国内备用（高速下载）

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

第一部分：前置环境安装（Node.js + Git）

1.1 安装 Node.js（硬性要求 ≥v18 LTS）

Windows 安装

官网下载LTS长期支持版：https://nodejs.org/
安装要点：全程默认下一步，务必勾选 Add to PATH（自动配置环境变量）
验证（打开新PowerShell/CMD）：

bash 复制代码

node -v
npm -v

出现版本号即成功。

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

用nvm-windows管理多个Node版本：

bash 复制代码

# 安装LTS版本
nvm install lts
nvm use lts
nvm alias default lts

macOS 安装（Homebrew）

bash 复制代码

brew install node
# 验证
node -v && npm -v

Linux（Ubuntu/Debian）

bash 复制代码

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

1.2 安装 Git（代码仓库、Claude项目依赖必备）

Windows

官网下载：https://git-scm.com/download/win
安装默认配置即可，编辑器可选VSCode，终端使用Git Bash
验证：

bash 复制代码

git --version

macOS

bash 复制代码

brew install git
# 首次全局配置（必做）
git config --global user.name "你的昵称"
git config --global user.email "你的邮箱"

Linux

bash 复制代码

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

第二部分：安装 Claude Code（CLI命令行 + VSCode插件双版本）

2.1 全局安装 Claude Code CLI（终端直接调用`claude`命令）

全系统统一npm安装方式（最稳定，国内推荐）

管理员权限打开终端执行：

bash 复制代码

npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version

出现v2.x.x版本号代表安装成功。

备选官方脚本（国内大概率网络超时，不优先）

Windows PowerShell：irm https://claude.ai/install.ps1 | iex

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

2.2 VSCode 安装 Claude Code 图形化插件

打开VSCode，快捷键 Ctrl+Shift+X（Mac：Cmd+Shift+X）进入扩展市场
搜索 Claude Code（Anthropic官方蓝色机器人图标），点击Install安装
重载窗口：Ctrl+Shift+P → 输入 Reload Window
验证：侧边栏出现Claude图标，右下角状态栏显示Claude Code标识

VSCode基础避坑配置（settings.json）

Ctrl+, 打开设置 → 搜索 claudeCode.environmentVariables → 编辑settings.json，粘贴基础配置（后续由CC-Switch接管API，此处先关闭登录弹窗）：

json 复制代码

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

第三部分：CC-Switch 安装与核心配置（重中之重）

3.1 CC-Switch 作用

统一可视化管理Claude Code的API服务商、中转地址、多Key一键切换、本地代理路由、自动故障转移 ，无需手动修改.claude配置文件，小白零配置接入DeepSeek、GLM等兼容模型。

3.2 安装 CC-Switch

方式1：桌面客户端（推荐，图形界面）

GitHub Releases下载对应系统安装包：

https://github.com/farion1231/cc-switch/releases

Windows：下载 .msi 安装包，一路Next默认安装
macOS：brew tap farion1231/ccswitch && brew install --cask cc-switch
Linux：下载AppImage赋予权限运行

方式2：npm全局命令行启动（极简）

bash 复制代码

npm install -g cc-switch
# 启动可视化面板
cc-switch

3.3 CC-Switch 核心配置（对接Claude Code）

步骤1：添加API服务商（以DeepSeek为例，国内最稳定）

打开CC-Switch，右上角 + 新增Provider
选择模板：DeepSeek
填写参数：
- API Base URL：https://api.deepseek.com/anthropic
- API Key：填入你在DeepSeek官网申请的sk-密钥
- 默认模型：deepseek-v4-pro[prm]
保存，点击设为默认激活供应商

步骤2：开启本地路由（让Claude Code自动走CC-Switch代理）

左上角齿轮【设置】→【路由】标签
打开启用本地请求路由总开关
保存设置，CC-Switch后台常驻托盘运行

步骤3：绑定Claude Code程序

CC-Switch左侧菜单选择【CLI绑定】
勾选 Claude Code，自动读取全局claude命令路径
开启自动注入环境变量，一键写入Claude全局配置文件

3.4 多模型一键切换进阶

重复新增多个服务商：Anthropic官方、智谱GLM5、Kimi兼容接口
托盘右键直接切换激活模型，无需改任何代码配置
开启自动故障转移：单个API超时自动切备用Key

第四部分：全套工具联动验证 & 最终测试

4.1 终端测试 Claude Code CLI

bash 复制代码

# 直接唤起对话
claude
# 读取当前项目代码分析
claude "帮我检查当前Node项目代码漏洞"

能正常回复，CC-Switch路由面板请求计数上涨=链路通了。

4.2 VSCode插件测试

打开任意Node.js项目文件夹（必须Open Folder，单个文件无上下文）
点击侧边栏Claude图标发起对话
选中代码使用快捷键 Ctrl+Option+K 加入AI上下文，执行重构/注释/调试

4.3 Git+Claude联动开发（工程化用法）

bash 复制代码

# 1.Git提交前让Claude生成commit注释
git diff | claude "根据代码变更生成规范git commit message"
# 2.让AI排查Git冲突并给出解决命令
claude "解决git merge冲突的完整步骤"

第五部分：常见报错排查（高频问题）

问题1：`claude` 命令不是内部命令

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

解决：重启终端；Windows手动把C:\Users\用户名\AppData\Roaming\npm加入环境变量。

问题2：Claude Code请求超时/401报错

检查CC-Switch路由开关是否打开
API Key是否正确、余额是否充足
Base地址是否为兼容Anthropic格式（必须带/anthropic后缀）
完全退出VSCode和终端重新启动。

问题3：CC-Switch无法识别Claude Code

重新执行全局安装：npm install -g @anthropic-ai/claude-code --force，在CC-Switch手动选择claude可执行文件路径。

问题4：Node版本过低报错

升级Node到LTS 20版本，不低于18。

第六部分：日常使用工作流总结

开机自启：CC-Switch后台托盘常驻（默认激活DeepSeek）
开发环境：VSCode + Claude Code插件实时编码辅助
版本管理：Git做代码提交、分支管理
终端增强：claude命令行批量重构、脚本生成、Git指令生成
灵活切换：CC-Switch托盘右键一键更换大模型供应商

Claude Code + cc-switch + Git + Node.js 一站式完整安装配置教程【8.3】