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

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

1. Node.js（运行环境）→ 2. Git（版本依赖）→ 3. 全局安装 Claude Code CLI → 4. 安装 cc-switch 模型切换工具 → 5. 打通联动配置 + 测试调用

---

🚀 国内备用（高速下载）

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

---

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

1. 下载地址

官网：https://nodejs.org/
只下载 LTS 长期支持版，兼容性最稳。

Windows 安装要点

1. 双击 msi 安装包，一路下一步
2. 必须勾选 Add to PATH（自动配置环境变量，不要取消）
3. 其余默认即可

Mac 安装（终端一行命令）

brew install node

2. 配置 npm 国内镜像（必做，解决下载超时）

新开终端执行：

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

# 校验是否生效
npm config get registry

3. 验证是否安装成功

node -v
npm -v

输出版本号代表成功。

---

二、第二步：安装 Git

1. 下载

官网：https://git-scm.com/downloads
Windows 直接下载安装包，默认安装，终端选 Git Bash。

Mac：

brew install git

2. Git 全局基础配置（必填）

# 替换为自己名字、邮箱
git config --global user.name "YourName"
git config --global user.email "xxx@xxx.com"

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

3. 验证

git --version

注意：Claude Code 分析项目、生成 commit 信息依赖 Git，使用前项目目录建议执行一次 git init。

---

三、第三步：全局安装官方 Claude Code CLI

1. npm 全局安装

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

2. 校验安装

claude-code --version
# 简写命令 claude 可直接调用
claude --help

出现帮助文档即本体安装完成。

重要说明

直接使用官方 Claude 需要境外 API Key + 网络环境，国内无法直连，依靠 cc-switch 做地址转发、替换为兼容协议的国产大模型（DeepSeek、智谱AI等）。

---

四、第四步：cc-switch 下载 + 安装 + 核心配置

工具作用

cc-switch：可视化管理 Claude Code 的 API 后端，一键切换模型厂商、自动注入环境变量、本地启动转发服务，解决国内无法访问 Anthropic 官方接口问题。

1. 下载地址（GitHub Releases）

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

根据系统选择安装包：

• Windows：CC-Switch-xxx-Windows.msi（安装版）或 zip 便携版
• macOS：CC-Switch-xxx-macOS.dmg

2. 安装

• Windows：双击安装包，默认路径下一步完成
• Mac：将 App 拖入「应用程序」，首次打开在系统设置允许未知开发者

3. 前置清理（极易踩坑）

去系统环境变量里，手动删除这两个旧变量：
ANTHROPIC_AUTH_TOKEN
ANTHROPIC_BASE_URL
cc-switch 运行时会临时注入环境变量，手动全局变量会覆盖导致不生效。

4. cc-switch 可视化详细配置

① 进入 Claude 面板添加服务商

打开 cc-switch → 顶部标签切换到 Claude → 右上角「+」新增服务商

② 推荐两个高兼容厂商（任选其一）

方案A：DeepSeek（兼容性最好，首推）

1. 平台：https://platform.deepseek.com/ 实名认证创建 API Key（sk-开头）
2. 在 cc-switch 选择 DeepSeek，粘贴密钥，可勾选超长上下文，设为默认

方案B：智谱AI GLM（备选）

1. 平台：https://open.bigmodel.cn/ 创建 API Key
2. 选择 Zhipu GLM，填入密钥保存

③ 开启本地路由（最关键一步）

点击左上角齿轮「设置」→ 路由 → 打开本地代理路由开关
工具会在本机启动一个中转地址，Claude Code 所有请求自动走这里转发。

④ 保存配置，关闭并重启 cc-switch

---

五、第五步：Claude Code + cc-switch 联动使用

1. 进入你的代码项目目录

# 如果还不是 git 仓库，初始化一次（只做一次）
git init

2. 直接终端调用 claude

# 让AI写功能
claude "写一个NodeJS简单接口，GET返回Hello World"

# 修复代码bug
claude "检查当前项目代码，找出潜在bug并修复"

# 自动生成git提交文案
claude "generate git commit message"

# 指定文件修改
claude "修改app.js，增加参数校验"

此时网络请求自动经过 cc-switch 本地代理，调用你配置的国产模型。

常用 claude 快捷命令

claude --help          # 全部指令
claude diff            # 查看AI将要改动的文件差异
claude undo            # 撤销上一次AI修改

---

六、全套环境自检命令（复制全部执行）

node -v
npm -v
git --version
claude-code --version

全部输出版号 = 整套环境部署完毕。

---

七、高频报错排查清单

1. npm install claude-code 卡住/失败

执行换源命令重试：

npm config set registry https://registry.npmmirror.com

2. claude 调用返回 401 / 无响应

1. cc-switch 是否打开了「本地路由总开关」
2. API Key 是否复制完整、无空格
3. 是否删除了系统全局 ANTHROPIC 环境变量
4. cc-switch 关闭重开一次

3. Claude 读取不到项目文件

必须在 git init 初始化过的文件夹内执行命令。

4. Windows cc-switch 打不开

右键 → 以管理员身份运行。

5. Mac 提示无法验证开发者

系统设置 → 安全性与隐私 → 仍要打开。

---

极简执行流程图（备忘）

Node.js LTS 安装 → npm 换国内源 → Git 安装配置 → npm 全局装 claude-code → GitHub 下载 cc-switch → cc-switch填入DeepSeek/智谱Key+开启本地路由 → Git项目内直接 claude "指令" 编码使用