ACP-Übersicht

Agent Client Protocol: eine Einrichtung, die mit Zed, Devin Desktop und JetBrains funktioniert – Claude Code als ACP-Agent ausführen, dessen Umgebung auf QCode zeigt

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Zuletzt überprüft: 2026-10-15 · 📄 Gemäß offizieller Dokumentation (agentclientprotocol.com, am selben Tag geprüft)

Auf einen Blick¶

Der Agent Client Protocol (ACP) ist ein offener Standard, der Editoren von KI-Agenten entkoppelt — denken Sie an LSP, aber für Agenten. Jeder Editor, der ACP spricht, kann jeden Agenten hosten, der ACP spricht, ohne maßgeschneiderte Integration pro Agent.

Für QCode-Nutzer hat dies eine sehr praktische Konsequenz:

🔑 Konfigurieren Sie den Agenten selbst (z. B. die Claude Code CLI) gegen QCode, und jeder Host folgt automatisch. ACP-Hosts starten den Agenten als Kindprozess, sodass er Ihre Umgebung erbt. Sobald ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN gesetzt sind, leiten Sitzungen in Zed, Devin Desktop und JetBrains alles über QCode weiter — Sie müssen die Einrichtung nicht pro Editor wiederholen.

Hosts, die ACP sprechen¶

Agenten, die ACP sprechen¶

Bemerkenswerte Einträge sind Claude Agent (der Name im offiziellen Registry – der ACP-Wrapper des Claude Agent SDK, claude-agent-acp) und OpenCode; der vollständige Katalog befindet sich auf agentclientprotocol.com. Alles, was ACP implementiert, kann eingebunden werden. Jeder Host liefert seinen eigenen Adapter und Startbefehl mit, daher halten Sie sich an die Dokumentation des Hosts.

Einrichtung: einmal konfigurieren, überall funktionieren¶

Claude Code (Anthropic-Endpunkt)¶

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_qcode_key"

Persistieren Sie sie in ~/.zshrc / ~/.bashrc. Aus Festlandchina verwenden Sie https://asia.qcode.cc/api.

Sie können sie auch in den env-Block von ~/.claude/settings.json setzen, für denselben Effekt. Siehe Umgebungsvariablen.

Codex CLI (OpenAI-Responses-Endpunkt)¶

Codex wird über TOML konfiguriert, wobei base_url bei /openai endet. Siehe den Codex-Leitfaden.

🔴 Eine häufige Falle: per GUI gestartete Editoren sehen Ihre Shell-Umgebung nicht¶

Auf macOS und Linux liest ein Editor, der vom Dock, einem Launcher oder einem Desktop-Symbol gestartet wird, nicht ~/.zshrc. Das Symptom: claude erreicht QCode aus dem Terminal, aber die ACP-Sitzung im Editor kann sich nicht authentifizieren.

Zwei Möglichkeiten zur Lösung:

1. Starten Sie den Editor aus einem Terminal (z. B. zed .), damit er die aktuelle Shell-Umgebung erbt
2. Legen Sie die Konfiguration in die eigene Konfigurationsdatei des Agenten statt in ein Shell-Profil (Claude Code: der env-Block von ~/.claude/settings.json)

Option 2 ist robuster, da sie nicht davon abhängt, wie der Editor gestartet wurde.

Prüfen, dass Datenverkehr QCode erreicht¶

KEY="cr_your_qcode_key"
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01"
# 400 = path and key are both fine (a missing body is expected); 401 = key problem

Sobald der Endpunkt überprüft ist, öffnen Sie eine Sitzung im Host. Wenn sie weiterhin fehlschlägt, liegt das Problem darin, wie der Host den Agenten startet (normalerweise die obige Umgebungsfalle), nicht in QCode.

Jede Anfrage über QCode wird an probe.qcode.cc gemeldet — geben Sie Ihren API-Key ein, um zu bestätigen, dass Anfragen tatsächlich ankommen.

Wie ACP den Agenten startet: warum Umgebungsvariablen „vererbt“ werden¶

Stand 2026-10-15 gilt laut offizieller ACP-Dokumentation zum Transport: ACP kodiert Nachrichten als JSON-RPC, und beim empfohlenen stdio-Transport startet der Client (der Editor) den Agenten als Unterprozess; der Agent liest JSON-RPC-Nachrichten von der Standardeingabe und schreibt Nachrichten auf die Standardausgabe, getrennt durch Zeilenumbrüche, und darf Logs auf die Standardfehlerausgabe (stderr) schreiben. Außerdem verbietet das Protokoll dem Agenten, etwas auf stdout auszugeben, das keine gültige ACP-Nachricht ist.

Für die Fehlersuche folgen daraus zwei Dinge:

• Ein Unterprozess erbt standardmäßig die Umgebung dessen, der ihn gestartet hat. Ob ein in Ihrer Shell gesetztes ANTHROPIC_BASE_URL wirkt, hängt also davon ab, wie der Editor selbst gestartet wurde (siehe oben die Falle beim Start über die grafische Oberfläche).
• Wenn Sie den Agenten in ein eigenes Skript einpacken, geben Sie darin keine Begrüßungen oder Debug-Ausgaben per echo auf stdout aus, sonst gelten sie als ungültige Nachrichten; solche Ausgaben gehören nach stderr.

Wichtige Einstellungen¶

Häufige Fehler und Fehlersuche¶

FAQ¶

Muss ich QCode in jedem Editor einzeln einrichten?¶

Nein. Sie konfigurieren den Agenten selbst (z. B. Claude Code), der Editor startet ihn nur. Ist der Agent mit QCode verbunden, nutzen ACP-Sitzungen in Zed, Devin Desktop und JetBrains dieselbe Konfiguration.

In welchem Verhältnis steht ACP zu LSP?¶

Die Idee ist ähnlich: LSP entkoppelt Editoren von Sprachservern, ACP entkoppelt Editoren von KI-Agenten. Ein Editor, der ACP spricht, kann jeden Agenten einbinden, der ACP spricht, ohne dass für jeden eine eigene Integration nötig wäre.

Wie prüfe ich, ob ein über das Dock gestarteter Editor die Umgebungsvariablen erhalten hat?¶

Öffnen Sie im Editor eine ACP-Sitzung und senden Sie eine Nachricht, geben Sie dann Ihren Schlüssel auf probe.qcode.cc ein und prüfen Sie, ob die Anfrage erscheint. Falls nicht, haben die Variablen den Agenten nicht erreicht; tragen Sie die Konfiguration stattdessen in den env-Block von ~/.claude/settings.json ein.

Kann ich in ACP-Sitzungen GPT nutzen?¶

Das hängt vom eingebundenen Agenten ab. Agenten der Claude-Familie nutzen nur die Anthropic-Schnittstelle, mit Claude und chinesischen Modellen. Für GPT binden Sie einen Agenten im Codex-Stil ein und richten dessen base_url wie bei Codex auf https://api.qcode.cc/openai. QCode bietet derzeit keine Gemini-Modelle an.

Welche Domain nutze ich in Festlandchina?¶

Ersetzen Sie api.qcode.cc durch asia.qcode.cc (der Asien-Zugangspunkt); der Schlüssel bleibt gleich. Bei Instabilität wechseln Sie zurück.

Weiterführend¶

• Endpunkte & API-Pfade — Protokoll × Modellfamilie-Tabelle
• Umgebungsvariablen
• Zed-Einrichtung · Devin-Desktop-Einrichtung · JetBrains IDEs

Enterprise →