Cloud だけでかなり行ける
文言、構成、多くのサイト改修、調査、PR 作成、レビュー、Automations。ここまでをブラウザ / スマホ中心で学べるのが、このパスの意図です。
自前の作業場(Team Pool / Self-Hosted など)を検討するチームもありますが、公式も多くのチームはまず Cursor が用意するクラウドの VM から始めることを勧めています。はじめての方は、環境の整備さえ進めば Cloud だけで一周を回す方が早いことが多いです。ダッシュボードの Secrets と、保存した環境の設定が届くのも Cloud machine です。リポジトリの environment.json は、その環境がファイルを指しているときだけ読みます。My Machines の鍵は手元 PC、Team Pool は Secret sync(`--sync-dashboard-secrets`)です(first-cloud-agent の実行先の選び方。公式 Choose where Cloud Agents run / Cloud Environment Setup)。
会社がすでにサンドボックスを持っているときだけ、Team Pool の実体をその上に置けます。公式 Self-Hosted integrations の例は AWS Lambda、Cloudflare、Namespace、Modal、Daytona、E2B、Vercel、Tensorlake、Coder、Superserve です。Kubernetes の新規は anysphere/k8s-workers で、古い operator は非推奨です。待たせたくないときは `--warm-idle` で空き Pod を温めておけます(詳しい人向け)。ガイドは参考アーキテクチャで、本番の検証は会社側が持ちます。
Team Pool の作業場は、使っていないあいだ休眠(hibernate)し、次の依頼で戻せる公式の動きがあります。高いマシンをずっと温めておかなくてよい、という説明です。
自前作業場では、コード本体と手元の鍵は残ります。会話に必要な抜粋・ターミナル出力・成果物はクラウドへ届きます。スクショだけ止めたいときは成果物ホストを塞ぎます(作業は続く。公式 Self-Hosted Machines)。自前作業場の MCP は、チームの MCP が毎回使え、環境ごとの上限はありません(公式 Self-Hosted Machines)。
Self-Hosted Machines で画面確認(コンピュータ操作)を使うときは、ワーカー起動時に `--computer-use` が必要です。macOS は Cursor Computer Use ヘルパーアプリにアクセシビリティと画面収録を許可します(Terminal や Cursor 本体ではありません)。Linux は X11。画面の共有(`--share-desktop`)は Linux だけです。見るだけ(view)か、マウスとキーボードも渡す(view_and_control、既定)を選べます。共有されるのはワーカーが作った隔離デスクトップで、クリップボードは渡りません(公式 computer use)。
macOS 15 以降は、画面収録の許可を定期的に聞き直すことがあります。スクショが止まったら、ログイン画面の『1か月許可』を確認してください。
会話に Browser と出たら、画面操作の途中を子に任せているだけです。Desktop の `@browser`(エディタ内のブラウザ枠)は別物で、ページ確認・クリック・入力ができます。Cloud Agent の画面確認はコンピュータ操作です(公式 Browser / Subagents)。
自前ワーカー(My Machines / Team Pool)では、未同期の個人用 Skill は届きません。手順を揃えるならリポジトリの `.cursor/skills/` に置くか、ワーカーのイメージへ焼き込みます(公式 Agent Skills。rules-and-skills)。`.cursor/environment.json` も読まれないので、install / start は作業場の `.cursor/hooks.json`(sessionStart)か `--on-session-start` へ移します(environments-and-secrets 末尾。公式 Self-Hosted Machines)。
Desktop が効いてくる合図
次のような気持ちが出てきたら、Desktop を足すタイミングです。Desktop でも Cloud を選べるので、『全部 Local に切り替える』必要はありません。手元の作業をクラウドへ移す『Move to Cloud』もあります。
- 手元の未保存作業や、ローカルだけの設定をまたいで試したい
- 細かい編集を自分の目でファイルツリーを見ながらやりたい
- Tab 補完や Inline Edit など、エディタ一体の速度が欲しい
- Remote Control で『自分の PC の環境』を使いながらスマホから指示したい
- チームが IntelliJ / PyCharm / WebStorm を使っていて、Cursor Desktop に移さず Agent に頼みたい
- チームが Xcode を使っていて、ビルドや SwiftUI プレビューを Cursor から頼みたい
- ターミナル(CLI)で会話していて、席を離れてクラウドに続けたい
Remote Control の要点
Remote Control は、『自分のコンピュータ上で動いている Agent を、スマホから見て返信する』仕組みです。いちばん簡単な入口は、iOS アプリでパソコンをペアリングすることです。手元の Agent は動かしたままで、Cloud Agent は不要です(公式 changelog Remote control for local agents)。
ペアリングの骨格: iOS アプリにサインインする → アカウントのパソコンが一覧に出る → パソコンをタップする → Desktop 側で承認する → 手元の Agent が一覧になり、タップして見る・返信する。Enterprise 以外は既定オンです。Enterprise は Org settings → Security and identity → Remote control で管理者がオンにします。
会話の指揮をクラウドへ移したいときは、別の入口があります。Desktop を 3.9.8 以降にする → Agents Window の Settings → Agents で Remote Control をオン → `/remote-control` を実行して次のメッセージを送る。こちらは公式 Mobile の手順で、道具は手元、会話のループはクラウドです。Teams / Enterprise では Dashboard → Cloud Agents → Self-Hosted の許可も要ります。オンにすると self-hosted worker 利用も一緒に有効になります。
どちらの入口でも、PC は起きていてオンラインである必要があります。Settings → Agents の『Keep this computer awake』は、電源接続かつふたを開けたままのときスリープを止めます(公式 changelog)。Local だけでなく Remote SSH でも使え、Git remote が無いプロジェクトでも問題ありません(公式 Mobile)。セッションはあなたのアカウントと手元 PC に紐づき、他人は操作できません。
Move to Cloud と Remote Control のちがい
端末をまたいで続ける方法は、公式には大きく2つあります。混同しやすいので、目的で選び分けましょう。
Move to Cloud は、手元の未コミットの変更を写しません。クラウドの Agent は、リモートの保管庫にあるコミット済みの状態から始まります。移るのは会話の履歴と、その文脈です。保存していない編集や、コミットしていない差分は移りません。続けてほしい最新の状態があるなら、移す前にコミットするか、stash(一時的に脇へ置く)してください(公式 Cloud Agents)。
- Move to Cloud: 会話をクラウド VM 上の Agent へ移す。以降、実装もテストもクラウド側で動き、手元 PC を閉じても続きやすい。未コミットの手元の変更は写らない
- 移す前: 残したい変更はコミットするか stash する。保存していないファイルのまま移すと、クラウド側には残らない
- iOS のペアリング: 手元の Agent は動かしたまま、スマホから見て返信する。Cloud Agent は不要(公式 changelog)
- Remote Control(`/remote-control`): 会話の指揮だけクラウドへ移し、ファイル編集・テスト・git などの道具は手元 PC(または Remote SSH)で動かし続ける。リポジトリや秘密情報は手元に残る
Agents Window との関係
Desktop には Agents Window があります。複数の Agent を一覧し、Remote Control のオン/オフや Automations 作成の入口にもなる指揮台です。Web の cursor.com/agents と同じ系統の仕事を、Desktop からも回せます。過去の会話を探すなら、Agents Window で Cmd+K(Windows / Linux は Ctrl+K)。いま開いている会話の中は Cmd+F、自分の依頼へ戻るのは Cmd+↑ / Cmd+↓ です(公式 Conversation search / changelog 3.23。くわしくはこのレッスンの会話検索節)。
『Desktop を入れる=全部 Local になる』ではありません。指揮は Desktop、実装は Cloud、という分け方もよく使います。
ターミナルの Cursor CLI でも同じ系統の Agent を動かせます。会話の途中でメッセージの先頭に `&` を付けると Cloud Agent へ引き継ぎ、cursor.com/agents やスマホから続きを見られます(公式 CLI。first-cloud-agent)。調べるだけは `/ask`、先に計画は `/plan`、再現できるのに原因が分からないときは `/debug` です。使い分けは prompting の Ask / Plan 節と Debug 節。手元で続けるときの sandbox / persist / worktree は、このレッスン末尾の CLI 安全な作業場節です。昨日の会話を履歴から開くのはその次の resume 節。コマンドをどこまで確認なしで任せるか(Run Modes)は、Settings → Agents → Approvals & Execution です。
大きな仕事は Projects(コーディネーター)
1つの Cloud Agent や `/goal` は、1本の仕事を終わるまで追う向きです。1回のチャットでは終わらない仕事——機能追加、移行、アプリ全体、品質の手入れ——は、公式の Projects が入口です。Desktop では Agents Window の左ナビ、iPhone では inbox の New Project です。使えるのは Cloud Agent がある契約だけです。新しい契約は Premium 以上で、Plus と Free にはありません。これまでの Start / Pro / Teams / Enterprise など、Cloud Agent がある契約では使えます。Enterprise の Desktop は Cursor 3.21.9 以降です。Hobby と Privacy Mode(Legacy)では使えません。iPhone の見え方と、手元の Agent の入れ方は、このレッスンの末尾です(公式 Projects / Cursor for iOS)。新しく作った Desktop の会話が Setting up project の一行だけのときは、見出し「準備中の一行(Setting up project)」を見てください。動き始めてから連絡が Messages from の一行にまとまるときは、見出し「連絡は中央の一行(Messages from)」を見てください。タスクの表で、自分の Pull Request も Agent も無い親が子より後ろに残るときは、見出し「親タスクは、子のいちばん進んでいる状態に合わせる」を見てください。
Projects の中心はコーディネーターです。自分ではコードを書かず、計画して複数の Agent に振り分け、仕上がりをあなたに返します。実装を人に渡すので、コーディネーター自身は止まりにくく、途中の指示にも答えやすい、というのが公式の説明です。実体は Cloud Agent なので、ノート PC を閉じても進みます。手元のテストが必要なときだけ、コーディネーターが Local Agent を起動します。
共有のファイルに、調査結果や『このサービスはこう試す』といった学びが残ります。1人が見つけたやり方を、次の Agent も使えます。Slack のバグ報告チャンネルを見る、予定で動く、PR をフォローする、といった待ちもコーディネーターに頼めます。待ちが1つ以上あると、入力の上に Listening(いま聞いている)と出ます。中身の一覧から外せます。これは1つの Agent の Subscriptions や、決まったきっかけで同じ型を起動する Automations とは別物です。
- 機能づくり: 調べて共有メモに残し、計画して並列で実装・テストする。手元で触りたくなったら Local Agent。出したあとも、同じ Project がログやバグ報告を追える
- 移行: 安全なやり方を先に決めてから、少しずつ PR を重ねる。最初は1件ずつよく見て、安定してきたら見る間隔を広げてよい(公式ブログ)
- 日常の手入れ: 終わらない仕事(品質、デザインの揃え、回帰の監視)。新しい PR や Slack のバグ報告、予定に合わせて動かす
ここから先の伸ばし方
公式ドキュメントの Cloud Agents / Automations / Integrations / Mobile を、必要になった節だけ読んでみましょう。成長は、短いループを繰り返すことで起きていきます。
- 週1: 影響の小さい文言や FAQ の改善を1件、Cloud Agent に依頼して PR まで出す
- 週1: 他人または自分の PR を、成果物 → Deployments(あれば)→ プレビュー → Origin なら Changes の Tour、GitHub なら Files changed → behind / コンフリクト確認の順でレビューする
- 隔週: 繰り返している依頼を Skill か Automations(`/automate`)の下書きにする
- 大きな仕事が出てきたら: Desktop は左ナビ、iPhone は inbox の New Project。出なければ1つの Agent のまま(くわしくは末尾)
手元の変更を読む Agent Review
Desktop で手元のファイルを直しているとき、PR を出す前に『いまの変更だけ』を読んでもらう機能が Agent Review です。PR が出てから動く Bugbot や、チャットの `/review` / `/review-bugbot` / `/review-security`(Cloud Agent 向けに先に読む)とは別物です(公式 Agent Review)。
起動の仕方は公式に3つあります。① 設定でオンにすると、コミットのたびに自動で走る ② チャットで `/agent-review` ③ Source Control(ソース管理)タブから、本線との差分全体を読む。③は『直近の一手』だけでなく、手元に溜まった変更の全体を見る向きです。
設定場所は Cursor Settings → Agents → Agent Review です。Cursor 3.11 以降は Git & PRs → Pull Requests に移ります。深さは Quick(速さ優先・小さな差分)と Deep(時間と利用量は増えるが、複雑な変更向き)の2段階です。
Agent Review も `.cursor/BUGBOT.md` を読みます。プロジェクト Rules(*.mdc)はここでも効きません。PR 側の Bugbot と同じ約束ファイルです。
まちがえたときの戻し方(Checkpoints)
Desktop の Agent が変な方向に進んだとき、会話を消さずにファイルだけ前の状態へ戻せる仕組みが Checkpoints です。大きな変更の前に自動で残ります(公式 Agent overview)。
チャットのタイムラインで戻り地点を開き、中身を見てから Restore します。直前の依頼の Restore Checkpoint、またはメッセージにカーソルを載せた + からも戻せます。戻るのはファイルだけです。会話のメッセージは消えません。
Checkpoints は手元に保存され、Git のコミットとは別物です。一時的な『いまの Agent 作業を取り消す』用です。残したい履歴は、これまでどおりブランチと PR です。
Cloud Agent ではこの画面は出ません。クラウド側で外れたときは follow-up-loop のとおり『残す / 戻す』を追記するか、PR を閉じます。
- 見る: チャットのタイムラインの Checkpoints
- 戻す: Restore Checkpoint。会話は残る
- 残す: よければ Git / PR。Checkpoints は一時的な戻り地点
Agent / Plan / Ask は Desktop でも同じ
Desktop と CLI では、入力の Shift+Tab で Agent(実装)・Plan(計画してから)・Ask(調べるだけ)を切り替えます。再現できるのに原因が分からないときは Debug Mode(モード選択または `/debug`)です。詳しい使い分けは prompting の Ask / Plan 節と Debug 節です。
計画どおりに作れなかったときは、追記で継ぎ足すより、Checkpoints でファイルを戻して計画を直してから作り直す方がきれいな結果になりやすい、というのが公式 Plan Mode の案内です。
CLI の安全な作業場(sandbox / persist / worktree)
ターミナルの Cursor CLI(コマンド agent)は、Desktop と同じ Agent の入口です。席を離れてクラウドへ渡す `&` は first-cloud-agent で触れました。手元のターミナルで続けるときの安全装置が、あと3つあります(公式 CLI overview / using / changelog)。
まず sandbox です。Agent が打つコマンドを、作業場の外まで届きにくい箱の中で走らせます。`/sandbox` でメニューが開き、`--sandbox enabled` か `disabled` でも切り替えられます。設定は次の起動にも残ります。箱の中のネットワークは、許可した先以外には出にくい公式の動きです。
sudo(管理者権限)が必要なコマンドでは、伏せ字のパスワード入力が出ます。パスワードは sudo へ直接渡り、AI のモデルには見えません(公式 CLI overview)。
会話を出ずに短いコマンドを打つ入口が Shell Mode です。ログインシェル(`$SHELL`)で、いまの作業フォルダから走ります。公式では30秒で打ち切り、対話入力や長いサーバー起動は向きません。`cd` は次のコマンドに残らないので、別フォルダなら `cd && …` です。抜けるのは空入力で Escape(または空の Backspace / Ctrl+C)。はじめての確認は短い `pwd` や `ls` で十分です。渡した文を実行するビルトイン Skill の `/shell` とは別です(公式 CLI Shell Mode)。
ターミナルを閉じても同じパソコン上で続けたいときは `agent persist` です。途中で離れるなら `/detach`。戻るときは `agent persist attach`。一覧と停止は `agent persist list` / `stop`。persist の実行の中で前の会話を続けるなら `agent persist --resume`。これは Cloud Agent への `&` とは別です。persist は手元のマシン、`&` はクラウドの作業場です。ターミナルを閉じて終わった会話を履歴から開くのは次の節の `agent resume` です。
- sandbox: `/sandbox` または `--sandbox enabled`。コマンドを箱の中で走らせる
- sudo: 伏せ字の入力。パスワードはモデルに見えない
- Shell Mode: 短い非対話コマンド。30秒で打ち切り。`cd` は残らない
- persist: 手元で切断しても続ける。クラウドへ渡すなら `&`
- worktree: 手元の枝を直接触らず、別コピーで作業する
CLI の会話を続きから開く(resume)
ターミナルを閉じてから、昨日の会話をまた開きたいときは persist(動かしたまま離れる)ではなく resume(履歴から再開)です(公式 CLI using / changelog)。
いちばん新しい会話は `agent resume`、起動時の `--continue`、チャットの `/resume` です。一覧から選ぶなら `agent ls`。既定はすべての作業場のチャットで、Left/Right で『この作業場』に切り替えられます。別フォルダの会話にはフォルダ名が付きます。特定の会話は `--resume チャットID` です。
persist は同じ実行を切断しても続ける起動です。resume は一度終わった/閉じた会話を履歴から開き直します。persist の実行の中で前の会話を続けるなら `agent persist --resume` です。クラウドへ渡す `&` はどちらとも別です。
会話が長くて重くなったら `/summarize`(別名 `/compress` / `/compact`)でこれまでのやり取りを要約して空きを作ります。別の方針を試したいときは `/fork`(別名 `/branch` `/duplicate`)で会話のコピーを作ります(公式 CLI slash commands)。
CLI はプロジェクト直下の AGENTS.md に加え、CLAUDE.md も Rules として読みます(公式 CLI using)。Claude Code から来たチーム向けです。はじめての約束は AGENTS.md か `.cursor/rules` で十分です。
- いちばん新しい会話: `agent resume` / `--continue` / `/resume`
- 一覧から選ぶ: `agent ls`(Left/Right でこの作業場)
- 長くなった会話: `/summarize`。別方針: `/fork`
コマンドをどこまで任せるか(Run Modes)
Desktop の手元 Agent は、ターミナルのコマンドや MCP、Web 取得の前に『あなたに確認するか』を Run Modes で決めます。設定場所は Cursor Settings → Agents → Approvals & Execution です(公式 Run Modes)。
公式が多くの人に勧めるのは Auto-review です。順番は、許可リストにある操作はすぐ走る → 箱の中で走らせられるコマンドは sandbox → 箱に入らないもの(ネット全開、作業場の外への書き込み、特権)は短い分類を挟みます。箱の制限で失敗したコマンドは、分類のあと箱の外でやり直すことがあります。分類が止めたあとは別のやり方を試し、それでも必要ならあなたに確認します。分類を間違えることもある、と公式も書いています。セキュリティの壁そのものではありません。道具側が確認必須と印を付けた MCP(マージなど)は、Auto-review でも確認カードが出ます。確認なしで通すのは Run Everything か、その道具を許可リストに入れたときです。『メールを送らないで』『デプロイしないで』と止めても、下書き・プレビュー・計画は進みます。確認が掛かるのは最後の送信や反映です(公式 changelog 3.22)。一方、フォルダごと消す・強制・ワイルドカード・mirror の削除で、対象が書き方と違う可能性があるときは確認カードが出ます。『いつも確認して』と permissions.json に書いた操作も、必ず確認します(公式 changelog 3.24)。作業場の外のファイルや保護された設定を読む/書くときも確認カードが出て、理由が書かれます(例: 作業場の外のファイルを直します)。読み取りの確認には、ファイルの場所の全体と Allow が出ます(公式 changelog 3.23)。
分類は Cursor 側の小さなモデルです。いまの公式は Gemini 3.5 Flash Lite、予備は Claude 4.5 Haiku です。Enterprise で Haiku が止まっていると、Auto-review がグレーになり Allowlist になります。Flash Lite だけ止まっていても、Haiku があれば動きます。グレーなら Team Settings → Models で Claude 4.5 Haiku を許可し、Cursor を完全に終了して開き直してください(公式 Run Modes)。会話で使う Claude Haiku 5.5 とは別です。分類はあなたのマシンで読み取り専用の ReadFile / Grep / Glob / ListDir を使うことがあります。
Allowlist は、許可した操作だけ自動です。sandbox をオンにすれば、対応するコマンドは箱の中でも走れます。許可リストを空にすると、ほぼ毎回聞かれます。以前の Ask Every Time(毎回聞く)は Cursor 3.5 で廃止され、新規では選べません。同じ動きが欲しければ空の Allowlist です。
Run Everything は、すべての道具を確認なしで走らせます。sandbox も分類も使いません。permissions.json でそのモードを制限していない限り、箱の外でそのまま走ります(公式 changelog 3.24)。確認ゼロを優先し、リスクを承知したときだけです。
ブラウザやスマホの Cloud Agent は専用の作業用コンピュータの中で動くので、Run Modes は使いません。コマンドごとに聞いてこないのは正常です。確認は終わったあとの要約・差分・成果物です(first-cloud-agent)。作業場の外を読む前に確認するかは、同じ画面の Read Access です(次の節ではなく、このレッスン末尾)。自分の手で打つと質問が出るのに、Agent が同じコマンドを打つと飛ばすときは、環境変数 CI=1 のことがあります。見出し「自分で打つと動きが違う(CI=1)」を見てください。
- Auto-review: はじめての公式おすすめ。許可リスト → 箱 → 箱に入らないものだけ分類。確認必須の MCP(マージなど)は、ここでも確認カードが出る。『送らないで』でも下書き・プレビューは進む。フォルダごと消すような危ない削除は確認する
- 分類: Gemini 3.5 Flash Lite(予備 Claude 4.5 Haiku)。Haiku が止まるとグレー
- Allowlist: 決めた操作だけ自動。空ならほぼ毎回聞く(旧 Ask Every Time の代わり)
- Run Everything: 全部自動。確認ゼロ。permissions.json で止めていなければ箱も使わない
- Cloud Agent: 専用 VM なので Run Modes なし。コマンド承認は出ない
- Read Access: 作業場の外を読む前に確認するか。詳しくはこのレッスン末尾
- 自分の手と Agent でコマンドの動きが違うとき: 環境変数 CI=1。詳しくはこのレッスン末尾
手元からクラウドの子へ(/in-cloud)
Desktop や CLI で手元の会話を続けたまま、次の仕事だけクラウドの子 Agent に渡したいことがあります。公式 Subagents の入口は `/in-cloud` です。打ったあとの次の依頼が、別の仮想マシンと別の枝で動くクラウドの子になります。手元の作業場は汚れにくく、長い調査や CI 直しを横で進められます。
会話ごとクラウドへ移す `&`(first-cloud-agent)や、セッションごとクラウド VM へ移す Move to Cloud とは別です。`/in-cloud` は『いまの会話は手元、次の一手だけクラウドの子』です。開いた PR をクラウド側で見守る `/autopilot` も、クラウドの子として動くことがあります。
クラウドの子が使う MCP は cursor.com/agents のチーム設定です。手元セッションの MCP ではありません。環境は保管庫に設定したものに従います(公式 Subagents)。
- `/in-cloud`: 次の依頼だけクラウドの子(別 VM・別枝)
- `&`: 会話ごと Cloud Agent へ引き継ぐ
- Move to Cloud: セッションごとクラウド VM へ移す
- `/autopilot`: 開いた PR をクラウドの子が見守る
横の質問と過去の会話(Side chat / 会話検索)
本線の Agent を走らせたまま、『この用語は?』『該当箇所はどこ?』だけ知りたいときは Side chat です。チャットで `/side` または `/btw`。親のやり取りは裏の参考になり、画面には横の質問だけ出ます(公式 Agent overview / Side chats)。
本線に戻すときは、本線で Side chat を @メンションします。閉じる(X)は保管するだけで消えません。入れ子は作れません。Fork(会話の写し)とは別です。
Cloud Agent でも同じ入口です。横会話は別の Cloud Agent として動きます。Projects の中では Side chat は出ず、スレッドを使います(公式 changelog 3.23 / Agents Window)。
あとから Side chat を探すときは、コマンドパレット(Mac は Cmd+Shift+P、Windows / Linux は Ctrl+Shift+P)で検索します。結果は Side chat とラベルされ、親の Agent 名が出ます。選ぶと親の会話が開きます(公式 changelog 3.22)。Cmd+K の会話検索は本線の過去会話向けです。
横のレールには最近更新した Side chat が最大5つ。6つ目以降は N more。畳むと Side chats の1ボタンから全部開けます(公式 changelog 3.24 / Agents Window)。
子役や Side chat をリンク・コマンドパレット・別の Agent から開くと、親の会話の横のタブとして並びます。親は見え続けます。戻るは Back で、開く前の画面です。Automations の実行の子役だけは単独で開きます(公式 changelog 3.24 / Agents Window)。
昨日の会話をキーワードで探すなら、Agents Window で Cmd+K(Windows / Linux は Ctrl+K)。開いている会話の中は Cmd+F(Windows / Linux は Ctrl+F)です。チャットや入力欄にフォーカスがあるときも、会話の中を探します。画面に出ている文字だけが対象で、差分やブラウザと同じ黄色い印です。会話を全画面にしたときは、その画面専用の検索欄があります(公式 changelog 3.23 / Conversation search)。サイトの /search はレッスン本文向けで、自分の Agent 会話は対象外です。
長い会話で自分の依頼を見失ったら、Cmd+↑ / Cmd+↓(Windows / Linux は Ctrl+↑ / Ctrl+↓)で自分のメッセージだけを順に辿れます。いちばん上や下へ飛ぶときは Shift を足します(Cmd+Shift+↑ / Cmd+Shift+↓)。入力欄にフォーカスがあっても、入力欄が空なら同じショートカットが使えます(公式 changelog 3.23)。
- 横で調べる: `/side` / `/btw`、または Shift+Cmd+S(Windows は Shift+Ctrl+S)
- 本線に戻す: 本線で Side chat を @メンション
- 過去の会話: Agents Window の Cmd+K。会話の中は Cmd+F(入力欄にフォーカスがあっても可)
- 自分の依頼へ: Cmd+↑ / Cmd+↓。端へ: Cmd+Shift+↑ / Cmd+Shift+↓(入力欄が空なら入力中でも可)
- Cloud Agent: `/side`・+・Add to Side Chat。横会話は別の Cloud Agent。Projects の中はスレッド
- あとから Side chat を探す: コマンドパレット。ラベルは Side chat、親の Agent 名が出て、親を開く
- 最近の Side chat: 横のレール(最大5つ。残りは N more)
- 子役や Side chat は親のタブ。戻るは Back(開く前の画面)
Grok Bot は別プロダクト
Grok Bot は、名前と役割を持った AI の同僚です。1台のクラウドパソコンを共有し、ブラウザやファイル、ログイン状態を持ち越します。この学習パスの本線である Cloud Agent(保管庫を直して PR を出す)とは別です(公式 Grok Bot)。
有料の個人プランと Cursor の Teams プランに含まれます。個別の SuperGrok 契約をつなぐこともできます。閉じたノート PC でも、クラウド側のパソコンは動き続けます。
- このサイトのコードを直したい → Cloud Agent(ここまでのレッスン)
- 名前付きの助手に CRM やメール、社内 Web をまたいで頼みたい → Grok Bot
- あなたの Bot は同じクラウドパソコンを共有する。置いたファイルやログインは、どの Bot からも見える
- はじめての方は混ぜない。PR を出して確認する流れは Cloud Agent のまま
Grok Bot のパソコンと安全な頼み方
公式の Work with Grok Bot では、あなたの Bot は1台のクラウドパソコンを共有します。ファイル・ログイン・ブラウザの状態は、どの Bot からも見えます。画面は Bot ごとに分かれますが、画面は作業場所であって安全の仕切りではありません。置きたくない鍵はパソコンに置かない、が公式の注意です。
チームの Team Bot に話しかけると、だいたいあなたのパソコンの上で動きます。相手のパソコンではありません。公開の共有リンクで配るのは設定のコピーで、あなたのパソコン・ログイン・会話履歴は渡りません。リンクの前に、説明文や Skill から API キー・社内 URL・お客様情報を外してください。
パスワード・パスキー・二要素・CAPTCHA・支払い確認は、Bot があなたにパソコンを渡します。チャットにパスワードやワンタイムコードを貼らないでください。止まらせたいときは『Stop now』(いま止めて)。すでにやったことは戻りません。
Gmail などのプラグインはアカウント全体に効きます。Cloud Agent の MCP とは別です。決まった時間や Slack の合図で繰り返すのは Grok Bot の定期実行(routine)で、第4章の Automations(コードを直す Cloud Agent の自動起動)とも別です。利用量は週でリセットされます(Cloud Agent の月次とは違う)。Bot を消しても、パソコン上のファイルとログインは残ることがあります。あとで使うなら Hide の方が安全です。
- パスワードやワンタイムコードはチャットに貼らない。パソコンを渡されたら、その場だけで入力する
- Team Bot はだいたいあなたのパソコン。共有リンクはコピー(パソコンは渡らない)
- 画面を見せて手順を教える Teach a task は順次公開。出ないときは、終わった仕事から Skill にして、と頼む
- はじめての繰り返しは、まず1回うまくいってから定期実行。広い『全部の新着』は使わない(公式)
Grok Bot のプラグインと、Team Bot が使うパソコン
Gmail などのプラグインはアカウント全体に効きます。1つ入れると、あなたの全 Bot から使えます。ログイン(OAuth)は Cursor 側に残り、Bot 自身は鍵を受け取りません。チームの Team Bot があなたのアカウントを使うときは、先に確認を聞きます(公式 Work with Grok Bot)。
チームが止めたプラグインは Disabled by team admin と出ます。場所はダッシュボードの Plugins & MCPs(Team Marketplace)で、Grok Bot 画面ではありません。ただしプラグインを止めても、そのサービスの Web サイトはパソコンのブラウザから開けます。サイト側も閉じるのは Network Controls(Enterprise のみ。未設定のチームは全部許可。セルフサーブの Teams には画面がありません)。
1対1のチャットでは、Team Bot はだいたいあなたのクラウドパソコンの上で動きます。Slack のチャンネル・スレッド・グループチャットでは、Team Bot 専用のパソコンを使います。オーナーが Team Bot に足した秘密・プラグイン・ファイルは、同僚のチャットからも見えます(公式 Grok Bot teams)。
決まった時間の繰り返し(定期実行)を試す Test は、本番と同じ仕事をします。サイトを開いたり、つながった道具を呼んだりします。試し打ちは安全な入力で、送信・購入・削除は承認の後ろに置いてください。
- プラグインをオフにした=その Web も閉じた、ではない
- 1対1はだいたい自分のパソコン。Slack / グループは Team Bot 専用パソコン
- Disabled by team admin はチームのコネクタ方針。サイト制限は Network Controls(Enterprise)
- 定期実行の Test は本番相当。広い『全部の新着』は使わない
Grok Bot の手元実行と Cloud Agent への委任
Grok Bot のクラウドパソコンと、いま目の前のパソコンは別です。手元でコマンドを走らせるのは『ローカル実行』という別スイッチです。既定はコマンドごとに確認です。Always allow(いつも許可)/ Ask every time(毎回聞く)/ Never(手元では走らせない)から選べます。公式は、手元のファイルを触る理由が無いなら Never を勧めています。チームの管理者は上限を決められます。自分の設定の方が厳しいときは、そちらの方が効きます(公式 Grok Bot security / settings)。
社内ネットに出したいときは、Settings → Computer の『このデスクトップ経由で通信する』(Route traffic through this computer)です。宛先にはあなたのデスクトップの IP が見えます。Enterprise の管理者が Allow Local Egress をオフにすると、スイッチは Disabled by your admin. You can't turn this on. になり、動いている経路は約5分で止まります。オンに戻すと、以前の選択が復活します(公式 Grok Bot settings / teams)。
Grok Bot はコード直しを Cloud Agent に渡すことがあります。渡した仕事は別の Cloud Agent のパソコンで動きます。PR を出す本線はこれまでどおり Cloud Agent です。管理者が委任をオフにしていると渡せません(公式 Grok Bot teams)。『混ぜない』は、Grok Bot から Cloud Agent を起動することもある、という意味です。
危ない操作の前に出る確認が Auto Review です。Desktop の Run Modes(Auto-review)とは別です。Allow once(今回だけ)/ Always allow(同じ型を覚える)/ Deny(拒否)。お金や共有アカウントは、公式も Allow once を勧めています。Enterprise では管理者が Enforce Auto-review でオフにできなくできます。個人のルールは厳しくする方向だけです。Ask first が勝ちます(公式 Grok Bot security)。
Network Controls は4モードです。未設定は全部許可。全部許可を明示する、既定プラスチームの許可リスト、チームの許可リストだけ、から選びます。動いているパソコンは約1分で反映し、休眠中は起きたときに反映します。Cloud Agent のネットワーク設定とは別です。パソコンを作り直す必要はありません(公式 Grok Bot security)。
対応している接続の秘密入力は、伏せ字の欄(secure secret request)です。会話にもモデルにも出ません。パスワードやワンタイムコードをチャットへ貼る必要はありません。
- 手元実行は別スイッチ。迷ったら Never(既定はコマンドごとに確認)
- 社内ネットはこのデスクトップ経由。Allow Local Egress がオフなら約5分で止まる
- Grok Bot から Cloud Agent へコード直しを渡せる。管理者はオフにできる
- Auto Review は Grok Bot 側。Desktop の Auto-review と混ぜない。Allow once を優先
- Network Controls は約1分で反映。Cloud Agent 側の制限とは別
Grok Bot の通知と、パソコンの直し方
終わった・確認が要る、に気づくには Bot ごとの通知です。会話の上の Bot 名 → Bot settings → Notifications。システム通知かスマホの通知が出ます。グループチャットには、このスイッチがありません。Grok Bot の画面を開いているあいだは通知は出ず、サイドバーとドックのバッジだけが未読を示します。iPhone は OS の通知許可と Bot の通知設定の両方がオンである必要があります。プッシュ通知は順次公開です(公式 Grok Bot settings)。
デスクトップアプリとクラウドパソコンの更新は別です。届かないときは、公式の順でいちばんやさしい手から試します。①エラー画面からやり直す/会話を開き直す ②アプリを再起動し、Check for Updates ③ Recover Grok Bot's Computer(届かないときに出る) ④ Update Grok Bot's Computer ⑤ Reset は最後の手段。会話はパソコンの外にあるので、Reset しても残ります(公式 Grok Bot work)。
Update Grok Bot's Computer の文言で種類が分かります。ソフト更新は Grok Bot のソフトだけ新しくし、入れたアプリは残ります。パソコンの更新は作り直しで、ファイルとログインは残りますが、入れたアプリやパッケージは消えます。Recover と Reset は、最後に保存した状態から作り直します。届かないまま保存できないと、ごく最近の変更は戻りません。
Enterprise では、管理者が Team Setup(全員のパソコンに同じ道具を入れる手順)を置けます。メンバーは Settings の Team Setup から中身を見る/入れ直せます。Team Secrets は、その手順が読む環境変数です。Bot には直接渡りません。Bot に置いた秘密とは別です。2つ以上のチームの Setup が同じパソコンに当たると、どのチームの Secrets も届きません(公式 Grok Bot teams)。
グループの Grok Bot 設定は、チームの上限を緩める方向だけです。厳しくすることはできません。複数のグループに入っている人は、いちばん緩い結果になります。手元実行や Allow Local Egress がチームより緩いのは、この例外です(公式 Grok Bot teams)。
- 通知は Bot ごと。グループチャットにはスイッチが無い
- iPhone は OS の許可と Bot の通知設定の両方
- 届かないときは Recover → Update → Reset の順。会話は Reset しても残る
- ソフト更新はアプリが残る。パソコンの更新は入れたアプリが消える
- Team Secrets はセットアップ用。Bot には直接渡らない
- グループ設定は緩める方向だけ
Grok Bot のスマホは、Cursor アプリとは別
Cloud Agent の指揮台は App Store の『Cursor』(Cursor for iOS。iOS / iPadOS 26 以降)です。Grok Bot の iPhone アプリは別アプリです。同じ Cursor アカウントでサインインし、公式は iOS 18 以降です。プランや SuperGrok の契約はそのまま持ち越せます。2回目の購入は不要です(公式 Get started with Grok Bot)。
スマホからできること: Bot へのメッセージ、パソコンの監視と引き継ぎ、操作の承認、定期実行の一時停止/再開。デスクトップと iPhone で、同じ Bot・会話・定期実行・クラウドパソコンにつながります。
デスクトップに残る作業: Teach a task(画面を見せて手順を教える)、定期実行の Test、パソコンの Update。iPhone では出ません。Teach a task の手順は末尾の節です。順次公開で、出ないときは終わった仕事から Skill にして、と頼んでください(公式 Grok Bot work / get-started)。
Grok Bot もクラウドにデータを置いて動きます。Privacy Mode(Legacy)のままだと案内が出ます。Cloud Agent のモバイルと同じく、先に Privacy Mode へ切り替えます。
- Cloud Agent のスマホ = App Store の『Cursor』(iOS 26)
- 名前付き同僚のスマホ = App Store の『Grok Bot』(iOS 18)
- 同じアカウント。Bot・会話・定期実行・パソコンはデスクトップと共通
- Teach a task / Test / Update はデスクトップ側
Grok Bot のグループと、複製・整理
自分の Bot が複数いるときは、よく使う相手をピン留めし、案件や顧客ごとにセクションへ分けられます。右クリックの Move to new section。セクションはデスクトップと iPhone で同期します。Hide from sidebar は一覧から外すだけで、仕事も定期実行も消えません。Hidden Bots の Show in sidebar で戻せます。消すとプロフィール・会話・定期実行が無くなります。パソコン上のファイルとログインは残ることがあります(公式 Grok Bot work)。
iPhone の Duplicate は、同じ役割を別の範囲で使うときのコピーです。例: 地域ごとの健康確認 Bot。コピーされるのはプロフィール、設定、有効な Skill、定期実行、画像です。会話履歴、覚えた記憶、添付はコピーされません。作業を振る前に、名前と範囲を直してください。
複数の自分の Bot が一つの成果を出すときはグループチャットです。New から2〜6人選ぶ。普通に書くと誰が返すか Bot が決めます。一人に渡すなら @、全員向けなら @everyone。あなたが送る文には添付できます。Bot からグループへの引き継ぎは文字だけです。画像を見せたいときは、その Bot へ直接送ってください。段階ごとに担当は一人。並行だと重複しやすいです。
デスクトップの添付は1通あたり6つまで。文書・画像・音声は各25MB、動画は200MBです。何のファイルでどう使うかを一文で書いてください。あなたからの直メッセージは、裏で動いている仕事より優先されます。止まらせたいときは『Stop now』。絵文字リアクションだけで、お金や公開の決定をしないでください。
- 隠す(Hide)は消すより安全。定期実行も止まらない
- iPhone の Duplicate は設定のコピー。会話と記憶はコピーされない
- グループは自分の Bot 2〜6人。Slack の Team Bot 専用パソコンとは別
- デスクトップの添付は1通6つまで。文書・画像・音声は25MB、動画は200MB
- 段階の担当は一人。@everyone は全員向けの更新だけ
Grok Bot の定期実行のきっかけと、共有の線引き
定期実行(routine)のきっかけは、決まった時刻だけではありません。公式 Routines では Slack、GitHub、Linear、Sentry、PagerDuty、メール、Webhook でも動けます。これは各サービスのプラグインとは別です。プラグインは Bot がメールや Issue を読む道具、アカウント連携は『この合図が来たら仕事を始める』スイッチです。コードを直して PR を出す自動起動は第4章の Automations、Slack の @cursor や Linear の担当 Cursor は Cloud Agent の起動です。混ぜないでください(公式 Grok Bot work / Routines / Automations)。
合図は狭い条件にしてください。例: 『#customer-escalations にチケットのリンクと needs repro があるとき、検証環境で再現パックをこの会話へ。お客様には連絡しない』。広い『全部の新着』や忙しいチャンネルの全メッセージは、1日で週の利用量を使い切ることがあります。Slack 合図はメンション、語句、リアクション、全メッセージから選べます。過去の投稿では動きません。長いあいだ使っていないと、続けてよいか聞かれ、返事が無いと一時停止することがあります。再開はデスクトップなら Bot 名 → Tasks、スマホならプロフィールの定期実行です。
作った直後の時刻指定は、次の予定まで待ちます。今日 8:05 に『毎日 8:00』と作ると、初回は明日の 8:00 です。すぐ試すならデスクトップの Test(本番と同じ仕事をします)。Webhook なら、定期実行画面に POST 先、鍵(Authorization: Bearer)、コピー用ヘッダーが出ます。応答 200 は受け付けただけで、終わったかは会話を見てください(公式 Routines)。
残したいファイルは共有パソコンの /workspace に、分かりやすいフォルダで置いてください。ファイル・ブラウザの状態・対応しているログインは、普通の更新や Recover でも残ります。一時フォルダや自分で入れたアプリは消えることがあります。過去のメッセージ・ファイル・リンク・定期実行は、検索とコマンドパレットで Bot をまたいで探せます。順次公開なので、出ないときはその Bot の会話履歴から探してください。
公開リンクで配るのは設定のコピー(名前・説明・Skill・定期実行)です。パソコン・ログイン・会話は渡りません。受け取った人は自分のアカウントへコピーを足し、そのとき第三者 Bot の利用条件に同意します。Teams / Enterprise の管理者は、チーム外への公開を止められます。Enterprise は最初オフ、ほかのチームは最初オンです。チームの1体をみんなで話すなら Team Bot。管理者の Manage Team Bots でサイドバーに自動追加された Bot は、自分では Hide できません(公式 Grok Bot teams)。
- 定期実行の Slack / GitHub / Linear / メール / Webhook 合図は Cursor アカウント連携。プラグインでも Automations でもない
- 狭い条件。『全部の新着』は使わない。1時間ごとや忙しいチャンネルは利用量が早く減る
- 作った直後の時刻指定は次の予定まで待つ。すぐなら Test。Webhook の 200 は受け付けただけ
- 長いあいだ使っていないと、返事が無いと一時停止することがある
- 残すファイルは /workspace。探すのは検索とコマンドパレット
- 公開テンプレートは設定のコピー。Enterprise はチーム外公開が最初オフ
- Manage Team Bots で自動追加された Bot は、自分では Hide できない
Grok Bot の役職の作り方
公式の Grok Bot use cases では、よい役職は『繰り返せる成果』を持つ、とあります。『何でも聞いて』ではなく、『毎週の顧客の健康確認リストを出す』のように、終わりが見える仕事です。はじめては読む・まとめるところまで。送る・公開する・買う・本番を変えるのは、確認の後ろに置きます。公式のコピペ例も、確認リストで止まるように書かれています。
説明文(description)には、いつもの仕事・使う道具・出し方・守る境界を書きます。『お客様に連絡しない』は説明文。『この12件の下書き』は今のメッセージです。General Helper は役職も記憶の型も持たない、と公式にあります。長い仕事の持ち主が要るときは、別の Bot を作ります。
公式の6ステップです。①説明文に仕事・道具・出し方・境界を書く ②安全な範囲で1回やる ③自分がいなくても確認できる形になるまで直す ④うまくいった手順を Skill にして、別の入力でも試す ⑤失敗したときとやり直しが決まってから定期実行 ⑥送る・買う・消す・公開・本番変更は承認の後ろ。時刻の定期実行は、Settings の Bot にあるタイムゾーンに従います(公式 Grok Bot settings)。
はじめて向きの例は、公式の Chief of staff です。『昨日からの予定・メール・許可したチャンネルから、優先事項に触れるものだけ。出典・なぜ大事か・次の一手・自分が決める必要があるかを返す。メッセージは送らない。会議は変えない』。うまくいったら、確認できる時間に定期実行します。コードを直して PR を出す繰り返しは、これまでどおり Automations です。
- 役職は『繰り返せる成果』。何でも屋から始めない
- はじめては読む・まとめる。送る・買う・本番変更は承認の後ろ
- 説明文はいつものルール。メッセージは今回の仕事
- Skill にして別入力でも試してから、定期実行
- 時刻の定期実行は Settings → Bot のタイムゾーン
Grok Bot の手順を見せて教える(Teach a task)
役職ができたら、次は手順を全部文章で書くのではなく、画面を1回見せて下書きの Skill にできます。公式の Teach a task です。1対1の会話で、右のパソコン画面を開いた状態から Teach a task を選び、終わりの形を書いて、ブラウザの手順を自分でやります。グループチャットでは使いません(公式 Grok Bot work)。
録画は画面の操作だけで、最大10分です。マイクの音は録りません。パスワードやワンタイムコードは見せないでください。鍵は伏せ字の欄(secure secret request)です。できた Skill は下書きです。いつ使うか、失敗したとき、承認が要るところを足してから、安全な入力で試します。定期実行はそのあとです。
Teach a task は順次公開です。ボタンが無いときは、終わった仕事から Skill にして、と頼んでください。作った Skill が `/` に出ないときは、Settings → Plugins → Yours で、いまの Bot 向けにオンにします(公式 Grok Bot work)。iPhone には Teach a task が無いので、デスクトップ側です(スマホ節)。
- 1対1でパソコン画面を開いて Teach a task。最大10分。マイクは録らない
- できた Skill は下書き。失敗時と承認を足してから、安全な入力で試す
- `/` に出ない Skill は Settings → Plugins → Yours で、いまの Bot 向けにオン
- グループでは使わない。iPhone にも無い
Xcode のビルドを Cursor から頼む(mcpbridge)
チームが Xcode のままなら、Cursor Desktop へ全部移す必要はありません。Xcode 26.3 以降は、内蔵の MCP(`xcrun mcpbridge`)でビルド・テスト・SwiftUI プレビュー・Apple の資料検索を Cursor の Agent から頼めます。有料プランと、プロジェクトを開いた Xcode が動いていることが前提です(公式 Xcode)。
先に Xcode → Settings → Intelligence で Xcode Tools をオンにします。つながらないときは、同じ画面の Allow external agents も確認してください。
- 画面: Customize → MCPs → Add New MCP Server。stdio、名前は `xcode-tools`、コマンドは `xcrun mcpbridge`
- ファイル: `~/.cursor/mcp.json` に `command: xcrun`、`args: [mcpbridge]`
- CLI: `agent mcp add xcode-tools -- xcrun mcpbridge`。エディタと同じ設定を共有する
- できること(20道具の大枠): ファイルの読み書き、ビルドとテスト、Issue Navigator、SwiftUI プレビューのスクショ、資料検索
- `mcpbridge` が見つからない: コマンドラインツールだけを向いていることが多い。`sudo xcode-select -s /Applications/Xcode.app/Contents/Developer` のあと `xcrun --find mcpbridge`(公式 Xcode)
- tabIdentifier のエラー: 空のウィンドウではなく、プロジェクトかワークスペースを Xcode で開く
iOS から手元の Agent を見る(ペアリング)
公式 changelog(Remote control for local agents)の入口は、ペアリングです。iOS アプリにサインインすると、アカウントのパソコンが自動で並びます。パソコンをタップし、Desktop アプリで承認します。つながると、手元で動いている Agent が一覧になり、様子を見たりメッセージを送れます。
この入口は Agent をどこかへ移しません。仕事は手元 PC のままです。Cloud Agent は不要です。Enterprise 以外は既定オン、Enterprise は Org settings → Security and identity → Remote control です。
PC は起きてオンラインである必要があります。Settings の Remote Control にある『Keep this computer awake』は、電源接続かつふたを開けたままのときスリープを止めます。ふたを閉じると止まります。
`/remote-control` は、会話の指揮をクラウドへ移す別手順です(このレッスンの Remote Control の要点)。ペアリングで足りるときは、そちらは後回しで構いません。
作業場の外を読むか(Read Access)
Desktop の手元 Agent が、開いているプロジェクトの外のファイルを読む前に確認するかは、Read Access(読み取り範囲)です。Cursor 3.23 以降。場所は Settings → Agents → Approvals & Execution → Read Access です(公式 Run Modes)。
既定は System です。作業場の外も、確認なしで読めます。家のほかのフォルダやメモも対象になり得ます。確認してから読んでほしいときは Workspace にします。作業場の中は自由、外は確認カードです。カードにはファイルの場所の全体と、なぜ聞いているかが書かれます。Allow でその読み取りを通します。
Workspace のとき、特定のフォルダだけ確認なしで読んでよいなら Read Allowlist です。同じ画面の Allowlist Options。絶対パスのフォルダ、* のパターン、ホームの ~ が使えます。箱の中のコマンドは glob を親フォルダとして扱います。
このプロジェクトの ~/.cursor/projects 下と、~/.cursor の skills / rules / plugins は作業場側です。Run Everything では確認しないので、この設定は隠れます。
CLI なら cli-config.json の sandbox.readBoundary と、permissions.allow の Read(...)。sandbox.json の readBoundary / additionalReadPaths があると、画面の値よりそちらが勝つことがあります。Enterprise の管理者はチームの Read Controls で Workspace に固定できます。
Cloud Agent は専用の作業用コンピュータの中だけなので、この設定は使いません。
- System: 作業場の外も確認なし(既定)
- Workspace: 外を読む前に確認。Allow で通す
- Read Allowlist: Workspace のとき、確認なしで読んでよい場所
- Cloud Agent / Run Everything: この設定は使わない/隠れる
手元に無い保管庫と HTML の下見
Agents Window の Run on(このパソコンで動かす)に、手元の行が Not cloned と出ることがあります。まだこのパソコンにコピーが無い保管庫です。その行を選ぶとクローンが始まり、進捗の通知が出ます(公式 changelog 3.24 / Agents Window)。
リモートや Cloud Agent、自前ワーカーの仕事場にある HTML は、ファイル一覧で右クリック → Open in Browser で、手元のコピーをブラウザで下見できます。開けないときは、仕事場がつながっていないか、ファイルが大きすぎる、という理由が出ます。公開 URL や Forwarded Ports の内部ブラウザとは別の、ファイルそのものの下見です(公式 changelog 3.24)。
- Not cloned: Run on のその行を選んでクローンする
- HTML: 右クリック → Open in Browser。リモート/クラウドの仕事場でも可
- 公開 URL や Forwarded Ports とは別。ファイルそのものの下見
Projects が自前作業場を使うとき
Projects のコーディネーターは、クラウドのコンピュータで動きます。手元のテストが必要なときだけ、Local Agent やチームの自前作業場(My Machines / Team Pool)へ仕事を振ります。
そのとき、チーム設定『Automatically allow Projects to place their work』(Projects の作業を自動で置いてよい)が効きます。オンなら、Project の所有者が使える自前作業場へ、確認なしで仕事を置けます。オフなら、新しい作業場やプールを使う前に、Project のチャットで確認します(公式 Cloud Agents settings)。
Enterprise チームは既定オフ、ほかのチームは既定オンです。確認カードが出てもおかしくありません。許可すればその作業場で進みます。勝手に置かれたくないときは、管理者にオフを頼んでください。
- オン: 所有者が使える My Machines / Team Pool へ、確認なしで置く
- オフ: 新しい作業場を使う前に、Project のチャットで確認する
- Enterprise は既定オフ。ほかのチームは既定オン
タブを閉じても戻れる
Agents Window でタブを閉じると、直前に見ていたタブへ戻ります。Mac は Cmd+W、Windows は Ctrl+W です。画面を分割していても同じです(公式 changelog 3.24 / Agents Window)。
いちばん最近閉じたタブを開き直すのは、Mac は Cmd+Shift+T、Windows は Ctrl+Shift+T です。会話だけでなく、Agent / Environment / Changes / Desktop / Machine / 音声通話の記録も対象です。
間違えて閉じたときは、まず Cmd+Shift+T です。新しい会話を作ると、いまの続きが見えなくなります。
- 閉じる: Cmd+W。直前のタブへ戻る
- 開き直す: Cmd+Shift+T。いちばん最近閉じたタブ
- 新しい会話は作らない。続きは開き直し
チャットタブの幅と名前
Agents Window の会話タブは、題の長さに合わせて幅が変わります。入りきらないときは、タブの列が横にスクロールします。題にマウスを載せると、サイドバーと同じ Agent のカードが出ます。隣のタブへ移しても、カードは待ち直さず付いてきます(公式 changelog 3.24 / Agents Window)。
単独の会話や、画面を分割したときのタイルも、同じタブ列です。タブをダブルクリックすると、名前を付け直せます。サイドバーを隠しているときは、Mac は Cmd、Windows は Ctrl を押し続けると、各 Agent のショートカットがタブに出ます。
各 Agent のタブ列には、子役をタブとして開く + があります。読み込み中でも列は出ます。Automations の実行から生まれた子役だけは、親の横ではなく単独で開きます(このレッスンの Side chat 節)。
- タブは題の幅。入りきらなければ横にスクロール
- マウスを載せると、サイドバーと同じカード。タブを移しても待ち直さない
- 名前を変える: タブをダブルクリック
- サイドバーを隠したとき: Cmd(Windows は Ctrl)でショートカット
確認カードは Escape では消えない
承認、エラー、枝が違う(branch mismatch)の確認カードは、Escape では閉じません。うっかり消して先へ進むことが減ります。答えるときは、カードのボタンを使います(公式 changelog 3.24 / Agents Window)。
利用量のリングを閉じる Escape や、Shell Mode を抜ける Escape とは別です。確認カードだけが、キーでは消えません。
自分で選んだ自前の作業場(My Machines など)で始めた Cloud Agent は、画面を更新したあとや、会話の写し(フォーク)のあとも、同じ作業場のままです。別のパソコンへ勝手に移りません。
Projects で終わったときの音は、コーディネーターのターンだけです。振り分けた子役が終わっても、そのたびに鳴りません。終わったかどうかは、行や子のタブで見てください。
サイドバーの下書きから Cloud Agent を始めようとして失敗したときは、依頼文が入力欄に戻ります。消えたわけではありません。
- 承認・エラー・枝が違う確認は、Escape では消えない。ボタンで答える
- 選んだ自前の作業場は、更新してもフォークしても残る
- 終わったときの音は、コーディネーターのターンだけ
- 下書きからの起動失敗は、依頼文が戻る
会話本文の幅(Chat Width)
Agents Window の会話本文の最大幅は、Settings → Appearance → Agent Conversations の Chat Width で変えられます。Narrow から Wide まで、およそ 600〜1600px です(公式 changelog 3.24 / Agents Window)。
表やコードを広く見たいときは Wide、日本語の文章を読みやすくしたいときは Narrow です。上の節のチャットタブの幅(題の長さに合わせる列)とは別です。こちらは、開いたあとの会話の幅です。
- Settings → Appearance → Agent Conversations → Chat Width
- Narrow: 読みやすく。Wide: 表やコードに余裕
- チャットタブの幅(題の長さ)とは別
別の Agent に話しかける、指名した作業場
Projects のコーディネーターに、別の Agent を @ で渡すと、その Agent のやり取りを読み、メッセージを送れます。受け取った Agent は直接返信できます。コーディネーターは、自分の親コーディネーターにもメッセージを送れます。届く範囲は、あなたがメンションし、かつあなたが開ける Agent までです(公式 Cloud Agents release notes、Week of Oct 5, 2026)。
要約や、Slack / GitHub / GitLab / Bitbucket の文章にある Agent へのリンクは、その Agent のページを開きます。壊れたリンクにはなりません。Web の Project ボードでは、コーディネーターのファイル内の Agent リンクが、その Agent を開きます。Changes タブを指しているときは、そのタブまで開きます。
指名した1台の自前作業場へ Project のワーカーを置くと、その作業場に登録された保管庫(またはフォルダ)で働きます。Project 側の保管庫ではありません。保管庫を持たないコーディネーターでも、1台を指名して置けます。プール(複数台の列)を1台の名前なしで置くと、1台の名前を指定するようエラーになります。
どの作業場とも合わないときは、頼んだラベルの一覧が出るか、指名したマシンがオフライン、と出ます。以前の「ラベルが違う」だけの表示ではありません。どの保管庫でも受け付けるプールは、前の実行が残した未追跡の Rules や指示を、次の Agent が拾いません。
Remote Control をオフにしているとき、スマホには「無効」と出ます。使えない、という曖昧なエラーではありません。組織に紐づいていない Enterprise チームでは、組織の管理者が許可するまで、メンバーは Remote Control をオンにできません。
Agent のターミナルでは、Ctrl+K や Ctrl+F はページのショートカットではなく、シェルへ届きます。
- @ で渡した Agent: やり取りを読み、メッセージを送れる。相手は直接返信できる
- 届く範囲: あなたがメンションし、かつあなたが開ける Agent まで
- 要約や Slack / GitHub などの Agent リンク: その Agent のページを開く
- 指名した1台: その作業場の保管庫で働く。Project の保管庫ではない
- プールを名前なしで置く: 1台の名前を指定するようエラー
- 合わないとき: ラベルの一覧、またはマシンがオフライン
- Remote Control オフ: スマホは「無効」。組織未接続の Enterprise は組織管理者が許可するまでオンにできない
- Agent のターミナル: Ctrl+K / Ctrl+F はシェルへ届く
レビューのタブは残る、流れは滑らか
Desktop の Agent Review のタブは、チャットの Review タブを開いたり閉じたりしても、計画の Checkpoints を戻しても、開いたまま残ります(公式 changelog 3.24)。消えたと思っても、タブの列を探してください。手元の変更を読む入口そのものは、上の Agent Review の節です。
以前のベータ設定「Hide Agent Review」(Agent Review を隠す)は無くなりました。オンにしていた人にも、Agent Review は再び出ます。隠したつもりなのに出る、は正常です。
Agent の返事が流れているあいだ、会話は段差で飛ばず、新しい文へ滑らかに付いていきます。ターンが終わっても、読んでいた位置はずれません。子役がまだ動いているあいだ、ターン末尾のフッターは出ません。終わってから見えます。
- Agent Review のタブ: Review タブの開閉や計画の戻しでも残る
- Hide Agent Review: ベータは廃止。隠していた人にも再び出る
- 流れている返事: 段差で飛ばず、新しい文へ付いていく
- ターン終了: 読んでいた位置はずれない。子役のあいだフッターは出ない
iPhone の Projects と、手元の Agent の入れ方
Projects は、Desktop の左ナビだけではありません。iPhone の Cursor アプリでは、inbox に Projects の区画があり、タップするとそのチャットが開きます。New Project の行から、名前だけで始められます。保管庫、枝、モデルは、付けても付けなくてもよいです。チームの管理者が Projects をオフにしていると、この区画と New Project は出ません(公式 Cursor mobile release notes 1.10.0)。
iPhone のコーディネーターのチャットには、自分のメッセージ、返事、質問、承認が出ます。Worked や thinking の節は出ません。続けて送った自分のメッセージは、まとまって見えます。動いているあいだは、状態の一行が出ます。報告した手順のほか、Running commands(コマンドを実行している)、Messaging an agent(Agent に連絡している)、Writing a reply(返事を書いている)のような文です。inbox の行は、動いているあいだローダーが出ます。振り分けた子の行は、完了・エラー・再起動で更新されます。子の画像や動画が読み切れないときは Retry があります。終わった Project の Live Activity は、Project 全体にかかった時間を出します。0分とは出ません(公式 Cursor mobile release notes 1.12.0)。
Desktop の Agents Window でも、コーディネーターが動いているあいだは、いま渡している仕事や見ている仕事などの短い状態が、Project のチャットと全画面エディタに出ます(公式 changelog 3.24 / Agents Window)。
使える契約は、Cloud Agent があるものだけです。新しい契約では Premium 以上です。Plus は有料でも Cloud Agent が無いので、Projects も出ません。Free も同じです。これまでの Start / Pro / Teams / Enterprise など、Cloud Agent がある契約では使えます。Enterprise の Desktop は Cursor 3.21.9 以降です。Hobby と Privacy Mode(Legacy)では使えません(公式 Projects)。
Desktop で、すでに動いている手元の Agent を Project のワーカーにしたいときは、サイドバーの Project へドラッグするか、Add to Project を使います。会話は消えません。作業はそのままパソコンで続きます。その作業場で Remote Control がオンである必要があります。クラウドのコンピュータへ移す Move to Cloud とは別です(公式 changelog 3.24 / Agents Window)。
- iPhone: inbox の Projects。New Project は名前から。保管庫・枝・モデルは任意
- 管理者がオフ: 区画も New Project も出ない
- iPhone のチャット: Worked や thinking は出ない。続けて送った自分の文はまとまる
- 動いているあいだ: 状態の一行。inbox の行はローダー。Live Activity は全体の時間
- Plus と Free には無い。Premium 以上、または Cloud Agent があるこれまでの契約
- Add to Project: 会話は残る。作業はパソコンのまま。Remote Control がオン
- クラウドへ移すなら Move to Cloud。Add to Project ではない
会社のパソコンで Agent やモデルが出ない
Desktop で Agent を始めようとして、『管理者が無効にした』と出ることがあります。契約が切れた印でも、利用上限に当たった印でもありません。管理者が方針 AgentRemoteWorkspaceAuthorities を入れていると、手元の Cursor の窓では Agent が止まり、リモートの作業場だけが許されます。許可するリモートは、カンマで区切ったパターンで絞れます。`*` は、その位置に任意の文字が合う印です。許可されていないリモート作業場で始めても、同じ文言が出ます(公式 changelog 3.24 / IDE release notes)。
次の一手は、会社が指定したリモート(SSH など)でフォルダを開き直すか、管理者に方針名 AgentRemoteWorkspaceAuthorities を伝えて許可を頼むことです。ブラウザの cursor.com/agents がこの方針で動くかは、公式の文面には書いてありません。契約と接続は accounts-setup で見ます。
会社の Private Inference(自社の推論ゲートウェイ)を使っているとき、起動直後にモデル一覧が空でも、すぐ故障とは限りません。ゲートウェイが返事をしないあいだ、Cursor は最大5分、試し続けます。返事が来ると一覧が埋まります。Private Inference と、Cursor が用意するモデルの切り替えは、再起動のあとも残ります。Settings → Models でオフにしたモデルでは、新しいチャットは始まりません。Private Inference の会話には、自動で名前が付きます(公式 changelog 3.24)。
会社のサインインが Okta FastPass のとき、内蔵ブラウザが『Okta FastPass requires network permission』で止まっていた不具合は、Cursor 3.24 で直っています。内蔵ブラウザが、Okta Verify に必要なローカルネットワークの許可を付けます。まだその英文で止まるときは、Cursor を最新にしてから、もう一度サインインします(公式 changelog 3.24)。
- 管理者が無効: 手元の窓を止める方針。契約切れでも利用上限でもない
- 方針名: AgentRemoteWorkspaceAuthorities。リモートはカンマ区切り。* は任意の文字
- 許可されていないリモート作業場でも、同じ文言
- Private Inference: 一覧が空なら最大5分待つ。切り替えは再起動後も残る
- Settings → Models でオフにしたモデルでは、新しいチャットは始まらない
- Okta FastPass の network permission: 最新の Cursor で内蔵ブラウザが許可を付ける
自分で打つと動きが違う(CI=1)
自分の手で打つと「続けますか?」と聞くコマンドが、Agent に頼むと質問を飛ばして先へ進むことがあります。テストやインストールが、人が見ていない自動の確認の場だけの道を通ることもあります。故障とは限りません。Agent がターミナルコマンドを実行するとき、公式は環境変数 CI=1 を付けます。CI は、その自動の確認の場にいる、という印です。ターミナルの道具が色や質問を減らし、出力を読みやすくするためです(公式 Agent troubleshooting)。
その動きを止めるときは、コマンドの前に印を外します。書く形は `unset CI && your-command-here` です。your-command-here のところを、実際のコマンドに置き換えます。毎回そうしてほしいなら、Rules に次の文を書いてもらいます。「ターミナルでは、CI だと動きが変わるコマンドの前に unset CI && を付ける」。置き方は rules-and-skills です。
公式のヘルプは、手元の Agent とクラウドの Agent を分けて書いていません。ブラウザの Cloud Agent が同じ印を付けるかは、この文面だけでは断定できません。手元で、自分の手と Agent で結果が違うときに、まず疑う印です。クラウド側の確認は、終わったあとの要約・差分・成果物のままです。
- Agent がコマンドを打つとき、環境変数 CI=1 が付く
- 質問を飛ばす、自動の確認の場だけの道を通る、は故障とは限らない
- 止めるならコマンドの前に unset CI &&
- 毎回なら Rules に、CI だと動きが変わるコマンドは unset CI && を前に付ける、と書く
- クラウドの Agent まで同じ印かは、公式のこのヘルプだけでは断定できない
準備中の一行(Setting up project)
Desktop で新しく Project を作った直後、環境の準備手順が次々と書き換わらないことがあります。Cursor 3.27 以降は、コーディネーターの最初の出力まで、会話には Setting up project(プロジェクトを準備しています)の一行だけです。手順が消えたのではありません。準備の途中を、一行にまとめて見せるようになりました。もう一つ Project を作り直さなくてよいです(公式 changelog 3.27)。
アプリのパネル(apps panel)も、最初は閉じたままです。アプリが壊れて隠れたのではありません。最初のタスクが出ると、Project のアプリが自分で開きます。パネルを開こうとして、作り直す必要はありません。
これは、動き始めてからの状態の一行とは別です。iPhone では Running commands(コマンドを実行している)や Messaging an agent(Agent に連絡している)のような文が、動いているあいだ出ます。Setting up project は、その前、最初の出力が出るまでの準備中だけです。
この一行と、閉じたパネルは、Desktop の新しい Project の話です。iPhone の inbox の New Project や、cursor.com/agents が同じ見え方かは、このリリースノートには書いてありません。3.27 より前の Desktop では、準備の手順が動いて見えることがあります。一行にしたいときは Cursor を更新します。失敗の英文が出る、または最初の出力もタスクもずっと出ないときは、待った時間と画面の英文を控えてから、詳しい人に見てください。動き始めてから連絡が Messages from の一行にまとまるときは、次の見出し「連絡は中央の一行(Messages from)」を見てください。
- 新しい Project の会話は、最初の出力まで Setting up project の一行
- 環境の手順が流れないのは、Desktop 3.27 以降の正常な表示
- apps panel は最初閉じている。最初のタスクで Project のアプリが開く
- 動いているあいだの状態の一行(Running commands など)とは別
- iPhone と cursor.com の同じ一行までは、このリリースノートでは断定できない
- 3.27 より前で手順が動いて見えるなら、Cursor を更新する
連絡は中央の一行(Messages from)
Project が Agent に連絡を送ると、その会話が連絡の文でいっぱいにならないことがあります。Cursor 3.27 以降の Desktop では、それらの連絡は画面の中央に一行へまとまります。公式の例は Messages from Hare, Tortoise です。Hare と Tortoise は、そのときの Agent の名前の例です。自分の画面には、実際に連絡した Agent の名前が入ります。会話が消えたのではありません。並んでいた連絡を、一行で見せるようになりました(公式 changelog 3.27)。
読むときは、名前をクリックします。その Project のチャットが、そのメッセージの位置で開きます。もう一つの読み方は、Update from(更新の項目)を広げることです。広げると、その場で更新の本文が読めます。一行だけを見て、本文が無いと判断しないでください。
これは、準備中の Setting up project とは別の一行です。Setting up project は、新しく作った Project の、最初の出力までの準備です。Messages from は、そのあと Project が Agent へ送った連絡です。動いているあいだの状態の一行(Running commands や Messaging an agent)とも別です。状態の一行は、いま何をしているかを伝えます。Messages from は、だれからの連絡がまとまっているかを伝えます。
このまとめ方は、Desktop の changelog 3.27 に書いてある見え方です。iPhone の inbox や cursor.com/agents が同じ一行かは、このリリースノートには書いてありません。3.27 より前の Desktop では、連絡が会話の中に並んだままのことがあります。一行にまとめたいときは、Cursor を更新します。タスクの表で親が子より後ろに残るときは、次の見出し「親タスクは、子のいちばん進んでいる状態に合わせる」を見てください。
- Project が Agent に送った連絡は、中央の一行にまとまる
- 例は Messages from のあとに、連絡した Agent の名前。Hare と Tortoise は名前の例
- 名前をクリックすると、その Project のチャットのその位置が開く
- Update from を広げると、更新の本文が読める
- 準備中の Setting up project や、動きの状態の一行とは別
- iPhone と cursor.com の同じ一行までは、このリリースノートでは断定できない
親タスクは、子のいちばん進んでいる状態に合わせる
Project がタスクの表(task tracker)を使っているとき、自分の Pull Request も Agent も持たない親タスクは、子のいちばん進んでいる状態に合わせます。優先の順は In Progress、その次が For Review、その次が Queued です。どれかひとつでも In Progress なら親は In Progress です。それが無く、For Review の子があれば親は For Review です。それも無く、Queued の子があれば親は Queued です。子が全部終わると、親は done(完了)へ移ります。子が変わるたびに更新されるので、一覧(List)とボード(Board)で、親だけが子より後ろに残って見えることはなくなります。親タスクは子に合わせる、と覚えてください。親が止まって見えることだけを、故障と決めつけないでください(公式 Cloud Agents release notes、Week of Oct 19, 2026)。
この合わせ方は、親が自分の Pull Request も Agent も持たないときです。親自身に Pull Request や Agent があるときは、子に合わせるとは、この一文では書いてありません。タスクの表を使っていない Project まで同じかも、書いてありません。Notion のタスク担当や、入力欄の上の Queued の印とは別です。iPhone と cursor.com の表が同じ見え方かは、このリリースノートでは画面の名前までは断定しません。書いてあるのは、Project のタスクの表と、List と Board です。
同じ表を合わせるのはコーディネーターです。ワーカーが報告した Pull Request を、対応するタスクへつなぎます。終わったタスクからは、ワーカーを外します。ほかの仕事がすでに届けた Queued のタスクや親タスクは、閉じます。ワーカーは、自分の状態をコーディネーターへ報告します。追記のメッセージでまだ忙しいワーカーや、同僚のワーカーは、ターンが終わっても、閉じたタスクから外れません。外れていないことだけを、故障と決めつけないでください。
ワーカーと、子のコーディネーターは、その Project のタスクの表を読めます。ほかのタスクの状態を見るためです。表を書き換えることはできません。読むだけです。コーディネーターがワーカーを始めるとき、名前は仕事の中身です。公式の例は Webhook retry backoff です。役割、動作、Pull Request の番号ではありません。Pull Request か Issue の番号だけで始めたワーカーは、最初の報告で中身が分かると、その中身の名前に変わります。番号のまま残ることだけを、名前が付いていない印と決めつけないでください。最初の報告より前は、番号のままです。
- 自分の Pull Request も Agent も無い親は、いちばん進んでいる子に合わせる
- 順は In Progress、For Review、Queued。子が全部終わると done
- 一覧(List)とボード(Board)で、親だけが後ろに残らない
- コーディネーターは、報告された Pull Request をタスクへつなぐ
- 終わったタスクからワーカーを外す。追記中と同僚のワーカーは、閉じたタスクから外れない
- ワーカーと子のコーディネーターは表を読める。書き換えはできない
- ワーカーの名前は仕事の中身。例は Webhook retry backoff。番号だけなら最初の報告のあとで変わる
理解チェック
- Cloud 中心運用の限界例を1つ言える
- チームが JetBrains IDE なら ACP で Cursor の Agent を使えると知っている
- Xcode 26.3 以降なら `xcrun mcpbridge` でビルドやプレビューを Cursor から頼めると知っている
- `mcpbridge` が見つからないときは、フルの Xcode を選び、プロジェクトを開いたままにすると知っている
- Remote Control が『手元 PC の道具を使い続ける』仕組みだと説明できる
- iOS のペアリングは手元の Agent を動かしたままで、Cloud Agent は不要だと知っている
- ペアリングは Enterprise 以外既定オンで、PC は電源接続・ふたを開けたまま起こすと知っている
- Remote Control の開始手順(設定オン → /remote-control)を言える
- Remote Control の設定は Agents Window から行う公式の入口だと知っている
- Remote Control は Local と Remote SSH ワークスペースで使え、Git remote なしでもよいと知っている
- Remote Control のセッションは自分のアカウントと手元 PC に紐づき、他人は操作できないと知っている
- Move to Cloud と Remote Control の目的のちがいを説明できる
- 起動時に Cloud machine / Team Pool / My Machines から選べると知っている
- ダッシュボードの Secrets は Cloud machine に届き、My Machines には届かないと知っている
- Teams / Enterprise では管理者が Remote Control を許可している必要があると知っている
- Self-Hosted Machines でコンピュータ操作を使うには --computer-use が必要だと知っている(詳しい人向け)
- Linux の `--share-desktop` は見るだけ(view)か操作も渡す(view_and_control)だと知っている(詳しい人向け)
- macOS の画面操作は Cursor Computer Use にアクセシビリティと画面収録を許可すると知っている(詳しい人向け)
- Team Pool は会社の Lambda / Cloudflare / Daytona などの上にも置けると知っている(詳しい人向け)
- 自前作業場ではコード本体は残り、会話に必要な抜粋と成果物はクラウドへ届くと知っている
- 使っていない Team Pool の作業場は休眠できると知っている(詳しい人向け)
- 自前ワーカーでは個人用 Skill が届かず、リポジトリかイメージ焼き込みが必要だと知っている
- Agents Window が Desktop 側の指揮台だと説明できる
- 大きな仕事は左ナビの Projects(コーディネーター)に計画と振り分けを任せられると知っている
- Projects の公式の使い方は機能づくり・移行・日常の手入れだと説明できる
- Projects は Automations や1つの Cloud Agent とは別物だと説明できる
- 完了後に週1で回す練習を1つ選べる
- Agent Review は Desktop の手元変更向けで、PR の Bugbot とは別だと説明できる
- `/agent-review` か Source Control タブから手元レビューを始められると知っている
- Cursor 3.11 以降は Agent Review の設定が Git & PRs → Pull Requests にあると知っている
- Desktop の Agent が外れたとき Checkpoints でファイルだけ戻せることを知っている
- Checkpoints は会話を消さず、Git のコミットとも別だと説明できる
- CLI のメッセージ先頭 `&` で Cloud Agent へ引き継げると知っている
- Desktop / CLI では Shift+Tab で Agent / Plan / Ask を切り替え、再現バグは `/debug` だと知っている
- CLI の Custom Mode は Enter が1通、⌥ Enter がピン留めだと知っている
- 計画が外れたら Checkpoints で戻して Plan を直してから作り直すと知っている
- CLI の `/sandbox` でコマンドを箱の中で走らせられると知っている
- CLI の sudo パスワードはモデルに見えないと知っている
- CLI の Shell Mode は短い非対話コマンド向けで、30秒で打ち切り・`cd` は残らないと知っている
- `agent persist` は手元で切断しても続ける起動で、クラウドへ渡す `&` とは別だと説明できる
- 手元の枝を守りたいときは CLI の `--worktree` か Desktop の `/worktree` だと知っている
- 昨日の CLI 会話は `agent resume` か `agent ls` で履歴から開けると知っている
- `agent persist` と `agent resume` のちがいを説明できる
- CLI の会話が重いときは `/summarize` があると知っている
- CLI はプロジェクト直下の CLAUDE.md も Rules として読むと知っている
- Desktop のコマンド確認は Settings → Agents → Approvals & Execution(Run Modes)だと知っている
- はじめての公式おすすめは Auto-review だと説明できる
- 確認必須の MCP(マージなど)は Auto-review でも確認カードが出ると知っている
- 『送らないで』と言っても、Auto-review は下書き・プレビュー・計画は止めないと知っている
- フォルダごと消す・強制・ワイルドカードの削除は Auto-review が確認すると知っている
- Auto-review の順番は許可リスト → 箱 → 箱に入らないものだけ分類だと知っている
- 分類は Gemini 3.5 Flash Lite、予備は Claude 4.5 Haiku だと知っている
- Claude 4.5 Haiku が止まっていると Auto-review がグレーになると知っている
- 箱の制限で失敗したコマンドは、分類のあと箱の外でやり直すことがあると知っている
- Ask Every Time は廃止され、空の Allowlist が同じ動きだと知っている
- Run Everything は確認ゼロで、リスクを承知したときだけだと知っている
- Cloud Agent は Run Modes を使わず、コマンド承認は出ないと知っている
- permissions.json は確認してほしいことのメモ、sandbox.json は箱の範囲だと説明できる
- Read Access の既定は System で、作業場の外も確認なしだと知っている
- 家のほかのフォルダまで読まれたくないときは Workspace にすると知っている
- Workspace のとき Read Allowlist に確認なしで読んでよい場所を足せると知っている
- Run Everything では Read Access が隠れ、Cloud Agent はこの設定を使わないと知っている
- Run on の Not cloned はその行を選ぶとクローンが始まると知っている
- リモートやクラウドの HTML は Open in Browser で手元のコピーを下見できると知っている
- Projects は Cloud Agent がある契約だけ(新しい契約は Premium 以上。Plus と Free は無い。Enterprise は 3.21.9 以降。Hobby と Privacy Mode(Legacy)は不可)だと知っている
- Projects が自前作業場を使う前に確認するかは、チーム設定で決まると知っている
- Enterprise では Projects の作業場の許可は既定オフだと知っている
- タブを間違えて閉じたら Cmd+Shift+T で戻ると知っている
- Cmd+W は直前のタブへ戻り、新しい会話は作らないと知っている
- チャットタブは題の幅で、ダブルクリックで名前を変えられると知っている
- 承認・エラー・枝が違う確認は Escape では消えないと知っている
- 選んだ自前の作業場は、更新やフォークのあとも残ると知っている
- Projects の完了音はコーディネーターのターンだけだと知っている
- 手元会話を止めずに次の仕事だけクラウドへ渡すなら `/in-cloud` だと知っている
- `/in-cloud` は `&` や Move to Cloud とは別だと説明できる
- クラウドの子が使う MCP は cursor.com/agents のチーム設定だと知っている
- Desktop でも Cloud Agent でも `/side` で本線を止めずに横で調べられると知っている
- Cloud の Side chat は別の Cloud Agent として動き、Projects の中ではスレッドだと知っている
- 過去の Agent 会話は Agents Window の Cmd+K で探せると知っている
- 開いている会話では Cmd+F、自分の依頼へ戻るのは Cmd+↑ / Cmd+↓ だと知っている
- あとから Side chat を探すならコマンドパレットで、ラベルは Side chat だと知っている
- 最近の Side chat は横のレールに最大5つ、残りは N more だと知っている
- Agents Window では子役や Side chat が親のタブとして並ぶと知っている
- Grok Bot は名前付きの同僚で、Cloud Agent(PR を出す本線)とは別だと説明できる
- Team Bot はだいたい自分のクラウドパソコンの上で動くと知っている
- Grok Bot にパスワードをチャットへ貼らず、パソコンを渡されたらその場で入力すると知っている
- Grok Bot の定期実行は Automations(コード直し)とは別だと説明できる
- Grok Bot の利用量は週でリセットされ、Cloud Agent の月次とは別だと知っている
- Grok Bot のプラグインを止めても、その Web サイトは開けると知っている
- Slack の Team Bot は専用パソコンだと知っている
- Grok Bot の定期実行 Test は本番相当だと知っている
- Grok Bot の手元実行はクラウドパソコンとは別スイッチだと知っている
- 社内ネットはデスクトップ経由(Allow Local Egress)だと知っている
- Grok Bot はコード直しを Cloud Agent に渡せるが、管理者はオフにできると知っている
- Grok Bot の Auto Review は Desktop の Auto-review とは別だと説明できる
- Network Controls の変更は約1分で反映し、Cloud Agent 側とは別だと知っている
- Grok Bot の通知は Bot ごとで、グループチャットにはスイッチが無いと知っている
- iPhone の Grok Bot 通知は OS の許可と Bot の設定の両方が要ると知っている
- パソコンが届かないときは Recover → Update → Reset の順だと知っている
- Grok Bot の会話は Reset しても残ると知っている
- ソフト更新はアプリが残り、パソコンの更新は入れたアプリが消えると知っている
- Team Setup はメンバーが Settings から入れ直せる、Team Secrets は Bot に直接渡らないと知っている
- グループの Grok Bot 設定はチームの上限を緩める方向だけだと知っている
- Grok Bot の iPhone アプリは Cursor アプリとは別だと知っている
- iPhone の Teach a task / Test / Update はデスクトップ側だと知っている
- 自分の Bot のグループは2〜6人で、Slack の Team Bot 専用パソコンとは別だと知っている
- iPhone の Duplicate は会話と記憶をコピーしないと知っている
- Hide は一覧から外すだけで、定期実行は止まらないと知っている
- デスクトップの添付は1通6つまでだと知っている
- Grok Bot の定期実行の Slack / GitHub 合図はプラグインや Automations とは別だと説明できる
- 広い『全部の新着』は使わず、狭い条件にすると知っている
- 長いあいだ使っていないと定期実行が一時停止することがあると知っている
- 残したいファイルは /workspace だと知っている
- 公開テンプレートは設定のコピーで、Enterprise はチーム外公開が最初オフだと知っている
- Manage Team Bots で自動追加された Bot は自分では Hide できないと知っている
- Grok Bot の役職は『繰り返せる成果』だと説明できる
- はじめての Grok Bot は読む・まとめるまでで、送る・買う・本番変更は承認の後ろだと知っている
- 説明文はいつものルール、メッセージは今回の仕事だと切り分けられる
- Skill にして別入力でも試してから定期実行すると知っている
- 時刻の定期実行は Settings → Bot のタイムゾーンだと知っている
- Grok Bot の定期実行は Linear / メール / Webhook でも動け、作った直後の時刻指定は次の予定まで待つと知っている
- Webhook の 200 は受け付けただけで、終わったかは会話を見ると知っている
- Teach a task は1対1で画面を見せて下書き Skill にすると説明できる
- Teach a task は最大10分で、マイクは録らず、パスワードは見せないと知っている
- 会話本文の幅は Chat Width で、チャットタブの幅とは別だと知っている
- `/` に出ない Grok Bot の Skill は Settings → Plugins → Yours だと知っている
- Projects のコーディネーターは、@ で渡した Agent のやり取りを読んでメッセージを送れると知っている
- 届く範囲は、自分がメンションし、かつ自分が開ける Agent までだと知っている
- 指名した1台の自前作業場では、その作業場の保管庫で働くと知っている
- Remote Control をオフにするとスマホは「無効」と出ると知っている
- Agent Review のタブは Review の開閉や計画の戻しでも残ると知っている
- Hide Agent Review は廃止され、隠していた人にも Agent Review が再び出ると知っている
- 流れている返事は段差で飛ばず、ターンが終わっても読んでいた位置はずれないと知っている
- iPhone の inbox から New Project で Projects を始められると知っている
- Projects は新しい契約では Premium 以上だけで、Plus と Free には無いと知っている
- Add to Project は会話を残したままパソコンで続き、Move to Cloud とは別だと知っている
- Move to Cloud は未コミットの手元の変更を写さず、移す前にコミットするか stash すると知っている
- 管理者が無効、は手元の窓を止める方針で、契約切れではないと知っている
- Private Inference のモデル一覧が空なら、最大5分待つと知っている
- オフにしたモデルでは新しいチャットは始まらないと知っている
- Okta FastPass の network permission が残るなら、Cursor を最新にしてやり直すと知っている
- Agent がコマンドを打つとき CI=1 が付き、自分の手と動きが違うことがあると知っている
- 新しい Project の準備中は Setting up project の一行で、アプリのパネルは最初閉じていると知っている
- Project が Agent に送った連絡は Messages from の一行で、名前をクリックするとその位置が開くと知っている
- 自分の Pull Request も Agent も無い親タスクは、いちばん進んでいる子に合わせ、子が全部終わると done へ移ると知っている
- ワーカーと子のコーディネーターはタスクの表を読めるが書き換えはできず、名前は仕事の中身だと知っている
開いただけでは「済」になりません。チェックできたら押してください。
実践
この学習パスで一番できるようになったことと、まだ不安なことを1つずつ書いてみましょう。不安側のレッスンを見直したうえで、来週の『小さな PR 1件』のテーマも決めてみてください。Bugbot の画面設定を Git に残すなら `.cursor/config/bugbot.yaml` は取り込み先の枝へ、約束文は `.cursor/BUGBOT.md`、も1行書いておくと安心です。1回のチャットで終わらない機能づくり・移行・日常の手入れが出てきたら、左ナビの Projects も見てみましょう。Desktop で手元の変更を読むなら `/agent-review` も一度試してみてください。手元 Agent が外れた想定で、Checkpoints の戻り方を1行メモしておくと安心です。大きな仕事なら、先に Plan で計画を見てから作る練習も1回入れてみてください。ターミナルを使うなら、`/sandbox` か `--worktree` を一度試して、手元の枝を直接触らない型も覚えておきましょう。昨日の会話を続きから開くなら `agent ls` か `agent resume` も一度見てください。Desktop を入れるなら、Settings → Agents → Approvals & Execution で Auto-review になっているかも一度見てください。家のほかのフォルダまで読まれたくないなら、同じ画面の Read Access を Workspace にしてみてください。グレーなら分類の予備 Claude 4.5 Haiku が止まっていないかを詳しい人に聞いてください。手元会話を続けたまま次の仕事だけクラウドへ渡すなら `/in-cloud` も一度見てください。本線を止めずに横で調べるなら `/side`、昨日の会話を探すなら Agents Window の Cmd+K、いまの会話で自分の依頼へ戻るなら Cmd+↑ も一度見てください。キューの順番を変えたいときはカードをドラッグしてみてください。名前付きの助手に Web をまたいで頼みたい気持ちが出たら、Grok Bot と Cloud Agent を混ぜないことも1行書いておきましょう。パスワードはチャットに貼らない、Team Bot は自分のパソコン(Slack では専用パソコン)、プラグインを止めてもサイトは開ける、定期実行の Test は本番相当、も一緒に書いておくと安心です。手元のコマンドは別スイッチ(迷ったら Never)、社内ネットはデスクトップ経由、Grok Bot から Cloud Agent へ委任できる、Auto Review は Allow once、Network Controls は約1分、も1行足しておくと安心です。通知は Bot ごと(グループチャットにはスイッチが無い)、パソコンが届かないときは Recover から、Team Secrets は Bot に直接渡らない、も書いておくと安心です。スマホで名前付き同僚に頼むなら App Store の『Grok Bot』(iOS 18)で、Cloud Agent の指揮は『Cursor』(iOS 26)のまま、も1行書いておくと安心です。自分の Bot をグループにするなら2〜6人・担当は一人、iPhone の Duplicate は会話をコピーしない、隠す(Hide)は消すより安全、も1行書いておくと安心です。Slack の新着全部で動かしたくなったら、定期実行は狭い条件・プラグインや Automations とは別、残すファイルは /workspace、公開テンプレートは設定のコピー、も1行足しておくと安心です。名前付き同僚を長く使うなら、役職は繰り返せる成果・はじめては確認リストで止める・Skill にしてから定期実行・時刻は Settings のタイムゾーン、も1行書いておくと安心です。手順を画面で教えるなら Teach a task(1対1・最大10分・下書き Skill)。作った直後の時刻指定は次の予定まで待つ、Webhook の 200 は受け付けただけ、も書いておくと安心です。タブを間違えて閉じたら Cmd+Shift+T で戻る、も一度試してみてください。チャットタブの名前はダブルクリック、確認カードは Escape では消えない、も一度見てみてください。本文が読みにくいなら Chat Width も一度見てください。Projects で別の Agent に話しかけるなら @、指名した1台の作業場はそちらの保管庫、も一度見てください。Agent Review のタブが消えたと思ったらタブ列を見る。Hide Agent Review はもう無い、も1行書いておくと安心です。iPhone の inbox に Projects があること、Plus には無いこと、Add to Project はパソコンのままであること、も一度見てください。会社のパソコンで管理者が無効と出たら方針名 AgentRemoteWorkspaceAuthorities、モデル一覧が空なら Private Inference を最大5分、Okta FastPass の英文が残るなら Cursor を最新に、も一度見てください。Move to Cloud の前に、未コミットの変更はコミットするか stash する、も一度見てください。自分の手と Agent でコマンドの動きが違うときは CI=1 を疑い、止めるなら unset CI && を前に付ける、も一度見てください。新しい Project の会話が Setting up project の一行なら、アプリのパネルが閉じていても最初のタスクまで待つ、も一度見てください。会話が Messages from の一行なら、名前をクリックするか Update from を広げる、も一度見てください。タスクの表で親が子より後ろなら、親に自分の Pull Request が無いかを見て、子の In Progress から合わせる、も一度見てください。ワーカーの名前が番号のままなら、最初の報告のあとで仕事の中身の名前に変わる、も一度見てください。
このレッスンで出てくる用語
全部覚える必要はありません。気になる言葉だけ開いてみてください。
- Remote Control手元 PC 上の Agent を、スマホから見て返信できる仕組みです。いちばん簡単な入口は iOS アプリでパソコンをペアリングすることです。会話の指揮をクラウドへ移す /remote-control もあります
- Move to CloudDesktop や Local で始めた会話を、クラウド VM 上の Agent へ移す操作です。会話の履歴は移ります。未コミットの手元の変更は写りません。移す前にコミットするか stash します
- Agents WindowDesktop アプリ内で、複数の Agent を一覧・操作する窓です。Remote Control の設定や Automations 作成の入口にもなります
- Side chat本線の会話を止めずに、横で調べものをする子の会話です。親のやり取りは裏の参考になり、画面には横の質問だけ出ます
- 会話検索Agents Window から、過去の Agent 会話をキーワードで探す機能です。開いている会話の中は Cmd+F(Windows は Ctrl+F)。自分の依頼へ戻るのは Cmd+↑ / Cmd+↓ です
- Not clonedAgents Window の Run on(このパソコンで動かす)メニューで、まだ手元にコピーが無い保管庫に付く表示です。その行を選ぶとクローンが始まり、進捗の通知が出ます
- Grok Bot名前と役割を持った AI の同僚です。共有のクラウドパソコンでブラウザやファイルを使い続けます。この学習パスの本線である Cloud Agent(保管庫を直して PR を出す)とは別プロダクトです
- Network Controls(Grok Bot)Grok Bot のクラウドパソコンが、どのサイトや宛先に出てよいかを決める Enterprise 向けの制限です。プラグインを止めてもサイトは開けるので、Web 側も閉じたいときに使います
- ローカル実行(Grok Bot)Grok Bot が、クラウドパソコンではなく目の前のパソコンでコマンドを走らせてよいかのスイッチです。クラウド側の作業とは別です
- Allow Local EgressGrok Bot の通信を、目の前のデスクトップ経由にしてよいかを決める Enterprise 向けのスイッチです。社内ネットへ出たいときに使います
- Auto Review(Grok Bot)Grok Bot が危ない操作をする前に、別の確認モデルが見て止める仕組みです。Desktop の Run Modes(Auto-review)とは別です
- Team SetupEnterprise の管理者が、全員の Grok Bot パソコンに同じ道具を入れる手順です。メンバーは Settings の Team Setup から中身を見る/入れ直せます
- Team SecretsTeam Setup の手順が読む、チーム共通の環境変数です。Bot には直接渡りません。Bot に置いた秘密とは別です
- Grok Bot の iPhone アプリ名前付き同僚(Grok Bot)用の iPhone アプリです。Cloud Agent 用の Cursor for iOS とは別です
- Grok Bot のグループチャット自分の Bot を2〜6人集めて、一つの成果を出す会話です。Slack の Team Bot 専用パソコンとは別です
- Duplicate(Grok Bot)iPhone で Bot を複製する操作です。役割のコピーは残りますが、会話と覚えた記憶はコピーされません
- 定期実行(Grok Bot)名前付き同僚が、決まった時刻や Slack / GitHub / Linear / メール / Webhook などの合図で同じ仕事を繰り返す仕組みです。コードを直して PR を出す Automations とは別です
- 公開テンプレート(Grok Bot)Bot の設定(名前・説明・Skill・定期実行)をリンクで配るコピーです。パソコン・ログイン・会話は渡りません。チーム外へ出していいかは管理者が決めます
- 役職(Grok Bot)名前付き同僚に持たせる、繰り返せる成果です。『何でも聞いて』ではなく、確認リストや下書きのように終わりが見える仕事です
- Teach a taskGrok Bot にブラウザの手順を1回見せて、下書きの Skill にするデスクトップの機能です。グループや iPhone では使いません
- /in-cloudDesktop / CLI の手元会話を止めずに、次の仕事だけクラウドの子 Agent(別 VM・別枝)へ渡すコマンドです。会話ごとクラウドへ移す `&` や Move to Cloud とは別です
- Projects1回のチャットで終わらない大きな仕事を、コーディネーターに任せる入れ物です。コーディネーターはコードを書かず、計画して複数の Agent に振り分け、仕上がりをあなたに返します。公式の使い方は機能づくり・移行・日常の手入れの3つです。iPhone の inbox からも始められます。新しい契約では Premium 以上で、Plus にはありません
- Projects の作業場の許可コーディネーターが、Project の所有者が使える自前作業場へ仕事を置く前に、チャットで確認するかどうかを決めるチーム設定です。Enterprise は既定オフ、ほかは既定オンです
- Setting up projectDesktop で新しく作った Project の準備中、会話に出る一行です。環境の手順が消えたのではなく、最初の出力までこの一行にまとまります。アプリのパネルは閉じたまま始まり、最初のタスクが出ると Project のアプリが開きます
- Messages fromProject が Agent に送った連絡が、会話を埋めずにまとまる中央の一行です。名前をクリックすると、その Project のチャットのその位置が開きます。Update from を広げると、更新の本文が読めます
- Agent ReviewDesktop で手元の変更を読むレビューです。PR が出てから動く Bugbot や、チャットの `/review` / `/review-bugbot` とは別物です
- CheckpointsDesktop の Agent 会話で、大きな変更の前に自動で残るファイルの戻り地点です。会話の履歴は消さず、ファイルだけ前の状態に戻せます。Git のコミットとは別物です
- CLI SandboxCursor CLI がコマンドを、作業場の外まで届きにくい箱の中で走らせる仕組みです。`/sandbox` か `--sandbox enabled` でオンにします。設定は次の起動にも残ります
- Shell ModeCursor CLI の会話を出ずに、短いコマンドを打つ入口です。公式では30秒で打ち切り、対話入力や長いサーバー起動は向きません。渡した文を実行する `/shell` スキルとは別です
- agent persistターミナルを閉じても、同じパソコン上で CLI の Agent を続けられる起動の仕方です。クラウドの作業場へ渡す `&` とは別物です
- worktreeいま開いている枝を直接触らず、別の作業コピーで Agent を走らせる仕組みです。手元の未保存作業を守りたいときに使います
- agent resumeターミナルを閉じたあとに、昨日の CLI 会話を履歴から開き直すことです。動かしたまま離れる `agent persist` とは別です
- /summarizeCLI の会話が長くなって重くなったとき、これまでのやり取りを要約して空きを作るコマンドです。`/compress` や `/compact` でも同じです
- Run ModesDesktop の手元 Agent が、コマンドや外部ツールを打つ前にあなたへ確認するかを決める設定です。公式のおすすめは Auto-review です
- Auto-review知っている安全な操作はすぐ実行し、箱の中で走らせられるコマンドは sandbox、それ以外は短い確認を挟む Run Modes です。フォルダごと消すような危ない削除は確認します。はじめての公式おすすめです
- Read AccessDesktop の手元 Agent が、開いているプロジェクトの外のファイルを読む前に確認するかを決める設定です。既定の System は確認なし。Workspace にすると外を読む前に聞きます
- ペアリング(iOS)iOS アプリに出た自分のパソコンをタップし、Desktop 側で承認してつなぐことです。つながると、手元で動いている Agent をスマホから見て返信できます
- タブの開き直し閉じたタブを、いちばん最近閉じたものから戻す操作です。Mac は Cmd+Shift+T、Windows は Ctrl+Shift+T です
- チャットタブAgents Window の会話タブです。題の長さに合わせて幅が変わり、マウスを載せるとサイドバーと同じ Agent のカードが出ます。ダブルクリックで名前を変えられます
- Chat WidthAgents Window の会話本文の最大幅です。Settings → Appearance → Agent Conversations で Narrow から Wide(およそ 600〜1600px)まで変えられます。チャットタブの幅(題の長さ)とは別です
- 確認は Escape で消えない承認、エラー、枝が違うときの確認カードは、Escape キーでは閉じません。ボタンで答えます
- 親タスクは子に合わせるProject のタスクの表で、自分の Pull Request も Agent も持たない親タスクが、子のいちばん進んでいる状態に合わせる動きです。順は In Progress、For Review、Queued。子が全部終わると done へ移ります
- 指名した作業場Projects が1台の自前作業場を指名してワーカーを置くと、その作業場に登録された保管庫で働きます。Project 側の保管庫ではありません
- 手元の Agent を止める方針管理者が Desktop の手元の窓で Agent を止め、許可したリモート作業場だけで使えるようにする方針です。画面には、管理者が無効にした、と出ます
- Private Inference会社の推論ゲートウェイを通してモデルを動かす仕組みです。起動時にゲートウェイが返事をしないあいだ、モデル一覧は最大5分、空のまま試し続けます
- Agent Review のタブDesktop の Agent Review のタブは、チャットの Review を開閉しても、計画を戻しても残ります。隠すベータ設定は無くなり、再び出ます
- CI=1Agent がターミナルコマンドを実行するとき付ける印です。道具の出力を読みやすくします。質問を飛ばしたり、自動の確認の場だけの道を通ったりすることがあります
いま身についている開発者スキル
ツール選択 / ローカル開発環境への移行判断
マイルストーン
学習パスを完了しました
ブラウザを司令塔に、開発者と同じ言葉で会話できるところまで来ました。小さな PR を週に1つほど回し続けると、さらに力がついていきます。