Claude Code und Codex an HiAPI anbinden: Ein Key, modellwahl je nach Aufgabe

In den letzten Tagen ging ein Satz von Karpathy vom Jahresanfang erneut viral: the new default is that you are not writing the code directly 99% of the time, you are orchestrating agents who do and acting as oversight. Übersetzt heißt das: Der neue Standard ist, dass du 99 % der Zeit keinen Code mehr selbst schreibst, sondern Agenten orchestrierst, die für dich arbeiten, und selbst nur die Aufsicht übernimmst. Der Satz stammt aus seinem Post, in dem er das Konzept des agentic engineering vorstellte; im No-Priors-Podcast legte er noch nach: I don't think I've typed a line of code probably since December.

Viral hin oder her – die Daten zeigen deutlicher, dass das keine bloße Parole ist. Der annualisierte Umsatz von Claude Code liegt bereits über $2.5B (offizielle Angabe zur Series G im Februar 2026, kein auditierter ARR), während GitHub Copilot damals etwa 3 Jahre brauchte, um $1B zu erreichen. In der JetBrains-Studie zur Entwicklerökologie 2026 (über 15.000 Befragte) nutzen rund 90 % der professionellen Entwickler wöchentlich AI-Programmieragenten; die Adoption von Claude Code im Arbeitskontext stieg von 18 % auf 39 % (in den USA 47 %), die von Codex von 3 % auf 16 %.

Damit kommen auch die Probleme: Es gibt mehr Agenten, aber Konfiguration und Abrechnung laufen weiter getrennt. Viele nutzen Claude Code und Codex gleichzeitig, doch beide Tools beantragen eigene Keys, laden getrennt Guthaben auf und zeigen getrennte Nutzungsstatistiken; wer das Modell wechseln will, muss den Antragsprozess erneut durchlaufen. Dieser Artikel zeigt, wie man beide Tools mit einem einzigen HiAPI-Key anbindet und wie man danach Modelle auswählt und wechselt.

Das Fazit vorweg

• Ein Key für zwei Tools: Der HiAPI-API-Key wird gleichzeitig von Claude Code und Codex genutzt; Guthaben, Nutzung und Abrechnung liegen in einem Backend
• Jedes Tool nutzt sein stärkstes Modell: Claude Code nutzt das Anthropic Messages-Protokoll (/v1/messages) mit den Claude-Modellen auf HiAPI; Codex nutzt die Responses API (/v1/responses) mit Modellen der GPT-6.1-Reihe
• Freiheit innerhalb zweier roter Linien: Claude Code unterstützt offiziell kein Routing über ein Gateway zu Nicht-Claude-Modellen; die richtige Vorgehensweise ist daher, dass jedes der beiden Tools seine eigene Modellfamilie anbindet, statt dass ein Tool alles abdeckt
• In 5 Minuten angebunden: /connect/agents öffnen, Tool + Modell + Betriebssystem auswählen und die generierte Konfiguration kopieren; Claude Code und Codex unterstützen den Ein-Klick-Import über CC Switch
• Modellwechsel an einer Stelle: Bei Claude Code das Modellfeld in settings.json ändern, bei Codex eine Zeile model in hiapi.config.toml – der Key bleibt unverändert

HiAPIs Lösung: ein Key, zwei Tools

HiAPI ist eine API-Plattform, die mehrere Modellfamilien aggregiert und nach außen einheitlich mehrere Standardprotokolle bereitstellt. Für Programmieragenten gibt es eine offizielle Ein-Klick-Anbindungsseite für 4 Tools: /zh/connect/agents (englische Version /en/connect/agents), mit Unterstützung für Claude Code, Codex CLI, OpenCode und Hermes Agent.

Die Protokollzuordnung ist der Schlüssel für eine korrekte Anbindung:

Tool	Protokoll	Endpunkt	Verfügbare Modelle auf HiAPI
Claude Code	Anthropic Messages	/v1/messages	claude-opus-5-5, claude-sonnet-4-6, claude-opus-4-8, claude-opus-4-8@aws (insgesamt 4)
Codex CLI	Responses API	/v1/responses	gpt-6.1-sol, gpt-6.1-terra, gpt-6-astra, GPT-5.6-Reihe, DeepSeek-v4-Reihe (insgesamt 9)
OpenCode / Hermes Agent	Chat Completions	/v1/chat/completions	Textmodelle aller Familien, größte Abdeckung

