このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。英語版

ACP（Agent Client Protocol）の基本手順

ステータス: 現行
対象範囲: IDE ホスト向けに文書化された基本手順
最終確認: 2026-07-12 所有者: AX Code runtime

AX Code は ACP サーバーを公開し、IDE（たとえば Zed）が独自のトランスポートなしでエージェントをホストできるようにします。

要件

サポートされる CLI インストール（PATH 上の ax-code）
設定済みのプロバイダー（ax-code providers login または環境変数のキー）

サーバーを開始する

# Current directory as workspace
ax-code acp

# Explicit workspace
ax-code acp --dir /path/to/project

初期化、セッション、プロンプト（stdio）

ACP は stdio 上の JSON-RPC です。最小の基本手順は次のとおりです。

# One-shot style example (hosts normally keep the process open)
printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{}}}' \
  | ax-code acp

典型的なホストの順序は次のとおりです。

initialize — プロトコル版とエージェント能力を交渉します
session/new — cwd をプロジェクトルートに設定してセッションを作ります
session/prompt — ユーザーのテキストを送ります。エージェントがツールを実行し、停止理由を返します
session/load — ホストが知っているセッション ID を再開します

Zed の例

{
  "agent_servers": {
    "AX Code": {
      "command": "ax-code",
      "args": ["acp"]
    }
  }
}

現在動くもの

能力	状態
initialize / capabilities	対応
session/new	対応
session/prompt	対応（応答の前にセッションが完了する）
session/load	セッション ID とモード復元に対応
クライアントのファイル読み書き	対応
ストリーミング `session/update`	部分的。完全な漸進ストリームではない
完全なターミナルブリッジ	プレースホルダー

詳細と限界は packages/ax-code/src/acp/README.md です。

任意の対話的な質問

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

ホストの UI が質問プロンプトに答えられるときだけ有効にしてください。