◉ANTIGRAVITY LABEN
記事一覧/Antigravity 基本
◉ Antigravity 基本/2026-06-18中級

同じ仕事を、デスクトップ・CLI・SDK・Managed Agents のどれで動かすか

Antigravity 2.0 はデスクトップ・CLI・SDK・Managed Agents API という複数の面を持ちます。同じタスクをどの面で動かすべきか。仕事の性質から利用面を選ぶ判断軸を設計します。

Antigravity419Antigravity 2.016アーキテクチャ9ワークフロー設計3

✦ プレミアム記事

Antigravity 2.0 が単体のエディタから 5 つの面を持つ基盤へ姿を変えてから、いちばん最初に迷ったのは新機能の使い方ではなく、「この仕事をどの面で動かすのが正しいのか」という問いでした。デスクトップで対話しながらやるのか、CLI で叩くのか、SDK でアプリに組み込むのか、Managed Agents API でクラウドに投げるのか。同じ「コンポーネントを直す」という作業でも、文脈によって正解の面が変わります。

私自身が個人開発で 4 つのサイトを並行運用するなかで、最初はすべてデスクトップで済ませようとして手が回らなくなりました。面を仕事の性質で選び分けるようになって、ようやく落ち着いたのです。ここでは、その選び方を判断軸として整理します。

まず 4 つの面の素の性格を押さえる

エンタープライズ Cloud を除くと、個人開発で触れるのは次の 4 面です。それぞれ得意な仕事の形が違います。

面素の性格最も向く仕事
デスクトップ対話的・並行エージェントを目で監督探索しながら作る・判断が要る作業
CLI非対話・スクリプトに組み込める定型処理・CI・夜間バッチ
SDK自前アプリにエージェントを内蔵プロダクトの機能としての常駐処理
Managed Agents API隔離環境を単一呼び出しで起動重い・危ない・隔離したい処理

ここで大事なのは、これらが「優劣」ではなく「向き不向き」だという点です。デスクトップが上位で API が下位、ではありません。仕事の性質に当てると、自然に向く面が決まります。

4 つの軸で仕事を測る

面を選ぶとき、私は仕事を次の 4 軸で測っています。

対話性

人の判断が途中で要るか。要るならデスクトップ。完全に手順が決まっているなら CLer や API へ寄せられます。「やりながら方針が変わる」作業を無理に自動化すると、結局やり直しが増えます。

スケジュール

決まった時刻に無人で動かしたいか。そうなら CLI を cron に載せるか、SDK のスケジュール実行を使います。デスクトップは人が前にいる前提なので、無人運用には向きません。

隔離

失敗したときの被害を閉じ込めたいか。信頼できない入力を扱う、破壊的な操作を試す、といった仕事は Managed Agents API の隔離環境に逃がします。手元のワークスペースで走らせる必要はありません。

統合深度

その処理を自分のプロダクトの一部として常駐させたいか。ユーザー操作に応じてエージェントが動く機能を作るなら SDK 一択です。CLI やデスクトップでは製品には組み込めません。

✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦対話性・スケジュール・隔離・統合深度の4軸で利用面を選ぶ判断フレーム
✦タスクの性質から面を返す小さなルータの実装と、CLI・SDK の最小起動例
✦個人開発で4面を併用して見えた、面をまたぐときの落とし穴と私の選び方
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

◉ Antigravity 基本2026-11-12
「常に続行」にしたのに承認を求められる日は、緩める範囲を設定名ではなくコマンドの種類で決め直す
「常に続行」を選んだのに、ターミナルのコマンドで承認を求められ続ける。設定が効かない原因を探す前に、どこまで緩めるかを「読むだけ」「手元を書き換える」「消す・送る」の三種類で決め直す方法を、仕分けスクリプトと一緒に書き残します。
◉ Antigravity 基本2026-10-31
最初の一日は「読むだけ」を頼む。Antigravity に任せる範囲を、壊せない順に広げる 5 段
Antigravity を初めて開いた日に、何を頼み、何をまだ頼まないか。壊せない順に任せる範囲を広げる 5 段の梯子と、作業の前後で「どこが動いたか」を数える小さなシェルスクリプトをお伝えします。
◉ Antigravity 基本2026-10-28
Failed to Fetch と出たとき、最初に見る3か所を先に決めておく
Antigravity で Failed to Fetch が出たとき、設定をいじる前に「通信の届き先」「認証の状態」「プロキシ」の3か所を順に確かめる切り分け手順です。ターミナルで貼れる確認コマンドと、結果ごとの次の一手をまとめました。