読み込み中

Claude Codeの並列化

レッスン 613 分
読み込み中

Claude Codeの複数インスタンスを並行して実行することは、得られる生産性向上の中でも最大のものの一つです。Claudeは軽量なため、複数のコピーを簡単に立ち上げ、それぞれに異なるタスクを割り当て、同時に作業させることができます。これにより、実質的にプロジェクトに取り組む仮想ソフトウェアエンジニアのチームが手に入ります。

課題:ファイルの競合

並列インスタンスの主な問題は、同じファイルを同時に変更しようとする可能性があることです。各インスタンスは他のインスタンスが何をしているかを認識していないため、これにより競合や不正なコードが発生する可能性があります。

1つのプロジェクトに取り組む3つのClaude Codeインスタンス:「ログを追加」「.pptxファイルをサポート」「失敗しているテストを調査」。

その解決策は、各Claudeインスタンスにそれぞれ独立したワークスペースを与えることです。各インスタンスはプロジェクトの自分専用のコピーを使って作業し、隔離された環境で変更を加え、その後それらの変更をメインプロジェクトにマージし直します。

4つのClaude Codeインスタンスがそれぞれ独自のプロジェクトコピーを持ち、「リソースを定義」「ログを追加」などのタスクに取り組む様子。

Git worktree

このワークフローにはGit worktreeが最適です。プロジェクトがすでにGitで管理されている場合は、すぐにworktreeを利用できます。worktreeはGitのブランチ機能の拡張のようなもので、マシン上の別々のディレクトリにプロジェクトの完全なコピーを作成できます。

フォルダ1のブランチfeature_aとフォルダ2のfeature_bで、それぞれ同じmain.py、tools/document.py、tools/math.pyを持つ様子。

各worktreeは個別のブランチに対応します。機能Aのためのフォルダと機能Bのためのフォルダをそれぞれ持ち、それぞれにコードベースの完全なコピーを含めることができます。そして、各worktreeで別々のClaude Codeインスタンスを実行し、完全に独立した状態で作業します。

feature_aとfeature_bのworktreeブランチの図。それぞれに1つのコミットがあり、メインブランチにマージされる様子。

各Claudeインスタンスが機能の実装を完了したら、作業をコミットし、通常のGitブランチをマージするのと同じように、メインブランチにマージし直します。

.treesフォルダにfeature_aという名前のworktreeを作成し、既に存在する場合は停止し、.venvをシンボリックリンクし、VS Codeを起動するプロンプト。

Worktree作成の自動化

これは管理が複雑に思えるかもしれませんが、ワークフロー全体をClaude Code自身に委任することができます。Claudeに次のことを依頼するプロンプトを書くことができます。

  1. 特定のフォルダに新しいgit worktreeを作成する
  2. Gitで追跡されていない依存関係をシンボリックリンクする
  3. そのディレクトリで新しいVS Codeインスタンスを起動する

.treesにfeature_aという名前のworktreeを作成するプロンプト:既に存在する場合は停止し、.venvをシンボリックリンクし、「code」でVS Codeを起動する。

カスタムコマンド

毎回長いプロンプトをコピー&ペーストする代わりに、Claude Codeでカスタムスラッシュコマンドを作成できます。.claude/commandsに.mdファイルを追加して、カスタムコマンドを作成します。

feature_aという名前の2つ目のVS Codeウィンドウで、プロジェクトファイルのworktreeコピー内でClaude Codeを実行している様子。

カスタムコマンドは$ARGUMENTSを参照でき、これはコマンドに渡す引数に置き換えられます。例えば:

  • /project:create_worktree feature_a は「feature_a」という名前のworktreeを作成します
  • /project:create_worktree develop は「develop」という名前のworktreeを作成します

実践における並列開発

実際の完全なワークフローは次のようになります。異なる機能のために複数のworktreeを作成できます。

同じプロジェクトファイルを持つ4つのVS Codeウィンドウ。「ドキュメントテスト」「ログを追加」「ノートツールを追加」「数学ツールを追加」とラベル付けされている。

各Claudeインスタンスは割り当てられたタスクに取り組みます。

  • ドキュメントテストの更新
  • ログの追加
  • ノート作成ツールの追加
  • 減算ツールの追加

.trees/$ARGUMENTSにある$ARGUMENTS worktreeをマージするプロンプト。マージ競合を一覧表示するために「git status」などのコマンドを使用。

変更のマージ

機能が完成したら、マージプロセスも自動化できます。Claudeに次のことを指示する別のカスタムコマンドを作成します。

  1. worktreeディレクトリに移動する
  2. 最新のコミットを確認する
  3. ルートディレクトリに戻る
  4. worktreeブランチをマージする
  5. マージ競合を自動的に処理する

.claude/commandsにcreate_worktree.mdとmerge_worktree.mdがあるVS Code、ターミナルで実行中のClaude Code。

Claudeは、各ブランチで行われた変更の理解に基づいて、マージ競合を自動的に解決することさえできます。

成果

このアプローチは、管理できる限り多くの並列インスタンスにスケールします。機能を順番に作業する代わりに、複数のClaudeインスタンスにプロジェクトの異なる部分を同時に開発させることができます。これはまるで、各自が独立した環境で作業した後、成果を持ち寄る自分専用の開発者チームを持っているようなものです。

生産性の向上は著しいものです。実質的に、実行する並列インスタンスの数だけ開発能力を掛け合わせることになります。