Claude Codeの--worktreeで並列作業を隔離

【結論】解決策 / 実行コマンド

Claude Codeは--worktreeまたは-wで隔離されたGit worktreeを作成し、並列セッションの編集競合を防げます。

手動のgit worktreeだけでなく、PR番号やURLを指定してレビュー用worktreeを作ることもできます。

# ターミナルで実行：メイン作業領域の信頼確認を済ませる
claude
# ターミナルで実行：機能開発用worktreeを作成して起動
claude --worktree feature-auth
# 別ターミナルで実行：バグ修正用worktreeを作成して起動
claude --worktree bugfix-123
# ターミナルで実行：worktree一覧を確認
git worktree list

具体的な手順・設定方法

1. 最初に通常のclaudeを起動し、workspace trustを承認します。

2. タスクごとに一意なworktree名を付け、同じファイルの同時編集を避けます。

3. 完了後は差分とコミットを確認し、不要なworktreeを削除します。

実践プロンプト / 活用テクニック

# feature-auth側のセッション内で入力
認証機能だけを実装し、変更をこのworktree内に限定してください。
対象ファイルとテスト計画を先に示してください。
完了後はコミット候補を提示し、mainへのマージやPushは実行しないでください。

注意点・よくあるエラーと対処法

新しいworktreeにはgitignoreされた.envが通常含まれないため、必要な設定を安全に用意してください。

.worktreeincludeで秘密をコピーする場合は、アクセス権と漏洩リスクを確認してください。

非対話モードで作成したworktreeは自動削除されない場合があるため、後片付けを確認してください。