Claude Code cc-switch Git Node.js 全套下载安装配置完整版整体安装顺序必须按这个来Node.js → Git → Claude CodeCLIVSCode插件→ CC-Switch核心代理切换→ 联动配置测试国内网络全程使用DeepSeek 兼容Anthropic协议绕开官方直连限制 国内备用高速下载https://pan.quark.cn/s/d6152047213b 含全平台包一、第一步安装 Node.js强制≥18 LTS运行依赖1. 官方下载地址官网https://nodejs.org/ 选择LTS 长期支持版Windows 安装要点双击安装包务必勾选 Add to PATH自动写入系统环境变量一路默认下一步完成关闭所有旧终端新开 PowerShell/CMD 验证node-vnpm-v输出版本号即成功。macOSHomebrew一键brewinstallnodenode-vnpm-vLinux Ubuntu/Debiansudoaptupdatesudoaptinstallnodejsnpm# 升级到稳定LTSsudonpminstall-gnsudon lts可选多Node版本管理开发者推荐Windowsnvm-windowsMac/Linuxnvm命令统一nvminstalllts nvm use lts nvmaliasdefault lts二、第二步安装 Git版本管理项目依赖下载地址官网https://git-scm.com/downloadsWindows下载Windows安装包默认配置安装编辑器选VSCode终端用Git Bash验证git--version首次全局配置必做gitconfig--globaluser.name你的昵称gitconfig--globaluser.email你的邮箱macOSbrewinstallgit# 同上配置用户名邮箱Linuxsudoaptinstallgitgitconfig--globaluser.nameNamegitconfig--globaluser.emailxxxxxx.com三、第三步安装 Claude Code命令行CLI VSCode插件3.1 全局安装 CLI 命令终端直接调用claudeWindows管理员身份打开PowerShell执行用淘宝npm镜像加速npminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.comMac/Linuxsudonpminstall-ganthropic-ai/claude-code验证安装claude--version# 出现 v2.x.x 版本号安装成功报错修复提示claude不是内部命令查看npm全局路径npm config get prefixWindows把输出路径一般是C:\Users\用户名\AppData\Roaming\npm添加到系统PATH环境变量重启终端3.2 VSCode 安装 Claude Code 官方插件VSCode快捷键CtrlShiftX打开扩展商店搜索Claude CodeAnthropic官方蓝色机器人图标安装CtrlShiftP→ 输入Reload Window重载窗口侧边栏出现Claude图标即为完成VSCode基础避坑配置打开设置settings.json粘贴{claudeCode.disableLoginPrompt:true,claudeCode.autoOpenChatOnActivate:true}四、—四、第四步CC-Switch 下载安装重中之重国内可用核心4.1 官方下载地址GitHub Releases发布页https://github.com/farion1231/cc-switch/releases各系统安装包选择Windows推荐下载xxx-Windows-x64.msi安装包双击一路Next默认安装也可下载Portable.zip绿色解压版直接运行macOS 一键brew安装brew tap farion1231/ccswitch brewinstall--caskcc-switchLinux下载deb包或AppImageAppImage需授权chmod x xxx.AppImage运行4.2 CC-Switch 可视化核心配置接入DeepSeek国内稳定前置准备去DeepSeek平台 https://platform.deepseek.com/ 注册实名认证新建API Keysk-开头保存好步骤1新增模型服务商打开CC-Switch右上角 Add Provider预设模板选择DeepSeek自动填充地址https://api.deepseek.com/anthropic粘贴你的DeepSeek API Key默认模型填写deepseek-v4-pro[prm]2026最新可用模型保存 →设为默认激活供应商步骤2开启本地路由接管Claude Code左上角齿轮「设置」→「路由」标签打开启用本地请求路由总开关保存CC-Switch最小化到系统托盘后台常驻步骤3绑定Claude Code程序自动注入环境变量左侧菜单【CLI绑定】→ 勾选Claude Code开启自动注入环境变量一键接管ANTHROPIC_BASE_URL/TOKEN/MODEL冲突提示处理如果弹出环境变量冲突全选删除旧手动配置避免覆盖失效进阶玩法重复添加智谱GLM、其他兼容Anthropic接口模型托盘右键一键切换服务商无需改任何配置文件。五、全套工具联动最终测试5.1 终端测试Claude CLI新开终端执行# 直接对话claude# 读取当前项目代码分析claude帮我检查这个Node项目代码问题CC-Switch面板请求计数上涨链路完全通。5.2 VSCode插件测试用VSCode打开项目文件夹必须Open Folder单个文件无项目上下文侧边栏打开Claude Code对话窗口提问代码重构、写接口、排查bug选中代码快捷键快速交由AI处理5.3 Git Claude 开发联动实用工作流# 1. 根据代码改动自动生成规范Git提交备注gitdiff|claude生成符合Angular规范的git commit message# 2. 让AI解决Git合并冲突命令claudegit merge冲突完整解决步骤六、高频报错排查Claude请求401/超时CC-Switch路由开关是否打开DeepSeek Key是否有效、账户是否有余额Base地址必须带后缀/anthropicCC-Switch不生效删除系统手动设置的ANTHROPIC系列环境变量CC-Switch自动管理优先级更高Node版本过低报错升级至20 LTS版本最低不能低于18npm安装卡住全程使用淘宝镜像--registryhttps://registry.npmmirror.com七、日常标准工作流开机自启CC-Switch后台托盘运行默认DeepSeek模型VSCode打开项目使用Claude Code插件编码辅助Git做版本提交、分支管理终端用claude命令批量生成脚本、分析代码、生成Git指令需要换模型时托盘右键CC-Switch一键切换API服务商
)
