第2章 · レッスン 07 / 17

読む一周を完結する

指示したあと、何が起きる?

Cloud Agent の開発サイクルを、3幕でやさしく掴みます

  • 目安 12 分
  • 進捗 7/17

このレッスンのゴール

  • 『あなたは最初と最後、真ん中はクラウド』と言い換えられる
  • ACT 2(VM・別ブランチ・作業ループ・PR)の意味を説明できる
  • 確認後の3択(反映 / やり直し / やめる)を判断の軸にできる
  • 動くウェブアプリは、クラウドの Agent に頼んで、自分で公開するまで外に出ないと説明できる
裏側の動き指示したあと、何が起きる?最初と最後はあなたです。真ん中はクラウドの Agent が進めてくれます。
Cloud Agent の開発サイクル図。ACT1で依頼、ACT2でクラウド側がVM上で実装し成果物付きのPull Requestを出し、ACT3であなたが反映・やり直し・中止を決める。終わりかけに送った文は同じ実行の一手。自分が開いていない PR の説明は下に足す。GitHub は7文字以上の短いコミットからも始められる。PR ページの Agent 一覧は入力欄のすぐ上。Waiting on は下の Agent 待ち。Cloud Agent の PR は頼んでいなければ最初から Ready。自分で作った子役のモデルが使えないときは、親のモデルで動く。チームが Gemini 3.1 Pro を止めても、コンピュータ操作は残る。止まるのは動画の確認だけ。読む・探す・メッセージだけのあとは、次の指示が作業場の写しを待たずに早く始まる。非公開 Origin のコメント末尾は Open in Web。押すとその Agent の実行が開く。iPhone で音声通話のシステムの画面が出ないときは、ロック画面からミュートと切断ができる。通話カードは始めた位置。進捗の8件とは別。iPhone / iPad でいちばん上の個人プランの利用枠を使い切ると、Included Usage Reached(利用枠到達)に Manage Plan が付く。行き先はノートに無く、Buy Credits とは別。チームの Manage Plan は誰が扱うかの案内。iPhone と iPad の保管庫ピッカーは、未公開の Start from scratch の下書きを出さず、最初から選ばない。動いている会話で Thinking がひとつだけのとき、考えた時間は節が終わると更新される。ウェブの cursor.com/agents、PR の Agent パネル、横の会話は Desktop の Agents Window と 同じ会話の並び。新しい Agent の 最初の一文はすぐ出る。画像も最初から入る。コードベースのページのサイドバーは ホイールで会話が動く。cursor.com の Pull Request ページで Fix with agent を押すと、出した側の会話へ戻る、か、自分の最近の会話へ戻る。新しい順の会話は選ばない。Linear の経過には 経過に3つの入口(Open in Web、Open in Cursor、Pull Request)。終わったあとの 最後の返事は一度だけ。課題から始めた提案書は Fixesの一行で閉じる。マージで課題が閉じる。ウェブで Cloud Agent へのリンクを直接開くと、直リンクは早く出る。見出しと状態は早く出る。始めた依頼は早く出る。会話の残りより先かは断定しない。保管庫なしの個人環境は追記できる。以前は同僚には読むだけ。許された保管庫は全部要る。利用の上限で Cloud Agent が始められない、または追記を受け取れないとき、上限の案内が次を示す。自分かチームの従量上限。試用の上限のあとはAuto。Agents のページでは、設定はカンマで開く。畳んだ欄はボタンで開く。狭い画面だけ畳む。iPhone と iPad の音声通話は、切れた通話は自分で戻る。切れたあいだの仕事は渡す。無音の約10分で切れる。ウェブの Agents では、引き出しは空で開かない。ピンは先頭の千件で止まらない。割り切れない幅でも空ではない。付けられる上限は最大75件のまま。iPhone と iPad のアプリは、会話の読み込みでは落ちない。プロフィール画面では落ちない。直ったのは iOS 27のその落ち方。ほかの版やほかの画面は断定しない。iPhone と iPad の依頼を書く入力欄は、入力欄は下の安全域に乗る。iPad の横の一覧は、アカウントの行も揃う。ホームの上に余分な隙間は無い。すべての隙間が消えた、とは断定しない。iPhone と iPad の操作の帯の絵は、ツールバーのアイコンは標準の大きさ。端末のアイコンと同じ大きさ。ほかのアイコンまでは書かない。すべての絵が揃った、とは断定しない。iPhone と iPad の下から出るシートの上の細い棒は、シートのつかみは変えられるシートだけ。変えられないシートには出ない。すべてのシートまでは書かない。すべてのシートが変わった、とは断定しない。iPad の使えないときの画面は、使えない画面は読みやすい幅。幅を保つのはiPadだけ。すべての画面の幅までは書かない。すべての画面の幅が変わった、とは断定しない。動くウェブアプリは、アプリはクラウドで作る。手元では作れない。出すのは自分で公開したあと。通らなければ外には出ない。入力欄が空で Agent が暇なとき、送る場所の波形は声の会話。隣のマイクは口述。マイクは文字にする。空のときだけ波形。以前にマイクを拒否すると、止めたマイクは戻す。画面は Microphone blocked。画面はシステムかブラウザ。iPhoneの画面は Settings。戻してからかけ直す。声の通話の文字は、通話の文字はチャットに出る。クラウドの通話中はほかの端末へ。プライバシーモードでは同期しない。声の更新は短い。無いときは書いた返事を読む。ふだんは全文を読まない。通話中に変えた声は残る。そのAgentに残る。保存した声は既定より先。声の通話で差分や実行の様子を聞くときは、調べは読むだけ。このAgentの履歴を探す。ワーカーがいる Project では、通話を別のワーカーへ。iPhone の音声通話で、狭い島にはボタンが無い。広げた島でミュートと切断。ロック画面でもミュートと切断。声の通話では、終わったと言うと切れる。声での終わりが切断。言い終わりで通話が終わる。git の狭い出口は、gitの出口はチームだけ。ghは出口を通らない。APIも出口を通らない。出口は有効にしたあと。個人のアカウントには、その出口はありません。インストール済み GitHub Apps の IP 許可は、アプリに登録した一覧を継ぐ。そのアドレスの誰でもは通さない。データ居住の GitHub Enterprise Cloud は、住所はghe.com。登録は社内サーバーと同じ。ベースURLはその住所。github.com でも、自社サーバでもありません。
図の内容をテキストで読む

