Ein Gateway für 3 Coding-CLIs (2026): Einrichtung & Fehlerbehebung — Gemini CLI, Codex CLI, Claude Code

Wenn Sie täglich Coding-CLIs verwenden, wird der Einrichtungsaufwand zu echten Kosten: mehrere API-Keys, unterschiedliche Konfigurationsformate, Auth-Konflikte und die klassische 401/429/Stream-Hänger-Schleife.

Wünschen Sie den kürzesten Weg? Nutzen Sie die speziellen Integrationsleitfäden (empfohlen):

• Claude CLI / Claude Code
• Codex CLI
• Gemini CLI

Hier starten (Schnellste Einrichtung)

Wählen Sie Ihr Tool und folgen Sie dem speziellen Leitfaden, der oben in der Einleitung verlinkt ist.

TL;DR: 5-Minuten-Checkliste (Wählen Sie Ihr Tool)

Hinweis: Einige CLIs erfordern leicht unterschiedliche Endpunkt-Formate (z. B. /v1 oder ein abschließender Schrägstrich). Folgen Sie dem Leitfaden des jeweiligen Tools für das exakte Format, das die CLI erwartet.

Warum Coding-CLIs über einen Gateway-Host routen?

Nutzen Sie ein Gateway oder einen Router, wenn Sie einen oder mehrere dieser Punkte wünschen:

1. Schluss mit dem Key-Jonglieren in mehreren Tools.
2. Modelle/Anbieter wechseln, ohne Tool-Konfigurationen neu schreiben zu müssen.
3. Traffic an einem Ort bündeln für operative Kontrollen (Retries/Timeouts/Auditing).
4. Workflow stabil halten, während sich Tools und Anbieter weiterentwickeln.

Dieser Leitfaden konzentriert sich auf die Einrichtung und die operative Realität: was kaputtgeht und wie man es repariert.

Entscheidungstabelle: Direkt zum Anbieter vs. ein Gateway-Host

Bevor Sie sich festlegen, hier der reale Abgleich für die Produktion.

Pfad A — Codex CLI (Benutzerdefinierter Anbieter via config.toml)

Minimale Schritte

1. Installieren:

   npm install -g @openai/codex

2. API-Key setzen:

   export OPENAI_API_KEY="IHR_EVOLINK_KEY"

3. Konfiguration ~/.codex/config.toml erstellen oder bearbeiten.

4. Verifizieren:

   codex "Who are you"

Minimaler config.toml Ausschnitt (Beispiel)

model = "gpt-5.2"
model_provider = "evolink"

[model_providers.evolink]
name = "EvoLink API"
base_url = "https://api.evolink.ai/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Pfad B — Claude Code / Claude CLI (settings.json + Anthropic Basis-URL)

Minimale Schritte

1. Installieren:

   npm install -g @anthropic-ai/claude-code

2. ~/.claude/settings.json bearbeiten.

3. Verifizieren:

   claude "Who are you"

Minimaler settings.json Ausschnitt (Beispiel)

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "IHR_EVOLINK_KEY",
    "ANTHROPIC_BASE_URL": "https://api.evolink.ai",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": { "allow": [], "deny": [] }
}

Hinweis zu Auth-Konflikten (Häufiger Stolperstein)

Wenn Sie zuvor über einen Abonnement-Flow angemeldet waren und zusätzlich einen API-Key/Token gesetzt haben, kann das Verhalten inkonsistent sein. Falls Warnungen oder unerwartetes Verhalten auftreten:

• Führen Sie claude /logout aus und authentifizieren Sie sich sauber neu, und/oder
• Entfernen Sie widersprüchliche Anthropic-Umgebungsvariablen und starten Sie Ihr Terminal neu.

Pfad C — Gemini CLI (.env + Benutzerdefinierte Basis-URL)

Voraussetzung

Prüfen Sie:

node -v

Minimale Schritte

1. Installieren:

   npm install -g @google/gemini-cli

2. ~/.gemini/.env erstellen oder bearbeiten.

3. Verifizieren:

   gemini "Who are you"

Minimaler .env Ausschnitt (Beispiel)

GOOGLE_GEMINI_BASE_URL="https://api.evolink.ai/"
GEMINI_API_KEY="IHR_EVOLINK_KEY"
GEMINI_MODEL="gemini-2.5-pro"

Bekannter Stolperstein: Basis-URL wird nicht übernommen

• Starten Sie Ihre Terminal-Sitzung neu.
• Bestätigen Sie, dass der Pfad zur .env-Datei korrekt ist.
• Prüfen Sie den CLI-Auth-Modus und vorhandene Cache-Sitzungen.
• Führen Sie den Befehl mit einem minimalen Prompt erneut aus, um Konfigurations- von Prompt/Runtime-Problemen zu isolieren.

Warum Konfigurationsänderungen nicht greifen (Rangfolge-Checkliste)

Die meisten „Es hat sich nichts geändert“-Probleme haben eine dieser Ursachen:

1. Falscher Dateipfad — Codex: ~/.codex/config.toml / Claude: ~/.claude/settings.json / Gemini: ~/.gemini/.env
2. Datei bearbeitet, aber nicht neu gestartet — Terminal oder CLI-Prozess neu starten.
3. Umgebungsvariablen überschreiben die Konfiguration — Besonders relevant bei Claude Auth-Konflikten (Token vs. Login).

Kurzer Check:

env | grep -E "OPENAI_API_KEY|ANTHROPIC_|GEMINI_|GOOGLE_GEMINI_BASE_URL"

Cheat Sheet zur Fehlerbehebung (401/403/429/Stream/Tool-Calls/Timeout)

401 / 403 (Authentifizierungsfehler)

