隔離した git worktree で起動したい
13. Git 連携コマンド / 機能
claude --worktree / -w独立した worktree でセッション開始
概要
--worktree（-w）フラグを使うと、<リポジトリ>/.claude/worktrees/<名前> に一時 git worktree を作成して Claude Code を起動します。メインのコードベースを汚染せずに並列で作業できます。
設定例
# 名前付きで worktree を作成して起動
claude --worktree feature-auth
claude -w "experiment-001"
# 名前を省略すると自動生成
claude --worktree
# 複数の worktree を同時に使う
# ターミナル1
claude -w feature-login
# ターミナル2
claude -w feature-signup
# worktree の場所
# <repo>/.claude/worktrees/<name>こんな時に使う
- 複数の機能を並列で独立して開発したい時
- 実験的な変更をメインブランチに影響させずに試したい時
- コードレビューを別ブランチで安全に行いたい時
使い方
- 1claude --worktree <名前> で起動
- 2git リポジトリ内から実行する必要がある
- 3作業完了後は自動または手動で worktree を削除
Tips
- worktree は <repo>/.claude/worktrees/<name> に作成される
- エージェントの frontmatter でも isolation: worktree が使える
- Remote Control の --spawn worktree でも自動 worktree 作成が可能
- --from-pr フラグと組み合わせて PR ベースの worktree も作れる