モジュール 3: 費用と利用枠を管理する

想定外の課金を防ぎ、2026年6月15日の課金の分離に備える。公式の一次情報と、自分の暴露を測る演習で学びます。

このモジュールの到達目標。 1M context への自動の昇格による課金を止め、6月15日の課金の分離で自分のどの使い方が別の枠へ移るかを、公式の事実に基づいて判別し、自分の暴露を実機で測れる。

これは研修の公開のモジュールです。そのまま読んで手を動かせます。モジュール 1・モジュール 2に続く3本目で、残りのモジュール（サブエージェントの制御、組織の baseline、事故対応）の構成はカリキュラムをご覧ください。

1. なぜ想定外の課金が起きるのか

費用の事故は、削除や漏洩と違って「気づいた時には請求済み」という形で起きます。主な原因は2つです。

(1) 1M context への自動の昇格

長い文脈を扱うと、モデルが 1M context の枠へ自動で昇格し、課金の区分が引き上がることがあります。これは会話の中身ではなく基盤の側で選ばれるため、CLAUDE.md に「1M を使わないで」と書いても効きません。利用者の側で止める手段は環境変数です（演習で扱います）。

(2) 2026年6月15日の課金の分離

2026年6月15日から、一部の使い方が、従来の購読の枠とは別建ての月額のクレジットの枠へ移ります（公式の告知は2026年5月13日）。どの使い方が移るかは、公式が次のとおり明確に分けています。

別建ての枠へ移る（programmatic）	従来の購読の枠に残る（interactive）
Agent SDK（Python / TypeScript）	対話的な Claude Code（ターミナルでも IDE でも）
`claude -p`（非対話 / headless）	claude.ai の web / desktop / mobile のチャット
Claude Code の GitHub Actions	Claude Cowork
SDK で購読を認証する第三者のアプリ

別建ての枠の月額のクレジットは、Pro が $20、Max 5x が $100、Max 20x が $200 です（Team と Enterprise は席の種類で異なります）。使い切った後は、従量の課金を有効にしていればその料率で続き、無効なら黙って止まります。繰り越しはありません。だからクレジットは6月15日より前に把握しておきます。

公式が分類していない使い方（断定しない）。 claude remote-control（#59823）、対話の中で動くサブエージェント、MCP サーバー経由、IDE からのプログラム的な起動は、公式が明示的に分類していません。構造的には「どの入口から起動したか」に従うと読めますが、公式の明文ではないため、自分の利用で計測して確認します（演習の手順 3）。

2. 実際の事故を読む

抽象論ではなく、番号で辿れる実際の報告で学びます。

`claude -p` の課金がモデルに誤って説明され、想定外の課金が出た（#61704）

何が起きたか: headless（claude -p）の課金についてモデルが繰り返し誤った確認を返し、€80 以上の想定外の課金につながった。
なぜ起きたか: 課金の仕組みを「モデルに聞いて確かめた」が、その回答が事実でなかった。課金は、推測でなく公式の一次情報で確認する必要がある。
何が止めたはずか: 公式の分類（上の表）に基づく事前の把握と、自分の暴露の計測（演習）。

1M context のクレジットを要求されて操作が止まった（#65283）

何が起きたか: 「Usage credits required for 1M context」と表示され、/clear をしても、利用枠が残っていても解消しなかった。
なぜ起きたか: 1M context への昇格が会話の側でなく基盤の側で選ばれるため、会話の操作では戻せない。
何が止めたはずか: 1M context の自動の昇格を環境変数で止める設定（CLAUDE_CODE_DISABLE_1M_CONTEXT、演習の手順 1）。

3. 演習: 課金を止める層と、暴露を測る

実際に設定を入れ、自分の6月15日の暴露を測ります。所要およそ10分。削除や漏洩のモジュールと違い、ここでの主役はコマンドを止める hook ではなく、環境変数の設定と、自分の利用の計測です。

手順 1. 1M context の自動の昇格を止める

1M context への昇格は環境変数で止められます。シェルの設定（~/.bashrc や ~/.zshrc）に次を加えます。

export CLAUDE_CODE_DISABLE_1M_CONTEXT=1

これで、長い文脈による 1M context への自動の昇格と、それに伴う課金の区分の引き上げを止めます（#65283 の型の事故の予防）。

手順 2. 6月15日の暴露を測る（最も確実な方法）

別建ての枠へ移るのは、上の表の4つの programmatic な使い方です。定義の上で確実なのは、自分のスクリプト・cron・CI を検索して、これらの使い方の箇所を洗い出すことです。

# 自分のスクリプトや CI に programmatic な起動があるかを洗い出す
grep -rEn 'claude[[:space:]]+-p|claude[[:space:]]+--print|claude-code-action|claude_agent_sdk|claude-agent-sdk' \
  ~/ . 2>/dev/null

出てきた箇所が、6月15日から別建ての枠で課金される候補です。0 件なら、あなたの使い方は対話的（従来の購読の枠）に収まっている可能性が高いです。cron・CI・バックグラウンドの自動の起動を特に確認します。

手順 3. 継続して計測する（公式の計測）

一度の検索だけでなく、入口（entrypoint）の別に費用を継続して測れます。公式の OpenTelemetry の計測を有効にします。

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_INCLUDE_ENTRYPOINT=true

これで app.entrypoint の属性ごとにトークンと費用を集計でき、どの入口が別建ての枠に当たるかを実データで確認できます。崖までの日数と準備の行動を毎セッション知らせる補助の hook（cliff-countdown-advisor、止めない助言・CC_CLIFF_QUIET=1 で抑制）も cc-safe-setup に含まれます。

確認（このモジュールの修了の判定）。 次のすべてに「はい」と答えられれば修了です。

1M context の自動の昇格を止める環境変数（CLAUDE_CODE_DISABLE_1M_CONTEXT）を設定した。
自分のスクリプト・cron・CI を検索して、6月15日から別建ての枠へ移る使い方の有無を確認した。
6月15日に別建ての枠へ移る4つの使い方と、従来の枠に残る使い方を、自分の言葉で説明できる。
課金の仕組みは、モデルに聞くのでなく公式の一次情報で確認すべき理由を説明できる（#61704）。

4. 自社への適用

Anthropic の Console で月額の上限（Spend Limit）を設定・確認する（無効だと従量で止まらない）。
6月15日より前に、Pool 1（購読の枠）と Pool 2（別建ての枠）の比率の baseline を取る（手順 2・3）。
cron・CI で動く claude -p や Agent SDK の起動を棚卸しし、並列の起動を見直す。
課金の事実は推測で広めず、公式の一次情報で確認した内容だけをチームに共有する（#61704 の型の混乱を防ぐ）。

次のモジュールと、研修の全体

このモジュールは「費用を管理する層」です。研修の全体（約12時間・7モジュール）では、削除とデータ破壊（モジュール 1）、機密と認証情報（モジュール 2）に続き、サブエージェントと auto モードの制御、組織の baseline と CI のゲート、事故対応と復旧までを、同じように手を動かして学びます。

研修のカリキュラム全体を見る法人での実施・費用の相談

本モジュールは公開版です。引用した事故はすべて番号で辿れる実際の報告で、課金の事実はすべて公式の一次情報（support.claude.com / platform.claude.com / code.claude.com）で確認しています。公式が分類していない使い方は、断定せず計測で確認するよう明記しています。個人での利用は無料のままです。