AIツール活用

git worktreeとは?使い方とAIエージェントを並列で動かす方法

中島大介(なかじ)読了時間 約28分
Git worktreeの使い方とAIエージェントの並列実行を解説する記事のアイキャッチ

Claude Codeにお問い合わせフォームの修正を頼んでいる間に、料金ページの表記修正も別のAIに進めてほしい場面があります。1つのフォルダで2つのAIを同時に動かすと、片方の書きかけの変更がもう片方の作業に混ざり、どちらの修正なのか見分けられなくなります。

混ざる原因はAIの性能ではなく、1つの作業フォルダを2つのAIで取り合っている状態です。AIを並列で動かす土台は、作業1件ごとにworktreeを1つ用意することです。

本記事では、Git worktreeの仕組みと基本コマンド、つまずきやすい点を押さえたうえで、Claude Code・Codexを並列で動かす手順と並列ツールの選び方を解説します。

この記事を読めば、Git worktreeでAIに2つの作業を同時に任せる方法が分かり、自分に合う並列ツールを判断できます。

目次

Git worktreeとは1つのリポジトリで作業フォルダを複数持てるGitの機能

Git worktreeは、1つのリポジトリ(ファイルと変更履歴のまとまり)に作業フォルダを複数持たせるGitの標準機能です。Git 2.5から搭載されていて、追加のツールは要りません。AIごとに専用の作業フォルダを渡せるため、複数のAIを同時に動かすときの土台になります。

Git worktreeを理解するために押さえたい点は、以下の3つです。

  • ブランチを切り替えずに別の作業を同時に進められる
  • Git worktreeはブランチやcloneとは役割と履歴の持ち方が異なる
  • 同じブランチは2つのworktreeで同時に使えない

ブランチを切り替えずに別の作業を同時に進められる

Git worktreeを使うと、ブランチごとに別の作業フォルダを開き、複数の作業を同時に進められます。通常のGitでは作業フォルダが1つしかないため、別のブランチへ移るたびに書きかけの変更のコミットか、一時的な退避(stash)が必要です。

Gitでは、最初からある作業フォルダを「main worktree」、増やした作業フォルダを「linked worktree」と呼びます。どちらも同じリポジトリの変更履歴を使うため、1つのフォルダで作ったコミットを別のフォルダからすぐに参照できる仕組みです。

AIエージェントにとっての利点は、AIごとに専用の作業フォルダを渡せることです。Claude Codeが編集するフォルダとCodexが編集するフォルダを分ければ、同時に動かしても書きかけのファイルは混ざりません。

Git worktreeとブランチ・cloneの違い

ブランチは変更履歴の分かれ道で、worktreeはブランチを広げて作業する机にあたります。リポジトリを丸ごと複製するgit cloneでも作業フォルダは増やせますが、履歴の持ち方が異なります。

ブランチの切り替え・Git worktree・git cloneの違いは、以下の表のとおりです。

項目ブランチの切り替えだけGit worktreegit cloneで複製
作業フォルダ1つの中身を入れ替えるブランチごとに増やせる複製ごとに増える
変更履歴(.git)1つ全フォルダで共有複製ごとに別々
同時の作業できないできるできる

同じブランチは2つのworktreeで同時に使えない

Git公式ドキュメントによると、ほかのworktreeで開いているブランチを新しいworktreeで開こうとすると、Gitは作成を断ります。ブランチは最新のコミットを指す1本の目印で、2つのフォルダから同時に進めると整合性が崩れるためです。

ほかのworktreeで使っているブランチを開こうとして、Gitが断ったところ。「is already used by worktree」は、そのブランチを別の作業フォルダで使っているという意味

片方のフォルダでコミットするとブランチは先へ進みますが、もう片方のフォルダのファイルは古いまま残ります。古いファイルのままコミットすると、直前の変更を取り消してしまう恐れがあります。

回避策は、worktreeごとに新しいブランチを作ることです。中身を見るだけなら、git worktree add -d <フォルダ>でブランチに属さない状態(detached HEAD)のworktreeを作れます。--forceで制限を外すこともできますが、AIの並列作業では使わない運用が安全です。

「git worktree add -d」で、ブランチに属さない状態の作業フォルダを作ったところ

Git worktreeの基本コマンドと使い方

