◉ANTIGRAVITY LABEN
記事一覧/連携・プラグイン
⬡ 連携・プラグイン/2026-11-21中級

Zed の Antigravity 設定を VS Code・JetBrains・Xcode へ移すとき、そのまま写せない3か所

Zed で動いている agy acp の登録を VS Code・JetBrains IDE・Xcode へ移すと、設定キー、コマンドのパス、認証と使えるモデルの3か所が変わります。公式手順を突き合わせた差分と、Zed の settings.json から移行先の設定を書き出す小さなスクリプトをまとめました。

ACPAntigravity CLI45ZedXcode4JetBrainsVS Code5移行14

壁紙アプリの iOS 版を Xcode で触りながら、同じ Antigravity のエージェントを Zed でも JetBrains でも呼べるようにしておきたい——そう考えて、各エディタの登録手順を一枚に並べた日がありました。

Antigravity CLI には agy acp という ACP(Agent Client Protocol)サーバーが入っていて、エディタはこれを子プロセスとして起動し、標準入出力の JSON-RPC で会話します。公式の説明では「Android Studio 以外は、どのクライアントも agy に引数 acp を一つ渡すだけ」とされています。

ところが、Zed の settings.json に書いた数行を他のエディタへそのまま貼ると、動かない箇所が出てきます。私自身、最初は「同じコマンドなのだから、コピーで済む」と思い込んでおりました。並べてみて分かったのは、変わるのはコマンドではなく、その周りだということです。

最初にお伝えしたいのは、移行で変わるのは3か所だけということ

公式ドキュメント(Other editors (ACP))を読み比べると、エディタをまたいで変わるのは次の3つに絞れます。

  1. 設定のキーと置き場所(agent_servers なのか acp.agents なのか、ファイルなのか画面なのか)
  2. コマンドのパス(agy で通るのか、絶対パスが要るのか)
  3. 認証と、選べるモデル(API キーをどこに置くか、他社モデルが出てくるか)

逆に言えば、エージェント本体・ツール・権限ルール・サインイン情報は Antigravity CLI 側から来るので、移行しても変わりません。ここを分けて考えると、移行の作業はずっと小さくなります。

1か所目:設定のキーと置き場所

いちばん目に見える違いです。同じ「Antigravity を登録する」でも、書く場所と形が4通りあります。

エディタ置き場所キーZed との差
Zedsettings.json(zed: open settings file)agent_servers基準。"type": "custom" が付く
VS Codeユーザーの settings.jsonacp.agentsネイティブ対応がなく、コミュニティ製の ACP Client 拡張が必要。type は書かない
JetBrains IDE~/.jetbrains/acp.jsonagent_serversキー名は同じでも type がなく、command は絶対パス
XcodeSettings > Intelligence > Add an Agent(画面入力)ファイルではなく Command と Arguments の欄に入れる

JetBrains は Zed と同じ agent_servers というキー名を使うので、つい丸ごと貼りたくなります。ただ、"type": "custom" は Zed の書式で、JetBrains の公式例には出てきません。キー名が同じだからこそ、混ぜないように気をつけたいところです。

なお Android Studio だけは ACP Registry からの導入で、この表の書き方とは別の手順になります。

2か所目:コマンドのパス

Zed では "command": "agy" で動いていても、JetBrains と Xcode では動かないことがあります。公式の注意書きは次のとおりです。

  • JetBrains IDE は、シェルの PATH を必ずしも引き継ぎません。which agy の絶対パスを書きます。
  • Xcode は ~ を展開せず、シェルの PATH も読みません。Command 欄は絶対パスにします。

Homebrew などで入れた CLI は、ターミナルからは見えても、Dock から起動したアプリからは見えない——macOS ではよくある話です。「ターミナルで agy acp --help が通るのに、エディタでは起動しない」なら、私はまずここを疑うようにしています。

もう一つ、Xcode の Arguments 欄について。公式手順に書かれているのは acp の1語だけで、--sandbox のような追加フラグをこの欄にどう並べるかまでは書かれていません。Zed で ["acp", "--sandbox"] のようにフラグを足している方は、Xcode に移したあとで、実際にサンドボックスが効いているかを一度確かめておくと安心です。

3か所目:認証と、選べるモデル

