如何在 OpenCode 和 Claude Code 中免费使用 ERNIE 5.5 Flash

手把手教你在 OpenCode 与 Claude Code 中通过 OpenRouter 免费接入百度 ERNIE 5.5 Flash Preview(1M 上下文),详解每日 50 次请求限额下的高效编码技巧。

用 Apifox,节省研发团队的每一分钟

如何在 OpenCode 和 Claude Code 中免费使用 ERNIE 5.5 Flash

免费使用 Apifox

相关推荐

最新文章

API

一体化协作平台

API 设计

API 文档

API 调试

自动化测试

API Mock

API Hub

立即体验 Apifox
目录

简要回答: 你可以通过 OpenRouter 的 baidu/ernie-5.5-flash-preview:free 端点,在 OpenCode 和 Claude Code 中免费运行 ERNIE 5.5 Flash。在 OpenCode 中,连接 OpenRouter 并将模型设置为 "model": "openrouter/baidu/ernie-5.5-flash-preview:free";在 Claude Code 中,将 ANTHROPIC_BASE_URL 指向 OpenRouter 并将该 ERNIE 模型 ID 固定为默认模型。每个 token 费用为 $0,但在未购买过额度的情况下每天限额 50 次请求。

对于编码 Agent 而言,这个每日限额至关重要。Agent 并不是每个任务只发一次请求,而是每执行一步都会发起一次请求。本文将介绍这两款 Agent 的配置方法,演示一个适合免费配额的编码任务,并说明免费路线在哪些情况下会受限。

下文列出的所有限额均于 2026 年 11 月 12 日核对自 OpenRouter 官方页面。

AI Coding 交流群

如果你也在用 AI 写代码,或者正在研究 Cursor、Claude Code 这些工具,欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流,还有各种新工具和新玩法。

AI Coding 交流群二维码

什么是 ERNIE 5.5 Flash Preview?

ERNIE 5.5 Flash Preview 是百度于 2026 年 11 月 10 日发布的对话与 Agent 模型。它采用稀疏混合专家(MoE)架构,总参数量为 280B,每个 token 激活参数量为 14B,拥有 1,024,000 token 的上下文窗口。百度将其定位于编码、Agent 任务和深度研究,OpenRouter 则将其列为支持推理(reasoning)和工具调用(tool calling)的模型。

ERNIE 5.5 Flash Preview 模型概览

此外,Hugging Face 上还有一个仅预训练的 ERNIE 5.5 Flash Base 模型,但那是供开发者自行微调或部署的基座版本;你的编码 Agent 实际调用的是 Preview 版本。如需了解完整的模型解析,请阅读什么是 ERNIE 5.5 Flash。如果你之前使用的是上一代模型,可以参考 ERNIE 5.1 概览了解具体变化。

OpenRouter 上 ERNIE 5.5 Flash 的免费限额

OpenRouter 的模型页面显示,:free 变体的输入和输出价格均为 $0,由单一提供商百度千帆(Baidu Qianfan)提供服务。速率限制来自 OpenRouter 的限额文档,适用于所有以 :free 结尾的模型 ID。

项目 数值(2026-11-12 核对)
模型 ID baidu/ernie-5.5-flash-preview:free
价格 输入 $0,输出 $0
上下文窗口 1,024,000 tokens
每分钟请求数 20
每日请求数(历史累计购买少于 10 额度) 50
每日请求数(历史累计购买 10 及以上额度) 1,000
后端提供商数量 1(百度千帆)

有两个细节对 Agent 尤为重要。OpenRouter 的定价页面指出,失败的请求尝试同样会扣减每日配额;此外,如果账户余额为负数,免费模型也会被拦截并返回 402 错误,直到充值恢复正余额为止。

OpenRouter 免费模型限额信息图:购买少于 10 额度时每天 50 次请求、每分钟 20 次;购买 10 及以上额度时每天 1,000 次、每分钟 20 次;Agent 循环中的每次模型调用均计为 1 次请求

每天 1,000 次请求的档位取决于你历史购买过的额度,而不是你实际消耗的额度。

在 OpenCode 中配置 ERNIE 5.5 Flash

OpenCode 原生支持 OpenRouter,因此在这两款工具中它的配置更简短。你需要准备一个 OpenRouter 账户,并从 OpenRouter 控制台获取 API 密钥。

  1. 安装或更新 OpenCode,然后在项目目录中启动:
cd your-project
opencode
  1. 连接 OpenRouter。在 OpenCode 中运行 /connect,选择 OpenRouter 并粘贴你的密钥。你也可以在启动前通过环境变量导出:
