1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Codeに「1日いくらまで」の上限をかける方法(API破産対策)

1
Last updated at Posted at 2026-11-19

Claude CodeをAPIキーで動かしていると、手元にはお金の使いすぎを止める仕組みがありません。夜中にAIが同じ処理をくり返し始めると、朝起きるまで止まりません。

自分は「1日いくらまで」で止まるようにしています。最悪でも「1,000円で止まっていた」で済み、「請求を見て青ざめる」にはなりません。そのやり方を書きます。

まず公式の設定

無料なので、先にやっておくのがおすすめです。

  • Anthropic Console:ワークスペースごとに月の上限を決められます。ただし1日ではなく1か月単位で、止まるまでに少し遅れがあり、上限を超えた例も報告されています。
  • OpenAI:組織やプロジェクトごとに「上限で止まる」設定があります(今年追加)。考え方は同じで、こちらもすぐには止まりません。
  • 自動チャージを切る:AIが使うアカウントでは切っておきます。

問題は、どれも「月単位」「ワークスペース単位」なことです。一晩で1か月分を使い切れてしまいますし、同じワークスペースのAI全部で1つの枠を分け合うことになります。

AIごとに1日の上限をかける

やり方は、AIに本物のAPIキーを渡さないことです。AIには中継(プロキシ)用の別のキーだけを渡し、本物のキーは中継側で持ちます。中継は、呼び出しのたびに予算を確認してから流します。

自分はAIの財布番(Saifuban)を使っています(自分で作ったもので、オープンソースです)。設定はターミナルで1行です。

npx https://github.com/ut181749ut/saifuban/archive/refs/heads/main.tar.gz

(WindowsのPowerShellでは npx を npx.cmd にしてください。Gitが入っていなくても動きます。)

1日の予算とAnthropicのAPIキーを聞かれて、最後に次の2行が出ます(Windowsでは $env:ANTHROPIC_BASE_URL=... というPowerShell用の書き方で出ます)。

export ANTHROPIC_BASE_URL="https://saifuban.saifuban-app.workers.dev/proxy/anthropic"
export ANTHROPIC_AUTH_TOKEN="sbk_..."

~/.claude/settings.json に書き込むか聞かれるので、Yにしておけば新しいターミナルでもずっと効きます。自分で設定するなら、Claude Codeを動かすシェルにこの2行を入れれば終わりです。Claude Codeの使い方は変わらず、中継を通るようになるだけです。

その日の予算を使い切ると、次の呼び出しはこんなメッセージで止まります。

[AIの財布番] この呼び出しは最大48円かかる可能性があり、1日の予算を超えます(残り12円)。11/20 00:00にリセットされます

Claude Codeはそこで止まり、くり返しを続けません(x-should-retry: false 付きの429を返すので、やり直しもしません)。

「呼び出しの前に」数えるのが大事

最初は、呼び出しが終わってから金額を数えていました。これだと、同時に何本も流したときや、やり直しが起きたときに抜けられます。上限の手前で10本同時に始まると、全部終わるまで気づけません。

今は、呼び出しを送る前に「かかりうる最大額」(入力の大きさ+max_tokens×モデルの単価)を予約し、終わったら実際の額に直しています。予約も予算に数えるので、同時に流しても上限を超えて通りません。max_tokensが指定されていない呼び出しには中継が上限を書き込むので、予約より長く書かれることもありません。

ほかに対応したこと:

  • 利用量が届く前に切れた応答は、0円ではなく予約額で記録
  • 同じ精算が再送されても二重に数えない
  • ウェブ検索の料金も数える(トークンではなく1回ごとにかかるため)
  • 何分もかかる長い応答も、途中で切れずに最後まで届く
  • 残りの予算がmax_tokens分に足りないときは、数千トークン書ける分が残っていれば、断らずにmax_tokensを縮めて通す
  • ほかの呼び出しが動いているせいで入らないだけなら、止めずに「少し待って」と返す

ややこしいケース(上限100円で2本同時、精算の遅れ・再送・取り消し)のテスト結果はここにまとめています。

ほかのツールでも

OpenAIのSDK、LangChain、CrewAI、Vercel AI SDKでも同じです。接続先のURLとキーを差し替えるだけで使えます。コード例はREADMEにあります。

一つだけ覚えて帰るなら、「AIには本物のキーではなく、1日の上限付きのキーを渡す」です。

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?