Claude Code cc-switch Git Node.js 一站式完整安装配置教程2026最新·国内可用版整体安装顺序严格按此执行避免依赖报错Node.js必须前置Claude Code、cc-switch均依赖npmGit版本管理项目上下文读取Claude Code CLI 命令行工具cc-switch可视化多API/模型切换管理器VSCode Claude Code插件集成cc-switch配置API密钥、模型路由、全局生效最终全链路验证常见报错修复一、 国内备用高速下载 https://pan.quark.cn/s/d6152047213b 全平台包一、第一步安装 Node.js≥18 LTS强制要求1.1 下载安装官网https://nodejs.org/ 选择LTS长期支持版Windows双击安装包全程默认勾选Add to PATH自动配置环境变量macOS.pkg一路下一步或Homebrewbrew install nodeLinuxsudo apt install nodejs npm1.2 校验安装新开终端执行node-vnpm-v输出版本号即成功建议≥18.17.0。1.3 国内npm加速必做避免安装超时失败# 设置淘宝镜像源npmconfigsetregistry https://registry.npmmirror.com# 验证npmconfig get registry可选多Node版本管理 nvm开发者推荐Windowsnvm-windowsMac/Linuxnvm-sh可随意切换Node版本。二、第二步安装 Git 版本控制系统2.1 下载安装官网https://git-scm.com/downloadsWindows安装时默认选项勾选Git Bash HereMacbrew install gitLinuxsudo apt install git2.2 基础配置校验# 校验安装git--version# 全局用户名邮箱Git提交必填gitconfig--globaluser.name你的名字gitconfig--globaluser.email你的邮箱# 查看配置gitconfig--global--list作用Claude Code可自动读取Git变更、diff、提交记录做代码分析。三、第三步全局安装 Claude CodeAnthropic官方CLI工具3.1 npm全局安装管理员终端执行Windows必须PowerShell管理员通用命令国内镜像加速安装解决官方源404npminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.comMac/Linux权限不足加sudosudonpminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com3.2 验证Claude Code是否安装成功claude--version输出版本号如2.1.139代表完成。3.3 初次初始化生成配置文件夹终端直接输入claude随便选一项退出即可会自动在用户目录生成.claude配置文件夹为后续cc-switch接管做准备。四、第四步安装 cc-switch 可视化配置工具核心4.1 cc-switch 作用一句话解释可视化一键切换Claude Code的API地址、密钥、模型无需手动改json配置文件托盘常驻支持接入DeepSeek、智谱、MiniMax等国产兼容Anthropic协议大模型。4.2 下载对应系统安装包GitHub Releases地址https://github.com/farion1231/cc-switch/releasesWindows下载.msi安装包macOS.dmgLinux.deb/.AppImage4.3 Windows安装步骤双击msi安装包 → Next自定义安装路径建议非C盘中文路径→ Next完成安装桌面启动CC Switch4.4 命令行校验可选cc-switch--version4.5 cc-switch首次初始化打开软件 → 顶部菜单栏执行Init → Initialize Claude Env自动关联本地.claude配置目录接管Claude Code环境变量。五、第五步VSCode 集成 Claude Code 插件5.1 安装VSCode官网https://code.visualstudio.com/建议版本≥1.98.05.2 安装官方插件快捷键CtrlShiftXMacCmdShiftX打开扩展市场搜索Claude Code for VS Code发布者Anthropic官方认证点击Install → Reload Window重启窗口5.3 插件生效判断重启后VSCode右上角出现⚡Claude图标左侧活动栏出现Claude入口即为成功。重要规则必须用File → Open Folder打开项目文件夹单个文件无法读取Git上下文与项目结构。六、第六步cc-switch核心配置API模型路由国内可用6.1 提前准备API Key二选一官方Claude API KeyAnthropic控制台申请国内访问受限国产兼容模型推荐DeepSeek、智谱GLM、MiniMax均兼容Anthropic协议以DeepSeek为例平台https://platform.deepseek.com/ 创建API Key复制保存。6.2 在cc-switch添加模型服务商打开CC Switch切换到Claude Code标签页右上角点击 Add Provider选择模板DeepSeek / Custom自定义填写参数DeepSeek示例Provider NameDeepSeek V4 ProBase URLhttps://api.deepseek.com/anthropicAPI Key粘贴你的sk-xxx密钥默认模型deepseek-v4-pro6.3 启用配置并全局生效选中添加好的服务商点击Activate激活软件自动写入系统环境变量ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN勾选Auto Export Env开机自动挂载配置6.4 验证链路是否打通终端测试# 让Claude Code读取cc-switch配置调用模型claude chat输出Hello WorldVSCode测试打开项目 → 点击右上角Claude图标 → 发送指令修改代码能正常返回代码即为全链路通。七、第七步Git Claude Code 联动使用项目根目录执行git init初始化仓库做初次提交在Claude Code对话中直接输入指令查看当前Git改动优化代码并自动生成commit提交信息Claude可直接读取diff、修改文件、执行git add/commit/push命令。八、全栈最终环境校验命令逐条运行全部通过即完工# 1. Nodenpmnode-vnpm-v# 2. Gitgit--version# 3. Claude Code CLIclaude--version# 4. cc-switchcc-switch--version# 5. Claude调用测试claude chat测试连通性九、高频报错解决方案报错1claude: command not found原因npm全局路径未加入系统PATH修复Windows重启终端/重启电脑检查Node.js安装时是否勾选Add to PATHMac/Linuxecho export PATH$HOME/.npm-global/bin:$PATH ~/.zshrc source ~/.zshrc报错2npm安装权限报错Windows右键PowerShell以管理员身份运行Mac/Linux命令前加sudo报错3VSCode插件无响应、无法调用模型关闭所有终端彻底退出cc-switch重新激活ProviderVSCode执行Reload Window删除用户目录.claude文件夹重新执行claude初始化报错4模型调用401/密钥无效确认cc-switch内已点Activate激活当前服务商API Key复制无空格、未过期Base URL填写正确国产模型必须带/anthropic后缀报错5cc-switch无法读取Claude配置终端执行一次claude生成初始化文件再回到cc-switch执行cc-switch init。十、日常工作流总结开机启动cc-switch托盘选择要使用的模型一键切换VSCode打开项目文件夹使用Claude Code写代码、重构、DebugClaude直接操作Git完成版本提交、分支管理Node.js环境用于运行AI生成的后端/前端代码