こんにちは、エンジニアのオオバです。

お悩みさん
お悩みさん
  • Antigravity CLI(agy)をスクリプトから非対話で呼びたい
  • agy -p にプロンプトを渡すとエラーになる
  • headlessモードで書き込みが自動で断られる
  • オオバ
    オオバ
    本記事ではこれらの悩みを解決します。

    原稿を書くための自分用のエディタとして、「執筆スタジオ」と「ノートスタジオ」を作って使っています。

    どちらも、AIに原稿を読ませて赤ペン(直したほうがよい箇所の指摘)を入れてもらう機能が付いています。

    裏で呼んでいたのは Claude Code で、モデルは Mac mini のダッシュボードの設定に従う作りでした。

    2026-11-12、ここに「AI・モデル・effort」の選択を付けて、Claude Code / Codex / Antigravity(agy)の3つを画面の上部で切り替えられるようにしています。

    AIに「Antigravityを追加して、agyで叩けると思う」と頼んだのが始まりです。

    「CLIなんだから、claude -p と同じ感覚で呼べるでしょ?」って思いますよね。

    僕もそう思っていましたが、agy の非対話モードはプロンプトの渡し方からして違いました。

    agyのプロンプトは--print=本文の引数で渡す。許可なしの非対話では書き込みが自動で断られ、サインインの判定はCLIの内部の保存場所に頼ると自動更新で壊れる

    先に結論をまとめます。

    Antigravity CLI(agy)を非対話で呼ぶときの要点

    ①プロンプトは引数でしか渡せない。--print=本文 の形にする(-p の直後に別の引数を置くと、その引数がプロンプトとして扱われる)

    ②許可なしの非対話モードでは、ファイルの書き込みとコマンドは自動で断られる。読み取りは通る

    ③1.5.6 から --output-format json と --json-schema で、構造化した返事を受け取れる

    ④effort はモデル名に含まれているので、表示名の括弧で分けて選ばせ、実行時にIDへ戻す

    ⑤サインインしているかは agy models の一覧では分からない。保存先は 1.5.9 でファイルからキーチェーンに変わった

    ということで本記事では、agy を Claude Code・Codex と並べて自作エディタの3つ目のAIにしたときに分かった違いをお話していきます。

    →11万文字で徹底解説した「DOTweenの教科書」Unityアニメーションの超効率化ツールはこちら

    Claude Code・Codex・agyの非対話モードの違い

    まずは3つのCLIの呼び方を並べます。

    # Claude Code(プロンプトは標準入力)
    claude -p --output-format json --json-schema ... --tools Read,Grep,Glob  
    
    # Codex(プロンプトは標準入力。最後の - が標準入力の意味)
    codex exec -s read-only -o <最後の返事のファイル> -  
    
    # Antigravity(プロンプトは引数)
    agy --print=<プロンプト> --output-format json --json-schema ...  
    
    ※形だけを並べています。スキーマの渡し方などは省略しています

    違いは大きく2つあります。

    AIを動かすのは原稿のリポジトリなので、勝手に書き換えられないこと は外せない条件です。

    3つとも、この条件は満たせました。

    Codexは PATH の先にある古い版に注意

    Codex では別のところでつまずいています。

    MacBook Pro の PATH の先に、2025年の古い npm 版の Codex(research preview の v0.1)が残っていました。

    その版で動くと返事がバナーになってしまい、JSON として読めません。

    ~/.local/bin を先に見るようにして解決しました。

    古い Codex が PATH に散らばっていた話は、別のランナーでも踏んでいます。

    👉 codex execでClaude CodeとCodex CLIを切り替えるAIランナーを作った:非対話で動かすときの落とし穴4つ

    agyのプロンプトは--print=で引数として渡す

    最初は claude -p と同じつもりで、agy -p --model X と書きました。

    返ってきたのは -p took "--model" as its prompt。

    -p の直後にある --model を、プロンプトの本文として受け取ってしまったということ。

    それなら標準入力はどうかと echo ... | agy -p= を試すと、今度は empty prompt です。

    標準入力は読まれていません。

    ネタに記録したエラー文(抜粋)を画面にしたもの

    agy -p の後ろの引数がプロンプトとして扱われるエラーと、標準入力では empty prompt になるエラー

    結局、--print=<本文> の形でプロンプトを1つの引数に入れて渡しています。

    引数で渡すので約90万バイトで止めた

    引数で渡す以上、macOS の引数の上限(約1MB)に引っかかります。

    長い原稿をそのまま渡すと上限を超えるかも知れないので、プロンプトは約90万バイトで止めるようにしました。

    標準入力で渡せる Claude Code と Codex では、気にしなくてよかった部分です。

    許可なしの非対話モードでは書き込みが自動で断られる

    agy の非対話モードは、許可を渡していないとファイルの書き込みやコマンドの実行を通しません。

    対話なら「許可しますか?」と聞かれる場面でも、非対話では聞く相手がいないため、自動で断られます。

    実際に出たメッセージがこちら。

    ネタに記録した出力を画面にしたもの

    headless mode cannot prompt for と出て write_file の許可が自動で断られたメッセージ

    一方で、ファイルの読み取りは通ります。

    原稿のリポジトリで動かしても書き換えられないので、赤ペンを入れてもらう用途にはむしろ都合が良い挙動です。

    「antigravity cli 自動承認」で調べている人は、書き込みを通す方法を探しているのかも知れません。

    僕の用途では断られるほうが都合が良かったので、書き込みを通す方法は試していません。

    1.5.6で--output-formatと--json-schemaが増えた

    作業の途中で、agy が 1.0.6 から 1.5.6 へ自動で更新されました(笑)。

    1.5.6 では --output-format json と --json-schema が増えていて、返事は次の形で返ってきます。

    {"status":"SUCCESS","response":"...","structured_output":{...}}  
    

    エラーのときは status が ERROR になり、error に理由が入ります。

    ネタに記録したエラーの返事を画面にしたもの

    agy 1.5.6 の status が ERROR の返事。error に authentication failed or timed out が入っている

    structured_output を読む形は、Claude Code の --json-schema と同じです。

    Claude Code の構造化出力を夜間の点検で使った話は、こちらに書いています。

    👉 Claude Code headless modeで夜間コード点検:Sonnetは38秒で切り上げ、Opusは7分で112ファイル読んだ

    agy modelsの出力が版で変わった

    モデルの一覧は agy models で取れますが、出力の形が版で変わりました。

    しかもパイプで受けたときは、先頭に「Fetching available models...」の1行が付きます。

    一覧として読むときは、この行を飛ばす必要があります。

    ネタに記録した agy models の出力(抜粋)を画面にしたもの

    agy 1.0.6 は表示名だけ、1.5.6 はIDとタブ区切りで出す agy models の出力

    effortはモデル名の括弧から取り出す

    agy の一覧では、effort がモデル名に含まれています。

    「Claude Opus 5.5 (High)」なら、「(High)」の部分が effort です。

    そこで表示名を括弧で分けて「モデル × effort」の2つのプルダウンにし、実行するときにIDへ戻しています。

    最小の再現(サンプルデータ)。実際のスタジオの画面ではありません

    表示名を括弧で分けてモデルとeffortのプルダウンにし、実行時はIDに戻す再現

    選んだ内容はスタジオ側の設定に保存し、Mac mini のダッシュボードのAI設定には書きません。

    Claude Code で「既定」を選んだときだけ、これまでどおりダッシュボードの設定に従います。

    速さは赤ペン1件でagyが14秒・Codexが6秒

    赤ペン1件にかかった時間を測りました。

    モデルが違う1件ずつの実測なので、CLIの速さを比べた数字ではありません。

    あくまで目安です。

    ハマり1:画面からの切り替えが保存されなかった

    画面でAIを切り替えても、保存されませんでした。

    返ってきたのは「AIの種類が違います」の400。

    原因は、サーバーのルーターの作りと食い違った書き方です。

    ルーターはリクエストの本文を先に読んで、ルートの関数に3番目の引数で渡す作りになっていました。

    それなのにルートの中で、もう一度 readJson(req) を呼んで本文を読もうとしていたわけです。

    本文は一度読むともう残っていないので、空の本文として扱われ、AIの種類が無いと判定されていました。

    考え方だけ書くと、次のような形です。

    // ルーターが本文を読んでから、3番目の引数で渡す作り  
    async function saveAiEngine(req, res, body) {  
      // NG: ここで読み直すと本文はもう空  
      // const body = await readJson(req);  
      save(body);  
    }
    

    ルートでは、3番目の引数で受け取った本文を使うように直しました。

    ハマり2:agy modelsが一覧を返しても使えるとは限らない

    ここからはサインインまわりの話です。

    一覧を返しても実行で落ちる

    1.0 系の agy は、サインインしていないと agy models が「Please sign in to view available models」を返していました。

    Mac mini はサインインしていなかったので、スタジオの画面には「使えません」と出すようにしています。

    ところが 1.5.6 は、サインインしていなくても agy models が一覧を返します。

    一覧が取れたからといって「使える」と判断すると、実行したときに authentication failed or timed out のエラーで落ちるということ。

    さらに、サインインしていない状態で agy --print=... を動かすと、Google のサインインURLを出して、60秒のあいだサインインを待ちます。

    ネタに記録した出力(抜粋)を画面にしたもの。サインインURLの行は省いています

    未サインインで agy --print を動かしたときの、60秒のあいだサインインを待つメッセージ

    サインインの印のファイルで判定した

    調べると、サインイン済みの MacBook Pro にだけ ~/.gemini/jetski-standalone-oauth-token がありました。

    そこで、このファイルがあるかどうか(中身は読まない)でサインインを判定することにしました。

    サインインボタンを画面に付けた

    サインインを待つこのメッセージは、逆に使えます。

    スタジオの画面に「サインイン」ボタンを付けて、次の流れにしました。

    1. ボタンを押すと、サーバーが agy を起動してサインインURLを拾う
    2. ブラウザでサインインする
    3. 認証コードが出たら、画面の欄に貼る。サーバーがそれを agy の標準入力へ書く
    最小の再現(サンプルデータ)。実際のスタジオの画面ではありません

    未サインインのときに使えませんとサインインボタンを出す再現

    一覧の覚えがサインアウトを隠した

    モデルの一覧は、10分覚える作りにしていました。

    その結果、サインアウトした後もしばらく「使える」と出てしまいます。

    サインインの印を、覚えている一覧より先に見るように直しました。

    agyは起動したときにしか自分で更新しない

    agy は、起動したときにしか自分で更新しません。

    Mac mini では毎日4:30に Codex と Claude Code を更新しているので、そこに agy update を足しました。

    成否は ~/.gemini/antigravity-cli/updater/update_status.json の success で見ています。

    ハマり3:1.5.9でサインインの保存先がキーチェーンに変わった

    11/16、また動かなくなりました。

    CLI ではサインインしているのに、スタジオは「未サインイン」と表示します。

    サインインボタンも失敗扱いでした。

    原因は、agy 1.5.9 でサインインの保存先が変わったことです。

    ~/.gemini/jetski-standalone-oauth-token のファイルから、macOS のキーチェーン(サービス gemini・アカウント antigravity)に移っていました。

    気づいたきっかけは、agy のログ(~/.gemini/antigravity-cli/cli.log)です。

    ネタに記録した cli.log の2行を画面にしたもの

    cli.log に keyringAuth: loaded token と ChainedAuth: authenticated via keyring が出ている

    キーチェーンの項目名は、security dump-keychain の属性だけ(中身は出さない)を見て特定しました。

    判定は security find-generic-password の終了コードで行っています。

    # -w を付けないので、トークンそのものは取り出さない
    security find-generic-password -s gemini -a antigravity  
    # 終了コードが 0 ならサインイン済み
    

    学び:CLIの内部の保存場所に頼った判定は黙って壊れる

    ハマり3で分かったのは、判定の作りの弱さです。

    ファイルがあるかで判定する作りは、agy の内部の保存場所に頼っていました。

    その保存場所が、毎日4:30の自動更新で黙って変わったわけです。

    エラーは出ず、表示が「未サインイン」に変わるだけ。

    しかも、その自動更新に agy update を足したのは自分です(笑)。

    つまり、CLI の中身に頼る判定は、更新のたびに壊れうるということ。

    今回は agy のログに「keyring」と出ていたおかげで、保存先が変わったことに気づけました。

    まとめ

    Antigravity CLI(agy)を3つ目のAIにして分かったこと

    ①プロンプトは --print=本文 の引数で渡す。-p の後ろの引数や標準入力は使えない。macOS の引数の上限(約1MB)に注意

    ②許可なしの非対話モードでは書き込みとコマンドが自動で断られるので、原稿を読ませるだけの用途には向いている

    ③1.5.6 からは --output-format json と --json-schema で、Claude Code と同じように structured_output を読める

    ④effort はモデル名の括弧に入っている。表示名を分けて選ばせ、実行時にIDへ戻す

    ⑤agy models の一覧ではサインインを判定できない。サインインの保存先は 1.5.9 でキーチェーンに変わった

    3つのAIを切り替えられるようになって、赤ペンを入れてもらうたびに、どのAIに頼むかを画面で選べるようになりました。

    CLIを自動で更新しているかぎり、今回のような変更はまた来ると思います。

    agy をスクリプトから呼ぼうとしている人の近道になればうれしいです。

    関連記事

    オススメ記事
    検証環境