CC逆引きリファレンス

API コストの上限を設定したい

12. CI/CD・自動化

コマンド / 機能

--max-budget-usd

最大予算（print モードのみ）

概要

--max-budget-usd フラグで、一回の実行で使用するAPI費用の上限（ドル）を設定できます。上限に達すると実行が停止します。CI/CDでのコスト管理に有用です。

設定例

# 最大 $5 まで使用可能
claude -p --max-budget-usd 5.00 "大規模なコード解析をして"

# 最大 $0.50 の軽量タスク
claude -p --max-budget-usd 0.50 "このファイルを要約して"
公式ドキュメントを見る

こんな時に使う

  • 大規模な自動処理でコストが膨らまないようにしたい時
  • CI/CD パイプラインでコスト上限を設けたい時

使い方

  1. 1-p（print モード）と合わせて使用
  2. 2--max-budget-usd <金額> でドル単位の上限を指定
  3. 3上限超過時はエラーで停止

Tips

  • print モード（-p）専用
  • 上限に達した場合はエラーとして扱われる
  • --max-turns と組み合わせてコストと実行時間を両方制限できる

同じカテゴリの記事

非対話で実行したい
claude -p "query"
JSON 出力したい
claude -p --output-format json "query"
ストリーミング JSON 出力したい
--output-format stream-json
テキスト出力したい
--output-format text
ターン数を制限したい
claude -p --max-turns 3 "query"
パイプで入力したい
echo "query" | claude -p
前の記事
JSON Schema に合致した構造化出力を得たい
次の記事
セッションをディスクに保存させたくない