Claude Codeで使用量の上限に近づいたとき：作業を止めずに整える段取り

先に押さえる上限の仕組み

公式ヘルプによると、ProとMaxには5時間ごとのセッション上限と週次の上限があり、Claude(チャット)とClaude Codeで共有されます。ブラウザ側で長く使った日は、Claude Codeの残りも減ります(Use Claude Code with your Pro or Max plan)。

セッション上限に達したとき、Claude Codeは進行中のステップを終えるために少しだけ動き続けることがあり、「Usage limit reached · wrapping up」と表示されます。この延長分は小さく上限があり、週次の枠にも数えられます(同ヘルプ)。つまり「あと少し」で粘る余地は小さく、そこに大きな依頼を重ねるのは得策ではありません。

メッセージによって打ち手が変わる点も重要です。Claude Codeのコスト管理ドキュメントでは、次のように区別されています。

• You've hit your session limit / weekly limit、意味：全モデル共通の利用枠が尽きた、/model で別モデルに替えれば続けられるか：続けられない
• You've hit your Opus limit / Sonnet limit、意味：そのモデル系統の枠が尽きた、/model で別モデルに替えれば続けられるか：別系統のモデルなら続けられる
• spend limit 系(個人・組織・チーム)、意味：追加の使用クレジットが設定した上限に達した、/model で別モデルに替えれば続けられるか：該当しない。上限の引き上げ。プランのリセット時刻も表示されている場合は、その時刻まで待つ方法もある

各メッセージの文言はエラー一覧にも載っています。会話が長くなったときの自動コンパクトの警告は、使用量の上限とは別物です。

上限が近いとき：まず状態を外に出す

/usage で、プランの使用量バーと、何が使用量を押し上げているかの内訳を確認できます(コスト管理ドキュメントより)。バーが高いと感じたら、新しい大きな依頼を出す前に次のチェックリストを上から実行します。

上限前のチェックリスト

1. 今のタスクを一区切りにする。 途中の大きな変更は、動く状態まで進めるか、いったん戻すかを決めます。壊れたまま止まるのが最も再開しにくい状態です。
2. 変更を残す。 動く状態ならコミットします。中途半端ならWIPとして別ブランチにコミットするか、差分を確認して残します。
3. 引き継ぎメモを書かせる。 Claudeに数行のメモを作らせます(依頼文は後述)。長い要約を求めると、それ自体に使用量を使います。
4. 後回しにする作業を決める。 下の表で、今やる・待つ・人が代わりにやるに分けます。
5. セッションに名前を付ける。 公式の手順では、/rename で名前を付けてから、後で /resume で戻れます。

保存するもの・後回しにするものの判断表

• 未コミットの変更の保存、判断：今やる、理由(編集上の目安)：再開時の状態確認の土台になる
• 次にやることのメモ、判断：今やる、理由(編集上の目安)：短く済み、再開時の指示の質が上がる
• テストの再実行、判断：人が代わりにやる、理由(編集上の目安)：結果を貼るだけで足りる場合が多い
• 広範囲のリファクタリング、判断：後回し、理由(編集上の目安)：読み込みが多く、使用量を食いやすい
• ログ全体の調査、判断：後回し、または絞って依頼、理由(編集上の目安)：長い出力は文脈を膨らませる
• 新機能の設計相談、判断：後回し、理由(編集上の目安)：上限後でも考えられる作業
• 小さなバグ修正、型の修正、判断：余力があれば今やる、理由(編集上の目安)：読むファイルが少ない

使用量を抑える公式の工夫として、無関係な作業の間に /clear で文脈を切る、/compact に残したい内容を指示する、簡単な作業では /effort を下げる、Sonnetなど軽いモデルに切り替える、依頼を具体的に書く、が挙げられています(コスト管理)。ただし /compact は長い会話を読み込むため、それ自体が大きなリクエストになる点には注意が必要です。上限ぎりぎりでの実行は避けたほうが安全です。

引き継ぎメモを書かせる依頼文

以下は説明用の例で、実際の環境では試していません。ファイル名や項目はプロジェクトに合わせて変えてください。機密情報、鍵、顧客データはメモに書かせないでください。

使用量の上限が近いので、作業を一度止めます。
コードは変更せず、HANDOFF.md に次の4点だけを10行以内で書いてください。
1. 完了したこと
2. 途中のこと(対象ファイルと、どこまで進んだか)
3. 次にやる最初の1手
4. まだ確認できていないこと(テスト未実行など)
推測は「推測」と明記し、事実は git diff と実行結果に基づくものだけにしてください。

メモを作らせたら、人が内容を読み、git status と git diff --stat で実際の変更と食い違っていないかを見ます。メモは便利ですが、正しさはリポジトリの状態で確かめます。

上限に達した後：待つか、広げるか

表示にはリセットの時刻が出ます(コスト管理ドキュメントより)。選択肢は次のとおりです。

• 待つ。 Claude Code v2.1.234以降では、リセット後に中断したタスクを自動で続ける機能があり、/rate-limit-options から選べます。自動で待ちに入る条件は公式のInteractive modeにまとまっています。
• 使用クレジットで続ける。 使用クレジットを有効にすると、枠を使い切った後は従量課金で続けられます。/usage-credits から設定画面を開けます。API認証では使えません。費用が発生するため、月の上限額を決めてから使います。
• プランを見直す、またはConsoleのAPIを使う。 ヘルプには、ProからMax 5xへの変更や、Claude Consoleのアカウントでの利用が挙げられています。なおMaxプランに含まれる月間のAPIクレジットはClaude Codeでは使えない、と明記されています。

待っている間にClaudeなしでできる作業は、次のとおりです。

• git diff の自己レビュー
• テストの実行と、失敗ログの該当部分の切り出し
• 次の依頼文の下書き(対象ファイル、完了条件、確認コマンドを書く)
• 後回しにした作業の優先順位付け

再開時に貼る確認文

再開直後は、すぐ編集させずに、現状確認だけをさせます。休憩が長いと、最初のメッセージで文脈の再処理が起きることも公式に書かれているため、再開の1通目は短く、目的を絞ります。

以下も説明用の例です。

作業を再開します。まず編集せずに現状を確認してください。
1. HANDOFF.md を読む
2. git status と git diff --stat を実行する
3. メモの内容と実際の変更が食い違っていないか報告する
4. 次の1手を、変更するファイル名つきで提案する
私が承認するまでファイルは編集しないでください。

報告を受けたら、人が次の3点を確かめます。

• 変更ファイルの一覧が、自分の認識と合っているか
• 「完了」とされた項目に、実行したテストの結果が伴っているか
• 提案された次の1手が、1回で終わる大きさか

複雑な作業なら、Shift+Tabでプランモードに切り替え、計画を見てから実装に進めると、やり直しによる無駄な使用量を減らせます(コスト管理ドキュメントより)。

上限前後の早見チェックリスト

• [ ] /usage で残りを確認した
• [ ] 作業を動く状態まで進めた、または戻した
• [ ] コミットまたはWIPで変更を残した
• [ ] HANDOFF.md を作り、中身を人が読んだ
• [ ] /rename でセッションに名前を付けた
• [ ] 後回しの作業を決めた
• [ ] 待つ・クレジット・プラン変更のどれにするか決めた
• [ ] 再開時は確認文を貼り、承認前に編集させなかった