Claude Codeのgit worktree並列実行は、複数のAIセッションを「別々の作業ディレクトリ」に分けて同時に動かす手法です。同じリポジトリを共有しつつ、各セッションのファイル編集が互いに干渉しないため、1つのターミナルで新機能を作りながら、別のターミナルでバグ修正を進める、といった並行開発が安全に行えます。順番に見ていきましょう。

スポンサーリンク

git worktreeとは？なぜAI並列開発に向くのか

git worktree は、1つのリポジトリから複数の作業ディレクトリを作れるGitの標準機能です。各ワークツリーは独自のファイルとブランチを持ちますが、リポジトリの履歴とリモートは共有します。

通常、1つのフォルダで複数の作業を並行すると、ブランチの切り替えのたびにファイルが上書きされ、AIエージェント同士が同じファイルを触って衝突します。worktreeで作業場所を物理的に分ければ、「片方のセッションの編集が、もう片方のファイルに触れない」状態を作れます。これがAI並列開発と相性が良い理由です。

Claude Codeでworktreeを使う3つの方法

① –worktree フラグで分離セッションを起動する（基本）

いちばん簡単なのは、起動時に --worktree（短縮形 -w）を渡す方法です。分離されたworktreeを作り、その中でClaudeを起動します。

claude --worktree feature-auth

デフォルトでは、worktreeは .claude/worktrees/feature-auth/ に作られ、worktree-feature-auth という新しいブランチ上で開始します。名前を省略すると、bright-running-fox のような名前が自動生成されます。

claude --worktree        # 名前は自動生成

② セッション中に「worktreeで作業して」と頼む

すでに起動中のセッションからでも、自然言語でworktreeに移れます。

このタスクは worktree を作って、その中で作業して

Claudeが EnterWorktree ツールで新しいworktreeを作成し、そこへ切り替えます。元のworktreeはディスク上にそのまま残ります。

③ git worktree add で手動管理する

worktreeの場所やブランチを自分で完全に制御したい場合は、Gitコマンドで直接作ります。リポジトリの外に置きたいときや、既存ブランチをチェックアウトしたいときに便利です。

# 新しいブランチで worktree を作る
git worktree add ../project-feature-a -b feature-a

# 既存ブランチから作る
git worktree add ../project-bugfix bugfix-123

# その中で Claude を起動
cd ../project-feature-a && claude

複数セッションを並列で走らせる（実践）

並列実行のやり方はシンプルです。ターミナルを複数開き、それぞれ別の名前で --worktree を実行するだけです。

# ターミナル1：新機能の開発
claude --worktree feature-auth

# ターミナル2：別の不具合を修正
claude --worktree bugfix-123

2つのClaudeセッションが別々のディレクトリ・ブランチで動くため、同時に編集してもファイルが衝突しません。フロントエンド・バックエンド・テストをそれぞれ別セッションに割り当てて、開発を一気に進めるといった使い方ができます。

サブエージェントをworktreeで分離する（isolation: worktree）

1つのセッション内で複数のサブエージェントを並列で動かす場合も、worktreeで分離すれば編集が競合しません。カスタムサブエージェントのフロントマターに isolation: worktree を追加すると、常にworktreeで実行されるようになります。

---
name: backend-builder
description: バックエンドAPIの実装を担当
isolation: worktree
---

各サブエージェントは一時的なworktreeを受け取り、変更なしで完了すれば自動的に削除されます。その場限りで「worktreeを使って」と頼むだけでも分離できます。チーム開発での役割分担はチーム開発を始める完全ガイドも参考になります。

環境ファイル（.env）を引き継ぐ：.worktreeinclude

worktreeは新しいチェックアウトなので、.env や .env.local のような追跡されていないファイルは存在しません。そのままだと「環境変数がなくて動かない」とつまずきがちです。

プロジェクトルートに .worktreeinclude を置くと、新しいworktree作成時に自動でコピーされます。記法は .gitignore と同じです。

# .worktreeinclude
.env
.env.local
config/secrets.json

これは --worktree・サブエージェントのworktree・デスクトップアプリの並列セッションすべてに適用されます。なお、各worktreeでは依存関係のインストール（npm install など）も改めて必要です。

後始末（クリーンアップ）と注意点

worktreeは作りっぱなしにすると散らかります。終了時の挙動を押さえておきましょう。

手動で整理するコマンドはこちらです。

git worktree list                       # 一覧を確認
git worktree remove ../project-feature-a   # 削除
# 変更が残っている場合は --force を付ける

よくある質問（FAQ）

Q. worktreeとブランチ切り替えは何が違う？

ブランチ切り替え（git switch）は1つのフォルダの中身を入れ替えますが、worktreeはフォルダ自体を別に持ちます。そのため複数ブランチを同時に開いて、並行作業できます。

Q. 何セッションまで並列にできる？

技術的な固定の上限はなく、ターミナルを増やせばその分動かせます。ただしマシンのCPU・メモリやAPIの利用枠が現実的な上限になります。まずは2〜3並列から試すのが無難です。

Q. worktreeのファイルが消えた？

削除を選ぶと、未コミットの変更ごとworktreeが消えます。残したい変更は削除前に必ずコミットしてください。

Q. Git以外（SVNなど）でも使える？

worktree分離はデフォルトでGit用ですが、WorktreeCreate／WorktreeRemove フックを設定すれば、SVNやMercurialでも独自の作成・削除ロジックを組めます。

まとめ

git worktreeを使えば、Claude Codeを「1人のAI」から「並行して働く複数のAI」へと拡張できます。まずは2つのターミナルで --worktree を試し、機能開発とバグ修正を同時に走らせる感覚をつかんでみてください。Git操作そのものの任せ方はClaude CodeでGit操作を自動化する方法で解説しています。

関連記事：Claude CodeでGit操作を自動化する方法 ／ Claude CodeのGitやらかしを元に戻す方法