当前位置：首页 > news >正文

Claude Code + Git + Node.js + cc-switch 全套下载配置完整教程【2026.8.3】

news 2026/8/4 18:36:55

Claude Code + Git + Node.js + cc-switch 全套下载&配置完整教程

整体安装顺序：Node.js → Git → Claude Code（CLI）→ cc-switch可视化模型切换工具 → 最终联动配置

🚀 国内备用（高速下载）

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

一、前置环境1：Node.js 安装（必须≥18 LTS，Claude Code运行依赖）

1. 下载地址

官网：https://nodejs.org/ ，选择LTS长期支持版（稳定）

2. 安装步骤

Windows：双击.msi安装包，全程默认下一步，务必勾选Add to PATH自动配置环境变量
Mac：brew install node终端一键安装
国内加速npm（必做，避免安装失败）

# 切换淘宝镜像源npmconfigsetregistry https://registry.npmmirror.com# 查看是否生效npmconfig get registry

3. 验证是否安装成功（新开终端执行）

node-vnpm-v

输出版本号即完成。

二、前置环境2：Git 安装（代码版本管理，Claude Code读写项目依赖）

1. 下载地址

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

2. 极简安装

Windows：一路默认下一步，选择Git Bash终端即可
Mac：brew install git

3. 初始化基础配置（全局用户名邮箱）

gitconfig--globaluser.name"你的昵称"gitconfig--globaluser.email"你的邮箱"# 验证gitconfig--global--list

4. 验证安装

git--version

三、第三步：全局安装 Claude Code 命令行工具

1. npm全局安装

npminstall-g@anthropic-ai/claude-code

2. 验证安装

claude-code--version# 简写直接输入 claude 可唤起命令行claude

出现命令帮助文档代表本体安装完成。

说明：直接使用官方Claude需要境外API Key+网络，国内正常使用依靠cc-switch 对接DeepSeek/智谱GLM等兼容Anthropic协议的国产模型。

四、第四步：cc-switch 下载+安装（核心：可视化切换模型供应商，不用手写环境变量）

工具作用

cc-switch = Claude Code配置可视化管理器，一键切换官方、DeepSeek、智谱GLM、MiniMax等模型，自动写入环境变量、本地代理路由，解决国内无法直连官方Claude问题。

1. 官方下载地址（GitHub Releases）

https://github.com/farion1231/cc-switch/releases
根据系统选择安装包：

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

2. 安装过程

Windows双击msi，一路Next完成安装；Mac拖拽dmg到应用程序
首次打开前清理旧冲突环境变量（关键避坑）
删除系统中手动配置过的：ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL，手动环境变量优先级更高会覆盖cc-switch配置。

3. cc-switch 可视化配置（对接模型给Claude Code调用）

步骤1：新增模型供应商

打开cc-switch → 顶部切换到Claude标签页 → 点击右上角**+加号**添加供应商

步骤2：选择兼容平台（推荐2个）

DeepSeek（兼容性最佳）
选中DeepSeek → 跳转DeepSeek开放平台创建API Key，复制sk-开头密钥粘贴进去，勾选1M超长上下文，保存并设为默认。
智谱GLM（备选）
选择Zhipu GLM，去智谱开放平台实名认证后创建API Key填入即可。

步骤3：开启本地路由（最重要一步）

左上角设置齿轮 → 路由 →打开本地代理路由总开关，cc-switch会本地启动服务接管Claude Code的API请求转发。

步骤4：保存配置，关闭重启cc-switch生效

五、最终联动：Claude Code + cc-switch 打通使用

1. 终端直接调用Claude Code

打开项目Git仓库文件夹（必须是git项目，否则部分代码分析功能受限），执行：

# 让AI读取当前代码，写功能claude"根据现有代码新增登录接口"# 代码重构、修复bugclaude"修复这段循环死循环问题"

此时请求会自动经过cc-switch代理，走你配置的DeepSeek/智谱模型。

2. 常用claude-code命令速查

# 查看帮助claude--help# 限定只修改某个文件claude 修改utils.js里的校验逻辑# 生成Git提交注释claude generategitcommit message

六、全套环境校验命令（一键自检）

复制逐条运行，全部输出版本即整套环境就绪：

node-vnpm-vgit-vclaude-code--versioncc-switch--version

七、高频踩坑解决

npm安装claude-code超时
执行npm config set registry https://registry.npmmirror.com换国内源重试；
Claude Code调用报错401/无响应
检查cc-switch是否开启本地路由、API Key是否粘贴正确、是否删除旧系统环境变量；
无法读取项目文件
必须在Git初始化过的项目根目录执行claude命令，执行git init初始化仓库；
cc-switch打不开
Windows右键以管理员身份运行，Mac在系统设置允许未知来源应用。