AIコーディングエージェントを使うと、「自分のPC上で動かすもの」と「クラウド上で動かすもの」の両方に出会う。Cursor でも、ローカルエージェントとクラウドエージェントがある。
見た目は似ていても、動く場所・権限・向き合うタスクが違う。この記事では、違い・メリット・使い分けをざっくり整理する。
先に結論
- ローカル … 手元の IDE / マシンで動く。対話が速く、手元の環境をそのまま使える
- クラウド … リモートの実行環境で動く。長時間・並列・PR 作成向き。手元を占有しない
- 短い確認・設計相談・手元デバッグ → ローカル
- まとまった実装・複数ブランチ・放置して進めたい作業 → クラウド
- どちらか一方、ではなくタスクで切り替えるのが実務的
そもそも何が違うのか
ざっくり言うと、エージェントの脳（モデル）より、手足がどこにあるかの違いが大きい。
ローカルエージェント
- 実行場所: 自分の PC / IDE セッション
- 見えるもの: 開いているワークスペース、ローカルの git、手元のツール
- 対話: その場で往復しやすい（「ちょっと直して」「ここ見て」）
- 制約: 手元マシンのスペック・ネットワーク・今の作業の邪魔になり得る
クラウドエージェント
- 実行場所: クラウド上の隔離された実行環境（VM など）
- 見えるもの: リポジトリを clone した環境、設定された secrets / MCP、用意されたツール
- 対話: 非同期寄り。投げておいて結果（差分・PR・ログ）を後で見る使い方が得意
- 制約: 手元の未コミット変更やローカルだけの設定は、基本そのままでは見えない
比較表（ざっくり）
| 観点 | ローカル | クラウド |
|---|
| 実行場所 | 手元 | リモート環境 |
| 応答の感覚 | 対話向き | バッチ／非同期向き |
| 手元環境の利用 | 強い（ローカル DB・VPN など） | 弱い（渡したもの／設定したもの） |
| 長時間作業 | PC を占有しやすい | 投げっぱなしにしやすい |
| 並列 | 自分の集中がボトルネック | 複数タスクを並べやすい |
| 成果物 | ローカル差分中心 | ブランチ / PR / ログまで一気に出しやすい |
| 秘匿情報 | 手元の慣習に依存 | 環境の secrets / 権限設計が重要 |
ローカルエージェントのメリット
- フィードバックが速い … 「ここ違う」「このファイルも見て」がすぐ回る
- 手元の現実に強い … ローカル起動中のアプリ、未コミットの作業中コード、社内 VPN 越しの検証など
- 設計・調査の壁打ち向き … コードを大きく変えず、方針を固めるフェーズに合う
- 細かい編集の制御 … 差分をその場で確認しながら進めやすい
- セットアップが軽い … 「今開いているリポジトリで今すぐ」がしやすい
向いている例: バグの原因切り分け、小さなリファクタ、レビューコメント対応、仕様の質問、テストの1本追加。
クラウドエージェントのメリット
- 手元を空けられる … 実装を投げている間に別作業・会議ができる
- まとまった変更に強い … 複数ファイル、ブランチ作成、コミット、PR まで一連で進めやすい
- 並列化しやすい … 独立したタスクを複数エージェントに振れる
- 再現可能な実行環境 … チームで同じ環境定義（依存関係・ツール）を共有しやすい
- 長時間・重い処理向き … インストール、広めのテスト、調査ループをマシンに縛られず回せる
向いている例: 機能追加一式、ドキュメント整備、TODO 消化、サイト投稿の一連作業、依存関係を含む検証付き改修。
使い分けの目安
ローカルを選ぶとき
- 今見ている画面・今のブランチの続きをすぐ直したい
- 未コミットの作業中ファイルが本題
- ローカル限定の環境（手元 DB、証明書、VPN）が必要
- 方針が固まっておらず、対話で探りたい
クラウドを選ぶとき
- ゴールが「PR ができる状態」まではっきりしている
- 変更範囲が広く、手元で付き合うと時間が溶ける
- 同じ型の作業を複数本並べたい
- 実行環境や secrets をクラウド側に寄せてある
組み合わせ（実務でありがち）
- ローカルで方針と受け入れ条件を固める
- クラウドに「実装〜PR」を投げる
- 戻ってきた差分をローカルでレビュー・微修正
エージェントを「代わりに全部考える人」ではなく、探索はローカル、実行はクラウドと役割分担すると回しやすい。
使う前に押さえる注意点
- 権限と秘密情報 … クラウドは特に、何を secrets に入れるか・何をリポジトリに書かないかを先に決める
- 再現性 … クラウドは環境構築（依存関係・ツール）が成果物の一部。ローカル「自分だけ動く」を持ち込みすぎない
- 指示の粒度 … クラウドは非同期なので、受け入れ条件・禁止事項・完了定義を最初に厚めに書く
- レビューは人がやる … どちらも自動マージ前提にしない。差分と動作確認は残す
ざっくりまとめ
- 違いは「賢さ」よりどこで手足が動くか
- ローカルは対話・手元環境・短い修正が強い
- クラウドは長時間・並列・PR までの実行が強い
- 使い分けは「今すぐ壁打ちか / 投げて進めたいか」
- 実務ではローカルで要件を固め、クラウドで実装する組み合わせが使いやすい
どちらが上位という話ではない。タスクの形に合わせて選ぶ道具だと捉えると、エージェント活用が一気に現実的になる。