Zed Editor einrichten

Verbinden Sie QCode.cc über das Agent Client Protocol (ACP) oder settings.json mit dem Zed-Editor – für das Opus 5 / 4.8 / 4.7 Agent-Panel mit 1M-Kontext und OpenAI-kompatible Anbieter

Zuletzt überprüft: 2026-09-18 · 📄 Laut offizieller Dokumentation (Zed Stable v1.20.2, veröffentlicht am 2026-09-17)

Auf einen Blick¶

QCode verwendet durchgehend einen einzigen API-Key (beginnt mit cr_). Derselbe Key unterstützt die Anthropic-, OpenAI-Chat-, OpenAI-Responses-, Gemini- und Bildprotokolle und wird auf drei Eingangsdomänen gemappt – api / asia / us (Nutzer in Festlandchina sollten asia.qcode.cc bevorzugen).

Warum Zed¶

• Native ACP-Integration: Claude Code-Sitzungen im Agent-Panel öffnen und die Überlegungen sowie Tool-Aufrufe des Agenten live im Editor verfolgen
• 1M Kontext: BYOK-Modus unterstützt das volle 1M-Token-Kontextfenster von Opus 5 / 4.8 / 4.7
• Rust-Performance: extrem schneller Kaltstart und ein um eine Größenordnung geringerer Speicherbedarf als VS Code / Electron-basierte Editoren
• Multi-Pane-Layout: Editor + Terminal + Agent-Panel nebeneinander für einen kompakten Workflow
• Zwei Integrationswege: Ausführung über die Claude Code CLI (volle Tool-Oberfläche) oder QCode als eingebauten Anbieter in settings.json hinzufügen

Die zwei Integrationswege im Vergleich¶

Zed bietet zwei komplementäre Wege, QCode zu erreichen – wählen Sie je nach Bedarf:

Der Abschnitt „Konfiguration“ unten behandelt Weg A; „Anbieter in settings.json konfigurieren“ behandelt Weg B.

Voraussetzungen¶

• Zed installiert (macOS / Linux)
• Claude Code CLI installiert (Zeds ACP-Integration nutzt die CLI als Backend; überspringen Sie diesen Schritt, wenn Sie nur Weg B verwenden)
• Ein QCode.cc API-Key (beginnt mit cr_), verfügbar im Dashboard
• Claude Code CLI ist bereits mit QCode-Umgebungsvariablen konfiguriert (siehe Schnellstart)

Konfigurationsschritte (Pfad A: ACP / Claude Code)¶

Schritt 1: Prüfen, ob die Claude Code CLI im Terminal funktioniert¶

Zed startet ACP, indem ein claude-Prozess erzeugt wird, daher prüfen Sie zuerst im Terminal, ob die CLI funktioniert:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_xxxxxxxx"
claude --version   # should print a version number (trust this machine + official Releases)
echo "ping" | claude   # simple echo test

ANTHROPIC_BASE_URL darf nicht mit einem Schrägstrich enden; das Anthropic SDK hängt /v1/messages selbst an. Verankern Sie diese beiden Umgebungsvariablen dauerhaft in Ihrer Shell-Konfiguration (~/.zshrc / ~/.bashrc), damit Zed sie beim Start erbt.

Schritt 2: Das Agent-Panel in Zed öffnen¶

• macOS: Cmd + ?
• Linux: Ctrl + ?

Beim ersten Öffnen bittet Sie Zed, einen Agent-Anbieter auszuwählen — wählen Sie Claude Code (wählen Sie nicht BYOK Anthropic API; dieser Pfad umgeht die CLI und erfordert, dass Sie in den Zed-Einstellungen separat eine Basis-URL eintragen — siehe Pfad B).

Schritt 3: Die Agent-Sitzung überprüfen¶

Geben Sie in die Eingabe des Agent-Panels ein: „List the exported symbols in the current file.“ Zed übergibt die aktuell geöffnete Datei als Kontext an Claude Code, und der Agent ruft die Tools read / grep auf, um zu analysieren und zu antworten.

Falls der Agent-Prozess nicht startet, kann der ACP-Agent-Befehl über agent_servers.<name>.command / args / env in settings.json explizit festgelegt werden (es gibt keinen Einstellungs-Schlüssel agent.path). Namen und Felder: richten Sie sich nach der offiziellen Dokumentation.

