两行命令
安装 anyr CLI,然后通过它在免费路由上启动 Claude Code:
curl -fsSL https://anyrouter.dev/setup.sh | bash
anyr claude --model anyrouter/free第一次运行会打开浏览器让你登录,创建 key 并保存。之后的运行会直接进入 Claude Code。如果还没装 Claude Code,加上 --install,anyr 会先帮你安装。需要 AnyRouter 账号,但不需要绑卡。
anyrouter/free 会选一个当前健康的免费模型,失败时回退到下一个。同样的两行命令也在 /claude-code 页面上;登录后的版本已填入你自己的 key,在 /welcome#claude-code。
让后台调用也免费
Claude Code 会把一部分调用发给小型后台模型和子代理。anyr claude 默认把它们指向 Claude Haiku,而这个模型只能通过你自己的供应商 key(BYOK)使用。没有 BYOK key 的 Free 账号即使主模型是免费的,这些调用也可能以 404 model_unavailable 失败。把所有别名都固定到免费路由即可避免:
anyr claude --model anyrouter/free \
--haiku anyrouter/free --sonnet anyrouter/free \
--opus anyrouter/free --fable anyrouter/freeanyr claude --dry-run 会打印它将使用的命令和环境变量(key 已打码),方便你在开始前检查这些别名。
不用 CLI
Claude Code 读取两个环境变量。先在控制台创建 key(每把 key 都以 sk-ar- 开头),然后:
export ANTHROPIC_BASE_URL="https://anyrouter.dev/api"
export ANTHROPIC_API_KEY="sk-ar-your-key"
claude --model anyrouter/freebase URL 不要带 /v1:Claude Code 会自己拼上 /v1/messages。完整参考:docs.anyrouter.dev/cli/claude-code。
可以试哪些免费模型
我们没有为编码给免费模型排名,任何排名一周就会过时。我们能说的是:anyrouter/free 可能路由到哪些模型,且上下文至少有 128K,因为 Claude Code 自己的提示词和工具列表会占掉小窗口的一大部分。下表在构建页面时从目录生成。
| 模型 | Id | 上下文 |
|---|---|---|
| Glyph Cluster | stealth/glyph-cluster | 256K |
| Step 5 Preview | stepfun/step-5-preview | 1M |
| Dots3-Note Preview | dots-studio/dots-3-note-preview | 512K |
| Inkling Small | thinkingmachines/inkling-small | 1M |
| LFM 2.5 2.6B | liquid/lfm-2.5-2.6b | 128K |
| Nemotron 3.5 Lightning 30B A3B | nvidia/nemotron-3.5-lightning-30b-a3b | 131K |
| Laguna S 2.1 | poolside/laguna-s-2.1 | 262K |
| Inkling | thinkingmachines/inkling | 1M |
| Laguna XS 2.1 | poolside/laguna-xs-2.1 | 262K |
| DeepSeek-V4-Flash | deepseek/deepseek-v4-flash | 128K |
| Qwen3-8B | qwen/qwen3-8b | 128K |
| Nemotron-3 Super 120B | nvidia/nemotron-3-super-120b-a12b | 262K |
| Nemotron 3 Ultra 550B | nvidia/nemotron-3-ultra-550b-a55b | 1M |
| Gemma 4 31B | google/gemma-4-31b | 262K |
| GPT-OSS 20B | openai/gpt-oss-20b | 131K |
把任意 id 传给 --model 即可固定该模型。完整的最新列表在 /free。如果只想看支持 Claude Code 所用 Messages API 的模型,可以筛选模型列表。
限制,直说
- 费用:免费模型每个 token 计费 $0,不动用你的额度余额。付费模型在你添加额度或套餐之前会返回
402。 - 速率:没有每日上限。所有套餐的免费模型共享每个 API key 每分钟 2,400 次请求。
- 登录:不带 key 的请求会收到
401。注册是免费的。 - 质量:这些不是 Claude。复杂的多文件任务最容易让免费模型卡住或出错,所以像对待任何代理一样审查 diff。
- 可用性:免费容量来自上游供应商,会变化。
anyrouter/free会自动回退,但固定的模型可能繁忙或已下线。 - 设置:如果 Zero Data Retention 这类隐私设置排除了所有免费模型,你会收到
400 no_eligible_models。固定一个符合该设置的模型。 - 长任务:对于慢速模型,
export API_TIMEOUT_MS=3000000可以提高 Claude Code 的超时时间。anyr启动器已经设置了它。
确认生效
运行任意提示词,然后打开你的请求日志。这次调用会在流结束后几秒出现,包含作答的模型、token 数和费用。免费调用显示 $0。
从 OpenRouter 迁移?同样的两行替换适用于任何兼容 OpenAI 的客户端。参见 AnyRouter 对比 OpenRouter,有带来源的对比和迁移步骤。
在 Claude Code 里用免费模型:两行命令,不需要绑卡。
打开设置页面常见问题
相关文章
AnyRouter vs OpenRouter: a sourced comparison and migration guide
Fees, BYOK, free-model limits and plans for AnyRouter and OpenRouter, each OpenRouter figure linked to its source and dated. Plus the base URL and key swap to move over.
Claude Code on anyrouter.dev
Claude Code on anyrouter.dev. setup.sh then anyr claude. ANTHROPIC_BASE_URL=https://anyrouter.dev/api. Free has no monthly credits; Go is $2/mo ($2.63 charged) → $4.
BYOK: bring your own keys to every provider
Attach the OpenAI, Anthropic, Google, and 60+ other provider keys you already pay for, route them through one OpenAI-compatible URL at $0 markup, cap spend per key, and — if you donate idle quota to the shared pool — earn up to 8% back and unlock Go for free while a donated key stays active.