Checkpoint と Worktree で並列作業

コース構成

このコースで学ぶこと

1. 01

   Checkpoint：セッション内 Undo

   Claude が編集する直前に自動でスナップショット。Esc 2 回で巻き戻せる。Git とは別系統。

   Checkpoint は『コードと会話の両方』のスナップショットを取ります。Claude の編集が想定外だったら、Esc 2 回 / `/rewind` で巻き戻せます。

   注意：Git のコミット履歴とは別系統です。Bash 経由の変更（`rm` 等）は追跡しません。`/rewind code` でコードだけ、`/rewind chat` で会話だけ、両方は `/rewind both`。

   • Esc 2 回 = 直前のチェックポイントへ
   • /rewind code = コードだけ巻き戻し、会話は維持
   • /rewind chat = 会話だけ巻き戻し、コードは維持
   • Git は独立、コミット履歴は変わらない

   用語: Checkpoint

   理解度チェック

   1. Q1.Claude が直前にしたコード編集だけを元に戻し、会話履歴は残したいときに使うのは？

      A`/rewind both`B`/rewind code`C`/rewind chat`D`git reset --hard`
   Checkpoint の活用パターン
2. 02

   Checkpoint の活用パターン

   「やってみて気に入らなかったら戻す」が気軽にできるようになる。

   • 🟢 大胆なリファクタを試す（失敗したら戻す）
   • 🟢 複数の実装案を比較する（A 試す → 戻す → B 試す）
   • 🟢 試行錯誤的なデバッグ（ダメな方向を進んだら戻す）
   • 🟡 ただし Bash 経由の変更（`rm`・`git push` 等）は戻せない

   理解度チェック

   1. Q1.Checkpoint で“戻せない”操作はどれ？

      AClaude が Edit ツールで行ったコード編集BClaude が Write ツールで作った新規ファイルCBash 経由で実行された `rm -rf` や `git push --force`DClaude の会話履歴
   Checkpoint：セッション内 UndoWorktree：並列セッション
3. 03

   Worktree：並列セッション

   Git worktree で別ブランチに別ディレクトリを作り、別ターミナルで Claude を起動。3 つの作業を同時進行。

   1 つのリポジトリで複数 Claude セッションを並走させると、互いのファイルを上書きして衝突します。Git worktree を使うと、同じリポジトリの別ブランチを別ディレクトリで開けるので、3 つの Claude が干渉せず動けます。

   bash

   # 作業ツリーを 3 つ作る
   git worktree add ../my-repo-feat-a feat/a
   git worktree add ../my-repo-feat-b feat/b
   git worktree add ../my-repo-bugfix bugfix/login
   
   # 各ディレクトリで別の Claude を起動
   cd ../my-repo-feat-a && claude   # ターミナル 1
   cd ../my-repo-feat-b && claude   # ターミナル 2
   cd ../my-repo-bugfix && claude    # ターミナル 3
   
   # 作業終了後、worktree を削除
   git worktree remove ../my-repo-feat-a

   理解度チェック

   1. Q1.1 つのリポジトリで Claude を 3 つ同じディレクトリで並走させると起きる事故は？

      AGit の commit が高速化するB各セッションが同じファイルを同時編集し、上書き競合や中途半端な状態になるCClaude が自動で互いを連携してくれるDAnthropic 側で課金が割引される
   Checkpoint の活用パターン/branch と --worktree-isolation
4. 04

   /branch と --worktree-isolation

   Subagent が同じファイルを触るのを防ぐ、組み込みの isolation 機能。

   • **`/branch [name]`**（alias `/fork`） — 会話内で現セッションから分岐
   • **`claude --resume <id> --fork-session`** — CLI から再開時に新 ID で分岐起動
   • **`-w / --worktree`** — 一時的な git worktree で起動、`.claude/worktrees/` 配下に隔離
   • Subagent の `isolation: worktree` 設定で、自動 worktree 化
   • 並列で 5 つの Subagent が同時にコード書く、なんてことも可能

   理解度チェック

   1. Q1.自作 Subagent を並列でコード編集させるとき、競合を避ける宣言は？

      ASubagent の YAML に `isolation: worktree` を設定するB`tools: []` を空にするC`model: opus` に固定するDSubagent の数を 1 つに絞る
   Worktree：並列セッション使い分けの定石
5. 05

   使い分けの定石

   Checkpoint / Worktree / 分岐コマンドの選び方。

   • **同じセッションで失敗を戻したい** → Checkpoint (Esc 2 回 / `/rewind`)
   • **別の作業を並行で進めたい** → Worktree + 別ターミナル
   • **今のセッションを残しつつ別案を試したい** → 会話内 `/branch`（alias `/fork`）、または CLI 再開時 `--fork-session`
   • **Subagent を並列で安全に走らせたい** → isolation: worktree

   手を動かす

   0 / 3

   • 次の Claude セッションで意識的に Esc 2 回を 1 回試す
   • 今週、並行作業が必要なら worktree を 1 セット作ってみる
   • Subagent を自作する時は isolation: worktree を最初から設定

   Lv.5 — Checkpoint と Worktree

   理解度チェック

   1. Q1.“今のセッションは残したまま別案を試したい”ときの正しい選択は？

      AEsc 2 回で Checkpoint に戻すB新しいターミナルで `git worktree add` するC会話内なら `/branch [name]`、CLI から再開時なら `--fork-session` で分岐Dプロジェクトを丸ごとクローンし直す
   /branch と --worktree-isolation