Die Agent- / Assistant-Einstellungen von Zed ändern sich zwischen Releases schnell; für exakte Schlüsselnamen gilt die offizielle Zed-Dokumentation.

Einen Anbieter in settings.json konfigurieren (Pfad B)¶

Wenn Sie die CLI lieber nicht installieren, fügen Sie QCode in settings.json hinzu — die JSON-Datei selbst öffnen Sie mit Cmd+Alt+, (Ctrl+Alt+, unter Linux; Cmd+, öffnet die Einstellungen-Benutzeroberfläche); sie liegt unter ~/.config/zed/settings.json (Windows: %APPDATA%/Zed/settings.json) und wird ohne Neustart angewendet. Für Drittanbieter-Gateways sind die offiziell empfohlenen Einträge die benutzerdefinierten Anbieter anthropic_compatible / openai_compatible. QCode spricht beide Protokolle mit dem gleichen cr_-Schlüssel.

Anthropic-kompatibler Anbieter¶

Richten Sie die Basis des in Zed integrierten Anthropic-Anbieters auf QCodes Anthropic-Endpunkt:

{
  "language_models": {
    "anthropic_compatible": {
      "QCode": {
        "api_url": "https://api.qcode.cc/api"
      }
    }
  }
}

Stellen Sie den Schlüssel über eine Umgebungsvariable bereit (von Zed beim Start geerbt):

export QCODE_API_KEY="cr_xxxxxxxx"

Das integrierte language_models.anthropic.api_url existiert ebenfalls und funktioniert, aber der in der Upstream-Dokumentation genannte Einstiegspunkt für Drittanbieter-Gateways ist der oben gezeigte anthropic_compatible-Anbieter. Die Basis-URL endet auf /api — kein /v1 — Zed hängt /v1/messages selbst an. Platzieren Sie keine API-Keys in settings.json (offizielle Regel); verwenden Sie die generierte Variable <PROVIDER_NAME>_API_KEY.

OpenAI-kompatibler Anbieter¶

Zed unterstützt auch einen OpenAI-kompatiblen Anbieter, der QCodes GPT-Modelle erreichen kann. Richten Sie die Basis auf QCodes OpenAI-Chat-Endpunkt:

{
  "language_models": {
    "openai_compatible": {
      "QCodeOpenAI": {
        "api_url": "https://api.qcode.cc/openai/v1",
        "available_models": [
          { "name": "gpt-5.6-terra" },
          { "name": "gpt-5.6" },
          { "name": "glm-5.3" },
          { "name": "deepseek-v4-flash" }
        ]
      }
    }
  }
}

Der Schlüssel stammt ebenfalls aus einer Umgebungsvariable:

export QCODEOPENAI_API_KEY="cr_xxxxxxxx"

Die OpenAI-Chat-Basis ist https://api.qcode.cc/openai/v1 (das SDK hängt dann /chat/completions an). Kein abschließender Schrägstrich. Die Feldnamen in available_models (name / max_tokens usw.) sollten sich nach der offiziellen Zed-Dokumentation richten.

Modellauswahl¶

Derselbe QCode-API-Key stellt Modelle mehrerer Anbieter bereit. Wechseln Sie bei Bedarf über das Modellauswahlmenü im Agent-Panel oder im Assistenten:

