用語集

Gitワークツリーとは？

Gitワークツリーは、専用ブランチを持つリポジトリの別コピーです。メインのリポジトリとGit履歴を共有しますが、ファイルは別のフォルダにあります。必要な数だけ同時に開けます。

ワークツリーが解決する問題

通常、リポジトリは1つのフォルダで、チェックアウトできるブランチも1つです。2つの機能を同時に進めるには、変更をstashし、ブランチを切り替え、別の作業をして、元のブランチに戻り、stashを戻します。面倒です。

ワークツリーなら、別のブランチを開いた2つ目のフォルダを作れます。片方で機能A、もう片方で機能Bを進められます。stashも切り替えも不要です。両方を同時に開いておけます。

AIエージェントに重要な理由

2つのAIエージェントを同じフォルダで動かすと、互いの変更を上書きします。エージェントAがauth.tsを編集します。エージェントBもauth.tsを編集します。最後に保存した方だけが残り、もう一方の作業は消えます。

ワークツリーなら防げます。各エージェントに専用のフォルダ、ブランチ、ファイルのコピーを用意します。同じauth.tsを同時に編集してもぶつかりません。終わったら、各ブランチを個別にマージします。

ディスク上ではこう見える

my-project/              ← your main repo (main branch)
../my-project-feature-a/ ← worktree (feature-a branch)
../my-project-feature-b/ ← worktree (feature-b branch)

3つのフォルダは同じGit履歴を共有します。あるワークツリーでcommitした変更は、マージ後にほかのワークツリーからも見えます。commit前のファイル変更は完全に分離されます。

Paneによる自動化

Gitコマンドを自分で打つ必要はありません。Paneで新しいPaneを作ると、次の処理が走ります。

1. Paneがワークツリーとブランチを作ります。
2. 環境変数、node_modules、重要なディレクトリをコピーします。エージェントはすぐに作業を始められます。
3. Paneをアーカイブすると、Paneがワークツリーを自動で片付けます。

手動で行う方法

Paneを使わずに行う場合は、次のようになります。

git worktree add ../feature-a feature-a
cd ../feature-a
claude   # start your agent here

# when done:
git worktree remove ../feature-a

Paneなら、すべてワンクリックです。

関連ドキュメント

著者 Parsa Khazaeepoul

最終更新：2026年6月24日