ユースケース

従量課金の API キーで使う Claude Code と Codex CLI

Claude Code、Codex CLI、Gemini CLI を 1 つのプリペイド API キーで実行。プロンプトキャッシュは有効なまま保たれ、開発者ごとの利用上限を設定でき、MCP 経由でデータツールも使えます。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
claude code$ export ANTHROPIC_BASE_URL=https://lovelyrouter.com$ export ANTHROPIC_AUTH_TOKEN=$LOVELY_API_KEY$ claude> Fix the flaky test in billing.test.ts ⏺ Read billing.test.ts · Grep "settle" ⏺ Edit src/billing.ts (+6 −2) cache read 41,280 tokens · write 1,212 ✓ npm test — 214 passed

Claude Code、Codex CLI、Gemini CLI を使用量に応じて支払い、開発者ごとにキーを分け、サブスクリプションなしで使いたい。変更する設定はベース URL とキーの 2 つだけで、それ以外はそのままです。プリペイド残高からトークン単位で支払います。各セッションがキャッシュを持つチャネルにとどまるため、プロンプトキャッシュは機能し続けます。さらに同じキーで、エージェントは MCP 経由で Web 検索、データツール、ブラウザを使えます。

01

仕組み

010203
  1. 開発者ごとにキーを作成する

    API キーで、メンバーや CI ジョブごとにキーを 1 つずつ作成し、利用上限を設定します。各キーの ツールで使う を開くと、CLI ごとのセットアップがキー入りで用意されています。

  2. エージェントの接続先をゲートウェイにする

    シェルまたはエージェントの設定ファイルで、ベース URL とキーを設定します。各 CLI は、それぞれが前提とする API(Anthropic、OpenAI、Gemini)で通信します。

  3. いつもどおりコードを書く

    各セッションは 1 つのチャネルに固定されるため、プロンプトキャッシュは有効なまま保たれます。ログでは、呼び出しごとのトークン数、キャッシュヒット、請求額をキー別に確認できます。

02

コーディングエージェントを設定する

Claude Code#

設定を export して起動します。セッションをまたいで設定を保つには、~/.claude/settings.json に記述します。

export ANTHROPIC_BASE_URL=https://lovelyrouter.com
export ANTHROPIC_AUTH_TOKEN=$LOVELY_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5.5
claude

ANTHROPIC_MODEL はメインのモデルで、ANTHROPIC_DEFAULT_HAIKU_MODEL はちょっとしたバックグラウンドタスクを担当します。claude-opus-5.5 など、Claude のモデル ID ならどれでも使えます。Claude Code ガイドと Claude API のページを参照してください。

Codex CLI#

Codex CLI は OpenAI Responses API を使います。Lovely Router をモデルプロバイダーとして追加し、env_key で指定したキーを export します。

~/.codex/config.toml
model = "gpt-6.1-sol"
model_provider = "lovely"

[model_providers.lovely]
name = "Lovely Router"
base_url = "https://lovelyrouter.com/v1"
env_key = "LOVELY_API_KEY"
wire_api = "responses"
Shell
export LOVELY_API_KEY="lr-..."
codex

GPT モデル(gpt-*)を使ってください。Responses API で提供しているのは GPT モデルです。現在の Codex は wire_api = "chat" を受け付けません。Codex CLI ガイドと GPT モデルを参照してください。

Gemini CLI#

Shell
export GOOGLE_GEMINI_BASE_URL=https://lovelyrouter.com
export GEMINI_API_KEY=$LOVELY_API_KEY
gemini -m gemini-3.1-pro
03

会話の固定が請求額を左右する理由

コーディングエージェントは、毎ターン会話全体を送り直します。システムプロンプト、ツール定義、それまでに読んだすべてのファイルです。プロンプトキャッシュがあれば、こうした入力トークンの大半はキャッシュ読み取りの価格、つまり通常の入力料金のごく一部で課金されます。ただし、キャッシュはそれを書き込んだチャネル上に存在します。ターンが別のチャネルに届くとキャッシュはなく、プレフィックス全体の料金を払い直すことになります。