ACT 1 · あなた

  1. 1やりたいことを送る(ブラウザ・スマホ、Slack / Teams / Jira / Notion / GitHub など。Slack なら repo= で保管庫も明示)

ACT 2 · クラウド側

  1. 2作業用コンピュータ(隔離 VM)を用意する。環境がそろうほど検証まで届く
  2. 3コードをコピーし、別ブランチで直す(main はそのまま)
  3. 4調べる → 直す → 試すを繰り返す(途中の追加指示可。終わりかけは同じ実行の一手。画面操作も)
  4. 5変更提案(Pull Request)を出す。成果物が付くことも。頼んでいなければ最初から Ready。自分が開いていない説明は下に足す。まだ本番ではない

ACT 3 · ふたたびあなた

  1. 6要約→成果物→プレビュー→差分の順で見て決める(反映 / 直してもらう / やめる)。動くウェブアプリは、出すのは自分で公開したあと。非公開 Origin のコメント末尾の Open in Web は、その Agent の実行を開く

ACT 2 は端末を閉じても進みやすいです。止まりやすいのは、権限不足・環境不足・確認待ちのときです。まとめているちょうどそのときに送った文は、別の追記にならず、同じ実行の一手になります。自分が開いていない Pull Request の説明は、既存の文の下に足します。空ならその欄を埋めます。GitHub なら、7文字以上の短いコミットからも始められます。同じ文字の枝やタグがあると、そちらが優先されます。cursor.com の PR ページでは、Agent 一覧が入力欄のすぐ上に開きます。Waiting on は下の Agent 待ちです。読み込みが終わらないときは Retry、Privacy Mode(Legacy)なら Cloud Agent が止まっています。Cloud Agent と Project のワーカーが開く PR は、頼んでいなければ最初から Ready です。Ready は見てよい印で、反映済みではありません。自分で作った子役のモデルが、止められている、Max Mode が要る、または使えないときは、失敗せず親のモデルで動きます。親はそのことを知ります。親のモデルを引き継ぐ子は、親が Fast でなければ、チームの Fast 禁止では止まりません。チームが Gemini 3.1 Pro を止めても、コンピュータ操作は残ります。止まるのは動画の確認だけです。コンピュータ操作が使うモデルを止めたときは、Agent がモデル名と用途を伝え、管理者はチームのモデル設定で戻せます。ファイルを読む・探すだけ、またはメッセージだけのあとは、次の指示が作業場の写しを待たずに早く始まります。ファイルを直したあとは、変わった作業場を残すために待つことがあります。非公開の Origin の提案書では、Cloud Agent が書いたコメント、返信、レビューの末尾に Open in Web が付きます。押すと、その Agent の実行が開きます。Microsoft Teams の起動カードの Open in Web とは別です。iPhone で音声通話のシステムの画面が出ないときは、ロック画面と Dynamic Island の Live Activity からミュートと切断ができます。通話中は声の文字起こしと空の Worked が隠れ、通話カードは始めた位置に出ます。進捗を最大8件まで追う Live Activities とは別です。iPhone / iPad で、いちばん上の個人プランの含まれる利用枠を使い切ると、Included Usage Reached(利用枠到達)に Manage Plan が付きます。ボタンの行き先はリリースノートに無く、Desktop の Buy Credits とは別です。チームの Manage Plan は、誰がプランを扱うかの案内です。iPhone と iPad の保管庫ピッカーは、未公開の Start from scratch の下書きを出さず、最初から選びもしません。一覧に無いことだけを、消えた印と決めつけないでください。iPhone と iPad の、動いている会話で Thinking がひとつだけのとき、考えた時間は節が終わると更新されます。終わる前に時間が無いことだけを、止まった印と決めつけないでください。cursor.com/agents、Pull Request の Agent パネル、ウェブの横の会話は、Desktop の Agents Window と 同じ会話の並び です。新しい Agent の 最初の一文はすぐ出る。付けた 画像も最初から入る。2通目以降の速さは、この図では断定しません。コードベースのページの Agent のサイドバーでは、ホイールで会話が動く。Page Up と Page Down も動きます。iPhone のアプリや、cursor.com/agents の会話本体まで同じとは限りません。cursor.com の Pull Request ページで Fix with agent と同じ種類の操作を押すと、出した側の会話へ戻る、か、その提案書での自分の最近の会話へ戻る、です。新しい順の会話は選ばない、です。どちらが先かは、この図では断定しません。iPhone や GitHub.com まで同じとは限りません。Linear 上の Cloud Agent の経過には、経過に3つの入口(Open in Web、Open in Cursor、Pull Request)が出ます。最後の返事は一度だけ、ふだんの言葉の要約です。Linear の課題から始めた実行の提案書は、末尾が Fixesの一行で閉じる(Fixes <ISSUE-ID>)です。マージされると Linear が課題を閉じます。課題から始めていない提案書まで同じ、とは限りません。ウェブで Cloud Agent へのリンクを直接開くと、直リンクは早く出る。見出しと状態は早く出る。始めた依頼は早く出る。何秒早いか、会話の残りが同時かは、この図では断定しません。一覧から開いたとき、iPhone、Desktop の Agents Window まで同じとは限りません。「Agent が終わった」は「本番に入った」という意味ではありません。反映を決めるまでが、あなたの役目です。保管庫の無い個人の環境で動く同僚の Cloud Agent は、保管庫なしの個人環境は追記できる、です。以前は同僚には読むだけ、でした。届くかは Team Followups と Allow VM Sharing の設定どおりです。開くときも追記するときも、許された保管庫は全部要る、です。両方オンが必要か、設定の画面、iPhone、チームの共有の保管庫なしまで同じかは、この図では断定しません。利用の上限で Cloud Agent が始められない、または追記を受け取れないとき、上限の案内が次を示す、です。次は、従量をオンにするか、自分かチームの従量上限を上げるか、試用中なら Cursor のモデルか Auto です。試用の上限のあとはAuto、です。三つが必ず全部出るか、ボタンの位置、iPhone、手元の Desktop、試用でないときの同じ切り替えは、この図では断定しません。前払い残高が尽きた案内、Out of Other Models usage、利用枠到達、Buy Credits とは別です。Agents のページでは、設定はカンマで開く、です。Mac は Cmd とカンマ、Windows と Linux は Ctrl とカンマです。畳んだ欄はボタンで開く、です。押すのは Open sidebar で、マウスを載せても開きません。会話を開いて一覧が畳まれるのは、狭い画面だけ畳む、です。窓の幅が 1024px より狭いときだけです。どの設定の欄が開くか、iPhone、手元の Desktop は、この図では断定しません。ページ上の保管庫名へマウスを載せて環境を見る案内は、横の一覧とは別です。iPhone と iPad の音声通話は、通信が落ちると切れた通話は自分で戻る、です。同じ会話の続きです。落ちているあいだに終えた仕事は、切れたあいだの仕事は渡す、です。何秒で戻るか、Desktop、ウェブ、Android まで同じかは、この図では断定しません。あなたが約10分黙っていて進行中の仕事が無いと、無音の約10分で切れる、です。普通の切断で、エラーではありません。再生中の返事は途中で切りません。ロック画面のミュートや、パソコンを起こして画面が追いつく再接続とは別です。ウェブの Agents では、引き出しは空で開かない、です。窓の幅が整数に割り切れないときも、割り切れない幅でも空ではない、です。ピン留めは、ピンは先頭の千件で止まらない、です。全部見えます。付けられる上限は最大75件のままです。コーディネーターが 1,000 人を超えるワーカーを新しい順に出す話や、保管庫が 1,000 を超える話とは別です。iPhone のアプリや手元の Desktop まで同じかは、この図では断定しません。iPhone と iPad の Cursor アプリは、iOS 27 で会話を読み込むとき、またはプロフィール画面のとき、落ちなくなりました。会話の読み込みでは落ちない、です。プロフィール画面では落ちない、です。直ったのは iOS 27のその落ち方、です。ほかの iOS の版、ほかの画面、1.16.0 より前までは、この図では断定しません。考えた時間、未公開の下書き、iOS 26 の起動時、動画の回転、折り目、プロフィールボタンの位置とは別です。iPhone と iPad の Cursor アプリでは、依頼を書く入力欄は、入力欄は下の安全域に乗る、です。iPad の横の一覧では、アカウントの行も揃う、です。ホームの上に余分な隙間は無い、です。すべての隙間が無くなった、とは、この図では断定しません。iPhone に同じ行があるか、どの画面の入力欄か、Android、ウェブ、手元の Desktop、1.16.0 より前も断定しません。ツールバーのアイコン、シートのつかみ、Access Disabled の幅、落ちる話、考えた時間、未公開の下書き、折り目とは別です。iPhone と iPad の Cursor アプリでは、操作の帯の絵は、ツールバーのアイコンは標準の大きさ、です。端末のアイコンと同じ大きさ、です。ほかのアイコンまでは書かない、です。すべての絵が同じ大きさになった、とは、この図では断定しません。どの画面の帯か、Android、ウェブ、手元の Desktop、1.16.0 より前も断定しません。シートのつかみ、Access Disabled の幅、欄の位置、落ちる話とは別です。iPhone と iPad の Cursor アプリでは、下から出るシートの上の細い棒は、シートのつかみは変えられるシートだけ、です。変えられないシートには出ない、です。すべてのシートまでは書かない、です。すべてのシートの見た目が変わった、とは、この図では断定しません。どのシートが大きさを変えられるか、Android、ウェブ、手元の Desktop、1.16.0 より前も断定しません。使えないときの画面の幅、操作の帯の絵、欄の位置、落ちる話とは別です。iPad の Cursor アプリでは、使えないときの画面(Access Disabled)は、使えない画面は読みやすい幅、です。幅を保つのはiPadだけ、です。すべての画面の幅までは書かない、です。すべての画面の幅が変わった、とは、この図では断定しません。iPhone まで同じ、いつその画面になるか、何ピクセルか、Android、ウェブ、手元の Desktop、1.16.0 より前も断定しません。シートの上の細い棒、操作の帯の絵、欄の位置、落ちる話とは別です。動くウェブアプリは、アプリはクラウドで作る、です。手元では作れない、です。出すのは自分で公開したあと、です。通らなければ外には出ない、です。プレビューは、まだ外に出ていません。名指しの置き場は、ゼロから始める Origin と、すでにある GitHub です。Origin の Marketplace の連携アプリとは別です。入力欄が空で Agent が暇なとき、送る場所の波形は声の会話、です。隣のマイクは口述、です。マイクは文字にする、です。空のときだけ波形、です。仕事の途中は止めるボタンです。以前にマイクを拒否すると、止めたマイクは戻す、です。画面は Microphone blocked です。Agents Window、IDE、ウェブは、画面はシステムかブラウザ、です。iPhone の Cursor アプリは、iPhoneの画面は Settings、です。戻してからかけ直す、です。設定の段、iPhone の Safari、Android のアプリ、ボタンの日本語名は、この図では断定しません。声の通話の文字は、通話の文字はチャットに出る、です。クラウドの Agent では、クラウドの通話中はほかの端末へ、です。プライバシーモードでは同期しない、です。通話が終わったあとや、手元の Agent まで同じかは、この図では断定しません。iPhone の通話中に文字を隠す表示や、見出しの Share の会話の写しとは別です。声の通話では、声の更新は短い、です。無いときは書いた返事を読む、です。ふだんは全文を読まない、です。必ず短い声だけ、とは限りません。どの画面でも同じか、何秒か、声の名前は、この図では断定しません。通話中に変えた声は残る、です。そのAgentに残る、です。保存した声は既定より先、です。すべての Agent の既定になる、とは限りません。設定の段、ボタンの日本語名、声の名前の全一覧は、この図では断定しません。声の通話で差分や実行の様子を聞く調べは、調べは読むだけ、です。このAgentの履歴を探す、です。ほかの Agent の履歴までは、この図では断定しません。ワーカーがいる Project では、通話を別のワーカーへ、です。ワーカーがいないときまで移せる、とは限りません。どのボタンか、ボタンの日本語名、Android のアプリは、この図では断定しません。iPhone の音声通話で、狭い島にはボタンが無い、です。広げた島でミュートと切断、です。ロック画面でもミュートと切断、です。どの絵で島が広がるか、iPad の機種は、この図では断定しません。声の通話では、終わったと言うと切れる、です。声での終わりが切断、です。言い終わりで通話が終わる、です。切れるのは通話です。コードを直す仕事まで止まる、とは限りません。どの日本語が必ず効くか、ボタンの日本語名、Android のアプリは、この図では断定しません。黙ったまま約10分の切れ方、画面の表示から切る話とは別です。GitHub の IP 許可リストでは、gitの出口はチームだけ、です。個人のアカウントには、その出口はありません。出口は有効にしたあと、です。どちらの許可の入れ方でも、Cursor がチームで有効にしてからです。ghは出口を通らない、です。APIも出口を通らない、です。それらは Cloud Agent の出口の範囲から出ます。どのアドレスかは、この図では写しません。社内 GitHub Enterprise Server の接続 IP とは別です。インストール済み GitHub Apps の IP 許可をオンにすると、アプリに登録した一覧を継ぐ、です。そのアドレスの誰でもは通さない、です。同じアドレスを使うほかのソフトまで通す、ではありません。どのアドレスかは、この図では写しません。データ居住の GitHub Enterprise Cloud は、住所はghe.com、です。登録は社内サーバーと同じ、です。ベースURLはその住所、です。github.com の Connect でも、自社のサーバに置いた GitHub でもありません。実在の会社の住所は、この図では写しません。