Das heißt: Die Stärke von Claude Code liegt bei langlaufenden Coding-Agent-Aufgaben, daher wird die Flaggschiff-Familie von Claude zugewiesen; die Stärke von Codex liegt im Massenbetrieb, daher die GPT-6.1-Reihe. Ein Key authentifiziert beide Seiten, die Abrechnung läuft zusammen.

Eines muss klar gesagt werden: Anthropic unterstützt offiziell nicht, Claude Code über irgendein Gateway zu Nicht-Claude-Modellen zu routen. GPT-Modelle gewaltsam in Claude Code zu stopfen, führt zu instabilem Tool-Calling und Agent-Verhalten, und bei Problemen gibt es keine offizielle Absicherung. Die genaue Bedeutung von „ein Key, jederzeit Modell wechseln“ ist daher: zwischen den beiden Tools nach Aufgabe aufteilen, jedes Tool nutzt das für sich stärkste Modell, statt in einem Tool Familien zu mischen.

Wenn Sie nur Claude Code nutzen, lesen Sie zusätzlich unseren früheren Einzeltool-Konfigurationsleitfaden „Claude Code mit HiAPI verbinden: vollständiger Konfigurationsleitfaden, um $100 Abo-Gebühren pro Monat zu sparen“. Dieser Artikel konzentriert sich auf die gemeinsame Nutzung eines Keys durch zwei Tools und die Wechselstrategie.

Anbindung 1 (empfohlen): Konfiguration über die /connect/agents-Seite generieren

Die bequemste Anbindung, komplett per Klickauswahl, ohne manuelles Schreiben von Konfiguration:

1. hiapi.ai/zh/connect/agents öffnen und auf „HiAPI mit deinem Agent verbinden“ klicken
2. Tool auswählen: Claude Code oder Codex CLI
3. Modell auswählen: z. B. auf der Claude-Code-Seite claude-opus-5-5, auf der Codex-Seite gpt-6.1-sol
4. Betriebssystem auswählen: macOS / Windows / Linux – die Pfade in der Konfiguration passen sich an
5. Generierte Konfiguration kopieren und wie angegeben in die entsprechende Datei einfügen

Claude Code und Codex unterstützen den Ein-Klick-Import über CC Switch: Auf der API-Keys-Seite von HiAPI auf Import klicken, der Browser startet CC Switch und schreibt die Konfiguration. Der Import-Link selbst enthält keinen Schlüssel; der Key liegt in einer lokalen Umgebungsvariable – das ist unbedenklich.

Prüfen Sie vorab die Versionsanforderungen: Codex CLI benötigt 0.134 oder höher, prüfbar mit codex --version; bei Claude Code bestätigen Sie mit claude --version, dass eine Versionsnummer korrekt ausgegeben wird.

Anbindung 2: Konfigurationsdateien manuell schreiben

Auch die manuelle Konfiguration ist unkompliziert – zwei Dateien, je eine pro Tool.

Claude Code: ~/.claude/settings.json

Schreiben Sie in den env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hiapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "你的 HiAPI API Key",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Feld für Feld erklärt:

• ANTHROPIC_BASE_URL verweist auf https://api.hiapi.ai, ohne /v1 – der Client setzt /v1/messages selbst zusammen
• ANTHROPIC_AUTH_TOKEN mit Ihrem HiAPI-API-Key füllen, Authentifizierung über Bearer
• ANTHROPIC_MODEL sowie die beiden Aliase OPUS / SONNET verweisen alle auf das auf HiAPI gewählte Modell (HiAPI bedient keine offiziellen Claude-Modell-IDs; die Aliase werden einheitlich dorthin umgeleitet)
• ANTHROPIC_DEFAULT_HAIKU_MODEL ist fest auf claude-sonnet-4-6 gesetzt – dieser Slot wird von Claude Code für Hintergrundarbeiten (Kontext komprimieren, Commit-Nachrichten erzeugen usw.) genutzt
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1, weil die neue Text-Pipeline Anfragefelder für experimentelle Betas ablehnt; das Abschalten erspart Fallstricke

Codex: ~/.codex/hiapi.config.toml

Erstellen Sie ~/.codex/hiapi.config.toml (unter Windows %USERPROFILE%\.codex\hiapi.config.toml):

model_provider = "hiapi"
model = "gpt-6.1-sol"

[model_providers.hiapi]
name = "HiAPI"
base_url = "https://api.hiapi.ai/v1"
env_key = "HIAPI_API_KEY"
wire_api = "responses"

Setzen Sie dann die Umgebungsvariable in der Shell und starten Sie:

export HIAPI_API_KEY="你的 HiAPI API Key"
codex --profile hiapi

