Claude Code（Anthropicが提供するAIコーディングエージェント）で長時間デバッグを続け、利用制限（usage limit）に達した経験がある方に向けた内容です。制限に達した瞬間、それまでの調査内容や試行錯誤の文脈がまるごと失われる問題を扱います。
複数のAIコーディングツールを併用している開発者にとって、この問題は地味に生産性を削ります。原因の切り分け方と、当面の回避策を整理しました。
何が起きるか
認証周りのバグ修正のような、複数ファイルにまたがるタスクを想定します。
Claude Codeにリポジトリを読ませ、認証フローを確認させ、リフレッシュトークンのロジックを特定させます。テストを読ませ、auth/session.pyを修正させます。テストが1つ失敗し、Claudeがさらに調査を続けます。
数十ターンのやり取りを経て、ようやくClaudeが問題の本質を理解します。その瞬間に「利用制限に達しました」という通知が出ます。
理解していた唯一の参加者が、突然いなくなるわけです。
別のツール（たとえばOpenAIのCodex）を開いても、状況は変わりません。Codexはこの会話について何も知らないので、ゼロから状況を説明する作業が発生します。
この説明作業が、開発者自身の仕事になってしまいます。ソフトウェアエンジニアリングをするはずだったのに、AI同士の翻訳係になってしまう構図です。
なぜ起きるか
原因は3段階に分解できます。
1つ目は、Claude Codeの会話履歴がセッション単位で管理されている点です。利用制限に達すると新しい応答を生成できなくなり、その時点の思考過程（推論の中間状態）はテキストとして保存されていても、要約や引き継ぎ用の形には整形されません。
2つ目は、利用制限の通知が事前警告なしに来る点です。「残りトークンが少ないので今のうちに要約してください」というような猶予は用意されていません。制限に達した瞬間にそこで停止します。
3つ目は、ツール間でコンテキスト（会話や作業の文脈情報）を共有する標準的な仕組みが存在しない点です。Claude CodeとCodexは別々の企業が別々の設計で作っており、内部の会話形式やツール呼び出しの記録形式は共有されていません。MCP（Model Context Protocol、AIモデルと外部ツール・データソースを接続するための共通規格）はツール呼び出しの標準化を進めていますが、エージェント間でのセッション引き継ぎまではカバーしていません。
この3つが重なることで、「情報は全部ローカルに存在しているのに、誰も自動で回収してくれない」という状況が生まれます。ファイルの変更履歴、Gitのdiff、エラーログ、ツール呼び出しの記録は全部残っているのに、それを再利用可能な形にまとめる仕組みがないだけです。
自分のプロジェクトが該当するか確認する
以下のいずれかに当てはまるなら、この問題の影響を受けやすい状況です。
- 1つのタスクでClaude CodeやCodexとのやり取りが30ターンを超えることがある
- 複数のAIコーディングツールを日常的に切り替えて使っている
- 認証・状態管理・非同期処理など、複数ファイルにまたがる調査が多いタスクを扱っている
- チームで同じリポジトリに対して複数人が別々のAIツールを使っている
確認方法としては、直近のClaude Codeのセッションログを見て、1セッションあたりの平均ターン数と、利用制限に到達した回数を数えてみるとよいです。Claude Codeはセッションの会話ログをローカルに保持しているため、~/.claude配下（環境により異なる）のセッションファイルを確認すると、どのタイミングで制限に達しているか振り返れます。
対策の手順
完全な自動引き継ぎの標準機能は現時点で存在しないため、手動での対策と、外部ツールを使う対策の2段階で考えます。
手動でできる対策
1. 長時間のデバッグに入る前に、区切りのよいタイミングでClaudeに現在の状態を要約させる。「これまでの調査結果と次にやるべきことを3行でまとめて」と指示する
2. その要約をMarkdownファイル（例: .ai-notes/session-log.md）としてリポジトリ内に保存する
3. ツールを切り替える際は、そのファイルを新しいツールに読み込ませてから作業を再開する
4. 利用制限が近いと感じたら（メッセージ数や作業時間の目安で判断）、早めに要約を挟む習慣をつける
この方法の弱点は、要約のタイミングを人間が判断しなければならない点です。利用制限は予告なく来るため、要約前に打ち切られるケースは避けられません。
外部ツールを使う対策
作業中の記録を自動でジャーナル（追記専用のログ）に残し、セッション切り替え時に「復旧カプセル」として要約を渡す、というアプローチを取るツールも登場しています。プロンプト、応答、ツール呼び出し、失敗、ファイル変更、現在の目的、Gitの状態などをリアルタイムで記録し、ツールを切り替えた際に直前の状態を新しいエージェントに渡す仕組みです。
こうしたツールを検討する際は、次の点を確認するとよいです。
- 記録がローカルに保存されるか、外部サーバーに送信されるか（機密コードを扱う場合は特に重要）
- Claude CodeとCodexなど、実際に使っているツールの組み合わせに対応しているか
- 記録の粒度がファイル変更単位か、メッセージ単位か
現時点でこの分野は成熟しておらず、公式のAnthropicやOpenAIの機能として引き継ぎが標準化されているわけではありません。導入する場合は、まず小さいリポジトリで試し、記録されたログが実際に有用な要約になっているか確認してから本格導入するのが安全です。
まとめ
Claude CodeやCodexの利用制限による文脈の消失は、ツール自体の欠陥というより、エージェント間で会話状態を共有する標準がまだ存在しないことに起因します。
今すぐできる確認は、直近のセッションで平均何ターンで制限に達しているかを振り返ることです。そのうえで、区切りのよいタイミングで要約をMarkdownファイルに残す運用を試してみてください。
自動記録型のツールを試す場合は、機密情報の扱いとツール対応範囲を必ず確認してから導入するのが無難です。