ゲートウェイは、各会話を最初のターンを処理したチャネルにとどめます。

Claude Code

はセッションごとに x-claude-code-session-id ヘッダーを、Codex は prompt_cache_key を送ります。ゲートウェイはこれらを使って、1 つの会話に属するターンを識別します。

固定は最長 1 時間続き

、セッションがアクティブな間は更新されます。リクエストがないまま 30〜60 分経つと期限切れになります。

チャネルが混雑してもキャッシュは崩れません。

ターンは別のチャネルに移って新しいキャッシュ書き込みの料金を払う代わりに、固定先のチャネルを少しだけ待ちます(短いプロンプトなら約 1 秒、長いプロンプトなら最大 10 秒)。

ログでは、各呼び出しのキャッシュ済みトークン、キャッシュヒット率、アフィニティ(sticky、new、explicit)を確認できます。詳しくはプロンプトキャッシュを参照してください。

04

開発者ごとに、個別の制限付きのキーを

すべてのキーは 1 つの残高を使いますが、制限はキーごとに設定でき、キーの一覧で各キーの支出を確認できます。

制限内容
利用上限モデル、データツール、ブラウザエージェントを合わせて、そのキーが使える金額の上限です。月ごとの予算ではなく、累計の上限です。
1 分あたりのリクエスト数、最大同時リクエスト数暴走したループを抑えたり、1 人がほかのメンバーの枠を使い切るのを防いだりします。
モデルの許可リストこのキーで呼び出せるモデルを限定します。
有効期限その日を過ぎるとキーは使えなくなります。

利用上限に達したキーには This API key has reached its spend limit. とともに 402 が返され、レート制限や同時実行数の制限に達すると Retry-After ヘッダー付きの 429 が返されます。拒否されたリクエストは課金されません。API キーを参照してください。

05

コーディングエージェントに Web、データツール、ブラウザを

同じキーで MCP サーバーに接続できるため、エージェントは Web の検索、ドキュメントページの Markdown での読み取り、Google Maps・LinkedIn・Reddit からの構造化データの取得、複数ステップの操作でのブラウザ操作ができるようになります。

claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

調べものには Web 検索、1 ページの読み取りには Web フェッチ、ドキュメントのセクション全体には Web サイトのクロールを使います。ブラウザエージェントはクラウドで動作するため、扱えるのは公開サイトで、localhost は扱えません。

06

おすすめの構成

難しい作業は Opus、それ以外は Haiku。

ANTHROPIC_MODEL=claude-opus-5.5 を設定し、ANTHROPIC_DEFAULT_HAIKU_MODEL はバックグラウンドタスク用に小さなモデルのままにします。

業務委託先向けのキー。

有効期限、利用上限、モデルを 1 つだけにした許可リストを設定します。

CI で動くエージェント。

利用上限と 1 分あたりのリクエスト数の制限を付けた専用のキーを使えば、ループで請求額が膨らむことはありません。

コードを書く前に読む。

「この URL の変更履歴を読んで、それに合わせて SDK の呼び出しを更新して」 と頼みます。web_fetch を 1 回呼び出すだけで、エージェントはページを読めます。

07

支払う料金

モデルの呼び出しはトークン単位で課金されます。入力、出力、キャッシュ読み取り、キャッシュ書き込みのそれぞれに、モデルの 100 万トークンあたりの価格がかかります。エラーを返したリクエストは課金されません。データツールは結果ごと、ブラウザエージェントはステップごとに、同じ残高から課金されます。サブスクリプションも自動チャージもありません。$5 からチャージでき、チャージした額を超えて請求されることはありません。料金とモデル一覧を参照してください。

