# ACP-Übersicht

> **Zuletzt überprüft**: 2026-09-18 · 📄 Gemäß offizieller Dokumentation ([agentclientprotocol.com](https://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](https://agentclientprotocol.com)
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](/docs/ide/zed) |
| Devin Desktop (ehemals Windsurf) | Unterstützt seit 2026-06-02, innerhalb des Agent Command Center | [Devin-Desktop-Einrichtung](/docs/ide/devin-desktop) |
| JetBrains IDEs | Über ein ACP-Plugin | [JetBrains IDEs](/docs/ide/jetbrains) |
| Neovim / Emacs / Sublime / Qt Creator usw. | im offiziellen Editorenkatalog aufgeführt | — |

## 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](https://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)

```bash
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](/docs/getting-started/environment).

### Codex CLI (OpenAI-Responses-Zweig)

Codex wird über TOML konfiguriert, wobei `base_url` bei `/openai` endet. Siehe [den Codex-Leitfaden](/docs/ide/codex).

## 🔴 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

```bash
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](https://probe.qcode.cc) gemeldet — geben Sie Ihren API-Key ein, um zu bestätigen, dass Anfragen tatsächlich ankommen.

## Weiterführend

- [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths) — Protokoll × Modellfamilie-Tabelle
- [Umgebungsvariablen](/docs/getting-started/environment)
- [Zed-Einrichtung](/docs/ide/zed) · [Devin-Desktop-Einrichtung](/docs/ide/devin-desktop) · [JetBrains IDEs](/docs/ide/jetbrains)