Claude Code + OpenRouter :接入超多免费大模型,告别 Token 焦虑
一句话速览:Claude Code 是 Anthropic 官方的命令行编程智能体,通过 OpenRouter 的 Anthropic Skin 端点接入,只需 4 个环境变量即可调用 13 款免费大模型,无需本地代理、无需 Anthropic 订阅,Token 焦虑一扫而空。
目录
- 一、背景:Claude Code 是什么
- 二、免费模型总览
- 三、免费使用指南
- 3.1 方案一:环境变量配置(推荐)
- 3.2 方案二:对话式无脑接入(最简单)
- 四、局限性
- 五、总结
- 六、参考链接
一、背景:Claude Code 是什么
Claude Code 是 Anthropic 官方推出的命令行(CLI)编程智能体。它能够跨多个文件读取上下文、规划差异(diff)、并自动执行代码重构、Bug 修复、功能开发等任务。作为终端原生的 AI 编程助手,Claude Code 深度集成于开发者的日常工作流中。
它的核心能力包括:跨文件上下文理解、多步任务规划与执行、原生工具调用(文件读写、终端命令、搜索等)、流式输出与多轮对话状态保持。你只需在终端中用自然语言描述需求,Claude Code 便会自主分析代码库并完成修改。
然而,直接调用 Anthropic API 会面临速率限制和高昂的 Token 费用问题。OpenRouter作为一个统一的 API 路由层,横跨 70+ 模型供应商,提供了故障转移、预算控制和用量可视等能力。将 Claude Code 接入 OpenRouter,即可在保持原生协议不变的前提下,切换到众多免费模型,实现零成本编码体验。
查询日期:2026 年 9 月 23 日
二、免费模型总览
OpenRouter 目前提供多款 $0 定价的免费模型,覆盖通用对话、代码生成、多模态、金融、医疗等场景。以下为 13 款热门免费模型总览(按 OpenRouter 平台使用量排序):
| 序号 | 模型 ID | 开发商 | 上下文窗口 | 适用场景 |
|---|---|---|---|---|
| 1 | nvidia/nemotron-3-ultra-550b-a55b:free | NVIDIA | 1M | 深度推理、Agent 编排 |
| 2 | poolside/laguna-s-2.1:free | Poolside | 262K | 软件工程、代码生成 |
| 3 | inclusionai/ling-3.0-flash-fin:free | inclusionAI | 262K | 金融分析、多步任务 |
| 4 | deepseek/deepseek-v4-flash-0731:free | DeepSeek | 1.05M | 编码、推理、Agent |
| 5 | nvidia/nemotron-3.5-lightning:free | NVIDIA | 1M | 高吞吐 Agent 工作流 |
| 6 | dots-studio/dots-3-note-preview:free | Dots Studio | 512K | 推理、多模态、长上下文 |
| 7 | inclusionai/ling-3.0-flash-vl:free | inclusionAI | 262K | 视觉感知、工具调用 |
| 8 | nex-agi/nex-n2.5-pro:free | Nex AGI | 262K | 自主软件工程、GUI 自动化 |
| 9 | thinkingmachines/inkling:free | Thinking Machines | 1.05M | 通用推理、多模态 |
| 10 | nvidia/nemotron-3-super-120b-a12b:free | NVIDIA | 262K | 多 Agent 应用、跨文档推理 |
| 11 | inclusionai/ling-3.0-flash-sante:free | inclusionAI | 262K | 医疗知识推理 |
| 12 | thinkingmachines/inkling-small:free | Thinking Machines | 1.05M | 推理、编码、多语言对话 |
| 13 | cohere/north-mini-code:free | Cohere | 256K | 代码生成、终端任务 |
以上模型均为 $0 输入 / $0 输出定价。免费模型每日限制 50 次请求,充值 $10 后提升至每日 1,000 次。
三、免费使用指南
OpenRouter 暴露了一个与 Anthropic Messages API 兼容的端点(称为 Anthropic Skin)。Claude Code 直接以原生协议与 OpenRouter 通信,Thinking blocks、原生工具调用、流式输出与多轮上下文等高级功能均可正常工作,无需本地代理、无需 Docker、无需监听端口。以下提供两种接入方案。
3.1 方案一:环境变量配置(推荐)
只需设置 4 个环境变量,即可完成全部配置:
exportOPENROUTER_API_KEY="sk-or-v1-你的Key"exportANTHROPIC_BASE_URL="https://openrouter.ai/api"exportANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"exportANTHROPIC_API_KEY=""关键注意事项:
ANTHROPIC_BASE_URL必须是https://openrouter.ai/apiANTHROPIC_AUTH_TOKEN使用你的 OpenRouter API Key(以sk-or-开头)ANTHROPIC_API_KEY必须显式设为空字符串"",而非取消设置(unset),否则 Claude Code 会回退到直接向 Anthropic 认证,导致配置失效
如果之前用 Anthropic 账号登录过 Claude Code,请先运行一次
/logout并重启,否则缓存的登录信息会覆盖你的环境变量,出现model-not-found错误。
配置完成后,使用/status命令验证是否切换成功:
> /status Auth token: ANTHROPIC_AUTH_TOKEN Anthropic base URL: https://openrouter.ai/api看到以上输出即表示接入成功,请求也会在 OpenRouter 的 Activity 面板 中实时显示。
如需将模型路由到特定免费模型,可额外设置:
exportANTHROPIC_DEFAULT_SONNET_MODEL="deepseek/deepseek-v4-flash-0731:free"3.2 方案二:对话式无脑接入(最简单)
如果你不想手动编辑配置文件,可以直接在 Claude Code 对话中告诉它:
“帮我配置 OpenRouter 接入。我的 API Key 是 sk-or-v1-xxx,请设置好相关环境变量。”
Claude Code 会自动帮你写入~/.zshrc(或对应 shell 配置文件),设置好上述 4 个环境变量,并提示你重启终端或执行source命令使其生效。这是最省心的方式,适合不熟悉环境变量配置的开发者。
四、局限性
在实际使用中,需要注意以下局限:
ANTHROPIC_API_KEY 必须设为空字符串而非 unset:若仅取消设置该变量,Claude Code 会尝试直接向 Anthropic 发起认证,导致 OpenRouter 路由失效,出现模型未找到错误。
模型路由需手动配置:Claude Code 默认按 Opus / Sonnet / Haiku 三档模型槽位工作,接入 OpenRouter 后需通过
ANTHROPIC_DEFAULT_*_MODEL等变量手动指定目标模型,否则不会自动匹配免费模型。原生集成仅保证支持 Anthropic 模型:OpenRouter 的 Anthropic Skin 端点专为 Anthropic 请求语义设计,非 Anthropic 系模型(如 GPT、Gemini)不在保证兼容范围内。
免费模型上下文窗口较小:部分免费模型仅提供 256K–262K 上下文,低于付费 Anthropic 模型的 1M 窗口,不适合处理超大型代码库的生产级会话。
免费层级有速率限制:未充值时每日仅 50 次请求,需充值 $10 后才能提升至每日 1,000 次,高频使用场景下可能触发限流。
部分免费模型会使用你的数据训练:例如 Poolside 的 Laguna 系列在免费使用时,可能会用你的输入和输出来训练改进其模型,涉及隐私敏感代码时需谨慎评估。
不读取 .env 文件:原生安装的 Claude Code 不会读取项目根目录的
.env文件,需将变量写入 shell 配置文件或.claude/settings.local.json的env块中。
五、总结
Claude Code + OpenRouter 的组合,为开发者提供了一条零成本体验顶级 AI 编程助手的路径。只需 4 个环境变量,即可解锁 13 款免费大模型,无需 Anthropic 订阅、无需本地代理。
当某个供应商出现速率限制时,OpenRouter 还会自动将请求故障转移到服务于同一模型的另一供应商,保障长流程任务不断线。
| 项目 | 方案一(环境变量) | 方案二(对话式) |
|---|---|---|
| 难度 | 中(需编辑 shell 配置) | 低(对话即可) |
| 适用人群 | 熟悉终端操作的开发者 | 新手 / 快速体验 |
| 可靠性 | 高(直接写入配置文件) | 中(依赖 Claude Code 执行) |
| 推荐度 | ★★★★★ | ★★★★☆ |
快速开始:注册 OpenRouter → 获取 API Key → 设置 4 个环境变量 → 运行/logout→ 用/status验证 → 开始编码。
六、参考链接
- OpenRouter 官方教程:How to Use Claude Code with OpenRouter
- OpenRouter 模型列表:https://openrouter.ai/models
- 免费模型合集:https://openrouter.ai/collections/free-models
- OpenRouter API Key 管理页:https://openrouter.ai/settings/keys
本文最后更新于 2026 年 9 月 23 日。内容基于 OpenRouter 官方文档与公开信息整理,模型列表与定价可能随时间变动,请以官方页面为准。转载请注明出处。