/compactコマンド徹底解説 ― 会話を圧縮して作業を続ける

はじめに

Claude Codeで長時間の作業をしていると、やがてコンテキストウィンドウが埋まり、パフォーマンスが低下します。そんなときに活躍するのが/compactコマンドです。会話の履歴を圧縮し、重要な情報だけを残して作業を続行できます。

この記事では、/compactの仕組みから実践的な活用パターンまでを徹底解説します。

/compactコマンドとは

/compactは、Claude Codeに組み込まれたコマンドで、現在の会話履歴をAIが要約・圧縮する機能です。セッションを終了せずにコンテキストウィンドウの使用量を大幅に削減できます。

# 基本的な使い方
/compact

# カスタム指示を添える
/compact 認証機能の実装状況と残りのTODOを保持して

# 特定の技術的文脈を保持する
/compact データベーススキーマの変更点とAPI仕様を忘れないで

圧縮の仕組み

/compactコマンドを実行すると、内部では以下の処理が行われます。

圧縮率の目安

圧縮率は会話の内容によって異なります。コードの変更が多い場合は要約が長くなり、質疑応答が中心の場合はより高い圧縮率になります。

使うべきタイミング

/compactの使いどころを見極めることが、効率的なセッション管理の鍵です。

保持される情報と失われる情報

/compactは「すべてを記憶する」のではなく、「重要な情報を要約する」ことでコンテキストを削減します。何が残り、何が失われるかを理解しておきましょう。

保持されやすい情報

失われやすい情報

カスタム圧縮指示の書き方

/compactにカスタム指示を添えることで、圧縮時に特定の情報を確実に保持させることができます。

基本パターン

# パターン1: 保持すべき情報を指定
/compact 以下を必ず保持：1) DBスキーマの変更内容 2) APIエンドポイント一覧 3) 残りのTODO

# パターン2: 現在のコンテキストを明示
/compact 現在の状況：ユーザー認証APIの実装中。JWTトークン方式。login/logout/refresh完了、パスワードリセット未着手。

# パターン3: 次のステップを明示
/compact 次にやること：1) パスワードリセットAPI 2) メール送信機能 3) フロントエンド連携

効果的なカスタム指示のテンプレート

/compact 以下の情報を保持してください：
- プロジェクト: [プロジェクト名]
- 現在のタスク: [何をしているか]
- 完了した作業: [完了リスト]
- 残りのTODO: [未完了リスト]
- 重要な決定: [技術選定など]
- 既知の問題: [バグや制約]

圧縮前後の比較例

実際に/compactを使った場合のイメージを見てみましょう。

シナリオ: PHPでのCRUD API開発

メッセージ1: 「ニュース管理APIを作りたい」→ 要件の確認
メッセージ2: DB設計の提案 → ユーザーが修正を依頼
メッセージ3: DB設計の修正 → 承認
メッセージ4: GET /api/news の実装
メッセージ5: テストでバグ発見 → デバッグ
メッセージ6: バグ修正完了
メッセージ7: POST /api/news の実装
メッセージ8: バリデーション追加の議論
メッセージ9: バリデーション実装
... (コンテキスト使用率: 65%)

【プロジェクト】ニュース管理API（PHP + SQLite）
【完了】
- DBスキーマ: newsテーブル（id, title, content, published_date, is_published, sort_order）
- GET /api/news: 一覧取得（ページネーション付き）、個別取得
- POST /api/news: 新規作成（title必須、content必須のバリデーション付き）
【未完了】
- PUT /api/news/:id（更新）
- DELETE /api/news/:id（削除）
- 認証（管理者のみ書き込み可能にする）
【変更ファイル】
- db/init.sql, api/news.php, includes/db.php
... (コンテキスト使用率: 8%)

このように、65%だったコンテキスト使用率が8%まで削減され、残りの作業に十分なコンテキストを確保できます。

長時間セッションの戦略

大きな機能開発など、長時間のセッションが必要な場合の/compact活用パターンを紹介します。

パターン1: 定期圧縮法

コンテキスト使用率を監視し、一定の閾値で/compactを実行します。

パターン2: マイルストーン圧縮法

機能単位の区切り（マイルストーン）で/compactを実行します。

# マイルストーン1: DBスキーマ設計完了
/compact DBスキーマが確定。次はAPIエンドポイントの実装。

# マイルストーン2: APIエンドポイント完了
/compact API全エンドポイント実装完了。次はフロントエンド連携。

# マイルストーン3: フロントエンド連携完了
/compact フロント連携完了。次はテスト作成。

パターン3: デバッグ後圧縮法

デバッグの試行錯誤は大量のコンテキストを消費します。バグが解決したら即座に/compactを実行しましょう。

# バグ修正完了後
/compact セッション管理のバグを修正完了（session_regenerate_id()の呼び出し位置を変更）。
本来のタスクであるOAuth2統合の実装に戻る。残り：Google OAuth連携、コールバック処理。

ベストプラクティス

/compactは「一時停止して整理する」機能です。作業の流れを止めずにコンテキストを最適化できる強力なツールですが、使いすぎは情報の劣化を招きます。適切なタイミングで、適切な指示とともに使いましょう。