agy acp は、対話モードの agy で一度サインインしたときの資格情報を使い回します。資格情報がない状態だと、リクエストは Authentication required(コード -32000)で失敗します。SSH 先やブラウザのない環境では agy acp --login を端末で先に済ませる、というのが公式の案内です(SSH 越しの症状は Zed の SSH 先で Antigravity のサインインが戻ってこないとき で詳しく書きました)。

移行で気をつけたいのは、Zed の設定に env で GEMINI_API_KEY を書いていた場合です。公式ドキュメントにも「エディタの設定ファイルは平文で保存され、同期や共有されやすい」という注意があります。Zed で一度そう書いてしまっていても、移行先へ同じ行を写す理由にはなりません。資格情報は CLI に預け、エディタの設定にはコマンドだけを書く——移行は、この線を引き直すよい機会だと思います。

もう一つの差は、選べるモデルです。Gemini のモデルはどのクライアントでも使えますが、他社モデルが選択肢に出るのは JetBrains IDE(JetBrains Air を含む)・Android Studio・Android Performance Analyzer・Zed・Xcode に限られます。VS Code の ACP Client 拡張はこの一覧に入っていません。 Zed で他社モデルを使っていた方が VS Code へ移ると、モデルの一覧が短くなるはずです。不具合ではないので、慌てて再インストールしなくて大丈夫です。

Zed の設定から、移行先の書き方を書き出す

3か所の差を毎回手で直すのは面倒なので、Zed の settings.json を読んで、VS Code・JetBrains・Xcode 用の書き方を出力する小さなスクリプトを用意しました。Zed の設定はコメントや末尾のカンマを含むことがあるため、素の json.loads では読めません。そこだけ前処理しています。

#!/usr/bin/env python3
"""Zed の agent_servers から Antigravity の登録を読み、他エディタ用の設定を書き出す。"""
import json, re, shutil, sys
from pathlib import Path
 
def load_jsonc(path: Path) -> dict:
    text = path.read_text(encoding="utf-8")
    out, i, in_str = [], 0, False
    while i < len(text):
        c = text[i]
        if in_str:
            out.append(c)
            if c == "\\" and i + 1 < len(text):
                out.append(text[i + 1]); i += 2; continue
            if c == '"':
                in_str = False
        elif c == '"':
            in_str = True; out.append(c)
        elif text.startswith("//", i):
            while i < len(text) and text[i] != "\n":
                i += 1
            continue
        elif text.startswith("/*", i):
            end = text.find("*/", i + 2)
            i = len(text) if end == -1 else end + 2
            continue
        else:
            out.append(c)
        i += 1
    cleaned = re.sub(r",(\s*[}\]])", r"\1", "".join(out))  # 末尾カンマを外す
    return json.loads(cleaned)
 
def main() -> int:
    src = Path(sys.argv[1]).expanduser() if len(sys.argv) > 1 else Path("~/.config/zed/settings.json").expanduser()
    servers = load_jsonc(src).get("agent_servers", {})
    entry = servers.get("Antigravity")
    if not entry:
        print(f"Antigravity の登録が見つかりません: {src}"); return 1
 
    command = entry.get("command", "agy")
    args = entry.get("args", ["acp"])
    env = entry.get("env", {})
    abs_cmd = command if command.startswith("/") else shutil.which(command)
 
    warnings = []
    if not abs_cmd:
        warnings.append(f"{command} が PATH に見つかりません。JetBrains と Xcode には絶対パスが必要です")
        abs_cmd = "/absolute/path/to/agy"
    if "GEMINI_API_KEY" in env:
        warnings.append("env に GEMINI_API_KEY があります。移行先の設定ファイルへは書き写していません")
    if "--dangerously-skip-permissions" in args:
        warnings.append("--dangerously-skip-permissions が付いています。移行先でも本当に要るか確かめてください")
 
    vscode = {"acp.agents": {"Antigravity": {"command": command, "args": args}}}
    jetbrains = {"agent_servers": {"Antigravity": {"command": abs_cmd, "args": args}}}
 
    print("# VS Code(ACP Client 拡張)の settings.json に足す")
    print(json.dumps(vscode, ensure_ascii=False, indent=2))
    print("\n# JetBrains の ~/.jetbrains/acp.json")
    print(json.dumps(jetbrains, ensure_ascii=False, indent=2))
    print("\n# Xcode > Settings > Intelligence > Add an Agent")
    print(f"Command  : {abs_cmd}")
    print(f"Arguments: {' '.join(args)}")
    for w in warnings:
        print(f"\n⚠️ {w}")
    return 0
 
