OmniRoute + Claude Code：配置步骤、免费额度的限制，以及把 CCSub 加成兜底渠道

export ANTHROPIC_BASE_URL="http://localhost:20128"
export ANTHROPIC_AUTH_TOKEN="你的OmniRoute密钥"
export ANTHROPIC_MODEL="ccsub/claude-sonnet-5"
claude

OmniRoute 是一个开源的本地 AI 网关（MIT 协议，代码在 GitHub）。它在你电脑上跑一个服务，Claude Code、Codex、Cursor 这些工具把请求发给它，它再按你定的规则分给各家模型：先用免费额度，用完或者出错了自动换下一家。

最近很多人搜 OmniRoute，是因为看到「让 Claude Code 免费用」的视频。这篇把三件事说清楚：怎么配、免费到底有哪些限制、怎么把 CCSub 加成付费兜底。

安装 OmniRoute

需要先装 Node.js，然后任选一种方式：

第一次用可以运行 omniroute setup 走引导，有问题时 omniroute doctor 会做一遍自检。npm 11 以上版本可能会拦截安装脚本，按 OmniRoute README 里给的 --allow-scripts 参数重装即可。

让 Claude Code 走 OmniRoute

Claude Code 只认环境变量，没有单独的地址参数。要设三个：

不想手动设变量的话，OmniRoute 自带两个命令：

• omniroute launch：直接用当前配置启动 Claude Code。
• omniroute setup-claude：在 ~/.claude/profiles/<名字>/settings.json 里按模型生成多套配置，之后用 omniroute launch --profile <名字> 启动。先加 --dry-run 看它要写什么文件再执行。

想在 /model 列表里直接选 OmniRoute 的模型，需要 Claude Code v2.1.129 以上并设置 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1。列表只显示 claude 或 anthropic 开头的型号，其他型号用 ANTHROPIC_MODEL 指定。

「免费」到底有哪些限制

OmniRoute 软件本身免费，但它路由过去的免费额度都是第三方的：

• 额度是估算的：README 里写的每月约 16.2 亿免费 token、150 多个免费层，是它把各家免费额度加起来估的，不是 OmniRoute 发的。每家的配额和限速由对方决定，随时会变。
• 新装可能没有可用线路：auto 模型需要至少一条符合条件的线路。刚装好、还没接任何账号时可能一条都没有；有些不需要 Key 的服务也会拒绝第三方客户端。
• 有些渠道默认不用：被 OmniRoute 标成条款风险高的渠道，默认不进自动路由，你接了账号也不会自动启用。
• 免费模型不等于你习惯的模型：免费层大多是其他家的模型。Claude Code 的工具调用、长上下文在这些模型上能不能稳定跑，要自己试。

所以实际用下来常见的情况是：小任务免费额度够用，长任务跑到一半额度用完或者被限速。这时候需要一个付费渠道接住，下面就是做法。

把 CCSub 加成 OmniRoute 的渠道

OmniRoute 支持添加自定义的 Anthropic Compatible 和 OpenAI Compatible 渠道，CCSub 两种都支持。Claude Code 用 Anthropic 格式，选前者：

1. 打开 OmniRoute 后台 Providers，点 Add Anthropic Compatible。
2. 按下面填写并保存：

3. 打开刚建的 CCSub 渠道，点 Add Connection，把 CCSub 控制台创建的 Key（sk- 开头）填进 API Key，保存后测一下连通。
4. 之后模型名写成 ccsub/型号，例如 ccsub/claude-sonnet-5。全部可用型号 ID 见 型号列表。

要在 OmniRoute 里用 GPT 系列，也可以再加一个 Add OpenAI Compatible：Base URL 同样填 https://www.ccsub.net/v1，API 类型选 Chat Completions。

免费额度用完自动切到 CCSub

OmniRoute 的「组合」（Combo）就是一串按顺序排好的模型。策略选 priority，前面放免费模型，最后放 CCSub：

omniroute combo create cc-fallback \
  --strategy priority \
  --targets 你的免费模型,ccsub/claude-sonnet-5

然后把 Claude Code 的 ANTHROPIC_MODEL 设为组合名 cc-fallback。前面的渠道额度用完、限速或出错时，请求会落到 CCSub 上，任务不会中断。也可以在后台 Combos 页面里点选创建；目标型号的具体写法以你所用版本 Combos 页面显示的为准。

怎么确认配置成功

• OmniRoute 后台的请求日志会显示每条请求被路由到了哪个渠道。
• 走了 CCSub 的请求，会同时出现在 CCSub 控制台的「使用记录」里，Token 数和扣费都能对上。
• 在 Claude Code 里用 /status 可以看实际生效的地址。

费用怎么算

OmniRoute 本身不收费，费用取决于请求最后落到了哪个渠道：

• 走免费额度的请求，按对应服务商的规则，不经过 CCSub，也不产生 CCSub 费用。
• 落到 CCSub 的请求按 CCSub 的规则扣费：按量付费 1 元 = 1 美元额度、永不过期，按每次请求的输入 / 输出 Token 和型号单价扣费，单价见 型号列表；月卡 先扣当天额度（北京时间 0 点重置），用完再扣余额。
• OmniRoute 开启了 token 压缩的话，发到 CCSub 的 Token 会变少，扣费也跟着变少。
• 鉴权失败（401）的请求不扣费。每条请求的 Token 和扣费都能在「使用记录」里查到。

适合谁用

• 想先用免费额度、只在不够用时才花钱的人。
• 同时用好几家模型、想在一个地方统一管理 Key 和路由规则的人。
• 只想稳定用 Claude Code、不想多维护一个本地服务的话，直接按 Claude Code 接入教程 设两个环境变量更省事；需要在多个服务之间手动切换，可以看 CC Switch 教程。