Cursor Background Agentの使い方完全ガイド — 料金・セットアップ・CI活用・Devinとの比較【2026年版】
Cursor Background Agentを使いこなすための完全ガイド。セットアップ手順・Slack連携・料金実測・プライバシーモードの制約・Devin/Claude Codeとの使い分けまで、実際に動かした視点で解説。
エンジニアのゆとです。
Cursor 1.0でBackground Agentが正式リリースされてから、使い方の記事がぽつぽつ増えてきた。でも読んでみると「試してみた」レベルのものが多く、「実際どう使うのか」「料金はいくらかかるのか」「Devinと何が違うのか」のあたりが薄い。
この記事では実際にBackground Agentを動かしながら、上記の疑問を一通り答えていく。
Background Agentとは何か
Background AgentはCursorが提供するリモートサンドボックス環境でのAIエージェント機能だ。普通のCursor AgentがローカルのIDEと対話しながら動くのに対して、Background Agentはクラウド上の隔離されたVM（Ubuntu）で非同期に動く。
つまり「ラップトップを閉じていてもAIが作業してる」状態が作れる。
主な特徴:
- 非同期実行: タスクを投げたら別の作業ができる
- 独立した環境: ローカルのファイルに直接触らない
- GitHub PR作成まで一貫: コード変更→commit→PR作成を自動実行
- Slack/Webから依頼可能: IDEを開かなくてもタスクを投げられる
Agent Mode（Cursor標準のエージェント）はローカルのファイルをリアルタイムで操作する。Background Agentはリモートで非同期実行。「今すぐ横で作業してほしい」ならAgent Mode、「これやっといて、後で見る」ならBackground Agent。
セットアップ手順
1. 対応プランの確認
Background AgentはCursorのProプラン（$20/月）以上で使える。ただし一つ注意点がある。
プライバシーモードが有効だとBackground Agentは使えない。Cursor Team Planではデフォルトでプライバシーモードが強制ONになっているケースがある。業務で使っている場合は管理者に確認が必要だ。個人のProプランであれば Settings → Privacy → プライバシーモードを確認して、OFFになっていればOK。
2. GitHubリポジトリとの連携
Background AgentはGitHubリポジトリと連携して動く。
- Cursor設定 → Background Agents
- 「Connect GitHub」でGitHub認証
- 使いたいリポジトリを選択
- Cursor GitHub Appのインストール（初回のみ）
リポジトリのブランチへのwrite権限が必要なので、fork先ではなくオリジナルリポジトリを連携する。
3. 環境の初期化設定
Background AgentはUbuntu VMを起動してからリポジトリをcloneし、設定に従って環境を構築する。.cursor/environment.json（またはcursor.shスクリプト）で初期設定を制御できる。
{
"install": "npm ci",
"build": "npm run build",
"test": "npm test"
}Node.jsやPythonなどの言語ランタイムはデフォルトで入っている。PostgreSQLやRedisが必要な場合はDockerで起動するスクリプトを書けば動く。
依存関係のインストールが重い（node_modulesが大きい等）と、タスク実行前の準備だけで数分かかることがある。Snapshots機能（有効化で環境をキャッシュ）を使うと起動が速くなる。
依頼の3つの方法
Cursor IDE から依頼
チャットパネルの上部でBackground Agentモードに切り替えて、通常のAgent Modeと同様に指示を出す。完了するとPRが作成される。
「auth.tsのJWT有効期限チェックのバグを修正してPRを作って」依頼後は別のタスクに移れる。進捗は通知パネルで確認できる。
Slack から依頼
Cursor BackgroundのSlack Appをインストールすると、Slackから直接タスクを投げられる。
@cursor fix the login redirect bug in /pages/login.tsx and create a PR英語の方が精度が高い傾向がある。日本語でも動くが、技術的な指示はできるだけ具体的に書く方がいい。
Webダッシュボードから依頼
cursor.com/background からブラウザ上でタスクを管理・追加できる。ログを見ながら途中で指示を追加することも可能。
料金の実態
Background Agentは基本的にCursorのリクエスト消費で動く。料金構造は：
- Pro（$20/月）: 月500リクエスト + Backgroundタスクは追加消費
- Max Mode有効時: モデルごとのコスト（GPT-4o/Claude Sonnet等）が適用
実際の感覚として、1つのBackground Agentタスクで5〜20リクエスト程度消費する。バグ修正なら5前後、大規模リファクタリングなら20以上になることもある。
月$20のProプランでヘビーに使うと月末にリクエスト残量が心配になる。使い切った後は$10/50リクエストの追加購入か、Business Planへのアップグレードが必要。
Background Agentを1日2〜3タスク使うとすると、月60〜90タスク程度。タスクごとに平均8リクエストとすると月480〜720リクエスト。Proの500リクエストは普通に超える計算になる。ヘビーユーザーはBusiness Plan（$40/月）の方が割安になるケースが多い。
実際に使って良かった場面・微妙だった場面
良かった場面
依存パッケージの更新作業npm outdatedの結果を貼り付けて「これらを最新版に上げてテストが通るか確認してPRを作って」と依頼すると、破壊的変更の確認→コード修正→テスト実行→PRまで一気にやってくれる。自分がやると半日かかる作業が1〜2時間で終わる。
JSDocコメントの追加、READMEの更新、型定義の整備などはBackground Agentが得意。ローカルで出力を確認しながら進める必要がないので非同期向き。
軽めのリファクタリング変数名の統一、共通化できる関数の抽出、非推奨APIの置き換えなど、「方針は明確だが手数が多い」系のリファクタリングに向いている。
微妙だった場面
デバッグ系のタスク「なんかエラーが出る、直して」系の曖昧な依頼は苦手。エラーの再現条件が複雑だったり、実行環境依存のバグだと、Background Agentのリモート環境では再現できないことが多い。
UIの細かい調整ビジュアルの確認が必要な作業はBackground Agentの守備範囲外。スクリーンショットを取る仕組みがないので、「ボタンのpaddingを8pxに変えて見た目を確認」は人間がやる必要がある。
Devin / Claude Code との比較
「Background AgentとDevinとClaude Code、どう使い分けるのか」という疑問が一番多い。整理するとこうなる。
| ツール | 実行場所 | 強み | 弱み | 月額 |
|---|---|---|---|---|
| Cursor BG Agent | リモート（Cursor管理） | Cursor Pro内で追加費用なし（リクエスト消費のみ）、GitHub連携がスムーズ | 料金上限が読みにくい、プライバシーモード非対応 | $20〜 |
| Devin | リモート（Cognition管理） | 自律性が高い、複雑タスクの完遂率が高い、詳細なログ | 高い（$500/月〜）、速度が遅い | $500〜 |
| Claude Code | ローカル | リアルタイム対話、大規模コードベース対応、カスタマイズ性が高い | ラップトップを開いている必要がある | $20〜（CC Max） |
Background AgentはDevinより格段に安く、Claude Codeより非同期でいい、という中間ポジションだ。
実際の使い分け（自分の場合）- 今すぐ対話しながら進めたい → Claude Code
- 「これやっといて」で離席したい → Background Agent
- 超複雑・長時間タスクで完遂率が重要 → Devin（使いどころは少ない）
CI/CDとの統合
Background Agentで作ったPRに対して、GitHub Actionsを回すのがいい組み合わせだ。
- Background AgentがPRを作成
- GitHub Actionsでlint + test + build
- テスト結果をPRコメントに自動投稿
- 自分がコードレビューしてマージ
この流れだとBackground Agentの成果物を自動テストが検証してくれるので、「何かおかしいまま気づかずマージ」を防げる。
@cursor fix: see test failures in PR #123とSlackから返信することで、Background Agentに修正を依頼し直すことも可能。
トラブルシューティング
タスクが途中で止まる- タイムアウト（デフォルト30分）に引っかかっている可能性がある。長いタスクは分割する
- 環境のセットアップに失敗している。ダッシュボードのセットアップログを確認する
- 指示が曖昧だった可能性が高い。「なに」「どのファイル」「どういう状態にする」を明確に書く
- 既存のコードとコンフリクトしていないか確認する
- CursorのSlack Appのパーミッションを確認する
- ボットへのメンションが正確かチェックする（スペースの有無等）
まとめ
Cursor Background Agentは「非同期でAIに任せたいタスク」にちょうどいい。Devinほど高機能じゃないが、Cursor Proに含まれる（追加コスト的な意味で）という点は無視できない強みだ。
守備範囲は明確で、「方針は決まってる・手数が多い・リアルタイム確認不要」系のタスクなら素直に使える。逆にデバッグ・UI調整・曖昧な依頼は向いていない。
プライバシーモードの制約だけ注意すれば、個人開発者にとってコスパのいい非同期エージェントとして機能する。
