# T3 Code mit QCode.cc einrichten

> **Zuletzt überprüft**: 2026-11-09 · 📄 Laut offizieller Dokumentation (T3 Code v0.1.7, veröffentlicht am 2026-11-04; die T3-Code-Dokumentation im Hauptzweig wurde am 2026-11-09 gelesen)

## Auf einen Blick

| Punkt | Details |
|---|---|
| Was es ist | T3 Code ist eine „agent harness control surface" mit Desktop-, Web- und Mobil-App. Es steuert die bereits auf Ihrem Rechner vorhandenen Agenten und ist selbst kein Harness |
| Nutzbare Modelle | Claude ✅ (eine auf den Anthropic-Endpunkt gerichtete Claude-Instanz) · Chinesische Modelle (GLM / Kimi / DeepSeek / Qwen) sind auf diesem Endpunkt ebenfalls verfügbar, siehe [Endpunkte und API-Pfade](/docs/getting-started/endpoints-and-api-paths) · GPT ❌ auf diesem Weg · Gemini ❌ (QCode bietet derzeit keine Gemini-Modelle an) |
| Protokoll & Base-URL | Anthropic: `https://api.qcode.cc/api` |
| Wo konfigurieren | **Settings > Providers** → Claude-Instanz → **Environment variables** |
| Offizielle Dokumentation | [T3 Code: Claude-Provider-Anleitung](https://github.com/pingdotgg/t3code/blob/main/docs/user/providers-claude.md) · [FAQ](https://github.com/pingdotgg/t3code/blob/main/docs/user/faq.md) |

## Welches Protokoll

T3 Code ruft selbst keine Modell-API auf. Im offiziellen FAQ heißt es: "T3 Code uses those harnesses. It is not a harness, and it does not work without one." Für Claude ist Claude Code das Harness, daher wird QCode genauso angebunden wie Claude Code selbst: eine Anthropic-Messages-Base-URL und ein QCode-Key.

Die offizielle FAQ beantwortet die Frage, ob statt eines Abos ein API-Key oder OpenRouter genutzt werden kann, mit Ja: Fügen Sie in den Settings eine weitere Provider-Instanz mit eigenen Keys und eigenem Endpunkt hinzu; Ihre Abo-Einrichtung bleibt unverändert.

| Sie möchten | In T3 Code verwenden | QCode-`ANTHROPIC_BASE_URL` |
|---|---|---|
| Claude (`claude-sonnet-5`, `claude-opus-5` …) | Eine Claude-Instanz mit eigenen **Environment variables** | `https://api.qcode.cc/api` |
| Codex / GPT | Eine Codex-Instanz, siehe „Codex-Instanzen" unten | nicht zutreffend |

Claude-Modelle funktionieren nur über das Anthropic-Protokoll, daher endet die Base-URL bei `/api`; `/v1/messages` ergänzt Claude Code selbst. Setzen Sie kein abschließendes `/`. Die vollständige Protokolltabelle finden Sie unter [Endpunkte und API-Pfade](/docs/getting-started/endpoints-and-api-paths).

## Installation

T3 Code benötigt mindestens einen installierten Provider auf dem Rechner, der die Agenten ausführt. Hier ist das Claude Code; installieren Sie es zuerst nach der [QCode-Installationsanleitung](/docs/getting-started/installation). Die Claude-Instanz, die Sie unter „Konfiguration“ anlegen, authentifiziert sich mit Ihrem QCode-Key.

Installieren Sie anschließend T3 Code. Offizielle Befehle:

```bash
curl -fsSL https://t3.codes/install.sh | sh
```

Unter Windows, in PowerShell:

```powershell
irm https://t3.codes/install.ps1 | iex
```

Mit `t3` starten Sie den Server und öffnen die lokale Web-App. Zum einmaligen Ausprobieren ohne Installation genügt `npx t3@latest`. Die Desktop-App erhalten Sie über [GitHub Releases](https://github.com/pingdotgg/t3code/releases) oder einen Paketmanager:

| Plattform | Installation |
|---|---|
| Windows | `winget install T3Tools.T3Code` |
| macOS | `brew install --cask t3-code` |
| Debian, Ubuntu | `sudo apt install ./T3-Code-*.deb` |
| Arch Linux | `yay -S t3code-bin` |

Für Intel-Macs gibt es keine `t3`-Programmdatei; verwenden Sie dort die Desktop-App. Weitere Plattformen und die Mobil-Apps finden Sie in der [offiziellen Installationsanleitung](https://github.com/pingdotgg/t3code/blob/main/docs/user/install.md).

## Konfiguration

Das offizielle Rezept für einen Router mit Anthropic-Protokoll ist eine eigene Claude-Instanz mit eigenem Konfigurationsverzeichnis. Die folgenden Schritte übertragen es auf QCode.

Laut offizieller Installationsanleitung kann jede Provider-Instanz eigene Umgebungsvariablen haben, etwa API-Keys oder eine eigene Base-URL; als sensitive markierte Werte zeigt T3 Code nach dem Speichern nicht mehr an.

1. Öffnen Sie **Settings > Providers** und fügen Sie eine Claude-Instanz hinzu. Belassen Sie **Binary path** auf `claude`. Setzen Sie **CLAUDE_CONFIG_DIR path** auf ein eigenes Verzeichnis; das offizielle OpenRouter-Beispiel nutzt `~/.claude_openrouter`, ein Name wie `~/.claude_qcode` folgt derselben Idee.
2. Ergänzen Sie in den **Environment variables** dieser Instanz:

   | Variable | Wert |
   |---|---|
   | `ANTHROPIC_BASE_URL` | `https://api.qcode.cc/api` |
   | `ANTHROPIC_AUTH_TOKEN` | Ihr QCode-Key (beginnt mit `cr_`), als Sensitive markiert |
   | `ANTHROPIC_API_KEY` | Ein ausdrücklich leerer Wert |

   Variablenzuweisungen gehören in **Environment variables**, nicht in **Launch arguments**.
3. Falls in diesem Claude-Konfigurationsverzeichnis eine Anthropic-Anmeldung zwischengespeichert ist, führen Sie vor dem Start `/logout` in einer Claude-Code-Sitzung mit demselben Verzeichnis aus. Die offizielle Anleitung warnt, dass zwischengespeicherte Anmeldedaten mit dem Router-Token kollidieren können.
4. Wählen Sie das Modell in T3 Code. Für ein Modell außerhalb der eingebauten Liste öffnen Sie die Claude-Instanz in **Settings > Providers** und fügen die vollständige Modell-ID über **Add custom model** hinzu, beispielsweise `claude-sonnet-5` von [qcode.cc/models](https://qcode.cc/models). Wählen Sie sie anschließend in der Modellauswahl des Chats.

Zwei Hinweise aus der offiziellen Anleitung: Variablen `ANTHROPIC_DEFAULT_*_MODEL` ordnen Claude-Code-Aliase wie `sonnet` zu, ersetzen aber nicht die in T3 Code ausdrücklich gewählte Modell-ID. Eigene Modelle können weniger Einstellungen für Effort, Thinking oder Kontext bieten als eingebaute Modelle.

Derselbe Key funktioniert auch auf den anderen QCode-Zugangsdomänen (`us.qcode.cc`, `asia.qcode.cc`): tauschen Sie den Host in `ANTHROPIC_BASE_URL` und behalten Sie den Pfad `/api`. Siehe [Endpunkte und API-Pfade](/docs/getting-started/endpoints-and-api-paths).

### Codex-Instanzen

Die Codex-Anleitung von T3 Code behandelt die Anmeldung mit ChatGPT oder mit einer bestehenden Codex-CLI-Anmeldung. Woher eine Instanz mit installiertem Codex ihre Konfiguration liest, zeigt der Quellcode von T3 Code (Release v0.1.7; der am 2026-11-09 gelesene Hauptzweig hat dieselben Zeilen):

- Für eine Instanz mit installiertem Codex startet T3 Code den App-Server von Codex und setzt `CODEX_HOME` auf den von Ihnen eingetragenen **CODEX_HOME path** (`apps/server/src/provider/CodexProvider.ts`, Zeilen 476–482). Im Beispiel der Codex-Anleitung steht dort `~/.codex`.
- Das im Quellcode enthaltene Schema des Codex-App-Servers beschreibt die Ebene der Nutzerkonfiguration als `$CODEX_HOME/config.toml` (`packages/effect-codex-app-server/src/_generated/schema.gen.ts`, Zeile 19730).
- Die Verbindung mit ChatGPT innerhalb von T3 Code ist anders: T3 Code setzt dort einen eigenen `model_provider` und entfernt `OPENAI_BASE_URL` (`apps/server/src/provider/CodexManagedRuntime.ts`, Zeilen 24–26 und 124), sodass QCode-Einstellungen dort nicht greifen.

In T3 Code v0.1.7 liest eine Codex-Instanz mit Ihrer vorhandenen Codex-Installation also die `config.toml` ihres Codex-Home. Richten Sie Codex zuerst nach der [Codex-Anleitung](/docs/ide/codex) für QCode ein: den Provider `qcode` in `~/.codex/config.toml` und Ihren Key als `OPENAI_API_KEY` in `~/.codex/auth.json`. Fügen Sie dann unter **Settings > Providers** eine Codex-Instanz hinzu, wählen Sie **Configure manually** und schließen Sie den Assistenten ab; der **CODEX_HOME path** der Instanz zeigt auf das Verzeichnis mit diesen beiden Dateien (zum Beispiel `~/.codex`). Wählen Sie die Instanz anschließend in der Modellauswahl des Threads.

## Verbindung überprüfen

1. Starten Sie einen neuen Thread, wählen Sie die Claude-Instanz und das eigene Modell und senden Sie eine kurze Nachricht wie `ping`.
2. Öffnen Sie [probe.qcode.cc](https://probe.qcode.cc), geben Sie Ihren QCode-Key ein und prüfen Sie, dass die Anfrage mit dem gewählten Modell erscheint. Das entspricht dem offiziellen Rat, das Modell im Aktivitäts-Dashboard des Routers zu kontrollieren.
3. Um Key und Pfad ohne T3 Code zu prüfen:

```bash
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
```

## Fehlerbehebung

| Symptom | Ursache | Lösung |
|---|---|---|
| Der Provider erscheint nicht | Die CLI ist nicht installiert oder nicht im `PATH` des Rechners mit dem Server | Installieren Sie `claude` dort oder setzen Sie **Binary path** in den Provider-Einstellungen (offizielles FAQ) |
| `Invalid API key` | Falscher Key oder überflüssige Leerzeichen | Prüfen Sie das Präfix `cr_`, setzen Sie den Key in `ANTHROPIC_AUTH_TOKEN` und lassen Sie `ANTHROPIC_API_KEY` leer |
| Authentifizierungsfehler trotz richtigem Key | Eine zwischengespeicherte Anthropic-Anmeldung im selben Claude-Konfigurationsverzeichnis | Führen Sie `/logout` in einer Claude-Code-Sitzung mit diesem Verzeichnis aus oder geben Sie der Instanz ein neues Konfigurationsverzeichnis |
| 404 | Abschließendes `/` oder `/v1/messages` in der Base-URL | Verwenden Sie genau `https://api.qcode.cc/api` |
| Die Anfrage wird wegen des Modells abgelehnt | In der Claude-Instanz wurde eine GPT-Modell-ID gewählt; der Anthropic-Endpunkt bietet kein GPT | Verwenden Sie dort eine Claude- oder eine chinesische Modell-ID; GPT läuft über Codex |
| Das Modell fehlt in der Auswahl | Es ist nicht in der eingebauten Liste | Fügen Sie die vollständige ID über **Add custom model** hinzu |
| 402 mit `*_cost_limit_exceeded` | Die Quote des Keys ist aufgebraucht | Siehe [Fehlercodes](/docs/reference/errors#402-quota-exhausted) |

## Bekannte Einschränkungen

- T3 Code beschreibt sich selbst als sehr frühe Software: "We are very very early in this project. Expect bugs."
- Die Router-Einrichtung der offiziellen Anleitung ist für Claude-Instanzen geschrieben; GPT-Modelle laufen über eine Codex-Instanz, wie oben unter „Codex-Instanzen“ beschrieben.
- Bei einer entfernten Verbindung nutzt T3 Code die Claude-Konfiguration auf dem verbundenen Server; richten Sie die Instanz daher auf diesem Rechner ein.

## Weiterführende Dokumentation

- [Endpunkte und API-Pfade](/docs/getting-started/endpoints-and-api-paths) — Tabelle „Protokoll × Modellfamilie"
- [Übersicht der Tool-Kompatibilität](/docs/ide/tool-compatibility) — welches Tool welches Protokoll spricht
- [Codex CLI](/docs/ide/codex) — `config.toml` für QCode
- [DeepSeek Harness (dsh)](/docs/ide/deepseek-harness) — ein Agent-Harness mit eigenem Formular für die Modell-API