SVG をダウンロード

操作イメージ3 ステップ
Cloud Agent 実行中の3幕(依頼・クラウド実装・確認)が順にアクティブになるイメージ
  1. ACT 1: あなたが依頼
  2. ACT 2: クラウドで実装・PR 作成
  3. ACT 3: あなたが確認して反映を決める
上の静止画とあわせて見てください。端末を閉じても、ACT 2 はクラウドで進みます。
第2章のレッスン一覧7 / 17
  1. 05開発は「依頼→変更→確認→反映」のループ8分
  2. 06変更を確認し、反映を決める16分
  3. 07指示したあと、何が起きる?12分
  4. 08追加指示とやり直し10分

この図が伝えたいこと

図は上から下へ、3幕だけで追えます。公式の Cloud Agent の動きはそのままに、骨格だけを次のように整理しています。

Desktop の Local Agent と同じ Agent の基本(依頼 → 道具で調べる・直す → 成果を返す)ですが、作業場は手元 PC ではなくクラウド上の隔離された VM です。開発環境(clone、依存の install、Secrets、起動コマンド)も、ノート PC に近い形で VM に用意されます(公式 Cloud Agent)。

  • ACT 1: あなたが依頼する
  • ACT 2: クラウド側の Agent が、隔離された作業用コンピュータで直し、Pull Request(変更提案)を出す
  • ACT 3: あなたが確認し、反映・やり直し・中止を決める

