news 2026/8/1 1:26:33

本地部署Claude CLI全攻略:模型路由、用量监控与踩坑排错

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
本地部署Claude CLI全攻略:模型路由、用量监控与踩坑排错

文章目录

  • 前言
  • 1. 第一步:先把地基打牢
    • 1.1 版本选对,少踩一半坑
    • 1.2 可选花活:NVM版本管理器
    • 1.3 可选花活:Git
  • 2. 主力选手:Claude Code CLI
    • 2.1 安装就一行命令
    • 2.2 API Key和网络那些糟心事
    • 2.3 备选选手:OpenCode
  • 3. 贴心管家:CC Switch
    • 3.1 两个版本随便挑
    • 3.2 我最常用的俩功能
  • 4. 进阶神器:9router
    • 4.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-g@anthropic-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 Switch

CC Switch这玩意儿,属于“没有也能活,有了回不去”的类型。专门配合Claude Code用,能省不少破事。

3.1 两个版本随便挑

有桌面版和CLI版,按自己习惯选。

桌面版有图形界面,管理配置一目了然,推荐大多数人用,直接下载安装包就行。

喜欢泡在终端里的,就装CLI版,npm一行命令搞定:

npminstall-gcc-switch-cli

3.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

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/8/1 1:25:33

Just do it (请做个小改变吧)

作者提出了一个行动理论:当你决定要得到某个事物,并且在物理上、情感上或是精神上开始行动后,这些行动就为你的生活开拓了新的道路。即使是很小的一步(物理上、情感上)。解释一下:现在想象你站在自我世界的正中央&…

作者头像 李华
网站建设 2026/8/1 1:22:18

世毫九理论(SH9)对话本体论形式化证明全维度研究报告

世毫九理论(SH9)对话本体论形式化证明全维度研究报告 作者:方见华 单位:世毫九实验室 核心摘要 本报告基于世毫九实验室(Shardy Lab)2026年公开的系列定型研究成果,针对该理论支撑“关系先于实体…

作者头像 李华
网站建设 2026/8/1 1:21:26

Python智能客服系统开发:从NLP到部署实践

1. 项目概述"基于Python的人工智能智能客服系统"是一个结合自然语言处理(NLP)和机器学习技术的自动化对话解决方案。这类系统正在彻底改变传统客服行业的运作模式,根据Gartner的预测,到2025年,超过80%的企业客户服务交互将由AI处理…

作者头像 李华
网站建设 2026/8/1 1:21:18

大数据目录:企业数据治理的核心引擎与应用实践

1. 大数据目录:数据治理的"图书馆索引系统"想象一下走进一个藏书百万册但没有任何分类标签的图书馆——这就是没有数据目录的企业数据环境现状。大数据目录(Data Catalog)本质上是一套元数据管理系统,它通过自动化的数据…

作者头像 李华
网站建设 2026/8/1 1:13:40

AI教材写作:低查重率与高效创作的技术实现

1. AI教材写作的技术变革与行业痛点教材编写领域正在经历一场由AI技术驱动的深刻变革。过去三年间,教育出版行业的AI工具渗透率增长了近300%,其中教材创作环节的AI应用增速最为显著。这种转变背后是传统教材编写模式面临的三大核心痛点:创作周…

作者头像 李华
网站建设 2026/8/1 1:11:32

UPC-A条形码:从编码原理到系统集成的完整实战指南

1. 项目概述:从条形码到数据桥梁如果你在超市收银台、仓库货架或者任何一件商品包装上停留过目光,大概率会看到一串黑白相间的竖条和底部的一排数字。这串看似简单的图形,就是我们今天要深入拆解的“UPC-A”条形码。它绝不仅仅是一个印刷图案…

作者头像 李华