読み込み中

長時間セッションを操縦する

レッスン 16 分
読み込み中

長時間セッションを操縦する

Claudeに手早いタスクをこなしてもらうのは簡単です。依頼すれば動き、結果を確認するだけです。しかし長時間のタスクはまったく別物です。十数個のファイルにまたがるリファクタリングや新機能の構築には何時間もかかることがあります。そして、その過程でClaudeを操縦する必要が増えるほど、作業は長引いていきます。

朗報なのは、こうした長時間セッションでClaudeを助けるためのツールがたくさんあるということです。結局のところ、2つの習慣に集約されます。Claudeが作業を始める前に範囲を定めること、そして実行中に操縦することです。両方を見ていきましょう。

まずプランモードで作業範囲を定める

Claudeが1行でも書く前に、プランを立てさせましょう。プランモードでは、Claudeはソースファイルを編集せずに調査を行います。コードを読み、何を変更する必要があるかを把握し、レビュー用のプランを提示します。

そのプランを受け取ったら、実際に読んでください。ざっと目を通すだけでは不十分です。プランが綿密であるほど、Claudeが実行を始めてから驚くことは少なくなります。何かがずれていたり抜けていたりする場合は、Claudeに希望する箇所へ追加するよう頼むだけで構いません。プランを反復する方が、Claudeを走らせてうまくいくことを願い、後で後始末をするよりもはるかに速いのです。

Claudeの作業中に操縦する

Claudeが動き出したら、正しい方向に向け続けるためのいくつかの方法があります。1つ目はコンテキスト圧縮です。

コンテキスト圧縮

コンテキスト圧縮は会話を要約し、その要約を新しいコンテキストとして使用し、古いメッセージを削除します。これによりコンテキスト ウィンドウに空きができ、Claudeは作業を続けられます。リスクは、要約の中で重要な何かが抜け落ち、Claudeが本筋から逸れてしまうことです。

そのため、/compact を単独で実行するだけにしないでください。コマンドの後に指示を加えて、Claudeにどう要約すべきかを伝えましょう。例えば、少し前にデバッグを終えて、今は一部のAPI変更だけが気になっているなら、そう伝えます。

/compact --version フラグの実装に焦点を当てる

コマンドの後に書いた内容が、要約が何を保持するかを決めます。それがコンテキストに対するあなたの操縦桿です。

巻き戻し

Claudeが誤った方向に進んでしまったとき、プロンプトで無理に引き戻す必要はありません。巻き戻しを使えば、直前のチェックポイントに戻れます。ユーザーのプロンプトはすべて、戻ることのできるチェックポイントを作成します。メニューを開くには、空のプロンプトでエスケープを2回押します。

巻き戻しメニューからは、いくつかの選択肢があります。

  • コードと会話を復元 - 両方をまとめて巻き戻します。
  • 会話を復元 - チャットだけを巻き戻します。
  • コードを復元 - ファイルだけを巻き戻します。
  • ここから要約 - チェックポイント以降のすべてを要約します。脇道にそれた会話があり、単に空き容量を確保したいときに最適です。
  • ここまで要約 - チェックポイント以前のすべてを要約します。長いセットアップ段階を圧縮したいが、実装部分はそのまま残しておきたいときに最適です。

Claudeをより自律的に動かす

ここまでの内容はすべて、あなたが手を動かし、見守りながら修正することを前提としています。もっと自律的なものが欲しい場合は、ゴールとループがあります。

ゴール

ゴールは完了条件を設定します。「完了」がどのような状態かを記述すると、Claudeは高速な評価器がその条件を満たしたと確認するまで、ターンをまたいで作業を続けます。最初に完了したと思った時点で単純に止まることはありません。

例えば:

/goal src/billing 内のすべてのテストが成功し、型チェッカーがエラーをゼロ件報告すること

キャンセルするには /goal clear を実行します。重要な制約が1つあります。評価器はトランスクリプトしか読みません。そのため、条件はClaudeが実際に生成する出力、例えばテスト実行の結果から確認できるものでなければなりません。

ループ

ループは、固定間隔または自己ペースのいずれかで、ターンの合間にプロンプトを実行します。CIの実行やデプロイなど、外部の何かをポーリングし、状態が変化したときに動作させるために使います。

自己ペースのループが次の実行を待っている間に止めるには、エスケープを押します。固定間隔のループは、Claudeにキャンセルを頼むか、7日が経過するまで実行され続けます。

worktreeで並行作業を実行する

ここまでの操縦の比喩は、1台の車に1つのハンドルがあることを前提としています。しかし、同じコードベースで複数のエージェントを動かしている場合、1台の車に2つのハンドルがあるのは望ましくありません。それは安全ではありません。同じファイルを巡って2つのClaudeセッションが競合すると、衝突が起こります。

そこでworktreeの出番です。セッション同士が互いを踏みつけ合う代わりに、それぞれが独立したファイルツリーを持つことになります。

各エージェントが自分自身のツリーを持つため、互いの変更を上書きすることはできません。セッションが終了すると、クリーンなworktreeは自動的に削除されます。

知っておくと便利なファイルが1つあります。リポジトリのルートにある .worktreeinclude ファイルには、各worktreeにコピーすべきgit管理外のファイルを列挙します。これは、すべてのworktreeで必要だがバージョン管理にはコミットしたくない環境変数ファイルやローカル設定などに便利です。

まとめ

長時間のClaude Codeセッションを扱うことは、いくつかの習慣に集約されます。

  1. まず作業範囲を定め、それから操縦する。
  2. コンテキスト圧縮の方向性を指示し、要約が重要な内容を保持するようにする。
  3. Claudeが逸れたときは、巻き戻しメニューを使って軌道修正する。
  4. 手順を説明するよりも「完了」を説明しやすい場合は、ゴールを設定する。
  5. worktreeで並行作業を実行する。

これを実践すれば、一つひとつの手順を見守らなくても、長時間の実行を信頼できるようになります。