Git worktreeの操作は、すべて「git worktree」に続くサブコマンドで行います。作業フォルダの作成・確認・片付けのコマンドを覚えれば、AIに渡す作業フォルダを自分で用意して管理できます。

Git worktreeの主なサブコマンドは、以下の表のとおりです。

コマンドできること
git worktree add新しい作業フォルダを作る
git worktree list作業フォルダの一覧を表示する
git worktree remove作業フォルダを削除する
git worktree prune手で消したフォルダの記録を掃除する
git worktree repair移動で切れた記録をつなぎ直す

Git worktreeのサブコマンドのうち、日常の作業でよく使うのは次の4つです。

  • git worktree addで作業フォルダとブランチを作る
  • git worktree listで作業フォルダの一覧を確認する
  • git worktree removeで終わった作業フォルダを片付ける
  • git worktree pruneで消えたフォルダの記録を掃除する

git worktree addで作業フォルダとブランチを作る

新しい作業を始めるときは、-bオプションでブランチと作業フォルダを同時に作ります。お問い合わせフォームの修正なら、git worktree add -b fix/contact-form ../site-contact-formを実行します。すると、今いるブランチの最新コミットを起点に、ブランチ「fix/contact-form」と作業フォルダ「site-contact-form」ができます。

siteフォルダで実行したところ。新しいブランチと作業フォルダができると「Preparing worktree (new branch …)」と表示される

git worktree addの主な書き方は、以下のとおりです。

  • 新しいブランチで始める:git worktree add -b <ブランチ名> <フォルダ>
  • 既存のブランチを開く:git worktree add <フォルダ> <ブランチ名>
  • フォルダ名と同じ名前のブランチを自動で作る:git worktree add <フォルダ>

作業フォルダは、元のリポジトリの外(隣のフォルダなど)に置くと管理しやすくなります。リポジトリの中に置くと、元のフォルダで未追跡のファイルとして表示されるためです。Claude Codeを使う場合は、Claude Codeの公式ドキュメントが勧めるとおり、worktreeの置き場所になる.claude/worktrees/を.gitignoreに加えておきます。

git worktree listで作業フォルダの一覧を確認する

git worktree listを実行すると、作業フォルダの場所・最新コミット・ブランチ名が1行ずつ表示されます。AIを複数動かしているときに、どのフォルダがどのブランチかを確かめる基本の操作です。

作業フォルダの場所、最新コミットの番号、[ ]の中のブランチ名が1行ずつ並ぶ

git worktree removeで終わった作業フォルダを片付ける

作業が終わったworktreeは、git worktree remove ../site-contact-formのようにフォルダを指定して削除します。削除できるのは、変更も未追跡のファイルも残っていないworktreeだけです。

削除が成功しても何も表示されない。続けて「git worktree list」を実行すると、一覧から消えている

コミットしていない変更があるとGitは削除を断り、変更を捨ててよい場合に限って--forceで削除できます。最初からある作業フォルダ(main worktree)は削除できません。

変更や未追跡のファイルが残っていると、Gitは削除を断る

worktreeを削除しても、ブランチは残ります。マージ済みで不要になったブランチは、git branch -d fix/contact-formで別に削除しましょう。

「Deleted branch」と表示されれば、ブランチは削除されている

git worktree pruneで消えたフォルダの記録を掃除する

Gitを通さずにworktreeのフォルダを消すと、リポジトリの中に記録だけが残ります。記録だけが残ったworktreeは、git worktree listで「prunable」と表示されます。git worktree pruneは、フォルダがなくなったworktreeの記録を削除するコマンドです。

「prunable」は掃除できる記録の印。「git worktree prune」の後は一覧から消える

worktreeの移動は、git worktree move <今のフォルダ> <移動先>で行います。

Gitで移動すると、一覧の場所も一緒に変わる

手で動かして記録が切れたときは、動かした先のフォルダを指定してgit worktree repairを実行すると、記録をつなぎ直せます。

手で動かした先のフォルダを指定して「git worktree repair」を実行したところ。一覧の場所が新しいフォルダに直る

Git worktreeでつまずきやすい注意点

Git worktreeは作業フォルダを増やすだけの機能です。設定ファイルや開発サーバー、AIの権限は、worktreeとは別に整える必要があります。