Unter Windows PowerShell entsprechend $env:HIAPI_API_KEY = "...". Beachten Sie: Die base_url hier enthält /v1, anders als auf der Claude-Code-Seite – nicht verwechseln und nicht voneinander abschreiben. wire_api = "responses" deklariert die Nutzung des Responses-Protokolls, eine harte Anforderung von Codex.

Modellwahl: Opus für komplexe Aufgaben, GPT-6.1 für den Massenbetrieb

Sind beide Tools angebunden, wird die Modellwahl zu einer Frage der aufgabenbasierten Weiterleitung. Unsere Empfehlung ist direkt:

• Schwierige, langlaufende Aufgaben an claude-opus-5-5: dateiübergreifendes Refactoring, Marathon-Debugging, Aufgaben, bei denen die gesamte Codebasis verstanden werden muss. Es ist das Flaggschiff auf der Claude-Code-Seite, mit einem Kontextfenster von bis zu 1M
• Täglicher Hochfrequenz-Massenbetrieb mit gpt-6.1-sol / gpt-6.1-terra: Batch-Umschreibungen, Einzeldatei-Funktionen, Skripterstellung – hohes Volumen, einzelne Aufgaben wenig komplex; ein günstigeres Modell macht sich in der Abrechnung deutlich bemerkbar
• gpt-6-astra für qualitätssensitivere Responses-Szenarien: eine Preisstufe höher, bei Bedarf aktivieren

Plattformpreise der wichtigsten Modelle ($/M Token, Stand 2026-10, Basistarif):

Modell	Input	Output	Cache-Lesen	Kontext
claude-opus-5-5	$2.02	$10.08	$0.10	1M
claude-sonnet-4-6	$3.00	$15.00	$0.30	—
gpt-6.1-sol	$0.50	$2.50	$0.025	1.05M
gpt-6.1-terra	$0.25	$1.25	$0.0125	1.05M
gpt-6-astra	$2.50	$12.50	$0.25	1.05M (über 272K wird der Langtext-Zuschlagstarif ausgelöst)

Beachten Sie die Spalte Cache-Lesepreis: In Agent-Sitzungen stammt ein großer Teil der Token aus Cache-Treffern; bei gpt-6.1-terra kostet Cache-Lesen nur $0.0125/M. Wenn in langen Sitzungen wiederholt dasselbe Repository bearbeitet wird, liegt die tatsächliche Abrechnung deutlich unter einer Schätzung nach Input-Preis. Massenbetrieb und Kosten sparen sind kein Entweder-oder.

Für einen tieferen Vergleich der Fähigkeitsausrichtungen von Opus 5.5 und GPT-6.1 Sol lesen Sie „Claude Opus 5.5 im Vergleich zu GPT-6.1 Sol“; die jüngste Preissenkung von Terra und ihre Hintergründe sind vollständig in „Analyse der Preissenkung von GPT-6.1 Terra“ aufgeschlüsselt. Maßgeblich für aktuelle Preise und Parameter der beiden Modelle sind die Modell-Detailseiten.

Wie einfach ist der Modellwechsel?

Das ist der am meisten unterschätzte Vorteil dieser Lösung. Ein Modellwechsel erfordert nur zwei Schritte:

• Claude Code: Die Werte an drei Stellen in ~/.claude/settings.json ändern – ANTHROPIC_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL (auf HiAPI verweisen die Aliase opus/sonnet alle dorthin, also einfach dieselbe neue Modell-ID eintragen); wirksam nach Neustart der Sitzung
• Codex: Die Zeile model = "..." in ~/.codex/hiapi.config.toml ändern; wirksam beim nächsten codex --profile hiapi

Der Key bleibt von Anfang bis Ende unverändert. Verglichen mit dem alten Weg „für jedes Tool einen eigenen offiziellen Key beantragen“: Modellwechsel erforderte neuen Antrag, Warten auf Genehmigung, Anpassen der Schlüsselverwaltung – jetzt ist es eine Zeile Konfiguration. Wenn Sie den CC Switch-Import genutzt haben, können Sie auch auf /connect/agents erneut ein Modell auswählen und erneut importieren – komplett grafisch.

Wer noch mehr Modelle anbinden möchte: OpenCode und Hermes Agent nutzen das Chat-Completions-Protokoll und bieten die größte Modellabdeckung, mit demselben Seitenablauf. Für multimodale und Weltmodell-Innovationen lesen Sie ergänzend „Genie 4 Weltmodell im Praxistest“.

Häufige Fragen

