T3 Code mit QCode.cc einrichten

Verbinden Sie T3 Code v0.1.7 mit QCode.cc: ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN in der Claude-Instanz setzen, ein eigenes Modell hinzufügen und prüfen.

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

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¶

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.

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.

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. Die Claude-Instanz, die Sie unter „Konfiguration“ anlegen, authentifiziert sich mit Ihrem QCode-Key.

Installieren Sie anschließend T3 Code. Offizielle Befehle:

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

Unter Windows, in 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 oder einen Paketmanager:

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.

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:

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. 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.

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 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, 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:

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¶

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 — Tabelle „Protokoll × Modellfamilie"
• Übersicht der Tool-Kompatibilität — welches Tool welches Protokoll spricht
• Codex CLI — config.toml für QCode
• DeepSeek Harness (dsh) — ein Agent-Harness mit eigenem Formular für die Modell-API

Enterprise →