Welcher Anbieterpfad: claude-* funktioniert nur beim Anthropic-Anbieter (https://api.qcode.cc/api); gpt-* funktioniert nur beim OpenAI-Anbieter (https://api.qcode.cc/openai/v1). Eine Mischung liefert model_not_available_on_endpoint.

Die obige Tabelle entspricht der aktuellen Empfehlung. 4.x-IDs wie claude-sonnet-4-6, claude-opus-4-8 und claude-opus-4-7 sind weiterhin erhältlich; die aktuelle Liste finden Sie unter qcode.cc/models.

• Bei Pfad A (Claude Code) wird das Modell durch die Konfiguration von Claude Code selbst bestimmt (Wechsel über /model oder setzen von ANTHROPIC_MODEL).
• Bei Pfad B mit dem Anthropic-Anbieter verwenden Sie claude-*-Modell-IDs; beim OpenAI-Anbieter gpt-*-Modell-IDs.
• Die Gemini- und Bildprotokolle (gpt-image-2) sind im Zed-Assistenten nicht unbedingt nativ verfügbar; rufen Sie sie direkt über die CLI / Skripte auf – siehe Endpunkte und API-Pfade und gpt-image-2 Bildgenerierung.

Nutzungsbeispiele¶

Agent-Panel: Dateiübergreifende Aufgaben¶

Das Agent-Panel spielt seine Stärken bei mehrstufigen, dateiübergreifenden Aufgaben aus. Beispiel:

„Konvertieren Sie alle synchronen IO-Aufrufe unter utils/ zu async und aktualisieren Sie die Aufrufer.“

Das Agent verwendet grep zum Auffinden, read zum Prüfen und edit zum Ändern und zeigt die Diffs Schritt für Schritt im Editor an, sodass Sie jeden einzelnen Diff akzeptieren / ablehnen können.

Screenshots für das Agent-Panel bereitstellen (Vision-Eingabe)¶

Claude Opus 5 / Sonnet 5 und GPT-5.x sind alle vision-fähig. Sie können UI-Mockups, Fehler-Screenshots oder Architekturdiagramme als Eingabe an das Agent übergeben:

• Bild einfügen (Ctrl+V) oder per Drag-and-Drop in die Eingabezeile des Agent-Panels ziehen
• Alternativ einen lokalen Bilddateipfad in Ihrer Eingabeaufforderung referenzieren

Typische Anwendungsfälle: UI aus einem Mockup erstellen, Debugging anhand eines Fehler-Screenshots, Architekturdiagramme / Charts lesen.

Hinweis: Hier geht es um das Bereitstellen von Bildern für das Modell (Vision-Eingabe), nicht um das Generieren von Bildern. Verwenden Sie zum Generieren von Bildern gpt-image-2 – siehe gpt-image-2 Bildgenerierung.

Dynamische Workflows (Orchestrierung von Hintergrund-Sub-Agents)¶

Claude Code unterstützt Dynamische Workflows: Orchestrieren Sie Dutzende bis Hunderte von Hintergrund-Sub-Agents, ideal für codebase-weite Reviews, Migrationen und Rechercheaufgaben. Auslösen, indem Sie das Schlüsselwort ultracode in Ihre Eingabeaufforderung aufnehmen oder einfach „run a workflow“ anfordern; aktive Läufe anzeigen über den Befehl /workflows. Sub-Agents laufen im Hintergrund weiter, während Sie andere Aufgaben erledigen. Der Workflow verwendet das Modell, das in Claude Code konfiguriert ist – er funktioniert also auch, wenn Claude Code auf QCode zeigt. Weiterführende Informationen: Subagents.

Headless / Automations-Ausgabeformate¶

Wenn Sie Claude Code in CI / Skripten aufrufen, verwenden Sie claude -p mit --output-format:

# JSON: one structured object with result / total_cost_usd / usage / session_id
claude -p "Summarize this change" --output-format json | jq .result

# stream-json: newline-delimited JSON event stream, good for real-time pipelines
claude -p "Refactor this module" --output-format stream-json

# text: plain text (default)
claude -p "Explain this code" --output-format text

Weitere Verwendungsmöglichkeiten finden Sie unter Automatisierung & CI/CD.

Fallback-Endpunkte¶

Ist der primäre Endpunkt nicht erreichbar, wechseln Sie ANTHROPIC_BASE_URL (oder api_url in settings.json):

Für den OpenAI-kompatiblen Pfad tauschen Sie die Domain auf dieselbe Weise – z. B. lautet die Asien-OpenAI-Chat-Basis-URL https://asia.qcode.cc/openai/v1. Die vollständige Endpunkt-Referenz finden Sie unter Endpunkte und API-Pfade.

Gemeinsames Kontingent¶

Der Claude Code Agent in Zed nutzt denselben QCode API-Key und dasselbe Kontingent wie die CLI / Claude Desktop / Codex CLI – es erfolgt keine doppelte Abrechnung. Pfad A und Pfad B teilen sich ebenfalls dasselbe Kontingent des Keys. Details finden Sie unter Abrechnung.

Einschränkungen und Hinweise¶

• Zeds BYOK-Anthropic-Direktmodus nutzt Zeds integrierten Anthropic-Anbieter und läuft nicht über die Claude Code CLI. Dafür müssen Sie api_url in den Zed-Einstellungen manuell auf QCode setzen (Pfad B). Der hier beschriebene ACP-/Claude-Code-Modus (Pfad A) wird bevorzugt – er erhält die volle CLI-Tool-Oberfläche (Hooks, Skills, MCP).
• Die Basis-URL darf keinen abschließenden Schrägstrich enthalten. Eine Self-Check-Anfrage an einen Basispfad gibt 401 zurück, was erwartet wird (der Pfad ist korrekt, es fehlt lediglich die Authentifizierung).
• Die ACP-Integration befindet sich in der Public Beta (seit 2026-04); einzelne APIs können sich noch ändern. Bei Abweichungen im Verhalten ist die offizielle Zed-Dokumentation maßgeblich.
• Linux-Sandbox-Nutzer: Ist Zed über Flatpak installiert, kann das Starten des claude-Subprozesses durch die Sandbox blockiert werden. Wir empfehlen, direkt den .deb- / AppImage- / Homebrew-Build zu installieren.
• Die Gemini CLI wurde eingestellt (EOL 2026-06-18 für Pro/Free; Enterprise-bezahlte Keys sind nicht betroffen); ihr Nachfolger ist die Google Antigravity CLI. Hinweis: Die Antigravity CLI akzeptiert ausschließlich einen Gemini-kompatiblen Endpunkt (über GOOGLE_GEMINI_BASE_URL), keinen OpenAI-kompatiblen – siehe Antigravity CLI.

FAQ¶

Agent-Panel meldet „Failed to start agent“¶

• Startet claude korrekt in Ihrem Terminal? Schließen Sie zunächst Konfigurationsprobleme auf CLI-Seite aus.
• Hat Zed die ANTHROPIC_*-Umgebungsvariablen geerbt? Unter macOS gewährleisten Sie die Vererbung, wenn Sie Zed über open -a Zed vom Terminal aus starten.
• Zeigt agent.path in Ihren Einstellungen auf einen gültigen Pfad? Prüfen Sie dies mit which claude.

settings.json-Provider liefert 401 / Authentifizierungsfehler¶

• Stellen Sie sicher, dass die richtige Umgebungsvariable gesetzt ist und einen cr_-präfixierten QCode-Key enthält: Benutzerdefinierte Anbieter verwenden <PROVIDER_NAME>_API_KEY (z. B. QCODE_API_KEY / QCODEOPENAI_API_KEY); nur integrierte Anbieter verwenden ANTHROPIC_API_KEY / OPENAI_API_KEY.
• Hat Zed diese Umgebungsvariable geerbt? Starten Sie Zed vom Terminal aus, um dies zu überprüfen.
• Enthält api_url versehentlich einen abschließenden Schrägstrich? Entfernen Sie ihn.

Das gewünschte Modell ist nicht im Dropdown enthalten¶

• Der OpenAI-Provider von Pfad B erfordert, dass Modelle explizit in available_models aufgeführt sind, bevor sie im Dropdown erscheinen.
• Die verfügbaren Modelle von Pfad A werden durch Claude Code bestimmt; verwenden Sie /model, um sie anzuzeigen und zu wechseln.

„Invalid model“ / 404¶

• Überprüfen Sie erneut, ob die Schreibweise der Modell-ID exakt mit der Tabelle übereinstimmt (z. B. claude-opus-5, gpt-6-luna).
• Stellen Sie sicher, dass das Protokoll der Basis-URL zum Modell passt: claude-* verwendet den Anthropic-Endpunkt, gpt-* den OpenAI-Endpunkt.

Unterschied zum BYOK-Anthropic-Modus¶

Nächste Schritte¶

• Claude Code Tutorial – vollständige CLI-Funktionsreferenz
• Endpunkte und API-Pfade – vollständige Referenz aller drei Ingress-Domains
• Subagents – Dynamic Workflows und Multi-Agent-Orchestrierung
• Automatisierung & CI/CD – Headless-Modus und Ausgabeformate
• gpt-image-2 Bildgenerierung – Bildgenerierung (unterschiedlich zu Vision-Eingabe)
• VS Code Integration – Vergleich mit Electron-basierten Editoren
• Abrechnung – Regeln zum gemeinsamen Kontingent

Aktuelle Preise und Kontextspezifikationen für jedes Modell finden Sie auf der QCode-Preisseite.