Git worktreeでつまずきやすい点は、以下の4つです。

  • .envやnode_modulesは新しいworktreeに入っていない
  • 開発サーバーのポート番号がぶつかる
  • submoduleを使うリポジトリには完全に対応していない
  • worktreeはAIの操作範囲を制限しない

.envやnode_modulesは新しいworktreeに入っていない

新しいworktreeに入るのは、Gitで管理されているファイルだけです。.gitignoreで管理対象から外した.env(接続先やAPIキーを書く設定ファイル)やnode_modules(npm installで入る依存ライブラリ)は、元のフォルダにあってもコピーされません。

依存ライブラリは、作業フォルダごとにインストールし直します。.envは手でコピーするか、Claude Code・Codex・Orcaが対応する.worktreeincludeに対象を書き、worktreeの作成時に自動でコピーさせます。.worktreeincludeはGit本体ではなく各ツールの機能で、書式は.gitignoreと同じです。

本番環境の認証情報を含む.envは、AI用のworktreeへコピーしない運用が安全です。コピーした数だけ、秘密の情報を置く場所が増えてしまいます。

開発サーバーのポート番号がぶつかる

2つのworktreeで開発サーバーを起動すると、同じポート番号(アプリを開く窓口の番号)を取り合います。1つのポート番号は1つのプログラムしか使えないので、2つ目の起動が失敗する場合があります。表示の確認を並べるときは、worktreeごとにポート番号を変えて起動しましょう。

submoduleを使うリポジトリでは動作が不完全

Git公式ドキュメントによると、Gitの複数の作業フォルダの機能はまだ実験的な扱いで、submodule(別のリポジトリを部品として組み込む仕組み)への対応は不完全です。submoduleを含むリポジトリで複数のworktreeを作る使い方は推奨されていません。

worktreeはAIの操作範囲を制限しない

VS Codeの公式ドキュメントによると、worktreeで分かれるのは作業ファイルだけです。AIがパソコンのほかのフォルダや外部のサービスにアクセスできる状態は変わりません。AIの操作確認の省略を既定にした並列ツールもあるため、AIに許可する操作の範囲は各AIの権限設定で決めます。

Git worktreeでClaude Code・Codexを並列で動かす手順

Git worktreeでAIを並列で動かすときは、作業ごとにworktreeを分けてAIを起動し、終わったら変更をmainへまとめます。会社のWebサイトのリポジトリ「site」で、2つの修正を同時に任せる場面を例に説明します。担当は、お問い合わせフォームの修正がClaude Code、料金ページの表記修正がCodexです。

Claude CodeとCodexの始め方は、それぞれの使い方の記事で解説しています。

Claude Codeの使い方を解説!導入から日本語での依頼・変更確認まで

Codexの使い方を解説!CLIの導入から日本語での依頼・変更確認まで

Git worktreeでAIを並列で動かす流れは、以下の2段階です。

  1. 作業ごとにworktreeを作ってAIを起動する
  2. AIの変更を確認してmainにまとめる

作業ごとにworktreeを作ってAIを起動する

AIを起動する前に、作業1件につき1つのworktreeを用意します。お問い合わせフォームと料金ページの2件を並べる手順は、以下のとおりです。

  1. siteフォルダでgit switch mainとgit pullを実行し、mainを最新の状態にそろえる
  2. git worktree add -b fix/contact-form ../site-contact-formでフォーム修正用のworktreeを作る
  3. git worktree add -b fix/pricing-text ../site-pricing-textで料金ページ用のworktreeを作る
  4. 1つ目のターミナルでcd ../site-contact-formを実行し、依存ライブラリと.envを用意してclaudeを起動する
  5. 2つ目のターミナルでcd ../site-pricing-textを実行し、同じ準備をしてcodexを起動する
  6. それぞれのAIに依頼を書き、作業を任せる

手順1から手順3までを実行したときの画面は、以下のとおりです。

手順1。mainが最新なら「Already up to date.」と表示される
手順2。フォーム修正用のブランチと作業フォルダができる
手順3。料金ページ用のブランチと作業フォルダができる

Claude Codeはsite-contact-formの中だけを、Codexはsite-pricing-textの中だけを編集するので、書きかけの変更は混ざりません。

AIの変更を確認してmainにまとめる

