本地部署Claude CLI全攻略:模型路由、用量监控与踩坑排错
文章目录前言1. 第一步先把地基打牢1.1 版本选对少踩一半坑1.2 可选花活NVM版本管理器1.3 可选花活Git2. 主力选手Claude Code CLI2.1 安装就一行命令2.2 API Key和网络那些糟心事2.3 备选选手OpenCode3. 贴心管家CC Switch3.1 两个版本随便挑3.2 我最常用的俩功能4. 进阶神器9router4.1 安装启动一条龙4.2 核心玩法模型随便切4.3 重点安利Combos备胎组4.4 和CC Switch啥关系5. 光有工具没用习惯才是王道5.1 Skill按需装别贪多5.2 每周复盘10分钟5.3 常用命令随手记6. 踩坑急救指南6.1 换了配置不生效6.2 端口被占用6.3 连不上报网络错误6.4 重启电脑就挂了P.S. 无意间发现了一个巨牛的人工智能教程非常通俗易懂对AI感兴趣的朋友强烈推荐去看看传送门https://blog.csdn.net/HHX_01前言今天上午帮同事搭了一套AI干活的配置弄完我一拍大腿——合着我自己用了这么久从来没正经整理过。正好趁热打铁把我日常高效办公的AI工作流扒出来给大伙看看。毕竟能少干点活多摸会鱼这种好事谁能拒绝。整体思路其实很简单底层靠Node.js撑着核心用Claude Code CLI当主力俩辅助工具补短板最后靠日常习惯把效率拉满。提前打个预防针中间有些下载和接口访问需要点特殊网络环境懂的都懂建议提前备好别半路卡壳抓瞎。1. 第一步先把地基打牢很多AI工具都是跑在Node.js上的Claude Code本身就是个npm包所以这一步是基础中的基础。1.1 版本选对少踩一半坑版本就选20以上的LTS兼容性最好踩坑最少。Windows用户直接去官网下个安装包下一步下一步点完完事没什么技术含量。1.2 可选花活NVM版本管理器要是你手头项目多这个要Node16那个要Node22那可以装个NVM来管版本。这玩意儿就像个版本切换器想用哪个切哪个不用来回卸载安装折腾得满头大汗。不过要是你就日常用用没那么多开发需求就别折腾了纯纯给自己加戏。常用命令放这需要的自取# Windows 用 nvm-windows# macOS / Linuxcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh|bash# 常用命令nvminstall22# 装指定版本nvm use22# 切换版本nvm list# 查看已安装版本1.3 可选花活Git做开发的朋友建议顺手把Git装上。Claude Code的代码对比、提交、回滚这些功能全靠Git撑着没装的话这些功能直接哑火。纯写文档、办公用的朋友就不用凑这个热闹了装了你大概率也只会用个git clone然后就再也没打开过。2. 主力选手Claude Code CLI我现在日常主力用的就是Claude Code命令行形式的。别觉得命令行很唬人用惯了是真的爽。网页版你还得复制粘贴来回切它直接就能操作你本地文件项目里的上下文门儿清写代码改配置查文件一条龙给你办了。2.1 安装就一行命令安装简单到离谱一行命令完事npminstall-ganthropic-ai/claude-code装完输个claude就能进交互界面第一次用绑个API Key就行。友情提示国内网络装npm可能慢得像蜗牛要么换淘宝镜像要么开代理。换镜像也简单一行命令的事npmconfigsetregistry https://registry.npmmirror.com要是换了镜像还不行那基本就是包源在国外只能上魔法了。后面装别的工具遇到这问题同理。2.2 API Key和网络那些糟心事API Key怎么来两种路子要么去Anthropic Console注册账号按量付费用多少花多少适合轻度用户要么直接订阅Claude Pro/Max在官网拿Key适合天天用的重度选手。重点提醒Claude官方API国内直连是连不上的别不信邪试半天纯纯浪费时间。没代理又想省钱的别急后面有个工具能解决这个问题。至于注册登录拿Key这些环节基本都得靠魔法懂的都懂。2.3 备选选手OpenCode最近试了试OpenCode也挺好用我平时桌面版用得多。最大的好处就是对国内环境友好不用魔法也能顺顺利利装完用上。桌面版直接下安装包图形界面多标签页管理比终端直观多了。习惯命令行的也有终端版一行命令装好npminstall-gopencode-ai用法和Claude Code大差不差还能兼容后面说的9router甚至能在里面用Claude的能力属于生态互补了。要是Claude Code用着不顺手换这个试试轻量还快。3. 贴心管家CC SwitchCC Switch这玩意儿属于“没有也能活有了回不去”的类型。专门配合Claude Code用能省不少破事。3.1 两个版本随便挑有桌面版和CLI版按自己习惯选。桌面版有图形界面管理配置一目了然推荐大多数人用直接下载安装包就行。喜欢泡在终端里的就装CLI版npm一行命令搞定npminstall-gcc-switch-cli3.2 我最常用的俩功能说出来你可能觉得平平无奇但真用起来是真香。第一个是用量查询。能看你API调用了多少token花了多少大概多少钱。尤其是月底结账前看一眼心里有个数别到时候账单出来吓一跳以为自己刷爆了信用卡。第二个是配置备份。你在Claude Code里改的那些自定义设置、选的模型一键就能备份。重装系统、换电脑的时候直接恢复不用从头再折腾一遍省老事了。4. 进阶神器9router如果说CC Switch是贴心管家那9router就是真正让你打开新世界大门的东西。简单说它就是个多模型管理和路由工具说白了就是管一堆AI模型想用哪个用哪个。4.1 安装启动一条龙安装还是老样子npm一行npminstall-g9router装完终端输9router启动服务会给你个本地控制面板地址浏览器打开就能操作。也支持纯命令行操作但我习惯用网页版点来点去直观不用记命令。4.2 核心玩法模型随便切打开控制面板里面内置了四十多家模型供应商不少都有免费额度注册一下就能白嫖。你自己有各种API Key的也能手动加进去官方的、中转的都能塞进去。配好之后把Claude Code的接口地址改成它给的本地地址API Key填它生成的之后所有请求就都走它统一调度了。友情提醒免费的和第三方中转的你的请求内容会发到人家服务器上。自己玩、写点公开内容无所谓公司项目、敏感代码就别图便宜了老老实实走官方渠道别因小失大。4.3 重点安利Combos备胎组这是我最喜欢的功能必须单独拎出来说。Combos就是把好几个模型打包成一个“虚拟模型”按顺序排好队。主模型挂了、配额用完了、报错了它自动切到下一个备选全程不用你动手。我自己就组了个组合Claude当主力后面排了俩备选。高峰期服务器卡、或者额度用光的时候根本不用慌它自己就找备胎顶上了丝毫不耽误干活。相当于给你的主力模型配了一整套备胎团安全感直接拉满。4.4 和CC Switch啥关系很多人问这俩会不会冲突完全不会功能互补的。CC Switch管配置、管用量监控像个管家管你自己用AI的成本和效率。9router管模型调度、管组合切换像个分发员管各个模型之间怎么配合干活。一个对内一个对外搭着用刚刚好。5. 光有工具没用习惯才是王道工具装一堆不会用也是白搭。真正能提效的其实是日常的使用习惯。5.1 Skill按需装别贪多Claude Code支持装Skill扩展功能就像手机装APP一样。写文档就装排版、配图的写代码就装调试、审查的办公就装日历、任务的。别一上来全装上看着功能多实则提示词巨长响应慢得要死得不偿失。除了Skill还有个MCP扩展能接外部工具和数据属于进阶玩法用到再研究就行不用一开始就全搞懂。5.2 每周复盘10分钟我每周都会花十来分钟复盘一下这周用AI的情况。哪些场景用着效率翻倍哪些场景越帮越忙提示词有没有优化空间工具配置要不要调一调。别小看这十分钟坚持俩月你会发现自己用AI的水平突飞猛进而不是装完工具就一直原地踏步。5.3 常用命令随手记最后放几个我日常高频用的命令省得你们再去翻文档。# 启动交互式会话claude# 单次提问不进交互claude帮我看看这个报错# 恢复上次会话claude--resume会话里的快捷命令也放几个常用的/init 初始化项目配置 /clear 清空当前上下文 /compact 压缩上下文对话太长时用 /cost 查看当前会话消耗 /insights 查看会话统计复盘好用 /exit 退出会话对了还有个小彩蛋提问最后加个ultrathink终端会出彩色特效专门对付特别复杂的问题没事可以玩玩。6. 踩坑急救指南装工具哪有不踩坑的几个常见问题给你们打个底。6.1 换了配置不生效大概率是环境变量在搞鬼。你要是系统里设了ANTHROPIC_API_KEY这种变量它会直接覆盖工具里的配置你改半天都白搭。查一下cc-switchenvcheck--appclaude确认是这问题的去系统设置里把对应变量删了重启终端就好了。说起来这环境变量就像前任你以为早就删干净了指不定哪天就跳出来给你添堵。6.2 端口被占用9router默认端口是20128被别的程序占了也正常。Windows用户查一下占用进程杀了就行或者换个端口。netstat-ano|findstr :20128 taskkill /PID /F说白了就是抢车位别人占了你的位要么把人撵走要么自己换个车位。6.3 连不上报网络错误别犹豫先查代理。官方API国内直连不通先确认你代理开没开终端能不能正常访问外网。十次报错九次是网络的锅剩下一次是你Key填错了。6.4 重启电脑就挂了9router默认是前台运行的重启电脑当然就没了得手动再启动一下。嫌麻烦的就去查查文档整个开机自启一劳永逸。说到底工具都是辅助。不管是Node.js还是9router本质上都是帮你减少麻烦让你把精力放在真正要解决的问题上。这套流程跑顺了日常就是开终端起9router进Claude会话按需调Skill换模型去面板点两下月底看看用量复盘一下。整套下来基本不用在工具本身上瞎折腾精力全用在正事上。当然了工具没有标准答案适合自己节奏的才是最好的。我这套也一直在改你们有啥更好用的玩意儿欢迎评论区交流。P.S. 无意间发现了一个巨牛的人工智能教程非常通俗易懂对AI感兴趣的朋友强烈推荐去看看传送门https://blog.csdn.net/HHX_01