はじめに
Claude Codeを一つのプロジェクトで複数並行で使用したい時ありませんか。
複数タブでClaude Codeを起動してみるものの、不意にエディタ自体を削除や再起動してしまったときに、一つのタブでしか再開できなかったり、指示するタブを間違えてしまったりと不便でした。
そこで、git worktreeを使うと並行処理ができると耳にし試してみることにしました。
環境
- VS Code
- Claude Code
- GitHub
git worktreeとは
公式ドキュメント:
ざっくり説明すると、指定のブランチから別ディレクトリ扱いのブランチが切れるイメージです。
もう少し正確に言うとgit worktree addを使うと以下の通りです。
- 別の物理ディレクトリに、別のブランチをチェックアウトできる
- でもリポジトリ自体は同じもの（共有）
- コミット履歴、ブランチ、リモート設定などは全て共有される
- 各ディレクトリで独立して作業できる（HEADやindexは別々）
実際の動作
worktreeを作成
origin/masterから../hogedirにworktree fix-hogeをcheckoutします。
git worktree add ../hogedir -b fix-hoge origin/master
worktreeの確認
git worktree list
実行結果
/path/to/ec-php-to-laravel dcce251 [master]
/path/to/hogedir dcce251 [fix-hoge]
VS CodeのGit管理でも作成したworktreeを確認することができました。
作成したworktreeからGitHubへpush
/path/to/hogedirでVS Codeを開くと、想定通りfix-hogeブランチでの作業ができました。
念のためGitHubにpushしたところfix-hogeブランチができておりmainへのPRも作成できました。
Claude Codeを起動
/path/to/hogedirでClaude Codeを起動してみました。
初めてClaude Codeを使うときの表示が出ました。
別プロジェクトとして捉えているようです。
一度Claude Codeを閉じてからclaude -cで起動させてみたところ、
別ブランチと混ざることなく、同一ブランチでのセッションが再開されました。
おわりに
別ブランチで並行作業ができるということで、細かくコミットしたいけど、別タブの作業のほうが早く終わりそうだし、、という葛藤も無くなりそうです。
git worktreeを活用し、ストレスフリーなClaude Codeライフを目指します。
追記
worktreeは完全に別ディレクトリでの作業となるため、以下の点に考慮する必要があります。
- gitに未反映のものは作成したworktreeに引き継げない
- ポートの競合への配慮
そのため、開発当初からworktreeを使う前提で進めるのが良さそうです。
また、急ぎの場合はリスクを承知で複数タブを用いてClaude Codeの並行作業を実施するのもやむなしだと感じました。