AIが作業を終えたら、各worktreeでgit diffを実行して変更点を確かめます。

例として、入力欄を必須にする変更を加えたsite-contact-formで「git diff」を実行したところ。赤い行が消えた行、緑の行が足された行

問題がなければ、worktreeの中でコミットします。変更したファイルをまとめてコミットするときは、git commit -am "メッセージ"を実行します。新しく作られたファイルがある場合は、先にgit addでコミットの対象に加えます。

worktreeの中でコミットしたところ。[ ]の中にブランチ名が表示される

mainへまとめる方法は、リポジトリの管理の仕方で分かれます。

  • チームでレビューを受ける場合:ブランチをpushしてプルリクエストを作る
  • 1人で管理するリポジトリの場合:siteフォルダでgit merge fix/contact-formとgit merge fix/pricing-textを順に実行する

1人で管理するリポジトリで、siteフォルダから2つのブランチを順にマージしたときの画面は、以下のとおりです。

1つ目のマージ。mainがそのまま先へ進む(Fast-forward)

2つ目のマージでは、マージの記録に付けるメッセージを書く画面(エディタ)が開きます。Macで特に設定していなければvi(Vim)が開くので、そのままの文で良ければ「:wq」と入力してEnterキーを押します。

マージのメッセージを書く画面。「:wq」と入力してEnterキーを押すと、保存して閉じる
2つ目のマージが終わったところ

2つのAIが同じファイルの同じ箇所を変えていた場合は、2本目のマージで衝突(コンフリクト)が起きます。衝突を避けるには、フォームと料金ページのように触るファイルが重ならない作業を組み合わせるのが近道です。

まとめ終えたworktreeはgit worktree removeで削除し、ブランチもgit branch -dで片付けます。

同時に動かすAIの数は、人が差分を確認できる量に合わせて決めます。最初は2つの作業から始め、確認が追いつくと分かってから3つ目を足す進め方がおすすめです。

Claude Codeのworktree機能(--worktree)の使い方

Claude Codeには、worktreeを作ってからセッションを始める機能があります。Git worktreeのコマンドを自分で打たなくても、Claude Codeの起動と同時に専用の作業フォルダを用意できます。

Claude Codeのworktree機能の主な使い方は、以下の3つです。

  • claude --worktreeでworktreeを作ってClaude Codeを起動する
  • 終了時にworktreeを残すか削除するかを選ぶ
  • サブエージェントも別々のworktreeで動かせる

claude --worktreeでworktreeを作ってClaude Codeを起動する

claude --worktree fix-contact-form(短縮形は-w)を実行すると、リポジトリ直下の.claude/worktrees/fix-contact-form/にworktreeができます。Claude Codeは、作られたworktreeの中で起動します。ブランチ名は「worktree-fix-contact-form」です。別のターミナルで名前を変えて同じコマンドを実行すれば、2つ目の独立したセッションを始められます。

新しいworktreeの起点は、既定ではリモートの既定ブランチ(通常はmain)です。Claude Codeのworktreeは既存のコミットから作るため、コミットが1つもないリポジトリでは使えません。

新しいworktreeには依存ライブラリや.envが入っていないため、Claude Codeにインストールを頼むか、.worktreeincludeを用意しておきましょう。Claude Codeのデスクトップアプリでは、セッションの開始時にworktreeのオプションを選びます。

終了時にworktreeを残すか削除するかを選ぶ

worktreeのセッションを終了すると、Claude Codeはworktreeに変更や新しいコミットが残っていないかを確認します。変更がなく名前も付けていないセッションなら、worktreeとブランチは自動で削除されます。変更が残っている場合に出るのは、worktreeを残すか削除するかの確認です。

残したworktreeに戻るときは、終了時に表示されるclaude --worktree <名前> --resumeを実行します。

サブエージェントも別々のworktreeで動かせる

Claude Codeが作業を分担させるサブエージェントも、それぞれ専用のworktreeで動かせます。会話の中で「エージェントごとにworktreeを使って」と頼むか、カスタムのサブエージェントの定義に「isolation: worktree」を書くと、専用のworktreeで動くようになります。

Claude Codeのサブエージェントの基本は、別の記事で解説しています。

Claude Codeのサブエージェントとは?使い方・作り方を徹底解説!

AIエージェントを並列で動かすツールの選び方