Kann Claude Code über HiAPI GPT-Modelle nutzen?

Nein, und das ist auch nicht nötig. Anthropic unterstützt offiziell nicht, Claude Code über irgendein Gateway zu Nicht-Claude-Modellen zu routen; ein erzwungenes Anbinden macht Tool-Calling und Agent-Verhalten instabil, und es gibt keine offizielle Absicherung. Die für Claude Code auf HiAPI verfügbaren Modelle sind claude-opus-5-5, claude-sonnet-4-6, claude-opus-4-8 und claude-opus-4-8@aws – diese 4. Für Modelle der GPT-6.1-Reihe nutzt man die Codex-Seite, wo das Responses-Protokoll native Unterstützung bietet.

Kann ein HiAPI-Key gleichzeitig von Claude Code und Codex genutzt werden?

Ja, genau das ist der Kern dieser Lösung. Beide Tools teilen sich denselben Key, die Authentifizierungsmethoden unterscheiden sich (Claude Code nutzt ANTHROPIC_AUTH_TOKEN, Codex die Umgebungsvariable HIAPI_API_KEY), aber es ist derselbe Key. Guthaben, Nutzung und Abrechnung sehen Sie in einem Backend, gruppiert nach Tool.

Ist der Ein-Klick-Import über CC Switch sicher?

Sicher. Der Import-Link selbst enthält keinen Schlüssel; der Key liegt in Ihrer lokalen Umgebungsvariable. Der Ablauf: Nach dem Erzeugen des Keys auf HiAPI auf der API-Keys-Seite auf CC Switch-Import klicken, der Browser startet CC Switch und schreibt die Konfiguration. Wer dem grafischen Ablauf nicht traut, kann settings.json und hiapi.config.toml auch vollständig gleichwertig manuell schreiben.

Wie bestätige ich nach der Konfiguration beider Tools, dass die Anbindung funktioniert?

Auf der Claude-Code-Seite claude --version ausführen, um den Client zu prüfen, dann eine beliebige Sitzung öffnen und einen Satz senden; im HiAPI-Backend prüfen, ob die Nutzung steigt. Auf der Codex-Seite ist CLI 0.134+ erforderlich; nach dem Start mit codex --profile hiapi ebenfalls eine Aufgabe senden und die Zählung im Backend beobachten. Beim ersten Mal empfiehlt es sich, je eine kleine Aufgabe auszuführen und zu bestätigen, dass Abrechnung und Modell-ID stimmen, bevor man loslegt.

Lohnt sich die Anbindung von OpenCode und Hermes Agent?

Das hängt von den Gewohnheiten Ihres Teams ab. Diese beiden Tools nutzen das Chat-Completions-Protokoll und bieten die meisten wählbaren Modellfamilien; sie eignen sich für Szenarien, in denen ein Client mehrere Modellfamilien übergreifend nutzen soll. Der Konfigurationsablauf ist identisch mit Claude Code / Codex, über dieselbe /connect/agents-Seite.

Beeinflusst ein Modellwechsel laufende Sitzungen?

Geändert wird die Konfiguration, die für neue Sitzungen gilt. Bereits geöffnete Sitzungen verwenden das beim Start gelesene Modell; nach der Konfigurationsänderung einfach die Sitzung neu öffnen – historische Sitzungsprotokolle bleiben unberührt.

Wichtige Erkenntnisse

Dass Karpathys 99-%-Satz erneut viral ging, zeigt: agentic engineering ist kein Spiel für Vorreiter mehr, sondern die Standardarbeitsweise. In der Standardarbeitsweise werden immer mehr Menschen Claude Code und Codex gleichzeitig nutzen, und die Fragmentierung von Konfiguration und Abrechnung ist realer Reibungsverlust. HiAPIs Lösung: ein Key für zwei Tools – Claude Code nutzt über das Messages-Protokoll das Flaggschiff der Claude-Familie, Codex nutzt über das Responses-Protokoll die GPT-6.1-Reihe; jedes Tool bekommt sein stärkstes Modell, die Abrechnung läuft zusammen. Die Anbindung erfolgt über die /connect/agents-Seite mit generierter Konfiguration und CC Switch-Import, in 5 Minuten lauffähig; Modellwechsel per einer Zeile Konfiguration, der Key bleibt unverändert. Aufgabenbasiertes Routing (schwierige Aufgaben an Opus 5.5, Massenbetrieb an GPT-6.1 Sol/Terra) ist derzeit die optimale Lösung, um Qualität und Abrechnung gleichzeitig im Griff zu behalten.