• Ist Ihr Key in der Variable gesetzt, die das Tool liest?
  • Codex: OPENAI_API_KEY
  • Claude: ANTHROPIC_AUTH_TOKEN
  • Gemini: GEMINI_API_KEY
• Entspricht Ihre Basis-URL dem Endpunkt-Format Ihres Integrationsleitfadens?

• Umgebungsvariable neu exportieren und Shell neu starten.
• Speicherort der Konfigurationsdatei und Schreibweise erneut prüfen.
• Für Claude: /logout ausführen, dann sauber neu authentifizieren.

Benötigen Sie einen neuen Key zur Behebung von 401/403? API-Key erstellen/verwalten →

429 (Rate Limit / Kontingent / Throttling)

• Parallelität reduzieren (viele gleichzeitige Ausführungen vermeiden).
• Kleine Verzögerungen zwischen großen Aufgaben einbauen.
• Wiederholung mit exponentiellem Backoff (wird optimalerweise von einem Gateway/Router gehandhabt, sofern verfügbar).

Falls 429 bestehen bleibt, behandeln Sie es als operatives Problem: Burst-Muster, lange Streaming-Sitzungen oder schwere Tool-Calls können das Problem verstärken.

Stream hakt / Lange Ausgabe bleibt hängen

• Testen Sie einen kurzen Prompt, um die Konnektivität zu validieren.
• Deaktivieren Sie vorübergehend VPN/Proxy, um Netzwerkprobleme zu isolieren.
• Führen Sie den Befehl in einem sauberen Verzeichnis aus (vermeiden Sie riesige Repo-Kontexte).

Tool-Calls schlagen fehl (Agent versucht Befehle/Dateien auszuführen)

• Permission-Policy blockiert die Ausführung.
• Tool-Umgebung fehlen Abhängigkeiten (git, ripgrep, Build-Tools).
• Pfad- oder Sandbox-Einschränkungen.

• Bestätigen Sie die Tool-Berechtigungsrichtlinie und das Arbeitsverzeichnis.
• Reproduzieren Sie das Problem mit einer minimalen Tool-Aktion.

Timeout

• Teilen Sie Aufgaben in kleinere Prompts auf.
• Verringern Sie die Größe des Repo-Kontexts.
• Vermeiden Sie beim ersten Test sehr lange Streaming-Sitzungen.

Modellwechsel (Schnell)

• Codex CLI: Aktualisieren Sie model = "..." in ~/.codex/config.toml
• Claude Code: Nutzen Sie /model (sofern von Ihrer Version unterstützt).
• Gemini CLI: Nutzen Sie /model oder aktualisieren Sie GEMINI_MODEL in der .env.

Nächste Schritte

Wenn Sie mehrere Coding-CLIs nutzen, ist der schnellste Weg zur Reibungsreduzierung die Standardisierung auf:

• Einen einzigen Gateway-Host.
• Vorhersehbare Konfigurations-Templates pro Tool.
• Ein wiederholbares Playbook zur Fehlerbehebung.

Starten Sie mit den speziellen Integrationsleitfäden (siehe Einleitung).

FAQ

Was ist ein „benutzerdefinierter LLM-Endpunkt“ für eine Coding-CLI?

Ein benutzerdefinierter Endpunkt ist eine Basis-URL, an die Ihre CLI Anfragen sendet, anstatt an den Standard-Endpunkt des Anbieters. In der Praxis kann dies ein Gateway oder Router sein, der eine oder mehrere Modell-APIs hinter einem einzigen Host bereitstellt.

Warum zeigt dieser Leitfaden unterschiedliche Endpunkt-Formate (/v1, abschließender Schrägstrich) für verschiedene Tools?

Wo befindet sich die Konfigurationsdatei der Codex CLI?

Wie setze ich eine benutzerdefinierte base_url in der Codex CLI?

Was bedeutet wire_api = "responses" in der Codex-Konfiguration?

Es gibt an, welche API-Struktur die CLI bei der Kommunikation mit dem Endpunkt verwendet. Halten Sie dies mit Ihrem Integrationsleitfaden konsistent.

Wo befindet sich die Claude Code settings.json?

Wofür wird ANTHROPIC_BASE_URL verwendet?

Es legt die Basis-URL fest, an die Claude Code Anfragen sendet, was das Routing über einen benutzerdefinierten Endpunkt anstelle des Standard-Anbieter-Endpunkts ermöglicht.

Warum warnt Claude Code vor Auth-Konflikten?

Woher liest die Gemini CLI die .env?

Warum wird GOOGLE_GEMINI_BASE_URL nicht übernommen?

Welche Node.js Version sollte ich für die Gemini CLI verwenden?

Nutzen Sie Node.js 20+.

Wie behebe ich 401/403 Fehlermeldungen bei Verwendung eines benutzerdefinierten Endpunkts schnell?

Überprüfen Sie, ob die richtige Key-Variable gesetzt ist, bestätigen Sie das Endpunkt-Format und starten Sie das Terminal neu. Bei Claude sollten Sie zudem Auth-Konflikte durch Abmelden oder Löschen der Variablen beseitigen.

Was bedeutet 429 bei Coding-CLIs?

Es weist normalerweise auf ein Rate Limiting oder ein erschöpftes Kontingent hin. Reduzieren Sie die Anzahl gleichzeitiger Anfragen, fügen Sie Verzögerungen ein und versuchen Sie es mit exponentiellem Backoff erneut.

Meine CLI streamt die Ausgabe und hängt dann — was sollte ich zuerst versuchen?

Testen Sie mit einem kurzen Prompt, deaktivieren Sie vorübergehend VPN/Proxy und verringern Sie die Größe des Repo-Kontexts. Teilen Sie große Aufgaben in kleinere Prompts auf.