はじめに：開発中の「あの悩み」を解決する新機能

「この機能の改修中に、急ぎのバグ修正を頼まれてしまった…」「今の作業をコミットするのは中途半端だし、かといって退避（stash）させるのも後で戻すのが面倒…」

開発者であれば、誰もが一度はこのような状況に頭を悩ませたことがあるのではないでしょうか。複数のタスクが同時に発生し、ブランチの切り替えに手間取ってしまう。こうしたコンテキストスイッチのコストは、私たちの集中力を削ぎ、生産性を低下させる大きな要因です。

この度、AIコーディングアシスタント「Claude Code」に、この長年の悩みを解決する画期的な機能が搭載されました。それがgit worktreeのネイティブサポートです。この機能を使えば、一つのプロジェクト内に複数の独立した作業スペースを瞬時に作り出し、AIエージェントを並行して走らせることができます。

この記事では、git worktreeの基本から、Claude Codeでの具体的な活用法、さらにはAIエージェントと連携させた並列開発スタイルまで、初心者の方にも分かりやすく、図解を交えながら徹底的に解説します。

そもそもgit worktreeとは？【初心者向け図解】

git worktreeという言葉を初めて聞く方も多いかもしれません。これは、Gitに標準で備わっている機能で、一つのリポジトリ（プロジェクト）の中に、複数の独立した作業ディレクトリ（ワークツリー）を作成できるというものです。

少し分かりにくいかもしれませんので、「作業机」に例えてみましょう。

従来の方法（git checkout）は、一つの机の上で、作業のたびに本を入れ替えるようなものです。小説を読んでいた机で、急に参考書を読む必要ができたら、小説にしおりを挟んで片付け、それから参考書を広げなければなりません。また小説に戻るときは、その逆の手順が必要です。この「片付けて、広げて」という手間が、ブランチ切り替え時のstashや中途半端なコミットに当たります。

一方で、git worktreeは、複数の専用机をあらかじめ用意しておくようなものです。小説用の机、参考書用の机、雑誌用の机と分けておけば、読みたい本が置いてある机に移動するだけで、すぐに作業を再開できます。片付けは一切不要です。

checkoutとworktreeの違い一覧

• 作業場所 ― checkout：1つのディレクトリ（1つの机） ／ worktree：複数のディレクトリ（複数の机）
• 並行作業 ― checkout：困難（作業の退避・コミットが必要） ／ worktree：容易（ディレクトリを移動するだけ）
• 状態の確認 ― checkout：常に1つのブランチの状態しか見れない ／ worktree：複数のブランチの状態を同時に確認・作業できる
• メリット ― checkout：シンプルで学習コストが低い ／ worktree：コンテキストスイッチが高速・安全
• デメリット ― checkout：並行作業時の手間が大きい ／ worktree：ディスク容量を少し多く消費する

このように、git worktreeを活用することで、ブランチの切り替えに伴う様々なストレスから解放され、真の並行開発を実現できるのです。

Claude Codeでgit worktreeを使ってみよう！

それでは、いよいよClaude Codeでgit worktreeを実際に使ってみましょう。驚くほど簡単に利用を開始できます。

CLIでの使い方

ターミナルでClaude Codeを利用している場合、操作は非常にシンプルです。claudeコマンドに--worktree（省略形は-w）オプションを追加するだけです。

例えば、feature-authという名前の新しい作業スペース（worktree）を作成して作業を開始したい場合は、以下のコマンドを実行します。

claude --worktree feature-auth

これだけで、Claude Codeは現在のリポジトリ内の.claude/worktrees/feature-authという新しいディレクトリに作業環境を自動で構築し、セッションを開始します。元のディレクトリの作業状態を一切汚すことなく、完全に独立した環境で新しいタスクに着手できるのです。

ポイント： worktreeの名前を省略した場合（claude --worktree のみ）、Claudeが自動的に名前を生成してくれます。名前を考える手間すら省けます。

Desktopアプリでの使い方

GUI操作が好みの方もご安心ください。Claude CodeのDesktopアプリでは、さらに直感的にworktreeを利用できます。

アプリの「Code」タブを開くと、「Worktree Mode」という設定項目があります。このチェックボックスをオンにするだけで、新しいセッションを開始するたびに自動で新しいworktreeが作成されるようになります。CLIでのコマンド入力を意識することなく、自然に並列開発の恩恵を受けることが可能です。