Git worktreeを手で使う方法のほかに、worktreeの作成をツールに任せる方法もあります。ツールによってworktreeを作る担当や対応OSが違うため、使うAIと作業の進め方に合わせて選びましょう。

並列ツールの選び方と各ツールの特徴は、以下のとおりです。

  • 目的に合わせて並列ツールを選ぶ
  • CodexはChatGPTアプリでWorktreeを選ぶ
  • Orcaは作業ごとにworktreeを自動で作る
  • cmuxではworktreeを自分で組み立てる
  • OpenCodeなどほかのAIもworktreeで並列にできる

目的に合わせて並列ツールを選ぶ

並列ツールを選ぶときの分かれ目は、worktreeを誰が作り、複数のAIをどの画面で見るかです。並列ツールを含む主な方法の違いは、以下の表のとおりです。

方法worktreeを作るのは対応OS向いている人
Git worktreeを手で使う自分Gitが動く環境自由に組み立てたい人
Claude Codeの--worktreeClaude CodeClaude Codeが動く環境Claude Codeだけで並列にしたい人
ChatGPTアプリのCodexCodexmacOS・Windows画面の操作でCodexを並列にしたい人
OrcaOrca(作業ごとに自動)macOS・Windows・Linux複数のAIを1つの画面で管理したい人
cmux自分かAImacOSターミナル中心で組み立てたい人

Claude CodeだけならClaude Codeの--worktree、CodexだけならChatGPTアプリのWorktreeで足ります。Claude CodeとCodexを混ぜて使い、進み具合を1つの画面で見たいならOrcaが候補です。Macでターミナル操作に慣れた人は、cmuxと手作業のworktreeの組み合わせも選べます。

CodexはChatGPTアプリでWorktreeを選ぶ

ChatGPTの公式ドキュメントによると、Codexのアプリは2026年7月9日に、macOSとWindows向けのChatGPTデスクトップアプリへ統合されました。新しいチャットを始めるときに入力欄の下で「Worktree」を選び、起点のブランチを選ぶと、Codexがworktreeを作って作業します。

Codexのworktreeはブランチに属さない状態(detached HEAD)で始まるため、試しに作ってもブランチは増えません。残したい変更は、チャット上部の「Create branch here」でブランチにできます。Codexが管理するworktreeは既定で新しい順に15個まで残り、古いものから自動で削除される設定です。

WindowsでのCodexの導入は、別の記事で解説しています。

CodexのWindowsアプリを徹底解説!インストールから使い方・スマホ操作まで紹介

Orcaは作業ごとにworktreeを自動で作る

Orcaは、複数のAIコーディングエージェントを並べて動かすための、無料でオープンソースのデスクトップアプリです。macOS・Windows・Linuxに対応し、作業1件ごとに専用のworktree・AIのターミナル・ブラウザのタブを自動で用意します。

編集部は、2026年9月26日にOrca v1.4.210でworktreeの作成を試しました。リポジトリ名の横の「+」から「ワークツリーを作成する」画面を開き、作成元(main)・名前・起動するAIを選ぶだけでworktreeができました。

Orcaの仕組みと操作、導入を判断する材料、エディタとの違いは、それぞれ別の記事で解説しています。

Orcaとは?AIを並列で動かすADE(AI IDE)の仕組み・機能・料金とエディタとの違い

Orcaの使い方|次世代AI IDEのインストールから並列作業まで解説

Orcaのメリットとデメリットを解説!並列AI開発で得られる効果と注意点

OrcaとCursorを比較!機能・料金・並列実行の違いと選び方・併用方法を解説

OrcaとVS Codeを比較!AI機能・料金の違いと選び方・併用方法を解説

cmuxはworktreeを自分で組み立てるターミナル

cmuxは、AIからの確認待ちを通知で知らせる、AIコーディングエージェント向けのmacOS用ターミナルです。

cmuxには、worktreeを自動で作る機能がありません。開発元はcmux公式サイトのブログで「worktreeを全員に押し付けたくない」として、今後も追加しない方針を示しています。worktreeは、自分で書いたスクリプトやAIへの依頼で作る前提です。

cmuxの機能とOrcaとの選び分けは、別の記事で解説しています。

cmuxとは?使い方とClaude Code連携、Windowsで使えるかも解説

