Claude Code の Worktree で複数機能を完全分離して並行開発する

Claude Code は git worktree のネイティブ対応で「同じリポジトリで複数 Claude セッションを並行実行」を実現する。各セッションは独立したブランチ・独立したファイルツリーで動き、編集が衝突しない。本稿は公式ドキュメントに沿って Worktree の起動・サブエージェント自動分離・ベストプラクティスを整理する。

Worktree が解決する問題

通常、Claude Code を 2 つ同時に起動すると、同じファイルを編集して衝突する。git の commit 状態も乱れる。これが直列開発を強いる理由。

Worktree は git の機能で、同じリポジトリから複数のチェックアウトを別ディレクトリに作る。Claude Code はこれをネイティブサポートし、`.claude/worktrees/feature-payments/` に分離したセッションを起動できる。

起動方法

claude --worktree feature-payments
# または短縮形
claude -w feature-payments

これで現在ブランチから分離した worktree が作られ、そこで作業が始まる。別ターミナルでもう 1 本起動すれば、2 つの Claude が完全分離で並走する。

サブエージェント自動分離

カスタムサブエージェントの frontmatter に書く：

---
name: parallel-implementer
description: Implements features in isolation
isolation: worktree
---

サブエージェントを並列起動するたび、それぞれが自分の worktree を持つ。並列実装で衝突しない。

Writer / Reviewer パターン

公式が推奨する定番パターン：