Claude Codeの自動圧縮と状態管理術

Claude Codeで開発を続けると、AIが過去の決定を忘れたり、一度却下した手法を再提案したりする現象が起きる。原因はトークン消費率が90%を超えた際に作動する自動圧縮だ。会話履歴が要約される過程で、設計判断の文脈が消失する。

この文脈消失を防ぐには、状態管理の外部化が有効だ。AI任せの運用から脱却し、エージェントを制御するための具体的な手法を解説する。

トークン上限90%の壁と開発現場の混乱

Claude Codeのセッションにおいて、トークン使用率が90%〜95%に達すると自動圧縮が作動する。この処理は会話履歴を自然文で要約し、新しいコンテキストとして再構築する。

要約には「過去の作業ログ」のみが残り、「なぜその設計を選んだか」という判断の文脈は削ぎ落とされる。圧縮直後のAIは、不採用にしたアプローチを再提案したり、検証前のコードを配置したりする。

しんたろー：
以前、一度却下したアプローチをAIが自信満々に再提案してきたときは驚いた。原因が自動圧縮による要約漏れだと気づき、対策の必要性を感じた。

Anthropicはエージェント型利用に対し、API経由の従量課金への移行を求めている。自律ループによる計算負荷の増大が背景にある。高負荷な連続ループを回すアカウントが停止される事例もあり、運用にはガードレール設計が求められる。

あわせて読みたいAIエージェントを自作して本番運用する方法｜最小構成の実装とサブエージェント設計 →

防御的エージェント運用の構築

AIのコンテキスト領域は揮発性である。永続化すべきデータはファイルシステム上に外出しする。

第一の防衛ラインは、CLAUDE.mdとsettings.jsonによる静的ガードレールだ。プロジェクトルートに命名規則や禁止事項を記載したCLAUDE.mdを配置する。settings.jsonでは破壊的なコマンド実行や環境変数の読み取りをdenyに設定する。

第二の防衛ラインは、状態管理フックの構築だ。作業フェーズや決定事項を特定のテキストファイルへ書き出す。圧縮発生時のPostCompactフックでマーカーを生成し、次のユーザー入力で状態を再注入する。

明日から始める防御的運用

AIエージェントを制御するためのアクションは3つある。

1. プロジェクトのルールと権限をファイルでコード化する。CLAUDE.mdで禁止事項を明記し、settings.jsonでコマンド実行権限を3段階で制御する。
2. 人間によるチェックポイントを設計する。タスクを小さな単位に分割し、フェーズごとにレビューを行う。
3. 状態復元フックを導入する。自動圧縮で消える思考プロセスをstate fileに保存し、圧縮後に再注入する仕組みを作る。

しんたろー：
以前は夜中にエージェントを走らせて朝起きるとコードが全壊していることがあった。今は設定ファイルとフックでガードレールを組んでいるため、手戻りは発生していない。

あわせて読みたい【2026年版】AI活用1人SaaS開発の完全ロードマップ｜5ステップで始める個人開発 →

よくある質問

Claude Codeの自動圧縮で作業内容が消えるのを防ぐには？

自動圧縮はコンテキスト利用率に基づき自動で発火する。決定事項やタスク状態を事前に状態保存用ファイルへ吐き出し、圧縮発生時のフックと連動させて再注入する仕組みを構築する。

サードパーティ製エージェントを使うとアカウントが停止されるリスクはある？

高負荷な連続推論ループは異常トラフィックとみなされる可能性がある。settings.jsonで実行権限を絞り込み、無制限なエラーリトライが発生しないよう設定する。

CLAUDE.mdに何を書けば精度が上がりますか？

あえて採用しなかった案とその理由を明記する。判断軸やテスト環境と本番環境の境界線をルール化することで、セッションが長引いても精度を維持できる。

まとめ

自動圧縮とAPI制限への対策は、AI開発の必須スキルだ。文脈の消失を防ぐ状態管理を組み込むことで、Claude Codeは安定した戦力となる。

状態ファイルとルール定義の導入により、意味不明な手戻りは減少する。AIを自在に制御するシステムアーキテクトとしての運用を目指す。

👉 ThreadPostでSNS運用を自動化する