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 安装

node -v
npm -v

出现版本号即成功。

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

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

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

macOS 安装（Homebrew）

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

Linux（Ubuntu/Debian）

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

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

Windows

git –version

macOS

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

Linux

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安装方式（最稳定，国内推荐）

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

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基础避坑配置（settings.json）

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

{
"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全局命令行启动（极简）

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

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

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

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

步骤3：绑定Claude Code程序

3.4 多模型一键切换进阶

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

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

4.1 终端测试 Claude Code CLI

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

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

4.2 VSCode插件测试

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

# 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报错

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

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

问题4：Node版本过低报错

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

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