ACT 1:頼む(あなた)

スタートは依頼文です。ブラウザやスマホから、『何を・どこまで・完了条件』を送ります。慣れてきたら Slack、Microsoft Teams の @Cursor、Jira の担当を Cursor にする/コメントの @Cursor、Notion のコメント/タスク担当、Linear の担当を Cursor にする/コメントの @Cursor、GitHub / Bitbucket の @cursor コメントからも同じ幕を開けます。GitLab / Azure DevOps チームは PR コメントの @cursor ではなく、cursor.com/agents や Desktop の Cloud から起動します(accounts-setup の GitLab / Azure DevOps 節)。Slack なら `repo=` で保管庫を明示したり、調査だけのとき `autopr=false` を付けたりできます。Microsoft Teams でも `repo=` / `env=` は使えますが、公式に `autopr=false` 相当は無いので調査だけなら本文に書きます。コードを書かなくてよい代わりに、成功の定義はあなたが持ちます。触れる保管庫は、起動した人がもともと開けた範囲までです。起動したからといって権限は広がりません(公式 Cloud Agent security。accounts-setup 末尾)。

端末をまたぐときは、どこで始めても inbox や cursor.com/agents に同じ Agent が並びます。Desktop で Local を続けたいなら Remote Control、クラウド VM に丸ごと移したいなら Move to Cloud を選びます(when-desktop)。起動時には Cloud machine / Team Pool / My Machines から作業場を選ぶこともあります(first-cloud-agent)。1回のチャットで終わらない機能づくり・移行・日常の手入れは、Projects のコーディネーターに計画と振り分けを任せられます。Desktop は左ナビ、iPhone は inbox の New Project です。使えるのは Cloud Agent がある契約で、新しい契約では Premium 以上です。Plus にはありません。Enterprise の Desktop は Cursor 3.21.9 以降です(when-desktop の Projects 節と末尾。公式 Projects / Cursor for iOS)。

