なぜ Worktrees?
Claude Code に 複数のタスクを同時に走らせる、または リスキーな作業を隔離する 場面で git worktree が劇的に効きます。
従来のフロー (worktree なし)
[main 作業ツリー]
├ feat/oauth ブランチで作業中
├ urgent: 緊急バグ修正したい
↓
git stash # 退避
git checkout main
git checkout -b hotfix/xxx
# 修正...
git checkout feat/oauth
git stash pop # 戻す ← 競合の可能性
→ 切替えごとに stash / checkout / 競合解決 が発生。Claude Code を 2 つ立ち上げて並行作業も難しい。
worktree を使うと
my-app/ # メイン (feat/oauth ブランチ)
└ claude (作業中)
my-app-hotfix/ # 別ディレクトリ (hotfix/xxx ブランチ)
└ claude (緊急対応)
→ 2 つの別ディレクトリで別ブランチを同時にチェックアウト。stash 不要、お互い独立。 両方で同時に Claude Code を立てて並行作業できる。
基本コマンド
worktree を追加
git worktree add ../my-app-hotfix -b hotfix/issue-42
cd ../my-app-hotfix
claude
→ ../my-app-hotfix/ に新しい作業ツリーが作成され、hotfix/issue-42 ブランチがチェックアウトされる。
.git は元のリポジトリと共有 (容量を食わない)。
既存ブランチをチェックアウト
git worktree add ../my-app-review feat/review-pr-123
レビュー用に PR ブランチを別ディレクトリに展開。
一覧を見る
git worktree list
# /home/user/my-app abc123 [feat/oauth]
# /home/user/my-app-hotfix def456 [hotfix/issue-42]
# /home/user/my-app-review 789012 [feat/review-pr-123]
削除
# 1. 作業ツリーを削除
git worktree remove ../my-app-hotfix
# 2. ブランチも消すなら
git branch -d hotfix/issue-42
Claude Code との連携: isolation: worktree
Claude Code の Agent ツール には isolation: "worktree" オプションがあります。
何が起きるか
ユーザー: 「リスキーな大規模リファクタを試して」
↓
Claude (メイン) → Agent サブを isolation: worktree で起動
↓
[サブエージェント]
git worktree add /tmp/cc-experiment-xxx -b cc-experiment-xxx
cd /tmp/cc-experiment-xxx
# ...作業...
↓
変更があれば: ブランチとパスを返す (人がレビュー → merge or 破棄)
変更がなければ: worktree を自動削除
→ リスキーな実験をメインの作業ツリーから完全に隔離。最悪サブが暴走しても、メインの作業は無傷。
使い分け
| シーン | 推奨 |
|---|---|
| 確実に通したい変更 | メインで普通に作業 |
| 試してみたいリファクタ | isolation: worktree のサブ |
| 並行で複数案を試す | 各案を別 worktree で |
| 信頼度の低いコード生成 | 必ず worktree で隔離 |
並列パターン 1: 「同じタスクを 3 つの方法で試す」
ユーザー: 「キャッシュ層を Redis / Memcached / in-memory の 3 案で試して、
それぞれ性能を計測したい」
↓
Claude (メイン) → 3 つの subagent を並列起動 (各 isolation: worktree)
├─ subagent A: ../experiment-redis (cache/redis 実装)
├─ subagent B: ../experiment-memcached (cache/memcached 実装)
└─ subagent C: ../experiment-inmemory (cache/inmem 実装)
↓ 各々が pytest --benchmark を実行
↓
3 つの結果を集約 → ユーザーに比較表で提示
これは Claude Code を 真の並列開発機械 に変える使い方。
並列パターン 2: 「ベース修正 + 並行で関連タスク」
[main worktree]: 認証バグの根本修正 (Claude Code セッション 1)
[../docs worktree]: 関連ドキュメント更新 (Claude Code セッション 2)
[../tests worktree]: テストカバレッジ拡充 (Claude Code セッション 3)
→ 3 つの Claude Code を別 IDE タブで同時に動かせる。お互いの状態を意識せず作業可能。
注意とハマりどころ
① 同じブランチを 2 つの worktree でチェックアウトできない
$ git worktree add ../experiment feat/oauth # 既に main にチェックアウト中
fatal: 'feat/oauth' is already checked out at '/home/user/my-app'
→ 別ブランチを切るか、-B で強制 (危険なので非推奨)。
② worktree のディレクトリを rm -rf で消した
rm -rf ../my-app-hotfix # 物理削除はしたけど git は知らない
git worktree list # まだ残ってる表示
git worktree prune # ← これで掃除
③ submodule との相性
submodule を含むリポジトリでは worktree 作成後に git submodule update --init が必要。
④ IDE が worktree を別プロジェクトと認識する
VS Code は worktree を別 workspace として開く。共有設定 (.vscode/) はメインから symlink するか、各 worktree にコピー。
ベストプラクティス
| やる | やらない |
|---|---|
| ✅ リスキーな実験は worktree で | ❌ main 作業ツリーで実験 |
✅ 終わったら worktree remove |
❌ rm -rf で物理削除 |
✅ 命名規約を決める (<repo>-<purpose>) |
❌ 適当な名前で増殖 |
✅ .gitignore の instance/ などを共有 |
❌ DB ファイルを worktree 間で共有 |
💡 worktree は git の隠れた最強機能。Claude Code 時代において再評価されています。
私は EC サイトを開発中です。次の 3 タスクを並行で進めるための git worktree 構成を提案してください。1) main の小さなバグ修正 2) 大規模なカート機能リファクタ (実験的) 3) リリースノートの執筆。各 worktree のディレクトリ名・ブランチ名・推奨される使い方を示してください。