Claude Code 跑满血的 5 个配置:网关版
一句话定义
把 Claude Code 的 base_url 指向网关是一种在保留官方客户端的前提下、让模型调用改由网关转发的做法;通常只改环境变量,不改代码。
Claude Code 装好只是第一步。同样是跑 Claude Code,有人月账单 $800,有人接近 $0——差的不是模型,是 5 个配置。这篇按顺序配下来,跑满血。
配置一:base_url 指向网关,别直连官方
Claude Code 默认连 Anthropic 官方。改成网关地址后,你得到三样东西:免费优先路由、自动 failover、用量视图。
- 国际站:
https://freemodel.online/v1(OpenAI 与 Anthropic 双兼容,Claude Code 直连) - 中文站:tokenexchage 的
/v1(人民币计费)
改完跑 claude --version 确认能启动,然后做一个最小验证:问一个简单问题,去网关用量视图看这条请求走了免费还是付费。如果用量视图没有这条记录,说明 base_url 没生效,回头检查。
配置二:模型分档——默认 Sonnet,硬骨头切 Opus
不要所有任务都用最贵的。推荐分档:
| 任务类型 | 模型 | 价格(输入/输出,每百万 token) |
|---|---|---|
| 日常写代码、改 bug、读仓库 | Claude Sonnet 5.5 | $2 / $10 |
| 复杂重构、跨文件推理 | Claude Opus 5.5 | $4 / $20 |
| 简单问答、补注释 | Claude Haiku 5.5 | $0.1 / $0.5 |
经验数字:80% 的日常任务 Sonnet 完全够用,Opus 留给那 20% 真正难啃的。全量 Opus 的账单大约是分档使用的 2–3 倍。
配置三:确认免费优先真的在工作
网关的免费优先路由是默认开启的,但"默认开启"不等于"对你生效"——要看用量视图里免费命中的比例。新账号前两周重点看三个数:
- 免费命中率:请求中有多少走了免费容量。轻度使用应该在 50% 以上。
- fallback 次数:免费额度耗尽后切到付费的次数。偶发正常;如果每次必 fallback,说明免费额度不够你的量级,考虑调低并发或接受付费部分。
- 失败重试:网关侧自动重试不应该出现在你的终端里。如果你频繁看到超时,说明某条线路有问题,换模型或联系网关支持。
配置四:aiglade 桌面端——一次配置,多 CLI 共用
如果你同时用 Claude Code、Codex CLI 等多个命令行 AI,每个都改一遍配置很烦。aiglade 是 Windows 桌面应用,把多个命令行 AI 装进一个中文窗口:
- 网关 key 在 aiglade 里填一次,各个 CLI 共用,不用每个工具单独配。
- 内置 Muse 助手:中文界面里直接调 Claude,不用切终端。
- 适合人群:Windows 本机开发、不想记一堆环境变量、希望中文界面管理多个 AI 工具的人。
这一步是可选的,但它是"配一次管全部"的关键—— especially 当你后面要加第三、第四个 CLI 的时候。
配置五:给断供留一条后路
网关已经做了多模型 failover,但你自己也可以加一层保险:
- 在项目里保留两个模型配置:主用 Sonnet 5.5,备用 Haiku 5.5(便宜 20 倍,应急时降级不中断)。
- 重要任务跑之前看一眼网关状态页/公告(厂商限流时网关会提前通知)。
- 代码里不要写死单一模型名,用环境变量,换模型只改一处。
验证清单:跑一个真实任务
配完别直接开工,先跑一遍验证:
- 拿上周真实做过的一个任务(例如"给这个模块加错误处理")完整跑一遍。
- 对比:答案质量是否达标、耗时是否可接受。
- 去用量视图确认:免费命中了多少、付费花了多少、总成本是否符合预期。
- 如果某项不达标,回头调配置二的分档或配置三的并发,而不是换回直连——直连是最贵的默认选项。
FAQ
网关会比直连慢吗?
多一跳理论上加几十毫秒。实测中,网关的 failover 反而减少了"某条线路抽风时的长尾超时"——平均延迟略增,P99 延迟下降。用你自己的任务测一次就知道。
免费额度会被薅完吗?
免费容量是厂商推广配额,有波动。网关的作用就是吸收波动:这家没了切那家。看配置三的三个数,比看广告靠谱。
aiglade 和网页版网关是什么关系?
网关(freemodel.online / tokenexchage)是 API 服务;aiglade 是跑在你 Windows 本机上的桌面应用,帮你管理多个 CLI 的配置和调用。两者配合:key 配一次,到处可用。
Disclosure
本文由 FreeModel / tokenexchage 团队撰写。价格数字来自厂商官方定价页(2026-10-19 核对)与网关公开价格页;用量数字为经验值,请以你自己的用量视图为准。
五个配置之外的两个坑
- 只改了 base_url,没改模型名:网关按模型名路由,名字写错会直接报错或落到非预期模型。改完先用一个最小请求验证返回里的模型字段。
- 没留回退路径:网关是单点。关键工作流要保留一条直连官方的备用配置,网关不可用时能切回去。
迁移检查清单
- 记录当前 base_url、模型名、环境变量,存一份可回滚的配置。
- 把 base_url 指向网关,先用
/v1/models或最小请求验证连通。 - 确认返回里的模型字段与预期一致,再跑真实任务。
- 观察一周的失败率、延迟和账单,和迁移前对比。
- 把免费额度耗尽后的行为写进运维文档:是停、转付费还是降级。
参考来源
- OpenAI API 文档(统一请求格式的规范来源):https://platform.openai.com/docs
- Anthropic API 文档(Claude 模型的官方调用口径):https://docs.anthropic.com/
- DeepSeek API 文档(国内模型的兼容接口说明):https://api-docs.deepseek.com/zh-cn