这篇教程是专门为“行动派”准备的。
我不扯那些虚头巴脑的概念,直接帮大家搞定四件事:
怎么顺利安装 Claude Code
怎么测试它是不是真能用
怎么把它和国产大模型连起来
怎么玩转多模型自动路由
如果你是头一回捣鼓 Claude Code,听我一句劝:老老实实按顺序来,别一上来就折腾高难度配置。
咱们折腾这一圈,不只是为了换个模型,而是为了留住 Claude Code 那套无敌的工作流:
直接在终端里开搞
自动读取整个项目的代码
动动嘴就能改文件
顺手帮你执行命令
完美衔接 Git 提交记录
所以最聪明的玩法是:
保留 Claude Code 这种“在终端里指点江山”的体验,把底层换成更省钱、更稳定、国内用起来更顺手的模型。
比如:
DeepSeek 全系列
智谱的 GLM 5 或 4.6
MiniMax-M2.5
阿里通义千问系列
还有各种聚合平台上的模型
先瞅一眼你的电脑装没装 Node.js:
node -v npm -v
只要能正常蹦出版本号,就闭眼执行这行命令:
npm install -g @anthropic-ai/claude-code
装完测试下:
claude --version
要是你讨厌 npm,那就直接用官方给的脚本。
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
装完别忘了也测一下版本:
claude --version
随便进一个你的代码目录:
cd /你的/项目/路径 claude
初次见面,它会让你登录授权。
这时候先别急着改配置,先确认这几点:
程序能不能跑起来
能不能读懂你的项目
你说的话它能不能听懂
可以试着丢给它这几个指令:
帮我解释下这个项目的结构 给 utils/date.ts 写点测试用例 把这个函数改成异步写法 找找这个模块里有没有明显的 Bug
这一段是全文的精华,建议直接复制粘贴。
只要某个模型厂家支持 Anthropic 的接口协议,咱们改个 环境变量 就能直接“白嫖” Claude Code。
我首推这两个,因为最容易搞定:
DeepSeek
智谱 GLM
在你的终端里敲这几行:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=这里填你的_DEEPSEEK_API_KEY export API_TIMEOUT_MS=600000 export ANTHROPIC_MODEL=deepseek-chat export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
然后直接开跑:
cd /你的/项目/路径 claude
如果你用的是 zsh,把这堆东西塞进 ~/.zshrc:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=这里填你的_DEEPSEEK_API_KEY export API_TIMEOUT_MS=600000 export ANTHROPIC_MODEL=deepseek-chat export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
记得运行一下生效指令:
source ~/.zshrc
要是你还在用 bash,那就写在 ~/.bashrc 里:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=这里填你的_DEEPSEEK_API_KEY export API_TIMEOUT_MS=600000 export ANTHROPIC_MODEL=deepseek-chat export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
同样也要 source 一下:
source ~/.bashrc
先看看变量对不对:
echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_MODEL
只要屏幕显示的是 https://api.deepseek.com/anthropic 和 deepseek-chat 就没毛病。
接着运行 claude,随口问它一句:
帮我写个 Python 版的 Hello World,顺便解释下代码。
接 GLM 有两种法子:
改 ~/.claude/settings.json 配置文件
依然用 shell 环境变量
建议两个都了解下,配置文件不行就换环境变量。
先给配置建个家:
mkdir -p ~/.claude
打开或新建这个文件:
nano ~/.claude/settings.json
把这段话贴进去:
{ "env": { "ANTHROPIC_AUTH_TOKEN": "这里填你的_GLM_API_KEY", "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic", "API_TIMEOUT_MS": "3000000", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air", "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6", "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6" } }
要是上面的不管用,就直接在终端执行:
export ANTHROPIC_AUTH_TOKEN=这里填你的_GLM_API_KEY export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic export API_TIMEOUT_MS=3000000 export ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-4.5-air export ANTHROPIC_DEFAULT_SONNET_MODEL=glm-4.6 export ANTHROPIC_DEFAULT_OPUS_MODEL=glm-4.6
~/.zshrc 或 ~/.bashrc。执行命令测测:
echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_DEFAULT_SONNET_MODEL
然后启动程序,给它个任务试试:
用几句话总结下这个项目是干啥的。
说句实在话:
MiniMax 很强,但不建议直接拿它硬刚 Claude Code 的第一优先级。
因为能不能稳定跑通,关键在于:
它对 Anthropic 或 OpenAI 的兼容层做得好不好
是不是用了中转聚合平台的标准接口
有没有路由层帮它做协议转换
所以更靠谱的玩法是:
先拿 DeepSeek 或 GLM 练手,跑通了再说。
之后再把它挂到模型路由器下面。
简单说,MiniMax 最好是配合这些东西一起用:
OpenRouter 等聚合平台
自己搭建的 API 兼容转发
专门的 Claude Code Router (CCR)
如果你只是想简单用用,上面那些就够了。
但如果你追求极致体验:
简单的活儿给便宜模型干
费脑子的活儿给强力模型干
巨长的代码给长上下文模型干
某个模型挂了能自动换另一个
那你就必须得整一个 CCR 了。
npm install -g @musistudio/claude-code-router
看看装上没:
ccr --help
mkdir -p ~/.claude-code-router nano ~/.claude-code-router/config.json
别整那些复杂的,先用这份能直接跑通的试试:
{ "LOG": true, "API_TIMEOUT_MS": 600000, "NON_INTERACTIVE_MODE": false, "Providers": [ { "name": "deepseek", "api_base_url": "https://api.deepseek.com/chat/completions", "api_key": "这里填你的_DEEPSEEK_API_KEY", "models": ["deepseek-chat", "deepseek-reasoner"], "transformer": { "use": ["deepseek"], "deepseek-chat": { "use": ["tooluse"] } } }, { "name": "glm", "api_base_url": "https://open.bigmodel.cn/api/paas/v4/chat/completions", "api_key": "这里填你的_GLM_API_KEY", "models": ["glm-4.6", "glm-4.5-air"] } ], "Router": { "default": "deepseek,deepseek-chat", "think": "deepseek,deepseek-reasoner", "background": "glm,glm-4.5-air", "longContext": "glm,glm-4.6", "longContextThreshold": 60000 } }
这份配置的逻辑很简单:
平常干活默认用 deepseek-chat
遇到烧脑的逻辑用 deepseek-reasoner
背后偷偷跑的任务用 glm-4.5-air
代码量特别大时自动切到 glm-4.6
以后别直接运行 claude 了,改用这个:
ccr code
你可以把它理解为给 Claude Code 套了个“智能大脑”,底层模型它说了算。
要是改了配置想重来:
ccr restart
想看可视化界面:
ccr ui
别再一个模型用到黑了,聪明人都这么分工:
默认干活: DeepSeek V3.2
深度思考: DeepSeek Reasoner 或 GLM 5
超长文档: GLM 5 或通义千问长文本版
后台打杂: 随便找个不要钱或者极便宜的
默认干活: GLM 4.6 或 GLM 5
深度思考: 顶尖的推理模型
超长文档: 找个读文档最稳的厂家
保底方案: DeepSeek V3.2
重点只有一句话:什么样的活儿配什么样的兵,别指望一个模型包打天下。
claude 命令一般是没装好,或者 npm 的路径没配对。
先搜搜东西在哪:
npm root -g npm bin -g
要是装了还是找不到,就手动把那个 bin 路径加进系统 PATH 里。
看到 401 或者 unauthorized 之类的字眼,基本就是 Key 的问题。
自查一下:
echo $ANTHROPIC_AUTH_TOKEN
要是空的,说明你刚才配的环境变量没生效,记得执行下 source。
看到 404 或者找不到模型,通常是地址填错了。
核对下这个:
echo $ANTHROPIC_BASE_URL
这多半是 JSON 格式写歪了。
检查下是不是少了逗号,或者 provider 的地址写错了,再或者是模型名字没对上。
最简单的办法是用 cat ~/.claude-code-router/config.json 仔细盯着看。
这可能不是技术问题,而是:
这个模型根本不会用你给它的工具
任务太复杂,它脑子转不过来
建议换个更强的推理模型试试
如果你只想现在就开始,不想听我啰嗦,选一条路走:
安软件: npm install -g @anthropic-ai/claude-code
走流程: 进项目跑一下官方原版,确认没坏。
配环境: 把 DeepSeek 的那几行 export 贴进终端。
开整: 再次运行 claude。
这就是最快的法子。
安软件: 把 Claude Code 和 CCR 全都装上。
写配置: 在 ~/.claude-code-router/config.json 贴入我给你的那段模版。
启动: 直接运行 ccr code。
如果你刚开始用:选 DeepSeek 或 GLM 直连。先用起来,感受到生产力的提升。
如果你打算天天用:研究多模型分工和路由。这是避免“被单一厂家绑架”的最好办法。
如果你非要试 MiniMax:别直连,走路由器,这样哪怕它报错你也能瞬间切换。
Claude Code 的灵魂在于它把 AI 变成了你终端里的得力助手;而接入国产模型,则是为了让这份生产力更便宜、更顺畅。
先求跑通,再求分工,最后上路由器。这才是最稳的进阶之路。