Claude Code + Git + Node.js + cc-switch 全套下载与配置最新教程

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. 安装步骤

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

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

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

node -v
npm -v

输出版本号即完成。

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

1. 下载地址

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

2. 极简安装

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

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

git config --global user.name "你的昵称"
git config --global user.email "你的邮箱"
# 验证
git config --global --list

4. 验证安装

git --version

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

1. npm全局安装

npm install -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. 安装过程

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

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

步骤1：新增模型供应商

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

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

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

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

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

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

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

1. 终端直接调用Claude Code

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

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

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

2. 常用claude-code命令速查

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

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

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

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

七、高频踩坑解决

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

极简执行顺序总结

1. Node.js LTS + 换npm淘宝源
2. Git安装+全局用户名邮箱配置
3. npm全局安装 claude-code
4. GitHub下载安装cc-switch
5. cc-switch添加DeepSeek/智谱API、开启本地路由
6. Git项目内执行 claude 指令 直接AI编码

到此这篇关于Claude Code + Git + Node.js + cc-switch 全套下载与配置最新教程的文章就介绍到这了,更多相关Claude Code cc-switch配置教程内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论