コストを効果的に管理する
トークン使用量を追跡し、チームの支出制限を設定し、コンテキスト管理、モデル選択、拡張思考設定、前処理フックを使用して Claude Code のコストを削減します。
Claude Code は API トークン消費によって課金されます。サブスクリプションプラン価格（Pro、Max、Team、Enterprise）については、claude.com/pricing を参照してください。開発者あたりのコストは、モデル選択、コードベースサイズ、複数インスタンスの実行や自動化などの使用パターンに基づいて大きく異なります。
エンタープライズ展開全体では、平均コストは開発者 1 人あたり 1 日約 13 ドル、開発者 1 人あたり月額 150～250 ドルで、90% のユーザーの 1 日あたりのコストは 30 ドル以下です。自分のチームの支出を見積もるには、小規模なパイロットグループから始めて、以下の追跡ツールを使用してベースラインを確立してから、より広い展開を行ってください。
このページでは、コストを追跡する方法、チームのコストを管理する方法、および トークン使用量を削減する方法 について説明します。
コストを追跡する
`/usage` コマンドを使用する
/usage の上部のセッションブロックは、現在のセッションの詳細なトークン使用統計を表示します。ドル数値はトークン数から局所的に計算された推定値であり、実際の請求書と異なる場合があります。権限のある請求については、Claude Console の使用量ページを参照してください。
Total cost: $0.55
Total duration (API): 6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes: 0 lines added, 0 lines removed
Pro、Max、Team、または Enterprise プランでは、/usage はプラン制限に対してカウントされるものの内訳も表示します。最近の使用量をスキル、サブエージェント、プラグイン、および個別の MCP サーバーに属性付けし、それぞれが合計のパーセンテージとして表示されます。d または w を押して、過去 24 時間と過去 7 日間を切り替えることができます。数値は概算であり、このマシン上のローカルセッション履歴から計算されるため、他のデバイスまたは claude.ai からの使用量は含まれていません。
プラン制限のリクエストが失敗した場合（ほとんどの場合、使用量エンドポイントがレート制限されているため）、/usage は過去 60 分以内にこのマシンで読み込んだ最後の使用量バーを表示し、そのデータがいつ取得されたかを示す Showing last-known usage ノートが表示されます。r を押して再試行します。再試行が成功すると、最後に認識されたバーが新しいデータに置き換わります。過去 60 分以内のスナップショットがない場合、/usage は使用量エンドポイントがレート制限されていることを報告し、同じ再試行ショートカットを提供します。v2.1.208 より前では、使用量をまだ読み込んでいないセッションでレート制限されたリクエストは常にバーなしでエラーを表示していました。
VS Code 拡張機能 では、同じ内訳が Account & usage ダイアログに Day および Week トグルとともに表示されます。Claude Code v2.1.174 以降が必要です。
Pro および Max で支出制限を設定する
Pro および Max プランでは、/usage-credits コマンドを使用して CLI でダイアログを開き、使用量クレジット を管理できます。ダイアログから以下を実行できます。
- アカウントの使用量クレジットをオンにする
- より多くの使用量クレジットを購入する（リストされたバンドルまたはカスタム金額）
- 月間支出制限を設定、変更、または削除する
- オートリロードを設定する。これにより、残高が設定したしきい値を下回ると、自動的により多くの使用量クレジットが購入されます
Claude Code v2.1.207 より前のバージョンおよび CLI 内ダイアログが利用できないアカウントでは、/usage-credits はブラウザで使用量クレジット請求ページを開きます。Team および Enterprise プランでは、請求アクセス権を持つメンバーは同じブラウザページを取得し、請求アクセス権を持たないメンバーは CLI から使用量クレジットをオンにするか制限を引き上げるよう管理者に要求を送信します。
月間支出制限の変更にはアカウントの請求アクセスが必要です。制限に達しても使用量クレジットがまだ利用可能な場合、Claude Code は制限を引き上げるか削除するよう促し、CLI を離れることなく続行できます。
カスタム購入金額、月間支出制限、またはオートリロードしきい値とターゲットなど、ダイアログに入力する金額は、数字である必要があり、オプションでピリオドと 1 つまたは 2 つの小数点以下の数字が続きます。例えば 20 または 20.50 です。コンマを含むその他の入力は、インラインエラーを表示し、保存されません。v2.1.207 より前のバージョンはダイアログを表示せず、代わりに請求ページを開きます。
Claude Code は、金額に関係なく、すべての購入とすべてのオートリロード変更を確認するために yes を入力するよう求め、購入確認は承認する税後の合計を表示します。月間支出制限の変更は、$1,000 を超える場合、または米国ドル以外の請求通貨の 1,000 ユニットを超える場合にのみ、同じ入力確認を求めます。v2.1.208 より前では、購入とオートリロード変更はそのしきい値も使用していたため、より小さい金額は追加の入力 yes ステップなしで標準ダイアログフローを通過していました。
金額フィールドは提案値で事前に入力された状態で開き、入力する最初の数字は提案に追加するのではなく、提案を置き換えます。使用量クレジットをオンにする画面は Cancel が選択された状態で開くため、それらをオンにするには意図的な選択が必要です。どちらも Claude Code v2.1.208 以降が必要です。
組織のコストを管理する
Claude Code にアクセスする方法によって、利用可能なコントロールが異なります。Claude for Teams または Enterprise プラン、Claude Console、またはクラウドプロバイダーです。Teams および Enterprise プランでは、使用量は各メンバーのシート割り当てから引き出されます。Console およびクラウドプロバイダーでは、使用量はトークンごとに組織に請求されます。組織がサインイン方法を混在させている場合、各開発者は認証した方法に従ってメーター化されます。
次の表は、各セットアップを、支出を確認する場所、支出をキャップする場所、およびユーザーごとの数値を取得する方法にマップしています。
| セットアップ | 支出を確認 | 支出をキャップ | ユーザーごとのレポート |
|---|---|---|---|
| Claude for Teams または Enterprise | org analytics の支出レポート | 管理者設定の支出制限 | 支出レポート CSV、Enterprise の Enterprise Analytics API |
| Claude Console（API） | Console 使用状況ページ | ワークスペース支出制限 | Console ダッシュボード、Claude Code Analytics API |
| Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry | クラウド請求コンソール | クラウドの予算コントロール | OpenTelemetry または LLM gateway |
OpenTelemetry エクスポート はすべてのセットアップで機能し、ユーザーごとのトークンおよびコストメトリクスをほぼリアルタイムで独自の可観測性スタックにストリーミングする唯一のオプションです。
Claude for Teams および Enterprise
Claude for Teams および Enterprise プランでは、各メンバーの Claude Code 使用量は、ローリング 5 時間ウィンドウと週間ウィンドウでリセットされるシート単位の割り当てから引き出されます。割り当ては Claude チャットおよび Cowork と共有され、そのサイズはメンバーの シート層（Standard または Premium）に依存します。コントロールは Claude Console ではなく claude.ai 管理コンソールにあります。
- 支出を確認: org analytics の支出レポート は、ユーザーごとおよびモデルごとの推定支出を CSV エクスポート付きで表示し、毎日更新されます。レポートは使用クレジット支出をカバーし、使用クレジットがオンになると表示されます。シート割り当て内の使用量はドルでメーター化されません。
- 採用を確認: analytics ダッシュボード は、日次アクティブユーザー、セッション、および貢献メトリクスを表示し、貢献データの CSV エクスポート付きです。analytics でチーム使用状況を追跡 を参照してください。
- 支出をキャップ: シート割り当てはデフォルトの上限です。メンバーがそれを超えて続行できるようにするには、使用クレジット をオンにして、組織、グループ、または個別メンバーレベルで支出制限を設定します。
- ユーザーごとの数値を取得: Enterprise プランでは、Enterprise Analytics API は Claude Code を含む Claude サーフェス全体のユーザーごとの使用状況およびコストレポートを返します。Primary Owner は claude.ai/analytics/api-keys で
read:analyticsスコープを持つキーを作成します。Teams プランでは、支出レポート CSV をエクスポートします。これはユーザーごとおよびモデルごとのトークン使用量と推定支出をリストします。
Claude Enterprise 消費ガイド は管理者向けの計画リファレンスです。Claude チャット、Claude Code、および Cowork 全体で消費がどのように異なるかを説明し、予算編成のためのユーザーごとのドル開始点を提供します。コーディングシートのチャットシートより多くの予算を計上してください。各 Claude Code ターンはファイルコンテンツ、ツール呼び出し、および多段階推論を含むため、1 つのデバッグセッションはチャットの 1 日分以上を消費できます。
Claude Console
API 組織は ワークスペース を通じて Claude Code 支出を管理します。ワークスペース支出制限を設定 して Claude Code 支出の合計をキャップし、Console で コストと使用状況レポートを表示 できます。
ユーザーごとのレポートについては、Console ダッシュボード はメンバーごとの支出と受け入れられた行を表示し、Claude Code Analytics API は Admin API キー を使用してプログラムで同じ日次ユーザーごとのメトリクスを返します。API カスタマー向けの analytics を参照してください。
レート制限の推奨事項
チーム向けに Claude Code を設定する場合、組織のサイズに基づいて、これらのユーザーあたりのトークン/分（TPM）およびリクエスト/分（RPM）の推奨事項を検討してください。
| チームサイズ | ユーザーあたり TPM | ユーザーあたり RPM |
|---|---|---|
| 1～5 ユーザー | 200k～300k | 5～7 |
| 5～20 ユーザー | 100k～150k | 2.5～3.5 |
| 20～50 ユーザー | 50k～75k | 1.25～1.75 |
| 50～100 ユーザー | 25k～35k | 0.62～0.87 |
| 100～500 ユーザー | 15k～20k | 0.37～0.47 |
| 500 ユーザー以上 | 10k～15k | 0.25～0.35 |
たとえば、200 ユーザーがいる場合、各ユーザーに 20k TPM をリクエストするか、合計 400 万 TPM（200*20,000 = 400 万）をリクエストできます。
チームサイズが大きくなるにつれて、ユーザーあたりの TPM は減少します。これは、より大きな組織では Claude Code を同時に使用するユーザーが少ない傾向があるためです。これらのレート制限は個別ユーザーレベルではなく組織レベルで適用されます。つまり、他のユーザーが積極的にサービスを使用していない場合、個別ユーザーは計算された共有量を一時的に超えて消費できます。
クラウドプロバイダー
Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry では、Claude Code はトークンごとにクラウドアカウントに請求され、支出コントロールはクラウドプロバイダーの請求コンソールにあります。Claude Code はクラウドからメトリクスを Anthropic に送信しないため、analytics ダッシュボード および Claude Code Analytics API はこの使用量をカバーしません。
ユーザーごとのコスト帰属については、3 つのオプションがあります。
- OpenTelemetry: 各開発者のマシンから メトリクスをエクスポート して、独自の可観測性スタックに送信します。これにより、プロバイダーに関係なく、ユーザーごとのトークンカウント、コスト、およびツールアクティビティが得られます。
- Claude apps gateway: セルフホストされた Claude apps gateway は、ユーザーごとの使用状況帰属、トークンカウント付きの OTLP メトリクス、およびこれらのプロバイダーの ユーザーごとの支出制限 を提供します。
- LLM gateway: すべての Claude Code トラフィックをキーごとに支出を追跡するプロキシを通じてルーティングします。複数の大規模企業は LiteLLM を使用していると報告しており、これはオープンソースツールで キーごとに支出を追跡 します。このプロジェクトは Anthropic と提携していないため、セキュリティについて監査されていません。
開発者が制限について質問する場合
開発者は通常、制限に関する質問を管理者に持ち込むため、どの上限に達したかを知ることが役立ちます。3 つの状況は異なることを意味します。
- 「セッション制限に達しました」または「週間制限に達しました」: サブスクリプションプランのシートベースの使用ウィンドウ。これらのウィンドウはすべてのモデル全体で共有されるため、
/modelでモデルを切り替えてもアクセスは復元されませんが、モデル固有の「Opus 制限に達しました」メッセージの後、開発者は作業を続けることができます。メッセージはウィンドウがリセットされるときを表示し、開発者は 使用クレジット がオンになっている場合、/usage-creditsを実行して割り当てを超えた使用をリクエストできます。使用制限エラー を参照してください。 - コンテキストまたは auto-compact 警告: 使用制限ではありません。会話がモデルの最大入力サイズに近づいており、Claude Code は古い履歴を要約して領域を解放します。開発者を トークン使用量を削減 に指してください。
- API またはクラウドプロバイダープランで予期しない高い支出: 通常、クリアされたことのない長いセッション、または Opus がデフォルトモデルとして残されていることに遡ります。共有する最も影響の大きい習慣は、関連のないタスク間でクリアすることとジョブにモデルを一致させることの両方で、トークン使用量を削減 でカバーされています。
エージェントチームのトークンコスト
エージェントチーム は複数の Claude Code インスタンスを生成し、各インスタンスは独自のコンテキストウィンドウを持ちます。トークン使用量はアクティブなチームメイトの数と各チームメイトが実行される期間に応じてスケーリングされます。
エージェントチームのコストを管理可能に保つには、以下を実行してください。
- チームメイトに Sonnet を使用します。これは調整タスクの機能とコストのバランスを取ります。
- チームを小さく保ちます。各チームメイトは独自のコンテキストウィンドウを実行するため、トークン使用量はおおよそチームサイズに比例します。
- スポーンプロンプトを焦点を絞ったものにします。チームメイトは CLAUDE.md、MCP サーバー、およびスキルを自動的に読み込みますが、スポーンプロンプト内のすべてが最初からコンテキストに追加されます。
- 作業が完了したらチームをシャットダウンします。アクティブなチームメイトはアイドル状態でもトークンを消費し続けます。
- エージェントチームはデフォルトで無効になっています。settings.json または環境で
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1を設定して有効にします。エージェントチームを有効にする を参照してください。
トークン使用量を削減する
トークンコストはコンテキストサイズに応じてスケーリングされます。Claude が処理するコンテキストが多いほど、より多くのトークンを使用します。Claude Code は プロンプトキャッシング（システムプロンプトなどの繰り返されるコンテンツのコストを削減）と自動コンパクション（コンテキスト制限に近づくと会話履歴を要約）を通じてコストを自動的に最適化します。
以下の戦略は、コンテキストを小さく保ち、メッセージあたりのコストを削減するのに役立ちます。
コンテキストを積極的に管理する
/usage を使用して現在のトークン使用量を確認するか、ステータスラインを設定 してそれを継続的に表示します。
- タスク間でクリアする: 関連のない作業に切り替える場合は
/clearを使用して新しく開始します。古いコンテキストは後続のすべてのメッセージでトークンを浪費します。クリアする前に/renameを使用してセッションに名前を付けると、後で簡単に見つけることができます。その後、/resumeを使用して戻ります。 - カスタムコンパクション指示を追加する:
/compact Focus on code samples and API usageは、要約中に保持する内容を Claude に指示します。
プロジェクトのルートにある CLAUDE.md ファイルでコンパクション動作をカスタマイズすることもできます。
# Compact instructions
When you are using compact, please focus on test output and code changes
適切なモデルを選択する
Sonnet はほとんどのコーディングタスクをうまく処理し、Opus よりもコストが低くなります。複雑なアーキテクチャの決定または複数ステップの推論のために Opus を予約します。/model を使用してセッション中にモデルを切り替えるか、/config でデフォルトを設定します。単純な subagent タスクの場合、subagent 設定 で model: haiku を指定します。
MCP サーバーのオーバーヘッドを削減する
MCP ツール定義は デフォルトで遅延 されるため、Claude が特定のツールを使用するまで、ツール名のみがコンテキストに入ります。/context を実行して、何がスペースを消費しているかを確認します。
- 利用可能な場合は CLI ツールを優先する:
gh、aws、gcloud、sentry-cliなどのツールは、ツールごとのリストを追加しないため、MCP サーバーよりもコンテキスト効率が高くなります。Claude はオーバーヘッドなしで CLI コマンドを直接実行できます。 - 未使用のサーバーを無効にする:
/mcpを実行して設定されたサーバーを確認し、積極的に使用していないサーバーを無効にします。
型付き言語用のコードインテリジェンスプラグインをインストールする
コードインテリジェンスプラグイン は Claude にテキストベースの検索の代わりに正確なシンボルナビゲーションを提供し、不慣れなコードを探索する際の不要なファイル読み取りを削減します。単一の「定義に移動」呼び出しは、grep の後に複数の候補ファイルを読み取る必要があるものを置き換えます。インストールされた言語サーバーは編集後に型エラーを自動的に報告するため、Claude はコンパイラを実行せずにエラーをキャッチします。
フックとスキルに処理をオフロードする
カスタム フック は Claude がそれを見る前にデータを前処理できます。Claude が 10,000 行のログファイルを読んでエラーを見つける代わりに、フックは ERROR に対して grep を実行し、一致する行のみを返すことができ、コンテキストを数万トークンから数百に削減します。
スキル は Claude にドメイン知識を与えることができるため、探索する必要がありません。たとえば、「codebase-overview」スキルはプロジェクトのアーキテクチャ、主要なディレクトリ、および命名規則を説明できます。Claude がスキルを呼び出すと、構造を理解するために複数のファイルを読むトークンを費やす代わりに、このコンテキストが即座に取得されます。
たとえば、この PreToolUse フックはテスト出力をフィルタリングして失敗のみを表示します。
これを settings.json に追加して、すべての Bash コマンドの前にフックを実行します。
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/filter-test-output.sh"
}
]
}
]
}
}
フックはこのスクリプトを呼び出します。mkdir -p ~/.claude/hooks でフォルダを作成し、以下のスクリプトを ~/.claude/hooks/filter-test-output.sh として保存し、chmod +x ~/.claude/hooks/filter-test-output.sh で実行可能にします。コマンドがテストランナーであるかどうかを確認し、失敗のみを表示するように変更します。
#!/bin/bash
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')
# If running tests, filter to show only failures
if [[ "$cmd" =~ ^(npm test|pytest|go test) ]]; then
filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"updatedInput\":{\"command\":\"$filtered_cmd\"}}}"
else
echo "{}"
fi
CLAUDE.md からスキルに指示を移動する
CLAUDE.md ファイルはセッション開始時にコンテキストに読み込まれます。PR レビューやデータベース移行などの特定のワークフロー用の詳細な指示が含まれている場合、関連のない作業を行っている場合でもそれらのトークンが存在します。スキル はオンデマンドでのみ呼び出されたときに読み込まれるため、特殊な指示をスキルに移動することで、ベースコンテキストを小さく保ちます。CLAUDE.md を 200 行以下に保つことを目指し、必須のみを含めます。
拡張思考を調整する
拡張思考はデフォルトで有効になっています。これは複雑な計画と推論タスクのパフォーマンスを大幅に向上させるためです。思考トークンは出力トークンとして課金され、デフォルト予算はモデルに応じて数万トークンになる場合があります。深い推論が必要ない単純なタスクの場合、/effort で 努力レベル を低下させるか、/model で、/config で思考を無効にするか、固定思考予算 を持つモデルで、MAX_THINKING_TOKENS=8000 などの MAX_THINKING_TOKENS 環境変数 を設定して予算を低下させることでコストを削減できます。適応推論モデルはゼロ以外の予算を無視するため、代わりに努力レベルを使用します。Fable 5 では思考を無効にすることはできません。これは常に拡張思考を使用します。
詳細な操作を subagent に委任する
テストの実行、ドキュメントの取得、またはログファイルの処理は、かなりのコンテキストを消費できます。これらを subagent に委任して、詳細な出力が subagent のコンテキストに留まり、メインの会話に戻るのはサマリーのみです。
エージェントチームのコストを管理する
エージェントチームは、チームメイトがプランモードで実行される場合、標準セッションよりも約 7 倍多くのトークンを使用します。これは、各チームメイトが独自のコンテキストウィンドウを維持し、別の Claude インスタンスとして実行されるためです。チームメイトあたりのトークン使用量を制限するために、チームタスクを小さく自己完結させておきます。詳細については、エージェントチーム を参照してください。
具体的なプロンプトを作成する
「このコードベースを改善する」のような曖昧なリクエストは、広範なスキャンをトリガーします。「auth.ts のログイン関数に入力検証を追加する」のような具体的なリクエストにより、Claude は最小限のファイル読み取りで効率的に作業できます。
複雑なタスクで効率的に作業する
より長いまたはより複雑な作業の場合、これらの習慣は間違った方向に進むことからの無駄なトークンを回避するのに役立ちます。
- 複雑なタスクにはプランモードを使用する: Shift+Tab を押して、実装の前に プランモード に入ります。Claude はコードベースを探索し、承認のためのアプローチを提案し、初期方向が間違っている場合の高価な再作業を防ぎます。
- 早期に方向を修正する: Claude が間違った方向に向かい始めた場合は、Escape を押して直ちに停止します。
/rewindを使用するか、Escape をダブルタップして、会話とコードを前のチェックポイントに復元します。 - 検証ターゲットを指定する: テストケースを含めるか、スクリーンショットを貼り付けるか、プロンプトで予想される出力を定義します。Claude が独自の作業を検証できる場合、修正をリクエストする必要がある前に問題をキャッチします。
- 段階的にテストする: 1 つのファイルを作成し、テストしてから続行します。これは、修正が安い場合に早期に問題をキャッチします。
バックグラウンドトークン使用量
Claude Code はアイドル状態でも、バックグラウンド機能にトークンを使用します。
- 会話要約:
claude --resume機能の前の会話を要約するバックグラウンドジョブ - コマンド処理:
/usageなどの一部のコマンドは、ステータスを確認するためにリクエストを生成する場合があります
これらのバックグラウンドプロセスは、アクティブなインタラクションがなくても、少量のトークン（通常はセッションあたり $0.04 未満）を消費します。
Claude Code の動作の変更を理解する
Claude Code は、コスト報告を含む機能の動作方法を変更する可能性のある定期的な更新を受け取ります。claude --version を実行して現在のバージョンを確認してください。特定の請求に関する質問については、Console アカウントを通じて Anthropic サポートに連絡してください。