多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

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

Claude Code + Git + Node.js + cc-switch 全套下载配置完整教程【2026.8.3】 Claude Code Git Node.js cc-switch 全套下载配置完整教程整体安装顺序Node.js → Git → Claude CodeCLI→ cc-switch可视化模型切换工具 → 最终联动配置 国内备用高速下载https://pan.quark.cn/s/d6152047213b 含 v3.17 全平台包一、前置环境1Node.js 安装必须≥18 LTSClaude Code运行依赖1. 下载地址官网https://nodejs.org/ 选择LTS长期支持版稳定2. 安装步骤Windows双击.msi安装包全程默认下一步务必勾选Add to PATH自动配置环境变量Macbrew install node终端一键安装国内加速npm必做避免安装失败# 切换淘宝镜像源npmconfigsetregistry https://registry.npmmirror.com# 查看是否生效npmconfig get registry3. 验证是否安装成功新开终端执行node-vnpm-v输出版本号即完成。二、前置环境2Git 安装代码版本管理Claude Code读写项目依赖1. 下载地址官网https://git-scm.com/downloads2. 极简安装Windows一路默认下一步选择Git Bash终端即可Macbrew install git3. 初始化基础配置全局用户名邮箱gitconfig--globaluser.name你的昵称gitconfig--globaluser.email你的邮箱# 验证gitconfig--global--list4. 验证安装git--version三、第三步全局安装 Claude Code 命令行工具1. npm全局安装npminstall-ganthropic-ai/claude-code2. 验证安装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 Releaseshttps://github.com/farion1231/cc-switch/releases根据系统选择安装包WindowsCC-Switch-vxxx-Windows.msi安装版或便携版zipMacCC-Switch-vxxx-macOS.dmg2. 安装过程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在系统设置允许未知来源应用。极简执行顺序总结Node.js LTS 换npm淘宝源Git安装全局用户名邮箱配置npm全局安装 claude-codeGitHub下载安装cc-switchcc-switch添加DeepSeek/智谱API、开启本地路由Git项目内执行claude 指令直接AI编码
返回列表