ACT 2:クラウドで進む(Agent)

Cursor はクラウド上に隔離された仮想マシン(VM)を用意します。手元の端末とは別の作業場です。端末を閉じても、基本的には作業が続きやすいです。iPhone で音声通話のシステムの画面が出ないときは、ロック画面と Dynamic Island の Live Activity(通話のロック画面)からミュートと切断ができます。進捗を最大8件まで追う Live Activities とは別です(first-cloud-agent 末尾)。通信が落ちたあとの戻りと、黙ったまま約10分で終わる切れ方は、first-cloud-agent の通話の節です。パソコンを起こして画面が追いつく話とは別です。ウェブの Agents で、幅の端数があるとナビゲーションの引き出しが空だった話と、ピンの表示が先頭で切れていた話は、そのレッスンの引き出しの節です。付けられる数の上限は最大75件のままです。iPhone と iPad のアプリが、iOS 27 で会話を読み込むとき、またはプロフィール画面のときに落ちていた話は、そのレッスンの落ちない話の節です。依頼を書く入力欄が、画面の下の安全な位置に揃い、ホームの印の上の余分な空きが無くなった話は、そのレッスンの入力欄の節です。下から出るシートの上の細い棒が出る場所は、そのレッスンのシートのつかみの節です。使えないときの画面の幅は、そのレッスンの使えない画面の節です。画面上部の狭い表示にミュートが無いかは、その次の節です。iPhone / iPad で、いちばん上の個人プランの含まれる利用枠を使い切ると、Included Usage Reached(利用枠到達)に Manage Plan が付きます。Desktop の Buy Credits とは別です(利用枠到達の節)。利用の上限で Cloud Agent が始められない、または追記を受け取れないとき、エラーは次の一手を伝えます。切り分けは accounts-setup の上限の案内の節です。利用枠到達や Buy Credits とは別です。iPhone Duo を横にして半開きにすると、一覧は折り目で終わり、チャットはもう半分に収まります。半分が狭すぎるときは、いつもの並びのままです(first-cloud-agent 末尾)。iPhone と iPad の保管庫ピッカーは、未公開の Start from scratch の下書きを出さず、最初から選びもしません(first-cloud-agent 末尾)。動いている会話で Thinking がひとつだけのとき、考えた時間は節が終わると更新されます(first-cloud-agent 末尾)。cursor.com/agents、PR の Agent パネル、ウェブの横の会話では、新しい Agent の最初の文が画像ごとすぐ見えることがあります。見え方が Desktop の Agents Window に揃った話は、first-cloud-agent 末尾です。コードベースのページの横欄では、マウスのホイールと Page Up / Page Down で会話を追えます。ウェブで実行のページをリンクから直接開いたとき、上の名前と進み具合と最初の依頼が以前より早く見える話も、first-cloud-agent の直リンクの節です。保管庫を持たない個人の環境への同僚の追記は、そのレッスンのいちばん末尾です。声で話すボタンと、文字にするマイクの見分けは、prompting の波形の節です。耳に入る長さは、そのレッスンの声の更新の節です。声で通話を終える話は、そのレッスンのいちばん末尾です。黙ったまま約10分で終わる切れ方とは別です。

最初の数ターンは、読み取り専用の探索になることがあります。保管庫を読んで状況を把握する段階で、まだファイルは変わりません。リポジトリの Hooks も、この探索が終わり書き込み可能な環境に切り替わってから動き始めます(rules-and-skills の Hooks 節)。『起動したのに何も変わらない』と感じたら、少し待つか、会話の進みを見てください。すでに動いている実行で、読む・探すだけ、またはメッセージだけのあとに送った次の指示が早く始まるのは別です。作業場の写しを待たない速さで、follow-up-loop 末尾です。

Agent は GitHub や Origin などからコードをコピーし、main(本番に近い本線ブランチ)を直接いじらず別ブランチで直します。公式では、作業対象の保管庫に加え、依存する別リポジトリやサブモジュールにも読み書きできる権限が必要です。権限が足りないと clone や push の段階で止まります。フロントと API など複数の保管庫にまたがる仕事では、multi-repo 環境を選ぶと1つの Agent がまとめて直し、触った保管庫ごとに PR を出せます。Web からの Cloud Agent は標準モードです。Long-running 設定は公式に廃止されたので、日をまたぐ仕事は `/goal` や Projects、または保管庫ごとに分けます。いちばん長いのは『調べる → 直す → 試す』の繰り返しで、途中の追加指示もここで受けます。作業中の追加は、いまの一手を途中で止めずに次の道具呼び出しで届けることもできます(follow-up-loop の作業中の追加指示節)。まとめているちょうどそのときに送った文は、別の追記にならず、同じ実行の一手になります(follow-up-loop の終わりかけの節)。ファイルを読む・探すだけ、またはメッセージだけのあとに送った次の指示は、作業場の写しを待たずに早く始まります(follow-up-loop 末尾)。会話に Explore / Bash / Browser のカードが出ることがあります。設定不要のビルトインサブエージェントで、途中のノイズを親の会話から外します。大きな仕事を小分けにした子は、既定では親と同じ作業コピーを共有します。衝突を避けたいときや新鮮な環境で試したいときは『それぞれ別環境で』と頼むと、隔離コピー(別 VM や worktree)で動けます(公式 Subagents)。自分で作った子のモデルが、チームに止められている、Max Mode が要る、または使えないときは、失敗せず親が使っているモデルで動き、親はそのことを知ります(follow-up-loop 末尾)。

