Cursorの並列実行とは？ 複数エージェントを同時に動かす仕組み
並列実行の利点
独立したタスクを同時に実行し、直列の待ち時間を削減。競合リスクが低いモジュールで効果的。
Worktreesによる隔離
git worktreesで各エージェントに独立チェックアウトを提供。ファイル競合を防止し、設定でセットアップ自動化可能。
マルチエージェント同時実行
最大8エージェントを並行稼働。プランモードで「Build in Parallel」を選択し、依存関係のないステップを自動分割・統合。
並列実行が役立つ場面：大規模コードベースでの独立タスク
テキトー教師.AI認定講師大規模なコードベースで直列にタスクをこなすと、待ち時間がもったいないですよね。独立した機能なら並列で進めたいというのはよく聞きます。
室谷代表取締役その感覚、経営的には正しいです。同時に動かせるタスクを1つずつやっていると、人件費の無駄が大きい。
独立したモジュールなら競合リスクも低いので並列実行の恩恵が大きい。
独立したモジュールなら競合リスクも低いので並列実行の恩恵が大きい。
テキトー教師.AI認定講師処理が重なる部分がないか確認してから並列にすると、安心して進められますね。
worktreesによる隔離環境：各エージェントが専用のGit checkoutで動作
室谷代表取締役Cursorの並列実行の肝はgit worktreesです。各エージェントに独立したチェックアウトを与えるので、ファイル競合が起きません。
テキトー教師.AI認定講師要するに、それぞれが自分の作業ディレクトリを持ってるイメージですね。依存関係やビルドも分離されるから、お互いの変更に影響されない。
室谷代表取締役設定ファイルでセットアップスクリプトも書けるので、npm installやマイグレーションを自動でやってくれます。詳しくは次のセクションで触れますが、実務で使うなら必須の知識です。
マルチエージェントの概要：最大8つのエージェントを並行実行
室谷代表取締役Cursor 2.0から最大8つのエージェントを同時に走らせられます。プランモードで「Build in Parallel」を選べば、依存関係のないステップを自動で並列実行してくれます。
テキトー教師.AI認定講師これは便利ですよね。プランの独立した部分をAIが自動で切り出して、サブエージェントに割り振ってくれる。
終わったら結果を統合してくれる。
終わったら結果を統合してくれる。
室谷代表取締役大規模リファクタリングや複数機能の同時開発で劇的に生産性が変わります。チームでworktreeのクリーンアップ設定もやっておくと、ディスク容量の管理も楽です。
テキトー教師.AI認定講師並列実行を意識してタスクを分割する習慣をつけると、Cursorの真価が引き出せますね。
並列実行のための設定：worktrees.jsonで環境をカスタマイズ
worktrees.jsonの配置場所と探索順序
室谷代表取締役並列実行やるなら、まず
.cursor/worktrees.json をどこに置くかが効くんですよね。ドキュメントだと、worktreeのパス→プロジェクトルートの順で探索するらしいです。テキトー教師.AI認定講師たしかに、そこを間違えると設定が効かないってハマりポイントです。ルートに置くのが無難なんですけど、プロジェクトによってはサブディレクトリにも置きたくなりますからね。
室谷代表取締役MYUUU の現場だと、ルートに1つだけ置いて共通化してます。複数置くと管理が煩雑になるんで、シンプルにした方が結果的にコストも抑えられます。
テキトー教師.AI認定講師なるほど。最初に戸惑うのは「どこに置けばいいんだ？」ってところなので、ルート推奨で問題ないですね。
setup-worktreeコマンドの書き方（配列・スクリプト）
室谷代表取締役で、肝心のコマンド指定は、配列で書くかスクリプトファイルを参照するかの2択です。Node.js なら
["npm ci", "cp $ROOT_WORKTREE_PATH/.env .env"] みたいな感じ。テキトー教師.AI認定講師配列で書くと簡潔でいいんですけど、複雑なセットアップだと管理が大変ですよね。スクリプトに切り出す判断が大事です。
室谷代表取締役そう。その判断もROI で考えますね。
依存関係のインストールだけなら配列で十分。DBマイグレーションまで入れるならスクリプトに逃がした方が後々楽です。
依存関係のインストールだけなら配列で十分。DBマイグレーションまで入れるならスクリプトに逃がした方が後々楽です。
テキトー教師.AI認定講師あと
$ROOT_WORKTREE_PATH って変数、最初は存在を知らない人も多いです。ルートから.envをコピーするときに必須ですよね。OS別スクリプトの例と$ROOT_WORKTREE_PATHの活用
室谷代表取締役OS ごとにスクリプトを分けられるのも地味に効きます。Unix と Windows で
setup-worktree-unix、setup-worktree-windows を用意しておけば、チームメンバーがどの環境でも同じように動く。テキトー教師.AI認定講師現場感覚で言うと、Windows ユーザーが混ざってるときに
cp とか chmod がエラーになるの、よくありますからね。分けて書けるのは安心です。室谷代表取締役ただ、そこまでやるかどうかはチームの構成次第。全員 Mac なら
過剰な設定は運用コストを上げるだけです。
setup-worktree-unix だけで十分。過剰な設定は運用コストを上げるだけです。
テキトー教師.AI認定講師そうですね。
あとは
$ROOT_WORKTREE_PATH を使って env をコピーするパターンが最も多いです。あとは
npm ci の代わりに pnpm install --frozen-lockfile にするなど、パッケージマネージャの選定もポイントです。実際に並列で動かす：エージェントウィンドウとプラン並列構築
- 1エージェントウィンドウでworktree作成自動で隔離されたworktreeを作成。手動のgit worktree add不要。worktrees.jsonでnpm ciなど自動実行可能。
- 2「Build in Parallel」で独立部分を同時実行プラン内の独立した部分を自動検出し、子エージェントが非同期で並列実行。フロントエンドとバックエンドの修正など。
- 3依存関係のあるステップは自動で順次実行APIスキーマ変更→フロント修正など、順序が重要なタスクは自動で順番に処理。並列による破壊を防止。
- 4エージェント完了後の結果確認とPR作成エージェントウィンドウで差分確認、修正後そのままPR作成。複数変更をPRごとに分割可能。
エージェントウィンドウでのworktree作成手順
室谷代表取締役エージェントウィンドウからエージェントを立ち上げると、自動で隔離されたworktreeが作成されるんですよね。手動でgit worktree addしなくていいのが楽で。
テキトー教師.AI認定講師そうなんです。最初に戸惑うのが、「これ、どこで動いてるの？」ってところですが、Cursorが裏で勝手に独立したコピーを作ってくれます。
室谷代表取締役タスクごとに依存関係や環境をスッキリ分けられる。worktrees.jsonでセットアップスクリプトを仕込んでおけば、npm ciとかも自動で走る。
テキトー教師.AI認定講師そこまでやってくれるなら、手間が一気に減りますね。
「Build in Parallel」ボタンでプランの独立部分を同時実行
テキトー教師.AI認定講師プランモードで「Build in Parallel」を押すと、プラン内の独立した部分を自動で見つけて並列実行してくれるんですよ。
室谷代表取締役MYUUUの現場で試したんですが、フロントエンドとバックエンドの修正を同時に回せる。子エージェントが非同期で動くので、待ち時間がほぼゼロに。
テキトー教師.AI認定講師プラン全体を一人のエージェントに任せるのではなく、分割して同時に取り掛かる。これで大幅な時短になります。
室谷代表取締役「ここは独立して動かせる」という判断をAIがやってくれるのが大きい。手動で分割するより安全。
依存関係のあるステップは自動で順次実行
室谷代表取締役ただし全部が全部並列になるわけじゃない。依存関係があるステップはちゃんと順番に処理してくれる。
テキトー教師.AI認定講師例えば「まずAPIのスキーマを変更してからフロントの画面を直す」みたいなケースですね。先にスキーマ変更のエージェントが完了してから、次のエージェントが走る。
室谷代表取締役順番が重要なタスクを勝手に並列で動かして壊す心配がない。この辺の制御が自動で効いてるのは地味に安心。
テキトー教師.AI認定講師現場で「これ並列でいいの？」と迷うことがなくなるので、初心者にも優しい設計です。
エージェント完了後の結果確認とPR作成
テキトー教師.AI認定講師エージェントが完了したら、エージェントウィンドウで変更内容を確認できます。差分を見ながら必要なら修正して。
室谷代表取締役さらに、そのままPRまで作成できる。変更をPRごとに分割する機能もあって、複数の独立した修正をきれいに分けられる。
テキトー教師.AI認定講師複数エージェントで並列に動かした結果を、まとめてレビューしてからまとめてPR、という流れがスムーズ。
室谷代表取締役これでレビューの手間も減る。チーム開発でかなり効く機能ですね。
競合を防ぐ：worktreeの隔離とクリーンアップ戦略
自動クリーンアップ設定（cursor.worktreeCleanupIntervalHours）
室谷代表取締役並列実行で気になるのがディスク容量ですよね。Cursorには自動クリーンアップの仕組みが入っていて、設定キーはcursor.worktreeCleanupIntervalHours。
デフォルトは6時間ごとです。
デフォルトは6時間ごとです。
テキトー教師.AI認定講師そうなんです。最初に触る人は「古いworktreeが残りっぱなしになるのでは？」と心配しますが、この設定で定期的に掃除してくれます。
Cursorを再起動したとき、前回の実行から6時間以上経っていれば遅延実行で補完されるんですよ。
Cursorを再起動したとき、前回の実行から6時間以上経っていれば遅延実行で補完されるんですよ。
室谷代表取締役チームで使うと、一人当たりのディスク消費が予測しやすくなる。時給換算すると、掃除の手間を省ける分が馬鹿にならない。
最大worktree数の管理（cursor.worktreeMaxCount）
室谷代表取締役もう一つがcursor.worktreeMaxCount。デフォルトはマシンあたり25個。
この上限を超えると新しいworktreeを作成するときに自動で古いものが削除されます。
この上限を超えると新しいworktreeを作成するときに自動で古いものが削除されます。
テキトー教師.AI認定講師つまり、手動で消す必要がない。25って結構多いですが、並列エージェントをがっつり回すとすぐ埋まります。
増やしたい場合はこの設定値を変更するだけ。
増やしたい場合はこの設定値を変更するだけ。
室谷代表取締役プロジェクトの規模とエージェント数に応じて調整すればいい。ただし、上限を上げすぎるとディスクを圧迫するので、トレードオフです。
依存関係のシンボリックリンクを避ける理由
テキトー教師.AI認定講師あと、setup-worktreeの設定で気をつけたいのがシンボリックリンク。公式ドキュメントでは推奨されていません。
室谷代表取締役そう、node_modulesなどをシンボリックリンクで共有すると、メインのworktreeに影響が出ることがある。並列実行の隔離性が損なわれるわけです。
テキトー教師.AI認定講師代わりにbunやpnpm、uvといった高速なパッケージマネージャーを使って、各worktreeで独立して依存関係をインストールするのが安全。最初は面倒に感じるけど、キャッシュが効くので実はそんなに遅くない。
デバッグ方法：OutputパネルでWorktrees Setupを確認
室谷代表取締役設定が正しく動いているか確認したい場合は、エディタのOutputパネルを開いて「Worktrees Setup」を選びます。
テキトー教師.AI認定講師ここに出るログを見れば、setup-worktreeのスクリプトがどんな順番で実行されたか、エラーがどこで起きたか一目瞭然。
室谷代表取締役特に複数のOSでスクリプトを使い分けている場合、これでデバッグしないと原因が追いにくい。
テキトー教師.AI認定講師ログを一読すれば「あ、ここでコケてる」とすぐ分かるので、最初に覚えておくと便利ですよ。
並列実行の応用：PR分割とチーム連携
PR自動分割
変更を論理単位で自動分割し、依存関係がないものは独立したPRとして出力。バックアップスナップショットで安全。
並列レビュー統合
複数のworktreeの変更を独立PRとしてレビュー一覧に表示。ReviewsタブとChangesタブで整理。
チームルール共有
ダッシュボードでworktreeセットアップコマンドやルールを一元管理。チームコマンドで初期化統一。
クラウドエージェント連携
Cloud Agentsでマシンリソースを拡張。ローカルとクラウドでworktreeを並列実行、同じルールが適用。
変更をPRごとに分割するクイックアクション
室谷代表取締役Cursor 3.3 から「変更をPRごとに分割する」クイックアクションが入ったんですよね。チャットのコンテキストを元に論理的な単位で自動分割してくれる。
テキトー教師.AI認定講師これ現場でめっちゃ助かるんですよ。並列で複数の修正を入れたあと、「あれとこれは別PRにしたいな」ってなるケース、結構あるんです。
室谷代表取締役依存関係がない変更は独立したPRとして出してくれる。バックアップのスナップショットも自動で取るから、分割に失敗しても戻せる。
テキトー教師.AI認定講師最初に戸惑うのが「どの単位で分割されるか」の見通しなんですが、実際に試すと意外と直感的で、承認用の分割案が提示されるので安心です。
プランの並列実行結果をまとめてレビュー
室谷代表取締役並列でプランを走らせた後、結果をどう統合するか。Cursor の PR レビュー機能がそのまま使えるんですね。
テキトー教師.AI認定講師実はそうなんですよ。複数の worktree で出てきた変更を、一つの PR にまとめるんじゃなくて、それぞれ独立した PR として出してレビューの一覧で見られる。
室谷代表取締役Reviews タブにインラインスレッドとトップレベルコメントが表示されて、変更のファイルツリーも整理されて見やすい。チームでレビューを並行して回せるのが大きい。
テキトー教師.AI認定講師これ、大規模な PR ほど効果を実感しますね。Changes タブのファイルツリーが整理されてるので、どこから見ればいいか迷わない。
チームでのルール・コマンド共有による効率化
室谷代表取締役チームで worktree のセットアップコマンドやルールを共有できるようにもなってます。2.0 からダッシュボードで一元管理できる。
テキトー教師.AI認定講師たしかに、worktrees.json を各自が書くのはミスの元ですから。チームコマンドで「npm ci と .env コピー」を shared にしとけば、新しい人が迷わない。
室谷代表取締役ルールも共有できるので「このプロジェクトでは worktree ごとに DB マイグレーションを流せ」みたいなのをチーム全体に強制できる。
テキトー教師.AI認定講師現場でよく聞くのは「メンバーによって worktree の初期化が違う」という悩みですが、これで統一できる。
クラウドエージェントとの併用でさらに並列度向上
室谷代表取締役ローカルの worktree だけだとマシンリソースが上限になる。そこに Cloud Agents を組み合わせると、クラウド上でもエージェントが動くので並列度が一気に上がる。
テキトー教師.AI認定講師そこはまだ試してない人も多いんですが、2.0 で Cloud Agents の信頼性が 99.9% になって即時起動するようになったので、実用的なんですよね。
室谷代表取締役ローカルで重いビルドが走ってる間に、クラウド上で別の worktree を動かす、みたいな使い方ができる。コストはかかるけど、時間対効果で見れば十分ペイする。
テキトー教師.AI認定講師最初に戸惑うのが「ローカルとクラウドの worktree をどう使い分けるか」ですが、基本的には同じルールファイルが適用されるので、切り替えに悩むことはありません。
並列実行のコスト対効果：生産性向上の閾値
- 1開発速度の待ち時間を測定チームのエンジニアがビルド待ちやレビュー待ちで止まっている時間を月単位で算出し、コスト換算する。
- 2並列実行導入の判断待ち時間のコストが並列化導入のコスト（学習、設定）を上回る場合に導入を検討する。
- 3小さな独立したタスクから試すログ出力の統一やテストコード追加など、作業範囲がかぶらないタスクで並列実行を開始。worktreesを使い各エージェントに独立した環境を割り当てる。
- 4徐々に並列数を増やす1エージェントで慣れたら2、3と増やしていく。Cursorの「Build in Parallel」機能を活用して、プラン内の独立部分を自動識別させる。
逐次処理と並列処理の定性的な違い
室谷代表取締役並列実行って聞くと何でも速くなりそうに思うけど、実際はタスクの独立性が重要なんですよね。例えばフロントエンドとバックエンドの変更が完全に独立してれば、同時に進められる。
でも依存関係があると順番待ちが発生する。
でも依存関係があると順番待ちが発生する。
テキトー教師.AI認定講師そうなんです。現場でよく聞くのは「並列にしたけど結局コンフリクトで手戻りが増えた」という話。
逐次でやれば確実に進む部分もある。
逐次でやれば確実に進む部分もある。
室谷代表取締役シリコンバレーのスタートアップだと、コードベースが大きくなると逐次では待ち時間が無視できなくなる。だからあえて並列実行の仕組みを導入する。
Cursor 2.0で導入されたマルチエージェント機能は、まさにそのニーズに応えた形ですね。
Cursor 2.0で導入されたマルチエージェント機能は、まさにそのニーズに応えた形ですね。
テキトー教師.AI認定講師たしかに、小さいプロジェクトなら逐次で十分ですが、規模が大きくなると並列の価値が一気に跳ね上がる。
チーム導入時に検討すべきポイント
室谷代表取締役並列実行を導入するかどうかの判断基準としては、チームの開発速度がどれだけ待ち時間で損してるか、ですね。時給換算すると、エンジニアがビルド待ちやレビュー待ちで止まってる時間が月に何時間あるか。
それが並列化で削減できるならコストは十分回収できる。
それが並列化で削減できるならコストは十分回収できる。
テキトー教師.AI認定講師ただ、導入には学習コストもあります。worktreesの設定や、.cursor/worktrees.jsonのカスタマイズが必要です。
最初は小さなタスクから試すのがいい。
最初は小さなタスクから試すのがいい。
室谷代表取締役そう。Cursorのworktrees機能は、各エージェントに独立したGitチェックアウトを割り当てるので、コンフリクトのリスクは低い。
でも、設定スクリプトを書く手間はある。ROIを考えて、優先度の高いタスクに絞って使うと良い。
でも、設定スクリプトを書く手間はある。ROIを考えて、優先度の高いタスクに絞って使うと良い。
テキトー教師.AI認定講師現場感覚で言うと、最初は1つのエージェントで動かしてみて、慣れたら2つ、3つと増やす感じですね。
現場でのベストプラクティス（小さなタスクから始める）
室谷代表取締役うちのチームでも最初は小さなリファクタリングから並列実行を試しました。例えば、ログ出力の統一とテストコードの追加みたいな独立したタスク。
worktreesを使えば、それぞれのエージェントが別々の環境で動くから、メインのブランチは汚れない。
worktreesを使えば、それぞれのエージェントが別々の環境で動くから、メインのブランチは汚れない。
テキトー教師.AI認定講師実践では、作業範囲がかぶらないことを確認するのが重要です。Cursorのエージェントウィンドウで「Build in Parallel」をクリックすると、プラン内の独立した部分を自動で識別して並列実行してくれる。
室谷代表取締役3.3のリリースでその機能が入ったのは大きい。手動で分割する必要がなくなり、初心者でも並列実行の恩恵を受けやすくなった。
テキトー教師.AI認定講師そうなんです。まずは1つのタスクを並列で試してみて、成功したら徐々に並列数を増やす。
無理に全部を並列にしようとしないことです。
無理に全部を並列にしようとしないことです。
よくある質問
Q1. 並列実行時に使えるモデルに制限はありますか？
室谷代表取締役現状、CursorのエージェントモードはデフォルトでClaude系とGPT-4o系などいくつか選べます。ただし並列実行で複数エージェントを動かす場合、同じモデルを使ってもリクエスト制限に引っかかる可能性がありますね。
テキトー教師.AI認定講師そうなんですよ。たとえばClaudeのAPIレートリミットが厳しいプランだと、同時に3つエージェントを立ち上げると制限に当たるケースがあります。
Proプランだと安心ですが、Maxプランでも注意が必要です。
Proプランだと安心ですが、Maxプランでも注意が必要です。
室谷代表取締役あとはモデルごとのコンテキストウィンドウも気を付けたい。並列で長い会話を続けると、すぐ上限に達します。
Q2. 並列実行中にエラーが起きたときの復旧方法を教えてください
テキトー教師.AI認定講師まず一番多いのがworktrees.jsonの設定ミスです。パスが間違っているとエージェントがファイルを見つけられず停止します。
室谷代表取締役そういう時は一旦全てのエージェントを止めて、worktrees.jsonを修正してから再起動するのが確実ですね。gitのworktree自体は削除しなくても、Cursorが参照する設定を直せば動きます。
テキトー教師.AI認定講師あと、エージェントが途中で止まった場合、プランが中途半端に残ることがあります。その時は手動で該当のworktreeを削除してから作り直すとスッキリします。
Q3. 並列実行と複数のCursorウィンドウを開くのと、どちらが効率的ですか？
室谷代表取締役複数ウィンドウだとコンテキストが完全に分離されるので、依存関係の少ないタスクには向いてます。ただ、同じプロジェクト内でファイルを共有するにはworktreeを使った方が安全です。
テキトー教師.AI認定講師実は両方組み合わせる人もいます。メインの作業は並列実行で、リファクタリングなど別系統のタスクは別ウィンドウで、みたいな使い分けです。
室谷代表取締役ただウィンドウを増やしすぎるとマシンリソースを食うので、メモリ16GB以下だと4つくらいが限界と聞きますね。
Q4. 並列実行の同時実行数にベストな数はありますか？
テキトー教師.AI認定講師現場でよく聞かれる質問ですが、正直タスクによります。依存関係が少ない機能追加なら4〜5並列でも問題ないですが、同じファイルを触る可能性があると2〜3に抑えた方が無難です。
室谷代表取締役うちのチームでは、最初は3並列から始めて、競合が起きなければ増やす方式を取ってます。あと、AIの応答速度も考慮して、無理に多くしない方が結局速い。
テキトー教師.AI認定講師そうそう、並列数を増やすと待ち時間が増えて、かえって生産性が落ちる閾値がありますからね。
Q5. Gitのブランチ管理とworktreeの関係はどうなりますか？
室谷代表取締役worktree自体はgitの機能で、ブランチごとに独立した作業ディレクトリを作れます。Cursorの並列実行ではこれを利用して、各エージェントに異なるブランチで作業させるのが定石です。
テキトー教師.AI認定講師つまり、featureブランチごとにworktreeを作って、エージェントに割り当てるわけです。そうするとマージ前にコンフリクトが起きにくい。
室谷代表取締役さらに、PRを出す前に各自のworktreeでテストまで済ませると、チーム連携がスムーズになりますね。
まとめ
テキトー教師.AI認定講師結局Cursorで並列実行を成功させるポイントは、worktrees.jsonで環境をきっちり分離することと、競合を避ける設計ですかね。
室谷代表取締役そうですね。ただ、設定は最初が面倒でも、一度慣れると生産性が一気に上がります。
うちのチームでは、並列実行を導入してから同じ時間で2倍以上のタスクを捌けるようになりました。
うちのチームでは、並列実行を導入してから同じ時間で2倍以上のタスクを捌けるようになりました。
テキトー教師.AI認定講師個人開発者でも、並列実行の機能を使うと、コードレビュー待ちの時間を有効活用できます。まずは小さいタスクから試してみると良いですよ。
室谷代表取締役あと、コスト面で言うと、Maxプランなら並列実行の追加料金はかからないので、使い倒す価値はあります。最初の一歩として、worktrees.jsonのサンプルを公式ドキュメントからコピーして動かすところから始めてみてください。
テキトー教師.AI認定講師そうですね。使ってみてハマるところがあれば、コミュニティの事例も参考になります。
並列実行はまだ発展途中の機能なので、今のうちに慣れておくと後で差がつきますよ。
並列実行はまだ発展途中の機能なので、今のうちに慣れておくと後で差がつきますよ。