if __name__ == "__main__":
    sys.exit(main())

コメント付き・末尾カンマ付きのサンプル設定(args に --sandbox、env に GEMINI_API_KEY を入れたもの)で動かすと、出力の最後に次の2行が出ました。

⚠️ agy が PATH に見つかりません。JetBrains と Xcode には絶対パスが必要です
⚠️ env に GEMINI_API_KEY があります。移行先の設定ファイルへは書き写していません

このスクリプトは、あえて二つのことをしません。一つは、API キーを移行先へ書き写さないこと。もう一つは、"type": "custom" を他のエディタへ持ち込まないことです。前者は上で書いた線引きのため、後者は「キー名が同じでも書式は別物」だからです。PATH に agy がない環境では絶対パスの欄がプレースホルダーのまま残るので、which agy の結果で埋めてください。

移したあとに確かめる3つのこと

設定を書き換えたら、エディタごとに次の3つを見ると、取りこぼしに早く気づけます。

  1. 起動するか。 新しいスレッドで Antigravity を選び、短い質問を一つ送ります。起動しないときは、ターミナルで agy acp --help が通るかを見てから、command を絶対パスに替えます。
  2. 権限の確認が出るか。 ファイルの編集やコマンドの実行で Allow / Deny のカードが出れば、権限ルールが CLI 側から効いています。--dangerously-skip-permissions を移行先でも付けるかどうかは、ここで改めて決めます(公式は、サンドボックスか使い捨ての環境に限るよう案内しています)。
  3. ログが残っているか。 うまくいかないときの手がかりは ~/.gemini/antigravity-cli/log/acp-*.log にあります。エディタごとに分けて見たい場合は、args に --log-file で出力先を指定できます。

エディタ側で HTTP の MCP サーバーを設定している場合は、--process-per-session が必要になる点も見落としやすいところです。MCP が見えないときの切り分けは Antigravity の MCP がつながらないときの確かめ方 にまとめています。

エディタは増やしても、エージェントは一つにしておく

個人開発でエディタを使い分けていると、それぞれに設定が散らばり、どれが正しいのか分からなくなる日が来ます。ACP のよいところは、エージェントの中身が Antigravity CLI に一本化されていて、エディタは「窓」にすぎない点なのだと思います。

その窓ごとに違うのは、設定の置き場所、コマンドのパス、そして認証とモデルの3つだけです。まずはいま使っている Zed の settings.json を上のスクリプトに通し、⚠️ が出た行から一つずつ片づけていただければと思います。

シェア

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

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

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

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

⬡ 連携・プラグイン2026-11-06
Conductor を Gemini CLI 拡張から Antigravity CLI のプラグインへ。spec.md と plan.md は動かさず、導入の前後だけ見比べる
Conductor が Gemini CLI の拡張機能からプラグインになり、Antigravity CLI でも使えるようになりました。conductor/ に溜めた spec.md と plan.md は移す必要がなく、導入の前後で何も変わっていないことを確かめる小さなスクリプトと手順をお伝えします。
⟐ Editor View2026-11-17
Zed の SSH 先で Antigravity のサインインが戻ってこない — ブラウザを待たず、端末で先に済ませる
Zed のリモート接続から Antigravity(agy acp)を使うと「Launching browser login flow...」で止まる症状の見分け方と、agy acp --login で SSH 先に資格情報を置く手順、ログの場所、直らないときの次の一手を順番に整理します。
⬡ 連携・プラグイン2026-10-22
プロジェクト直下の mcp_config.json が読まれているのに MCP が立ち上がらない — プローブ 1 本で確かめる
Antigravity CLI のログには project-local の設定ファイルを使うと出るのに、MCP サーバーは起動しない。公式 Issue の経過(2026年11月時点で未解決)、ログの文言が約束していること、起動の有無を確かめる最小のプローブ、似た症状との切り分け表、プロジェクト別に MCP を分ける現実的な選択肢をまとめます。