画面が絡む仕事では、開発サーバーを起動してブラウザで画面を開き、クリックして動作を確かめることもあります。コンピュータ操作(computer use)でその確認を Agent が代わりに行い、スクショや短い動画などの成果物を PR に添えてくれることもあります。チーム設定でオフになっている場合もあります。チームが Gemini 3.1 Pro を止めても、この操作そのものは残ります。止まるのは動画の確認だけです。見分けは、Gemini の節です。

ここがうまくいくかは、仕事場(実行環境)の質に大きく左右されます。公式も、環境を渡さないことは『エンジニアに PC を渡さない』ことに近い、と表現しています。Cloud Agent Builds が有効な環境では、依存の install などを起動前に済ませた型から始められるので、ACT 2 に入るまでが速くなります(詳しくは第4章の実行環境レッスン)。道具がそろうほど、『書いたつもり』ではなく『動かして確認した』状態まで届きます。

一区切りつくと Pull Request(変更提案)が出ます。『こう直しました』という提案書であり、まだ本番反映ではありません。Cloud Agent と Project のワーカーが開く PR は、頼んでいなければ最初から Ready です。下書きは、あなたか依頼が頼んだときだけです(review-and-merge の「Cloud Agent が開く PR は、最初から Ready」)。非公開の Origin の提案書では、Cloud Agent が書いたコメント、返信、レビューの末尾に Open in Web が付きます。押すと、その Agent の実行が開きます(review-and-merge 末尾)。自分が開いていない PR の説明を直して、と頼むと、既存の文の下に足します。空ならその欄を埋め、作者の文は消しません(review-and-merge の「自分が開いていない PR の説明は、下に足す」)。GitHub の保管庫なら、枝の名前だけでなく7文字以上の短いコミットからも始められます。同じ文字の枝やタグがあると、そちらが優先されます(first-cloud-agent 末尾)。Linear の課題から始めた実行では、経過に実行と提案書を開くリンクが出ます。最後の返事は要約ひとつです。提案書は、マージでその課題を閉じる一行で終わります(first-cloud-agent 末尾)。外部の道具が、サインインに無い権限の名前で呼び出しを拒んだときは、失敗の代わりに名前つきの案内が出ます。切り分けは実行環境レッスンの、権限の名前が載る案内です。メールと予定表の道具が回数や権限で止まったときの直しは、その次の節です。

PR を出したあとも、レビューコメントや CI の結果、Slack の返信などを待って同じ会話で自動再開させたいときは Subscriptions(サブスクライブ)を使います。依頼文に待ち条件を書くか `/subscribe` スキルで伝えます(詳しくは第2章の追加指示レッスン)。

ACT 3:確かめて決める(あなた)

差分・プレビュー・成果物(スクショや動画)を見て、次の3択です。OK なら反映(マージ)。ずれていれば追加指示で ACT 2 の作業ループへ戻す。危険や不明ならやめる・相談する。

cursor.com の Pull Request ページでは、Agent の一覧が入力欄のすぐ上に開きます。作業中の件数と、注意が必要な件数が分かります。開いている Agent が止まっていて、下の Agent がまだ動いているときは、見出しが Waiting on です。読み込みが終わらないときは Retry、Privacy Mode(Legacy)と出たら Cloud Agent が止まっています(review-and-merge の「PR ページの Agent 一覧は、入力欄のすぐ上」)。

cursor.com の提案書のページで Fix with agent を押すと、その提案書を出した Agent、またはあなたがその提案書で直前まで動かしていた Agent への追記になります。一覧で時刻が新しい Agent とは限りません(review-and-merge 末尾)。

文言だけでは足りないときは、Agent 画面からクラウド上のデスクトップを一時的に操作して自分で触って試す(リモートデスクトップ操作。公式表記は remote desktop control)こともできます。試し終わったら操作を返し、続きは Agent に任せます。

同僚に途中経過を見せたいときは、Agent の URL を送れば会話・差分・成果物を同じ画面で見せられます。公式では、Agent は起動した Cursor チームのメンバーに見えます。ただし、チームのメンバーであるだけでは開けません。相手も Integrations で GitHub などを Connect し、そのリポジトリを開ける必要があります。開いたときに Cursor が閲覧者ごとのリポジトリ権限も確認します。複数の Cursor チームにいるときは、起動時のチームと相手のワークスペースが一致しているかも確認しましょう(詳しくは第1章の初回起動レッスン)。

URL 共有は既定で閲覧のみです。同僚に追記指示まで送ってもらうには、Cloud Agents の team follow-ups 設定が別途必要です。閲覧だけなら URL 共有で足りるチームも多いです(初回起動レッスンの follow-ups 節)。

チャット見出しの Share で作る Shared transcripts は、この URL とは別の会話の写しです。差分や成果物の画面は付きません。実行そのものを見せるなら URL を送ってください(初回起動レッスン末尾。公式 Shared transcripts)。

『Agent が終わった=本番に入った』ではありません。Cloud Agent が開いた PR が最初から Ready でも同じです。Ready は見てよい印で、反映済みではありません(review-and-merge の「Cloud Agent が開く PR は、最初から Ready」)。非公開の Origin の提案書に付いたコメント末尾のボタン(Open in Web)は、その Agent の実行を開きます。Microsoft Teams の起動カードの Open in Web とは別です(review-and-merge 末尾)。公式の流れでも、提案は人が確認してからマージします。反映を決めるまでが、あなたの役目です。焦らず確認して大丈夫です。動くウェブの画面として出したいときは、提案書の反映とは別の出口です。手順は、このレッスンのアプリを出す節です。プレビューのトレイは、まだ外に出ていません。

