☰
Claude Code + OpenRouter :接入超多免费大模型,告别 Token 焦虑
2026/9/26 12:21:31 网站建设 项目流程

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开发商上下文窗口适用场景
1nvidia/nemotron-3-ultra-550b-a55b:freeNVIDIA1M深度推理、Agent 编排
2poolside/laguna-s-2.1:freePoolside262K软件工程、代码生成
3inclusionai/ling-3.0-flash-fin:freeinclusionAI262K金融分析、多步任务
4deepseek/deepseek-v4-flash-0731:freeDeepSeek1.05M编码、推理、Agent
5nvidia/nemotron-3.5-lightning:freeNVIDIA1M高吞吐 Agent 工作流
6dots-studio/dots-3-note-preview:freeDots Studio512K推理、多模态、长上下文
7inclusionai/ling-3.0-flash-vl:freeinclusionAI262K视觉感知、工具调用
8nex-agi/nex-n2.5-pro:freeNex AGI262K自主软件工程、GUI 自动化
9thinkingmachines/inkling:freeThinking Machines1.05M通用推理、多模态
10nvidia/nemotron-3-super-120b-a12b:freeNVIDIA262K多 Agent 应用、跨文档推理
11inclusionai/ling-3.0-flash-sante:freeinclusionAI262K医疗知识推理
12thinkingmachines/inkling-small:freeThinking Machines1.05M推理、编码、多语言对话
13cohere/north-mini-code:freeCohere256K代码生成、终端任务

以上模型均为 $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/api
  • ANTHROPIC_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命令使其生效。这是最省心的方式,适合不熟悉环境变量配置的开发者。


四、局限性

在实际使用中,需要注意以下局限:

  1. ANTHROPIC_API_KEY 必须设为空字符串而非 unset:若仅取消设置该变量,Claude Code 会尝试直接向 Anthropic 发起认证,导致 OpenRouter 路由失效,出现模型未找到错误。

  2. 模型路由需手动配置:Claude Code 默认按 Opus / Sonnet / Haiku 三档模型槽位工作,接入 OpenRouter 后需通过ANTHROPIC_DEFAULT_*_MODEL等变量手动指定目标模型,否则不会自动匹配免费模型。

  3. 原生集成仅保证支持 Anthropic 模型:OpenRouter 的 Anthropic Skin 端点专为 Anthropic 请求语义设计,非 Anthropic 系模型(如 GPT、Gemini)不在保证兼容范围内。

  4. 免费模型上下文窗口较小:部分免费模型仅提供 256K–262K 上下文,低于付费 Anthropic 模型的 1M 窗口,不适合处理超大型代码库的生产级会话。

  5. 免费层级有速率限制:未充值时每日仅 50 次请求,需充值 $10 后才能提升至每日 1,000 次,高频使用场景下可能触发限流。

  6. 部分免费模型会使用你的数据训练:例如 Poolside 的 Laguna 系列在免费使用时,可能会用你的输入和输出来训练改进其模型,涉及隐私敏感代码时需谨慎评估。

  7. 不读取 .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 官方文档与公开信息整理,模型列表与定价可能随时间变动,请以官方页面为准。转载请注明出处。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询