Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

ACP (Agent Client Protocol) – der direkte Weg

Status: Aktiv
Geltungsbereich: dokumentierter direkter Weg für Hosts von IDEs
Zuletzt geprüft: 2026-07-12 Verantwortlich: AX Code runtime

AX Code stellt einen Server für ACP bereit, damit IDEs, zum Beispiel Zed, den Agenten ohne einen eigenen Transport aufnehmen können.

Anforderungen

• Unterstützte Installation der CLI (ax-code im PATH)
• Ein eingerichteter Anbieter (ax-code providers login oder Schlüssel der Umgebung)

Den Server starten

# Current directory as workspace
ax-code acp

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

Initialisieren, Sitzung und Prompt (stdio)

ACP nutzt JSON-RPC über stdio. Der minimale direkte Weg:

# 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

Übliche Folge beim Host:

1. initialize — Version des Protokolls und Fähigkeiten des Agenten aushandeln
2. session/new — eine Sitzung anlegen und cwd auf die Wurzel des Projekts setzen
3. session/prompt — Ihren Text senden; der Agent führt Werkzeuge aus und gibt einen Grund für den Stopp zurück
4. session/load — eine dem Host bekannte Kennung der Sitzung fortsetzen

Beispiel mit Zed

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

Was heute funktioniert

Einzelheiten und Grenzen: packages/ax-code/src/acp/README.md.

Optionale Fragen im Dialog

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

Schalten Sie das nur ein, wenn die Oberfläche des Hosts Rückfragen beantworten kann.