AIエージェントを並列実行！サブエージェントでの活用法

git worktreeの真価は、AIエージェント、特にサブエージェントと組み合わせることで最大限に発揮されます。

サブエージェントとは、特定のタスク（コードレビュー、テスト作成など）に特化した専門家のAIエージェントです。Claude Codeでは、こうしたサブエージェントに処理を委任できますが、worktreeサポートにより、複数のサブエージェントを同時に、かつ並列で実行させることが可能になりました。

例えば、プロジェクト全体に及ぶ大規模なリファクタリングを考えてみましょう。従来であれば、一つの変更が完了するのを待ってから次の変更に取り掛かる必要がありました。しかし、worktreeを使えば、以下のようなプロンプトで複数のエージェントを同時に起動し、それぞれが独立した環境で作業を進め、完了次第プルリクエストを作成させるといった芸当が可能になります。

「プロジェクト内の同期I/Oをすべて非同期I/Oに移行してください。変更をいくつかのバッチに分割し、10個の並列エージェントをworktreeアイソレーションで起動します。各エージェントは自身の変更をエンドツーエンドでテストし、完了したらプルリクエストを提出するようにしてください。」

この指示により、10人の優秀なアシスタントが一斉に作業を開始し、それぞれが独立した「机」でコードを書き、テストを実行し、レビュー依頼を出すという、まさに未来の開発風景が現実のものとなります。

カスタムエージェントでの設定方法

さらに、自分で作成したカスタムエージェントを、常にworktree内で実行するように設定することも可能です。これにより、意図しないファイル変更のリスクを完全に排除し、エージェントの動作をより安全かつ予測可能なものにできます。

設定は、エージェントを定義するMarkdownファイルのフロントマター（frontmatter）に、たった一行追加するだけです。

---
name: safe-refactor-agent
description: 安全な環境でリファクタリングを実行するエージェント
isolation: worktree
---
あなたはベテランのソフトウェアエンジニアです。...

このisolation: worktreeという記述により、safe-refactor-agentは呼び出されるたびに必ず新しいworktreeを作成し、その中で作業を行うようになります。エージェントが変更を加えなかった場合、worktreeは自動的にクリーンアップされるため、不要なディレクトリが溜まる心配もありません。

Worktree設定一覧

• isolation（エージェントファイルのfrontmatter） ― 値：worktree ／ 効果：エージェントが毎回新しいworktreeで実行される
• --worktree / -w（CLIオプション） ― 値：任意の名前（省略可） ／ 効果：指定した名前のworktreeでセッションを開始する
• Worktree Mode（Desktopアプリの「Code」タブ） ― 値：ON/OFF ／ 効果：ONにすると全セッションが自動でworktreeを使用する

まとめ：AIと共に、もっとスマートな開発スタイルへ

本記事では、Claude Codeに新たに搭載されたgit worktreeサポートについて、その基本概念から具体的な活用法までを解説しました。

git worktreeは、ブランチ切り替えの手間をなくし、安全な並行開発を可能にする強力な機能です。そして、Claude Codeとの連携は、その能力をAIエージェントの領域にまで拡張し、これまでの開発の常識を覆すほどのポテンシャルを秘めています。

--worktreeオプション一つで、すぐに並列作業を開始できる手軽さ、サブエージェントを並列実行させ、大規模なタスクを高速に処理する能力、isolation: worktree設定による安全なエージェント実行環境の実現。これらの機能を活用することで、私たちはコーディングにおける反復的で時間のかかる作業から解放され、より創造的で本質的な問題解決に集中できるようになります。

AIが優秀なアシスタントとして、複数の「机」で同時に作業を進めてくれる。そんな新しい開発スタイルが、もう目の前まで来ています。ぜひ、あなたのプロジェクトでもClaude Codeとgit worktreeを試し、AIと共に歩むスマートな開発体験を実感してみてください。

参考文献

• Boris Cherny's Tweet ― Claude Code v2.1.50 with git worktree support
• Claude Code Docs: CLI reference
• Claude Code Docs: Create custom subagents
• 世界一わかりやすくGit worktreeを解説！AI駆動開発でも活用できる並列開発の方法
• Git worktreeとは何か？その概要とメリットを初心者向けに解説