簡単にまとめると：OpenRouterの baidu/ernie-5.5-flash-preview:free エンドポイントを使えば、ERNIE 5.5 FlashをOpenCodeとClaude Codeで無料で利用できます。OpenCodeではOpenRouterに接続し、"model": "openrouter/baidu/ernie-5.5-flash-preview:free" を設定します。Claude Codeでは ANTHROPIC_BASE_URL をOpenRouterに向け、モデルとしてERNIEのスラッグを指定します。トークン単価は$0ですが、クレジットを購入していない場合は1日50リクエストまでという制限があります。
コーディングエージェントにとって、この1日あたりの上限こそが最大の課題です。エージェントはタスク1件につき1リクエストではなく、ステップ1つにつき1リクエストを消費します。このガイドでは両エージェントのセットアップ方法を解説し、無料枠に収まるコーディングタスクの例を示したうえで、無料ルートがどこで限界を迎えるかを説明します。
以下の制限はすべて、2026年11月12日時点でOpenRouterの公式ページで確認したものです。
ERNIE 5.5 Flash Previewとは？
ERNIE 5.5 Flash Previewは、2026年11月10日にリリースされたBaiduのチャット・エージェント向けモデルです。総パラメータ数2,800億、トークンごとに140億がアクティブになるスパースなMixture-of-Expertsモデルで、コンテキストウィンドウは1,024,000トークンです。Baiduはコーディング、エージェント作業、ディープリサーチ向けに位置づけており、OpenRouterでは推論有効・ツール呼び出し対応として掲載されています。
Hugging Faceには事前学習のみのERNIE 5.5 Flash Baseもありますが、こちらはファインチューニングや自己ホスティング用のものです。コーディングエージェントが接するのはPreviewの方です。モデルの詳細な解説については「what is ERNIE 5.5 Flash」を参照してください。前世代からの変化については「ERNIE 5.1 overview」が参考になります。
OpenRouterにおけるERNIE 5.5 Flash無料版の制限
OpenRouterのモデルページでは、:free 版は入力$0・出力$0で、プロバイダーはBaidu Qianfanの1社のみです。レート制限はOpenRouterの制限ドキュメントに基づき、:free で終わるすべてのモデルIDに適用されます。
| 項目 | 値（2026-11-12確認） |
|---|---|
| モデルID | baidu/ernie-5.5-flash-preview:free |
| 価格 | 入力$0、出力$0 |
| コンテキストウィンドウ | 1,024,000トークン |
| 1分あたりのリクエスト数 | 20 |
| 1日あたりのリクエスト数（累計購入クレジット10未満） | 50 |
| 1日あたりのリクエスト数（累計購入クレジット10以上） | 1,000 |
| 背後のプロバイダー数 | 1（Baidu Qianfan） |
エージェント利用において重要な点が2つあります。OpenRouterの価格ページによると、失敗したリクエストも1日の上限にカウントされます。また、クレジット残高がマイナスになると、チャージするまで無料モデルが 402 エラーでブロックされます。
1日1,000リクエストの枠は、消費したクレジットではなく、購入したクレジットに依存します。
OpenCodeでERNIE 5.5 Flashをセットアップする
OpenCodeはOpenRouterをネイティブにサポートしているため、こちらの設定の方が簡単です。OpenRouterのアカウントと、OpenRouterダッシュボードで発行したAPIキーが必要です。
- OpenCodeをインストールまたはアップデートし、プロジェクトフォルダで起動します：
cd your-project
opencode
- OpenRouterに接続します。OpenCode内で
/connectを実行し、OpenRouterを選んでキーを貼り付けます。起動前にエクスポートしておくこともできます：
export OPENROUTER_API_KEY="sk-or-v1-..."
- プロジェクトルートの
opencode.jsonでモデルを固定します。OpenCodeのプロバイダードキュメントでは、openrouter/プレフィックスの後に完全なOpenRouterモデルIDを指定するよう案内されています：
{
"$schema": "https://opencode.ai/config.json",
"model": "openrouter/baidu/ernie-5.5-flash-preview:free"
}
/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を実行することは、ドキュメント化された設定を通じて可能ですが、保証された組み合わせではありません。
- 接続用の変数をシェルプロファイルに、OpenRouterのドキュメントどおり正確に設定します：
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="" # must be explicitly empty
- 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"
設定を1つのプロジェクトに限定したい場合は、同じキーを .claude/settings.json の env ブロックに記述しても構いません。
- シェルを再読み込みし、
claudeを起動して/statusを実行します。Auth token: ANTHROPIC_AUTH_TOKENとAnthropic base URL: https://openrouter.ai/apiが表示されるはずです。ANTHROPIC_API_KEYやClaudeアカウントログインと表示された場合は、変数がセッションに反映されていません。 /modelを開いて各クラスがERNIEに解決されていることを確認し、最初のプロンプト送信後にOpenRouterのアクティビティダッシュボードでモデル列をチェックしてください。
一般的なClaude Codeのセットアップについては、「how to use Claude Code with OpenRouter」でより詳しく解説しています。
50リクエストに収まる現実的なコーディングタスク
1日50リクエストでは、エージェントに自由に探索させるわけにはいきません。「完了」がどのような状態かをこちらで把握している、範囲を限定したタスクを与えましょう。小規模なリポジトリでうまく機能する例を以下に示します：
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.
この形が無料枠でうまく機能する理由：
- ファイル名を指定している。エージェントはリポジトリ全体の検索を省略でき、複数のリクエストを節約できます。
- 修正内容が定義されている。ステータスコードとレスポンスボディがプロンプトに含まれるため、やり取りが発生しません。
- スコープが制限されている。「テスト実行後に停止」という指示でループが終了し、エージェントが仕上げに迷走することを防ぎます。
この種のタスクは、通常は少数のモデル呼び出しで済みます：ルートを読む、エラーハンドラを読む、編集する、テストを実行する、報告する。「ordersモジュールをきれいにして」といった曖昧なプロンプトは、何も成果が出る前に1日分のクォータを消費しかねません。
100万トークンのコンテキストウィンドウも、ERNIEがエージェントに向いているもう一つの理由です。長いスタックトレースやOpenAPIファイル全体をターンを分けずに1つのプロンプトに貼り付けることができます。すべてのリクエストが貴重な状況では、小さいリクエスト5回より大きいリクエスト1回の方が効率的です。
Apidog CLIでERNIEにAPIテストを実行させる
エージェントがエンドポイントを修正したら、ユニットテストが通っただけでなく、APIが期待どおり動作していることの証明が欲しいはずです。Apidog CLIを使えば、同じエージェントがチームがApidogに保持しているテストシナリオを実行し、失敗を読み取り、コードを修正して再実行できます。あなたはプロンプトを1つ書くだけ。コマンドを実行するのはERNIEです。
CLIをインストールし、ログインしてエージェントスキルを追加します：
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick OpenCode or Claude Code when prompted
そしてエージェントに次のプロンプトを1つ与えます：
Run the "Orders API" test scenario in Apidog 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.
エージェントはシナリオを検索し、パース可能なJSONレポート付きで実行し、修正後に再実行します：
apidog test-scenario list --project <projectId>
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --out-dir ./apidog-reports
# agent edits the failing route, then:
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --upload-report
--upload-report フラグを付けると、実行サマリーがApidogに送信され、チームがアプリ内で確認できます。過去の実行と比較する必要がある場合は、apidog test-report list --project <projectId> で取得できます。
ただし、消費量には注意が必要です。テスト実行、レポートの読み取り、コード編集のそれぞれがエージェントの1ステップなので、修正と再実行のループでは簡単に10リクエスト以上消費します。1日50リクエストの枠では、このループは午後ずっと回すのではなく、1〜2回に留めましょう。その他のフラグについては「Apidog CLI in Claude Codeガイド」と「apidog run コマンドリファレンス」を参照してください。ApidogのFreeプランは最大4ユーザーのチームまで利用できます。
無料ルートが破綻するケース
無料エンドポイントは、単一プロバイダーの背後にあるプレビューモデルです。想定される問題と対処法を紹介します。
| 症状 | 考えられる原因 | 対処法 |
|---|---|---|
ステップを連続実行した直後に 429 |
1分あたり20リクエスト制限 | エージェントを遅らせるか、1分待つ |
その日ずっと 429 |
1日50リクエストを消費（失敗もカウント） | UTCでのリセットを待つか、10クレジット購入して1日1,000リクエストにする |
無料モデルで 402 |
アカウント残高がマイナス | クレジットを追加して残高をプラスに戻す |
| エージェントがJSON出力で失敗 | 構造化出力のエラー | プレーンテキストを要求し、自分でパースする |
| Claude Codeの機能が不調 | Claude Codeの背後に非Anthropicモデル | ERNIEにはOpenCodeを使うか、モデルを戻す |
構造化出力の行には数字が欠かせません。2026年11月12日時点で、OpenRouterのモデルページはこのエンドポイントの構造化出力エラー率を21.70%、ツール呼び出しエラー率を1.01%と表示していました。コーディングエージェントが依存するツール呼び出しは健全に見えますが、厳密なJSONスキーマはそうではありません。エージェントのワークフローはツールとプレーンテキストに絞るのが賢明です。
速度もスペック通りの数値とは異なります。Baiduの説明では毎秒200トークン超を謳っていますが、OpenRouterがその日に無料エンドポイントで計測したP50は毎秒79トークンでした。
最後に、名前に「Preview」と付いているのには理由があります。モデル、その制限、:free 版は予告なく変更される可能性があります。スラッグが解決できなくなった場合は、設定のデバッグの前にOpenRouterのページを確認してください。有料版や直接アクセスについては、Baidu Qianfanを解説した「ERNIE 5.5 Flash APIガイド」を参照してください。
FAQ
OpenCodeでERNIE 5.5 Flashは本当に無料ですか？ はい。baidu/ernie-5.5-flash-preview:free エンドポイントは、OpenRouter上で入出力トークンともに$0です。ただし、OpenRouterクレジットを10以上購入していない限り、1分あたり20リクエスト、1日あたり50リクエストの制限があります。
Claude CodeはERNIE 5.5 Flashを公式にサポートしていますか？ 公式にはサポートしていません。OpenRouterはClaude Codeを他のモデルに向ける方法をドキュメント化していますが、その設定が保証されるのはAnthropicファーストパーティプロバイダーの場合のみとしています。動作はしますが、ツール周りで粗い部分が出ることを想定してください。ERNIEにはOpenCodeの方が安全な選択です。
OpenRouterにおけるERNIE 5.5 FlashのモデルIDは？ 無料版は baidu/ernie-5.5-flash-preview:free です。OpenCodeでは openrouter/ をプレフィックスとして付けます。Claude Codeでは ANTHROPIC_DEFAULT_*_MODEL 変数にそのまま指定します。
1日50リクエストでどれくらいのコーディングタスクを完了できますか？ タスクによります。範囲を絞った修正なら5〜10ステップ程度なので、いくつかのタスクがこなせます。オープンエンドなリファクタリングは1回で全クォータを使い切る可能性があります。プロンプトではファイル名を指定し、「完了」を明確に定義しましょう。
100万トークンのコンテキストを無料で使えますか？ OpenRouterは無料版にもモデルのフルウィンドウと同じ1,024,000トークンのコンテキストウィンドウを表示しています。大きなプロンプトもそれぞれ1リクエストとしてカウントされるため、長いコンテキストのプロンプトは1日の上限に対して効率的です。
OpenRouterを使わない無料の選択肢はありますか？ 「ERNIE 5.5 Flash無料ガイド」ですべての$0ルートを比較しています。また、BaiduはHugging FaceでERNIE 5.5 Flash Baseを公開しており、自己ホスティングも可能です。詳細は「running ERNIE 5.5 Flash locally with vLLM」を参照してください。