cmuxとOrcaの違いを比較!AIを並列で動かす道具の選び方と併用方法

OpenCodeなどほかのAIもworktreeで並列にできる

Git worktreeはGitの機能なので、Claude CodeやCodex以外のAIエージェントもworktreeのフォルダで起動すれば、編集をworktreeの中に収められます。

OpenCodeは、ターミナル・デスクトップアプリ・IDE拡張機能で使えるオープンソースのAIコーディングエージェントで、本体は無料です。同じプロジェクトで複数のエージェントを並行して動かす使い方にも対応しています。

OpenCodeの特徴と、モデルの利用料を定額にするプラン「OpenCode Go」は、別の記事で解説しています。

OpenCodeとは?料金・使い方とClaude Code・Codexとの違い

OpenCode Goとは?料金・使えるモデル・始め方とZenとの違いを解説

Orca・cmuxに加えて、Conductor・Superset・T3 Code・AGI Cockpit・Vibe Kanbanの料金・対応OS・worktreeの扱いは、並列ツールを比較した記事の表にまとめています。

Claude Codeを並列で動かすツールとは?Codex対応の7選を比較

まとめ

Git worktreeは、1つのリポジトリに作業フォルダを複数用意し、ブランチを切り替えずに別々の作業を同時に進めるGitの機能です。AIごとに専用のworktreeを渡せば、Claude CodeとCodexを同時に動かしても変更は混ざりません。

使い始める前に押さえたいのは、同じブランチを2つのworktreeで開けない点と、.envや依存ライブラリが新しいworktreeにない点です。

Git worktreeを初めて試すときの手順は、以下のとおりです。

  1. 検証用のリポジトリでgit worktree add -bを使い、作業用のworktreeを2つ作る
  2. 各worktreeで依存ライブラリと.envを用意する
  3. 片方でClaude Code、もう片方でCodexを起動して、別々のファイルの修正を依頼する
  4. git diffで変更を確認し、mainへまとめてからgit worktree removeで片付ける

2つの作業を混ぜずに最後まで回せたら、Orcaなどの並列ツールで作業の数を増やしてみましょう。

参考リンク

この記事の監修者

中島大介(なかじ)

中島大介(なかじ)

株式会社メリル 代表取締役 / 記事監修

株式会社メリル代表取締役。SEO歴20年以上。最新AIやセキュリティについて発信するYouTube「ウェブ職TV」は登録者15万人以上。著書「ChatGPT & Copilotの教科書」は10万部突破!

プロフィールを見る

関連する記事

Cursorのプラグイン「pstack」の使い方を解説する記事のアイキャッチ
AIツール活用

pstackの使い方|Cursor・Claude Codeへの入れ方と頼み方

pstackを使ってみたい方は必見!この記事では、pstackの入れ方と/poteto-modeでの頼み方を解説します。実は、pstackで最初に覚えるコマンドは2つだけです。記事を読めば、AIに確かめさせながら作業を任せられます。

中島大介(なかじ)監修 / Touch AI編集部25 分で読めます
MetaのAIエージェント「Muse」の使い方を解説する記事のアイキャッチ
AIツール活用

Museの使い方|Meta Museの始め方・初期設定・料金を解説

Museを使い始めたい方は必見!この記事では、Meta Museの始め方・初期設定・料金を解説します。実は、Museとのやり取りをAIの学習に使う設定は最初からオンです。記事を読めば、任せる範囲を決めてから使い始められます。

中島大介(なかじ)監修 / Touch AI編集部26 分で読めます
Claude Codeで複数ファイルを一括置換する方法を解説する記事のアイキャッチ
AIツール活用

複数ファイルの文字列を一括置換するには?Claude Codeで残す語を指定

製品名の変更で複数のファイルを直したい方は必見!この記事では、Claude Codeで複数のファイルの文字を一括置換する手順を解説します。実は、残す語を決めてから置き換えられます。記事を読めば、コピーから元に戻す方法も分かります。

中島大介(なかじ)監修 / Touch AI編集部19 分で読めます

次のステップ

最新動向を学びに変える

話題のAIアップデートを、現役講師が背景と実務への影響まで解きほぐします。Touch AI の最新講座で、変化に追いつくための視点を得てください。

受講できる講座を見る