export OPENROUTER_API_KEY="sk-or-v1-..."
  1. 在项目根目录的 opencode.json 中固定模型。OpenCode 的提供商文档要求在 openrouter/ 前缀后填写完整的 OpenRouter 模型 ID:
{
  "$schema": "https://opencode.ai/config.json",
  "model": "openrouter/baidu/ernie-5.5-flash-preview:free"
}
  1. 运行 /models 确认模型选择。即使 ERNIE 没有出现在列表中,配置文件中的值依然生效,因此请仔细核对包含 :free 在内的模型标识拼写。

现在,每次提示词都会通过 OpenRouter 发送给 ERNIE 5.5 Flash Preview。如果你之前参考过我们的 GLM-5.3-Flash OpenCode 指南或 DeepSeek V4.1 Flash 指南,会发现配置模式完全一致,只需替换模型标识即可。

在 Claude Code 中配置 ERNIE 5.5 Flash

Claude Code 之所以能够连接 OpenRouter,是因为 OpenRouter 暴露了兼容 Anthropic 的 Messages 端点。ERNIE 模型页面已将 POST https://openrouter.ai/api/v1/messages 列为该模型支持的路由。

首先需要明确支持程度。OpenRouter 的 Claude Code 集成指南指出,通过 OpenRouter 使用 Claude Code“仅保证在使用 Anthropic 官方第一方提供商时正常工作”,并且 Claude Code“在搭配其他提供商时可能无法正常工作”。通过文档记载的设置可以在此运行 ERNIE,但这并非官方保证兼容的组合。

  1. 严格按照 OpenRouter 文档说明,在你的 shell 配置文件中设置连接变量:
export OPENROUTER_API_KEY="sk-or-v1-..."
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""   # 必须显式设为空字符串
  1. 将 Claude Code 使用的每个模型类别都固定为 ERNIE,避免某些步骤在后台静默回退到付费的 Anthropic 模型:
export ANTHROPIC_DEFAULT_OPUS_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_SONNET_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="baidu/ernie-5.5-flash-preview:free"

如果希望该配置仅对单个项目生效,也可以把相同的键值放进 .claude/settings.json 的 env 块中。

  1. 重新加载 shell,启动 claude 并运行 /status。你应该能看到 Auth token: ANTHROPIC_AUTH_TOKEN 和 Anthropic base URL: https://openrouter.ai/api。如果显示的是 ANTHROPIC_API_KEY 或 Claude 账户登录信息,说明环境变量没有传入当前会话。
  2. 打开 /model 确认各个类别均解析为 ERNIE,并在发送第一条提示词后前往 OpenRouter 活动面板检查模型列。
两条 Agent 路由示意图:OpenCode 使用 OPENROUTER_API_KEY,Claude Code 使用 ANTHROPIC_BASE_URL 连接 OpenRouter,再由 OpenRouter 将 baidu/ernie-5.5-flash-preview:free 请求转发至百度千帆

关于通用的 Claude Code 配置详情,可以参考如何结合 OpenRouter 使用 Claude Code。

适合 50 次请求限额的实战编码任务

每天只有 50 次请求时,不能让 Agent 漫无目的地探索。应当给它一个边界清晰、完成标准明确的任务。下面是一个在小型代码仓库中效果很好的提示词示例:

In src/routes/orders.ts, GET /orders/:id returns 500 when the order
doesn't exist. Make it return 404 with {"error":"order_not_found"}.
Read only the files you need, make the smallest change, then run
the orders tests with npm test and stop. Don't refactor anything else.

为什么这种提示词结构适合免费档位:

  • 直接点明文件名。 Agent 可以跳过全仓库搜索,从而省下好几次请求。
  • 明确定义修复预期。 状态码和响应体直接写在提示词里,无需来回确认。
  • 严格限制任务范围。 “运行测试后立即停止”可以及时结束循环,避免 Agent 继续做多余的代码润色。

这类任务通常只需要寥寥几次模型调用:读取路由文件、读取错误处理函数、修改代码、运行测试、汇报结果。而像“清理一下 orders 模块”这样模糊的提示词,可能在还没产出任何可用改动前就已经耗尽一整天的免费配额。

1M 上下文窗口是 ERNIE 适合 Agent 的另一个原因。你可以把长篇堆栈跟踪或整份 OpenAPI 文件一次性粘贴到单条提示词中,而不必拆分成多轮对话。在每次请求都弥足珍贵的情况下,一次大请求远比五次小请求更划算。

让 ERNIE 配合 Apifox CLI 运行你的 API 测试

当 Agent 修复某个接口后,你需要验证 API 的实际行为确实符合预期,而不仅仅是单元测试通过。Apifox CLI 可以让同一个 Agent 直接运行团队保存在 Apifox 中的测试场景、读取失败原因、修复代码并重新运行验证。你只需编写一条提示词,由 ERNIE 执行具体命令。

安装 CLI、登录并添加 Agent 技能:

npm install -g apifox-cli@latest
apifox auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apifox.com   # 按提示选择 OpenCode 或 Claude Code

然后向你的 Agent 发送一条提示词:

Run the "Orders API" test scenario in Apifox project <projectId> against
the local environment. If any step fails, find the endpoint in this repo
that causes it, fix it, and rerun the scenario until it passes.
Summarize what you changed.

Agent 会查找该测试场景,运行并输出可供解析的 JSON 报告,然后在修复代码后重新运行:

apifox test-scenario list --project <projectId>
apifox run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --out-dir ./apifox-reports
# Agent 修改失败的路由代码后执行:
apifox run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --upload-report

--upload-report 参数会将运行摘要上传到 Apifox,方便团队在客户端中查看。如果 Agent 需要对比历史结果,可以使用 apifox test-report list --project <projectId> 拉取过往运行记录。

不过请注意控制配额预算。每次运行测试、读取报告和修改代码都是一个 Agent 步骤,因此一次“修复并重跑”的循环很容易消耗 10 次模型请求。在每天 50 次请求的免费档位下,这个循环适合每天跑一两次,而不适合连续运行整个下午。其余参数用法可参考 Claude Code 中的 Apifox CLI 指南和 apifox run 命令参考。Apifox 免费版不限制成员数量和协作人数。

免费路线遇到问题时的排查方法

免费端点背后是由单一提供商承载的预览版模型。以下是常见问题、可能原因及解决方法:

现象 可能原因 解决方法
密集执行几步后返回 429 触发每分钟 20 次请求限制 放慢 Agent 速度或等待一分钟
当天剩余时间一直返回 429 已用完每日 50 次请求(失败尝试也计入) 等待 UTC 零点重置,或购买 10 额度提升至每天 1,000 次
调用免费模型返回 402 账户余额为负数 充值使账户余额恢复到零以上
Agent 在输出 JSON 时中断 结构化输出错误 改为要求输出纯文本,再自行解析
Claude Code 功能表现异常 Claude Code 后端接入了非 Anthropic 模型 改用 OpenCode 运行 ERNIE,或切回原模型

结构化输出这一行值得用数据说明。2026 年 11 月 12 日,OpenRouter 模型页面显示该端点的结构化输出错误率为 21.70%,而工具调用错误率仅为 1.01%。这意味着编码 Agent 依赖的工具调用表现健康,但严格的 JSON schema 表现不佳,因此建议让 Agent 工作流保持使用工具调用和纯文本输出。

实际速度也与官方宣传存在差距。百度描述称生成速度超过每秒 200 token,而当天 OpenRouter 在免费端点上测得的 P50 吞吐量为每秒 79 token。

最后,模型名称中带有“Preview”是有原因的。模型本身、速率限制以及 :free 变体随时可能调整而不另行通知。如果模型标识无法解析,请先检查 OpenRouter 页面,再去排查本地配置。如需付费或直接接入,可以参考 ERNIE 5.5 Flash API 指南了解百度千帆的接入方式。

常见问题

在 OpenCode 中使用 ERNIE 5.5 Flash 真的免费吗? 是的。OpenRouter 上的 baidu/ernie-5.5-flash-preview:free 端点对输入和输出 token 均收费 $0。除非你购买过至少 10 个 OpenRouter 额度,否则限制为每分钟 20 次请求、每天 50 次请求。

Claude Code 官方支持 ERNIE 5.5 Flash 吗? 官方并不直接支持。OpenRouter 提供了将 Claude Code 指向其他模型的配置文档,但也说明该方案仅在使用 Anthropic 第一方提供商时有保障。虽然可以运行,但在工具使用上可能会遇到一些小问题,运行 ERNIE 时选择 OpenCode 会更稳妥。

OpenRouter 上 ERNIE 5.5 Flash 的模型 ID 是什么? 免费变体的模型 ID 是 baidu/ernie-5.5-flash-preview:free。在 OpenCode 中使用时需加上 openrouter/ 前缀;在 Claude Code 中则原样填入 ANTHROPIC_DEFAULT_*_MODEL 环境变量。

每天 50 次请求能完成多少编码任务? 这取决于任务大小。一个范围明确的修复通常消耗 5 到 10 个 Agent 步骤,因此每天可以完成几个小任务;而开放式的重构可能会一次性耗尽全部配额。建议在提示词中明确指定文件名并定义好“完成标准”。

可以免费使用完整的 1M token 上下文吗? 可以。OpenRouter 为免费变体列出了 1,024,000 token 的上下文窗口,与完整版模型一致。超长提示词每次同样只计为 1 次请求,因此在每日请求次数受限的情况下,单次长上下文提示词非常高效。

除了 OpenRouter 还有其他免费方案吗? 我们的 ERNIE 5.5 Flash 免费指南对比了所有 $0 方案。百度还在 Hugging Face 上发布了 ERNIE 5.5 Flash Base 权重,你可以自行部署服务,详见使用 vLLM 在本地运行 ERNIE 5.5 Flash。