マージまで任せたいときは、GitHub の auto-merge(条件が揃ったら自動反映)・Agent の Subscriptions(レビューや CI を待って再開)・`@cursor autofix`(Agent 作成 PR の CI 自動修正)の3道具を組み合わせられます。くわしくは review-and-merge のマージまで任せるレシピ節へ。

Gemini 3.1 Pro を止めても、コンピュータ操作は残る

チームのモデル設定で Gemini 3.1 Pro を止めると、以前は、コンピュータ操作が使うモデルは許されていても、チームの Cloud Agent 全部でコンピュータ操作まで止まっていました。いまは直っています。使えなくなるのは動画の確認(video review)だけです。Agent はコンピュータ操作で、画面を開いて試し続けます(公式 Cloud Agents release notes、Week of Oct 19, 2026)。

Gemini 3.1 Pro は、画面のラフを読む側としても案内しています(accounts-setup 末尾)。ここでいう「止めても残る」は、そのモデルをチームが止めたときのコンピュータ操作の話です。料金や、入力が 200k を超えたときの単価とは別です。

コンピュータ操作が実際に使うモデルを、管理者が止めたときは別です。Cloud Agent は、コンピュータ操作は使えない、止まっているモデルの名前、そのモデルが何に使われるか、管理者ならチームのモデル設定で戻せる、と伝えます(公式 Cloud Agents release notes、Week of Oct 12, 2026)。Gemini 3.1 Pro だけを止めたときは、この案内にはなりません。動画の確認だけが止まります。

Enterprise のチーム設定でコンピュータ操作そのものをオフにした場合や、自前ワーカーで `--computer-use` が無い、Mac の画面収録の許可が無い、という止まり方とは別です(when-desktop)。会話に出る Browser カードとも別です。

  • Gemini 3.1 Pro を止めた: 動画の確認だけ止まる。コンピュータ操作は残る
  • コンピュータ操作が使うモデルを止めた: Agent が、使えないこと、モデル名、用途、管理者なら戻せる、と伝える
  • チーム設定でコンピュータ操作をオフにした、自前ワーカーの許可不足、とは別

アプリはクラウドで作る

