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

Aktualisiert 2026-10-01

Auf dieser Seite

Auf einen Blick
Hosts, die ACP sprechen
Agenten, die ACP sprechen
Einrichtung: einmal konfigurieren, überall funktionieren
- Claude Code (Anthropic-Zweig)
- Codex CLI (OpenAI-Responses-Zweig)
🔴 Eine häufige Falle: per GUI gestartete Editoren sehen Ihre Shell-Umgebung nicht
Prüfen, dass Datenverkehr QCode erreicht
Weiterführend

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

Auf einen Blick ¶

Punkt	Details
Verfügbare Modelle	abhängig vom eingebundenen Agenten: Claude Agent / Claude Code (Anthropic-Zweig) ✅ · GPT ✅ (Codex-ähnliche Agenten) · Chinesische Modelle ✅ · Gemini agentenabhängig
Protokoll & Basis-URL	wird im Agenten selbst konfiguriert: Anthropic-Zweig `https://api.qcode.cc/api` für Claude-Familien-Agenten
Wo konfigurieren	Umgebung / eigene Konfigurationsdatei des Agenten; der Host startet ihn lediglich
Offizielle Dokumentation	Agent Client Protocol
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 ¶

Host	Hinweise	Unsere Dokumentation
Zed	Native Unterstützung; Sitzungen öffnen im Agenten-Panel	Zed-Einrichtung
Devin Desktop (ehemals Windsurf)	Unterstützt seit 2026-06-02, innerhalb des Agent Command Center	Devin-Desktop-Einrichtung
JetBrains IDEs	Über ein ACP-Plugin	JetBrains IDEs
Neovim / Emacs / Sublime / Qt Creator usw.	im offiziellen Editorenkatalog aufgeführt	—

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-Zweig)¶

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-Zweig)¶

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:

Starten Sie den Editor aus einem Terminal (z. B. zed .), damit er die aktuelle Shell-Umgebung erbt
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.