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日の上限付きのキーを渡す」です。