Cloud Agent は、申し込みの一覧や社内の受付、短い案内ページのような、動くウェブアプリを用意できます。やりたいことを、アプリを作ってほしい、と明示して頼みます。置き場、必要なデータベース、サインイン、秘密の置き場は Cursor が扱います。アプリはクラウドで作る、です。公式の英語は Be explicit that you want Cursor to build an app. Remember to use a cloud agent; this feature is not supported locally です(公式 Cloud Agent Apps、https://cursor.com/docs/cloud-agent/apps 。changelog の Build Live Apps、2026-11-05)。

動くのはクラウドの Agent だけです。手元の Agent では、この公開はできません。手元では作れない、です。ゼロから始めると、Cursor の Origin に新しい保管庫ができます。すでにある GitHub の保管庫から出すこともできます。公式の Apps のページが名指ししている置き場は、この2つです。ほかの置き場は、このページでは書いてありません。Origin の Marketplace に出す連携アプリ(accounts-setup の「Origin のアプリは Marketplace から足す」)とは別です。あちらはコードベースへ足す道具で、こちらは人が開くウェブの画面です。

用意ができると、プレビューして公開するトレイが出ます。公開するとき、アプリの URL を選びます。あとから変えられます。Cursor は、決まった確認と、Agent による確認を走らせます。全部通ると、開くリンクが返ります。通らないときは、直す点が並びます。Agent に直させてから、もう一度公開します。出すのは自分で公開したあと、です。公開を選ぶ前に、外へは出ません。通らなければ外には出ない、です。プレビューが見えていることと、外から開けることは別です。

公開の前に、いつもかかる確認が4つあります。ファイルに書いた API キーやアクセス用のトークンは止めます。秘密鍵、サービスアカウントの鍵、認証トークンの入ったファイルも止めます。.env は載せません。ソースマップは外して、訪れた人に元のソースを読ませません。この4つは、セキュリティ確認をオフにしても残ります。その上で、AI がファイルを読み、重大な問題なら公開を止めます。チームの管理者は、その確認への指示を Apps の画面で足せます。足せるのはルールの追加で、上の4つは外せません。AI の確認が止めた公開を、管理者が通すことがあります。悪意のあるコード、ファイルに書いた秘密、露出した資格情報は、その例外では通りません。

データベースが要るときは、Postgres を自動で用意します。置き場のアカウントは、チームならそのチーム用、個人ならあなた用で、ほかのチームやほかの人とは分かれます。非公開とチーム向けは、Cursor にサインインした人だけが開けます。個人の契約では、リンクを知っている人へ公開もできます。Teams と Enterprise で、その公開共有は既定ではオフです。管理者が Apps の画面でオンにできます。オフに戻すと、すでに公開していたアプリはチーム向けへ戻ります。つなぎたい先の秘密は、Agent には値が見えません。多くはチームの管理者が Apps の画面で作ります。個人の秘密を作れる人は、自分でも足せます。

使えるのは、Cloud Agent がある有料の契約です。新しい契約の Plus には Cloud Agent が無いので、こちらもありません(accounts-setup)。チームでは、管理者が Apps 自体をオフにできます。オフのときは、この手順では出ません。iPhone のアプリに同じトレイがあるか、API キーでアプリを開く手順は、この節では書いてありません。コンピュータ操作で画面を試す話(前の節)とは別です。

  • アプリはクラウドで作る。手元では作れない
  • 出すのは自分で公開したあと。通らなければ外には出ない
  • 名指しの置き場は、ゼロから始める Origin と、すでにある GitHub
  • Origin の Marketplace の連携アプリとは別

理解チェック

  • 『最初と最後は自分、真ん中はクラウド』と言える
  • Cloud Agent が Local Agent と同じ Agent の基本で、作業場だけクラウド VM だと説明できる
  • Pull Request が『まだ本番ではない提案』だと説明できる
  • 確認後の3択を挙げられる
  • マージまで任せたいとき、auto-merge / Subscriptions / autofix の3道具があると知っている
  • 依存リポジトリやサブモジュールにも権限が要る場合があると知っている
  • Web からの Cloud Agent は標準モードで、日をまたぐ仕事は /goal や Projects、保管庫ごとだと知っている
  • Builds 有効な環境では ACT 2 に入る前に仕事場が温められていることがあると知っている
  • ACT 2 の最初は読み取り専用の探索で、書き込み可能になるまでファイルが変わらないことがあると知っている
  • 端末をまたいでも同じ Agent が inbox に並び、Move to Cloud と Remote Control のちがいを説明できる
  • 作業中の追加指示は、いまの一手を途中で止めずに次の道具呼び出しで届けられると知っている
  • 終わりかけに送った文は、別の追記にならず同じ実行の一手になると知っている
  • 自分が開いていない PR の説明は既存の文の下に足され、GitHub なら7文字以上の短いコミットからも始められると知っている
  • cursor.com の PR ページでは Agent 一覧が入力欄のすぐ上にあり、Waiting on は下の Agent 待ちだと知っている
  • Cloud Agent と Project のワーカーが開く PR は、頼んでいなければ最初から Ready だと知っている
  • 非公開の Origin の提案書では、コメント末尾の Open in Web が、その Agent の実行を開くと知っている
  • cursor.com の提案書で Fix with agent を押すと、出した Agent か、その提案書で直前まで動かしていた Agent への追記で、時刻が新しいほうとは限らないと知っている
  • Linear の経過には実行と提案書を開くリンクが付き、最後の返事は要約ひとつで、課題から始めた提案書はマージでその課題を閉じる一行で終わると知っている
  • 会話の Explore / Bash / Browser カードは設定不要のビルトインだと知っている
  • 子 Agent は既定では親と同じ作業コピーを共有し、隔離は『それぞれ別環境で』と頼むと知っている
  • 自分で作った子役のモデルが使えないときは、失敗せず親のモデルで動き、親がそのことを知ると知っている
  • 読む・探すだけ、またはメッセージだけのあとの次の指示は、作業場の写しを待たずに早く始まると知っている
  • チームが Gemini 3.1 Pro を止めても、コンピュータ操作は残り、止まるのは動画の確認だけだと知っている
  • コンピュータ操作が使うモデルを止めたときは、Agent がモデル名と用途を伝え、管理者はチームのモデル設定で戻せる、と知っている
  • 大きな仕事は左ナビの Projects(コーディネーター)に計画と振り分けを任せられると知っている
  • Projects は Cloud Agent がある契約だけで、新しい契約の Plus には無いと知っている
  • Agent URL を同僚に送るとき、相手の Integrations 接続とリポジトリ権限が必要だと知っている
  • Agent は起動した Cursor チームのメンバーに見えるが、メンバーであるだけでは開けないと知っている
  • URL 共有は閲覧のみで、追記指示は team follow-ups 設定が別だと知っている
  • Shared transcripts は会話の写しで、Agent の URL とは別だと知っている
  • 触れる保管庫は起動した人の権限までで、広がらないと知っている
  • 提案は人が確認してからマージすると知っている
  • 動くウェブアプリは、アプリはクラウドで作る。手元では作れない。出すのは自分で公開したあと。通らなければ外には出ない、と知っている

開いただけでは「済」になりません。チェックできたら押してください。

実践

図を見ながら、自分の不安が ACT 1 / 2 / 3 のどれかを選んでみましょう。その ACT に関係する次のレッスンを重点的に読むと理解が深まります。起動時にワーカー選択が出たら、迷えば Cloud machine(first-cloud-agent の実行先の選び方節)。clone が止まるなら、依存保管庫の権限も疑って repository レッスンへ。『自分の見えない保管庫まで触られるのでは』が不安なら accounts-setup 末尾の権限の節。起動が遅いと感じたら、第4章の Cloud Agent Builds 節もあわせて見てください。URL を同僚に送る予定があるなら、相手の GitHub 接続と、追記まで必要かどうかも一言確認してみましょう。Desktop で Local を始めたなら、when-desktop の Move to Cloud とのちがい節も読んでおきましょう。チームが Gemini 3.1 Pro を止めたあとも画面確認が続くなら、Gemini の節を見て、コンピュータ操作まで止まったと決めつけないでください。動くウェブアプリを出したいときは、アプリを出す節を見てください。読むだけのあとに次の指示がすぐ始まったら、follow-up-loop 末尾を見て、起動直後の探索と混ぜないでください。非公開の Origin の提案書でコメント末尾に Open in Web と出たら、review-and-merge 末尾を見て、Teams の起動カードと混ぜないでください。cursor.com の提案書で Fix with agent を押したら、同じレッスンの末尾を見て、一覧の上の Agent と混ぜないでください。Linear の経過でリンクや要約の出方が違う、またはマージしても課題が閉じないときは、first-cloud-agent 末尾を見てください。

このレッスンで出てくる用語

全部覚える必要はありません。気になる言葉だけ開いてみてください。

用語集を全部見る →

いま身についている開発者スキル

実行環境とハンドオフ(branch → PR → review → merge)の可視化