プランモードでのファイルの使用方法
Anthropic はプランモードを「Claude に変更を加えることなく、調査と変更の提案を指示する」ものと定義しています。Claude はファイルを読み込み、コマンドを実行して調査し、プランを書き込みますが、ユーザーが承認するまでソースコードを編集することはありません。
プランは、Claude が承認を求める前にディスクに書き込まれます。Anthropic のフックリファレンスには、「Claude はツールを呼び出す前にプランをディスク上のファイルに書き込む」と明記されています。フックがその承認ステップを検査する際、Claude Code は 2 つのフィールドを渡します。1 つはプランの Markdown である plan（「ディスク上のプランファイルから注入される」）、もう 1 つはそのファイルへのパスである planFilePath です。
つまり、ファイルが信頼できる唯一の情報源（Source of Truth）です。会話で見ているのは Claude が提示したプランであり、ディスクにあるのは Claude Code が後で読み戻すプランです。
ファイルの場所と名前
デフォルトの場所は ~/.claude/plans/ です。Anthropic の .claude ディレクトリガイドでは、このフォルダを「プランモード中に書き込まれたプランファイルを保持する」場所としてリストしています。CLAUDE_CONFIG_DIR を設定して Claude Code のホームディレクトリを移動した場合、プランフォルダも一緒に移動します。
ファイル名はプロンプトに従います。Claude Code のリリースノートには、「プランファイルは、純粋にランダムな単語ではなく、プロンプトにちなんで命名されるようになりました（例：fix-auth-race-snug-otter.md）」とあります。したがって、認証のレースコンディションを修正するためのプランには、Anthropic の例のように、その言葉で始まり、その後にランダムな単語が続く名前が付けられます。
すべてのプロジェクトのプランは、同じデフォルトフォルダに保存されます。複数のリポジトリで作業している場合、~/.claude/plans/ にはそれらすべてのプランが並んで保存されます。
プランを開いて編集する方法
ファイルを変更するために手動で探す必要はありません。
- ターミナルで: プランの準備ができたら、「
Ctrl+Gを押して、提案されたプランをデフォルトのテキストエディタで開き、Claude が続行する前に直接編集する」ことができます。 - VS Code で: 拡張機能はプランをフル Markdown ドキュメントとして開き、インラインコメントを追加できます。すでにプランモードのときに
/planと入力すると現在のプランが表示され、/plan openと入力するとエディタでプランファイルが開きます。 - 承認メニューで: プランニングを継続することを選択し、Claude に何を修正すべきか伝えます。
Claude Code はファイルを読み戻すため、ファイルを編集することで Claude が作業するプラン自体を変更できます。
コンパクション後のプランの挙動
長時間のプランニングセッションはコンテキストウィンドウを埋め尽くし、コンパクション（圧縮）によって会話が要約され、空き容量が作られます。プランは他の要素とは異なる扱いを受けます。コンパクション後も存続するものを記した Anthropic の表には、「プランモードで Claude が書いたプラン」の結果として「ディスクから再注入される」と記載されています。
これは、プランが他のすべてと一緒に要約に押し込められないことを意味します。Claude Code はファイルを再度読み込み、コンテキストに戻します。これには 2 つの実践的なポイントがあります。
- ファイルへの編集が反映される。 コンパクション実行時にディスクにある内容が、そのまま戻ってきます。
- プランに関する議論は同じ扱いを受けない。 あるアプローチを拒否した理由や、話し合ったトレードオフは会話の一部であり、会話とともに要約されます。重要な理由がある場合は、プランファイルに記述してください。
context コマンドのガイドでは、コンパクションが発生する前にウィンドウを占有している内容を確認する方法を紹介しています。
/clear 後の挙動
/clear は新しい会話を開始し、プランもそれに従います。リリースノートには、まさにこの点に関する修正が記載されています。「/clear コマンドをまたいでプランファイルが残ってしまう問題を修正し、会話をクリアした後は新しいプランファイルが使用されるようにしました」。
したがって、/clear 後、Claude Code は新しい会話のために新しいプランファイルを開始します。リリースノートには古いファイルの削除については記載されていません。つまり、新しい会話が古いプランを引き継がないことを意味します。クリアした後にそのプランで作業を続けたい場合は、先にファイルを開くか、パスを指定して古いファイルを読み込むよう Claude に依頼してください。
承認時の clear-context オプション
プランを保持するように設計された「クリア」が 1 つあります。showClearContextOnPlanAccept 設定を有効にすると、承認メニューに「プランを承認し、会話コンテキストをクリアして、プランのみから実装を開始する」という最初のオプションが追加されます。これはデフォルトでオフになっています。Anthropic がこれを提供している理由は、「プランニングは大量のコンテキストを消費する可能性があるため」です。
このオプションは、長い探索プロセスを捨てて、その結果だけを保持するためのスマートな方法です。
/fork、resume、およびクラウドセッションでの挙動
フォークは独自のプランファイルを持ちます。 リリースノートで「フォークされた会話 (/fork) が同じプランファイルを共有し、一方のフォークでのプラン編集がもう一方を上書きしてしまう問題」が修正されました。現在は、各フォークが個別にプランニングを行います。
Resume はプランモードを復元します。 これに関してはいくつかの修正が行われており、claude --resume セッションピッカーや /resume でセッションを再開した際に「プランモードが復元されない問題」などが修正されています。再開したセッションがプランモードを抜けているように見える場合は、最新バージョンを使用しているか確認してください。
クラウドセッションは再起動後もファイルを保持します。 リリースノートには、コンテナの再起動後にリモートセッションがプランファイルを見失う問題や、プランが提示される前にクラウドセッションのコンテナが再起動した際にプランモードで書かれたプランが失われる問題の修正が記載されています。
プランファイルの保持期間
プランファイルは永続的ではありません。Anthropic の Claude Code がスケジュールに従って削除するアプリケーションデータリストには、トランスクリプトや他のセッションファイルとともに plans/ が含まれています。ルールは「Claude Code は、以下のパスにあるファイルが cleanupPeriodDays より古くなった場合に削除する」というものです。デフォルトは 30 日です。
アプリケーションデータを自分で削除した場合に失われるものについての Anthropic の表では、~/.claude/plans/ は「ユーザー向けのデータなし」のフォルダに分類されています。言い換えれば、Claude Code はデフォルトフォルダ内のプランを、記録ではなくセッション用の作業資料として扱います。
プランを記録として残したい場合は、別の場所に保存する必要があります。
plansDirectory を使ってリポジトリ内にプランを保持する方法
plansDirectory 設定により、プランファイルの保存場所を変更できます。「Claude Code がプランモードで書き込むプランファイルの保存先を選択します。Claude Code はプロジェクトのルートからの相対パスでパスを解決します」。Anthropic の例の値は ./plans です。
これをプロジェクトの .claude/settings.json に追加すると、そのプロジェクトのプランはリポジトリ内の plans/ フォルダに保存されます。この設定はどの設定ファイルにも記述できるため、ローカル設定で自分専用に設定することも可能です。
以下の 2 つのケースでは、プランはデフォルトフォルダに戻されます。
- プロジェクトルート外のパス（例：
../plans）。 - macOS、Linux、WSL でのバックスラッシュ。 Anthropic は Windows スタイルのパスではなく
docs/plansのように書くことを推奨しています。スラッシュ（/）は Windows でも動作します。
自動クリーンアップリストには ~/.claude/ 下の plans/ フォルダが指定されていますが、リポジトリ内のプランフォルダはそのリストに含まれません。また、プランモードは引き続きそこに書き込むことができます。Anthropic の保護パスリストでは、「~/.claude/plans/ または設定した plansDirectory 内にある現在のセッション自身のプランファイル」は例外とされています。
コミットするか無視するか
プランがリポジトリに入ったら、それを共有するかどうかを決めます。コミットされたプランは、レビュー担当者に変更の背後にある理由を提供します。無視（ignore）されたプランはローカルに残り、クリーンアップリストの対象外になります。いずれにせよ、これらはあなたが管理するファイルになります。Factory が同じ問題をどのように扱っているかについては、Factory spec プランをホームディレクトリ外に移動するガイドをご覧ください。
よくある間違い
プロジェクトフォルダ内でプランを探してしまう。 デフォルトではリポジトリではなく ~/.claude/plans/ にあります。
/clear でプランが保持されると期待する。 新しいプランファイルが開始されます。古いものを先に開くか保存してください。
プランが永遠に残ると想定する。 デフォルトフォルダのファイルは cleanupPeriodDays（デフォルト 30 日）でクリーンアップされます。
plansDirectory を親フォルダに設定する。 プロジェクトルート外のパスはデフォルトにフォールバックします。
プランをプロジェクトの記憶（memory）として扱う。 プランは 1 つのセッションに属します。常に適用すべきルールは CLAUDE.md やルールファイルに記述すべきです。Claude Code ルールのガイドでその違いを説明しています。
解決策：見つけられる場所にプランを保管する
ステップ 1: プロジェクトの plansDirectory を設定する
プロジェクトの設定に、./plans のようなプロジェクト内のパスを指定した plansDirectory を追加します。そのプロジェクトの新しいプランは、ホームフォルダではなくリポジトリに保存されるようになります。
ステップ 2: 理由をプランファイルに記述する
承認する前に、Ctrl+G または /plan open でプランを開き、重要な決定事項や却下したアプローチを追記します。コンパクション後に戻ってくるのは、このファイルの内容です。
ステップ 3: 永続的な決定事項をプランから移動する
作業が完了したら、決定した規約や除外したアプローチなど、セッションを超えて残すべき決定事項を CLAUDE.md や自身のノートに書き写します。実装がうまくいかなかった場合は、Claude Code の /rewind ガイドで編集の取り消し方法を確認してください。
MemoryLake でのセットアップ
プランファイルは 1 つの変更に関する推論を保持します。その推論の一部（なぜそのライブラリを選んだのか、前回どのアプローチで失敗したのかなど）は、その後も重要であり続けます。デフォルトフォルダのプランがクリーンアップされるとそれらの事実は消えてしまい、次のセッションのプランには一切含まれません。
MemoryLake は、それらの決定事項を管理可能な 1 つの場所に保管し、ChatGPT、Claude Code、Codex などの接続されたアシスタントで利用できるようにする記憶レイヤーです。
エントリーはあなた自身の言葉で記述します。プランファイル、Claude Code セッション、CLAUDE.md ファイル、自動記憶、またはベンダーのストレージから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。プランモードと plansDirectory は、Anthropic が説明している通りに動作し続けます。
ステップ 1: API キーを作成する
サインインし、ダッシュボードからキーを生成します。このキーは MemoryLake ワークスペースに属し、Claude アカウントとは別物です。
ステップ 2: 最初の記憶をアップロードする
解決策のステップ 3 で挙げた決定事項から始めましょう。採用した選択肢や却下したアプローチ、そしてそれぞれの理由を 1 行添えます。1 エントリーにつき 1 つのポイントを記述します。
ステップ 3: AI とエージェントを接続する
Claude Code やその他の使用しているアシスタントを接続します。次のプランは、利用可能な最新の決定事項を踏まえた状態で開始されます。
実践で何が変わるか
第一の違いは、プランを見つけられるようになることです。プランはリポジトリ内にあり、プロンプトに基づいた名前が付けられ、クリーンアップリストの対象外になります。
第二に、プランがセッションを越えて存続するようになります。コンパクションはファイルを再読み込みし、あなたが追加した理由も一緒に戻ってきます。
第三に、同じ議論を繰り返すことが減ります。先月却下したアプローチが記録されていれば、次のプランでそれが再び提案されることはありません。別のモデルでプランニングを行う場合は、セッション途中のモデル切り替えガイドで、それが会話に与える影響を確認してください。
Claude Code プランファイルのベストプラクティス
デフォルトフォルダを把握する。 plansDirectory を設定しない限り、プランは ~/.claude/plans/ に保存されます。
plansDirectory をプロジェクト内に設定する。 ルート外のパスはデフォルトにフォールバックします。
フォワードスラッシュを使用する。 macOS や Linux では、バックスラッシュを使用するとプランがデフォルトに戻されます。
チャットだけでなくファイルを編集する。 コンパクション後に復元されるのはファイルの内容です。
/clear の前にプランを保存する。 次の会話では新しいプランファイルが使用されます。
30 日間のクリーンアップに注意する。 これはデフォルトのプランフォルダに適用されます。
永続的な決定事項は CLAUDE.md に移動する。 プランは 1 つのセッションに属するものです。
結論
Claude Code は、承認を求める前にすべてのプランをファイルに書き込みます。デフォルトでは ~/.claude/plans/ にプロンプトに基づいた名前で保存されます。ファイルはコンパクション後にディスクから再注入され、/clear 後は新しいファイルが使用され、各フォークは独自のファイルを持ち、デフォルトフォルダは 30 日後にクリーンアップされます。
プランを保持するには、plansDirectory をプロジェクト内のフォルダに設定してください。プランを変更するにはファイルを編集し、理由をそこに記述し、セッション後も残すべき決定事項は再発見できる別の場所に移動させましょう。