Claude Code × Git Worktrees 並行作業ガイド：複数セッションを衝突なしで回す

guide_claude_code_worktrees.sections.why_worktrees_title

guide_claude_code_worktrees.sections.why_worktrees_subtitle

1. 1

   worktree とは

   git worktree は同じリポジトリの別ブランチを別フォルダにチェックアウトする仕組みです。各フォルダは自分のファイルだけを編集しますが、git データ自体は共有——feature1 フォルダは Feature-1 ブランチに留まり、main は自分のフォルダで一切影響を受けません。

   

2. 2

   最初のコミットを用意する

   worktree にはブランチを切れるリポジトリが必要です。動画では demo-app フォルダで git init、touch で index.html を作成し、git add と git commit でまとめてコミット。条件はコミットが1件以上あることだけで、あとは Claude Code が処理します。

   

guide_claude_code_worktrees.sections.parallel_sessions_title

guide_claude_code_worktrees.sections.parallel_sessions_subtitle

1. 3

   claude --worktree でセッション開始

   素の claude ではなく claude --worktree と入力します。ウェルカム画面にこのセッションの居場所が表示されます：demo-app ルートではなく .claude/worktrees/clever-munching-toast。ランダムな名前が並行セッションの衝突を防ぎます。

   

2. 4

   ターミナルをもう1つ開いて再実行

   並行化こそが本丸です。同じディレクトリでもう1つターミナルを開き、claude --worktree を再実行。今度は .claude/worktrees/spicy-napping-otter がルートになります。2つのエージェントが同じリポジトリの index.html を、互いの変更を見ずに同時編集できる状態です。

   

3. 5

   1つ目のセッションにタスクを渡す

   1つ目のセッションには「HTML を黒背景の hello world にして」と依頼します。index.html に24行を書き込み、Done と報告。セッションは自分の worktree だけを編集するので、メインのチェックアウトには一切影響しません。

   

4. 6

   2つの結果を並べて比較

   両セッションがページをブラウザで開きます。黒の hello world は clever-munching-toast の URL、紫の hello world は spicy-napping-otter の URL。間に挟まった Finder ウィンドウには .claude/worktrees のフォルダが見え、セッションごとにサブフォルダが1つ。同じリポジトリを2回チェックアウトし、それぞれ別々に変更した状態です。

   

guide_claude_code_worktrees.sections.subagent_isolation_title

guide_claude_code_worktrees.sections.subagent_isolation_subtitle

1. 7

   プロンプト1つでエージェントを5つ展開

   worktree 分離はその場で依頼することもできます。プロンプト1つ——サブエージェントを5つ起動し、HTML のクリエイティブな SaaS ランディングページ案を5つ、全員 git worktree 分離で——Claude Code は Running 5 Task agents と応え、Variation 1〜5 と各エージェントのツール使用回数・トークン数を一覧表示します。Ctrl+B で部隊をバックグラウンドへ回すことも可能。

   

2. 8

   部隊の完了を待つ

   数分後、全バリエーションが Done を報告——各4回のツール使用、約5万トークン。同じファイルの5つの異なるデザインが同時に存在し、メインのチェックアウトには誰も触れず、途中の stash やマージも不要でした。

   

3. 9

   worktree のパスで方向性を選ぶ

   Claude Code は5つのテーマ——Minimal Dark Mode、Gradient Dreamscape、Retro Terminal / Hacker、Soft Pastel / Friendly、3D / Isometric——をまとめ、それぞれの正確なファイルパス（.claude/worktrees/agent-a01ee76a/index.html など）を提示します。採用するなら、その worktree のブランチを残すだけです。

   

guide_claude_code_worktrees.sections.agent_config_title

guide_claude_code_worktrees.sections.agent_config_subtitle

1. 10

   分離付きサブエージェントを自然言語で頼む

   分離設定はエージェント定義に組み込めます。/clear の後の一文は「フロントエンド開発のサブエージェントを作成して。モデルは Haiku、worktree 分離を有効にして」。Claude Code はまず自前のサブエージェント文書を調べ、それから設定を組み立てます——YAML を手書きする必要はありません。

   

2. 11

   Claude Code がエージェントファイルを書く

   設定はプロジェクトに落ちてきます。mkdir -p で .claude/agents を作り、そこに frontend-dev.md を書き込み。プロジェクト単位のエージェントはこのフォルダ——skills と同じ場所——に置かれるので、定義はリポジトリと一緒に運ばれます。

   

3. 12

   並行化を約束するあの一行

   フロントマターにすべてが書かれています：name、description、model: haiku、そして isolation: worktree と、Read・Edit・Write・Bash・Glob・Grep のツールホワイトリスト。今後このエージェントが呼ばれるたび、専用の git worktree が自動で用意されます——フラグも、プロンプトでの前置きも不要です。

   

合わせて読みたい