モデルコンテキスト入力出力キャッシュ読み取り
Claude Fable 5.1
claude-fable-5.1
1M$10.00$50.00$0.25
Claude Opus 5.5
claude-opus-5.5
1M$4.00$20.00$0.20
Claude Sonnet 5.5
claude-sonnet-5.5
1M$2.00$10.00$0.10
Claude Haiku 5.5
claude-haiku-5.5
1M$0.10$0.50$0.01
Claude Fable 5
claude-fable-5
1M$10.00$50.00$1.00
Claude Opus 5
claude-opus-5
1M$5.00$25.00$0.50
Claude Sonnet 5
claude-sonnet-5
1M$2.00$10.00$0.20
Claude Opus 4.8
claude-opus-4.8
1M$5.00$25.00$0.50
Claude Opus 4.7
claude-opus-4.7
1M$5.00$25.00$0.50
Claude Opus 4.6
claude-opus-4.6
1M$5.00$25.00$0.50
Claude Sonnet 4.6
claude-sonnet-4.6
1M$3.00$15.00$0.30
Claude Opus 4.5
claude-opus-4.5
200K$5.00$25.00$0.50
Claude Sonnet 4.5
claude-sonnet-4.5
1M$3.00$15.00$0.30
Claude Haiku 4.5
claude-haiku-4.5
200K$1.00$5.00$0.10

100 万トークンあたりの米ドル価格(カタログからリアルタイム表示)。

モデルコンテキスト入力出力キャッシュ読み取り
GPT-6 Astra
gpt-6-astra
1.05M$10.00$50.00$1.00
GPT-6.1 Sol
gpt-6.1-sol
1.05M$2.00$10.00$0.10
GPT-6 Sol
gpt-6-sol
1.05M$2.00$10.00$0.20
GPT-6.1 Terra
gpt-6.1-terra
1.05M$1.00$5.00$0.05
GPT-5.6 Sol
gpt-5.6-sol
400K$2.00$10.00$0.20
GPT-5.6 Terra
gpt-5.6-terra
400K$2.00$12.00$0.20
GPT-5.6 Luna
gpt-5.6-luna
400K$0.20$1.20$0.02

100 万トークンあたりの米ドル価格(カタログからリアルタイム表示)。

08

よくある質問

?
従量課金の API キーで Claude Code を使えますか?+

はい。ANTHROPIC_BASE_URL を https://lovelyrouter.com に、ANTHROPIC_AUTH_TOKEN を Lovely Router のキーに設定すれば、Claude Code はサブスクリプションなしで、プリペイド残高からトークン単位で課金されます。

Claude Code や Codex でプロンプトキャッシュは機能しますか?+

はい。cache_control や prompt_cache_key などのリクエストフィールドは変更されずに渡されます。ゲートウェイは、Claude Code が送るセッション ID や Codex が送る prompt_cache_key を使って、セッションのすべてのターンをキャッシュを持つチャネルにとどめます。

Codex CLI ではどのモデルを使えますか?+

GPT モデル(gpt-*)です。Codex は OpenAI Responses API を使い、この API で提供しているのが GPT モデルだからです。Codex CLI の設定では、プロバイダーに wire_api = "responses" を指定してください。

開発者ごとの支出を制限するにはどうすればよいですか?+

チームで Claude Code を使うなら、開発者ごとに利用上限付きの専用キーを渡し、必要に応じて 1 分あたりのリクエスト数の制限、モデルの許可リスト、有効期限も設定します。キーが上限に達すると、リクエストは 402 で失敗し、それ以上は課金されません。

Gemini CLI も使えますか?+

はい。GOOGLE_GEMINI_BASE_URL を https://lovelyrouter.com に、GEMINI_API_KEY をあなたのキーに設定し、gemini-3.1-pro などの Gemini モデルで起動してください。Gemini CLI ガイドと Gemini API のページを参照してください。

多数のエージェントを同時に動かすなら、高い同時実行性が求められる LLM アプリを参照してください。そのほかのクライアントと SDK は、すべてお使いのツールで使うで紹介しています。

モデル・データ・エージェントを 1 つのプリペイドキーで

サブスクリプションなし。チャージして必要な分だけ使い、すべての請求をログで確認できます。