Codex CLI mit kostenlosen Modellen nutzen
Codex CLI ist der Open-Source-Coding-Agent von OpenAI für das Terminal. Er kann einen eigenen Modellanbieter nutzen. Diese Anleitung verbindet Codex CLI über FreeLLMAPI mit kostenlosen Modellen anderer Anbieter. Codex spricht die Responses API, und FreeLLMAPI stellt sie unter /v1/responses bereit.
Code, Modellnamen und Bezeichnungen aus dem Live-Katalog werden auf Englisch angezeigt.
So funktioniert es
Codex CLI sendet Anfragen im Format der OpenAI Responses API. Die Dokumentation von Codex sagt, dass responses der einzige unterstützte Wert für wire_api ist. Ein Anbieter für Codex muss daher /v1/responses bereitstellen. FreeLLMAPI stellt diesen Endpunkt bereit. Es übersetzt jede Anfrage und sendet sie an ein kostenloses Modell, zum Beispiel Gemini, GPT-OSS, Qwen oder GLM.
- Sie erhalten: den Codex-CLI-Agenten, seine Tools und seine Bearbeitungsschleife, mit kostenlosen Modellen.
- Sie erhalten nicht: die eigenen GPT-Modelle von OpenAI über Ihren ChatGPT-Tarif. Anfragen gehen an die kostenlosen Anbieter in Ihrem FreeLLMAPI-Pool.
- Grenze: Bildeingaben über
/v1/responseswerden noch nicht unterstützt. Verwenden Sie Text-Prompts.
Schritt 1: FreeLLMAPI und Codex CLI installieren
Beides installieren
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexÖffnen Sie http://localhost:3001. Fügen Sie auf der Seite Keys mindestens zwei kostenlose Anbieter-Schlüssel hinzu. Kopieren Sie Ihren einheitlichen Schlüssel von derselben Seite. Unter macOS können Sie Codex auch mit brew install --cask codex installieren.
Schritt 2: Codex CLI verbinden
Der Setup-Befehl fügt einen Anbieter in ~/.codex/config.toml hinzu. Vorher legt er eine Sicherung an und führt den neuen Block zusammen, sodass Ihre anderen Einstellungen erhalten bleiben.
Ein Befehl
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexDer Befehl schreibt diese Einstellungen mit Werten aus Ihrem Live-Katalog. Der Schlüssel steht nicht in der Datei. Codex liest ihn aus der Umgebungsvariable FREELLMAPI_API_KEY. Exportieren Sie die Variable daher in jeder Shell, in der Sie Codex starten.
~/.codex/config.toml
model = "auto"
model_provider = "freellmapi"
model_context_window = 128000
model_auto_compact_token_limit = 115200
tool_output_token_limit = 20000
[model_providers.freellmapi]
name = "FreeLLMAPI"
base_url = "http://localhost:3001/v1"
wire_api = "responses"
env_key = "FREELLMAPI_API_KEY"
requires_openai_auth = false| Schlüssel | Was er bewirkt |
|---|---|
model_provider | Wählt den Anbieter aus model_providers. Der Standard ist openai. |
env_key | Die Umgebungsvariable mit dem API-Schlüssel des Anbieters |
requires_openai_auth | false bedeutet, dass Codex keine Anmeldung bei OpenAI verlangt |
model_context_window | Die Kontext-Tokens des aktiven Modells. Der Befehl übernimmt den Wert aus Ihrem Live-Katalog. |
model_auto_compact_token_limit | Die Token-Anzahl, ab der die automatische Verdichtung des Verlaufs startet. Der Befehl setzt 90 % des Kontextfensters. |
tool_output_token_limit | Das Token-Budget für jede Tool-Ausgabe, die Codex im Verlauf behält |
Damit der Schlüssel nicht in Dateien und nicht in Ihrem Shell-Profil steht, verwenden Sie den Launcher. Er startet Codex mit dem Schlüssel nur in dessen Umgebung:
Launcher ohne Speicherung
npx freellmapi launch-codexUm sicherzustellen, dass die Anfragen das Gateway erreichen, führen Sie npx freellmapi doctor aus. Der Befehl prüft den weitergeleiteten Header Authorization, den Katalog und eine Live-Probe. Das Anfrage-Protokoll im Dashboard zeigt dann jeden Codex-Aufruf. Der Antwort-Header X-Routed-Via nennt den Anbieter und das Modell, die geantwortet haben. Ist eine Anfrage auf einen anderen Anbieter ausgewichen, nennt X-Fallback-Trail jeden fehlgeschlagenen Schritt und den Grund.
[profiles.NAME] aus config.toml nicht mehr liest. Profile sind jetzt eigene Dateien, zum Beispiel ~/.codex/NAME.config.toml. Verwenden Sie mit einer aktuellen Codex-Version die Standard-Einrichtung oben.Die Warnung zu den Modell-Metadaten entfernen
Codex gibt bei jedem Lauf "Model metadata for auto not found" aus. Codex kennt die Modell-IDs des Gateways nicht. Damit Codex echte Metadaten erhält, etwa das Kontextfenster und die Unterstützung für Bilder, fügen Sie dem Anbieter eine URL zum Modellkatalog hinzu:
In [model_providers.freellmapi] hinzufügen
model_catalog_url = "http://localhost:3001/v1/codex/models"Der Katalog behält den eigenen Standard-System-Prompt und die Tool-Einstellungen von Codex bei. Nur die Warnung und das Kontextfenster ändern sich.
Modelle für Codex CLI auswählen
Codex ist ein Agent. Er führt Shell-Befehle aus und bearbeitet Dateien über Tool-Aufrufe. Verwenden Sie Modelle mit Tool-Aufrufen und einem großen Kontextfenster. Die Tabelle zeigt kostenlose Modelle, die heute beide Regeln erfüllen.
| Modell | Kostenlos bei | Kontext | Kostenlose Limits (bestes Angebot) | Tools | Bildverarbeitung |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 Anfragen/Min. 1 req/min per model | Ja | Nein |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 Anfragen/Min. 40 RPM | Ja | Ja |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ja | Ja |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ja | Nein |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 Anfragen/Min. 50 Anfragen/Tag 50 req/day account-wide (1,000 after a $10 purchase) | Ja | Ja |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 Anfragen/Min. 50 Anfragen/Tag Shared rate limit | Ja | Nein |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 Anfragen/Min. 250 Anfragen/Tag 70,000 Token/Min. ~6M | Ja | Ja |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ja | Ja |
Es werden 12 von 109 passenden kostenlosen Modellen angezeigt. Alle Modelle ansehen.
Live-Daten aus dem FreeLLMAPI-Katalog (Version 2026.11.19, geprüft 2026-11-19). Kostenlose Limits ändern sich oft. Der Katalog wird jeden Tag geprüft.
Behalten Sie model = "auto" bei, damit der Router für jede Anfrage ein Modell auswählt. Um ein Modell festzulegen, führen Sie npx freellmapi setup-codex --url http://localhost:3001 --model <id> aus. Sie können auch model = "auto:smart" oder model = "auto:fast" in config.toml setzen.
Kostenlose Tarife haben Limits pro Minute und pro Tag. Sendet ein Anbieter einen Fehler 429, schickt FreeLLMAPI die Anfrage an das nächste Modell in der Kette. Fügen Sie für lange Codex-Sitzungen Schlüssel von vier oder mehr Anbietern hinzu. Codex verdichtet seinen Verlauf, sobald er model_auto_compact_token_limit erreicht. Ein niedrigerer Wert sendet kleinere Anfragen. Das hilft bei kostenlosen Tarifen mit niedrigen Limits für Tokens pro Minute.
Fehlerbehebung
| Problem | Ursache | Lösung |
|---|---|---|
| Codex fordert Sie auf, sich mit ChatGPT anzumelden | model_provider ist nicht gesetzt, daher verwendet Codex openai | Setzen Sie model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY ist in dieser Shell nicht gesetzt | Exportieren Sie die Variable oder verwenden Sie npx freellmapi launch-codex |
"Model metadata for auto not found" | Codex kennt die Modell-IDs des Gateways nicht | Fügen Sie model_catalog_url hinzu |
Fehler mit wire_api = "chat" | Codex unterstützt nur die Responses API | Setzen Sie wire_api = "responses" |
| Profileinstellungen werden ignoriert | Codex 0.134.0 und neuer ignoriert die Tabellen [profiles.NAME] | Verwenden Sie die Standard-Einrichtung des Anbieters oder eine eigene Profildatei |
| Meldung: "All models rate-limited after N attempts" | Alle Schlüssel sind an ihrem Limit | Fügen Sie Schlüssel von weiteren Anbietern hinzu oder warten Sie auf die Abkühlzeiten |
Häufig gestellte Fragen
Kann ich Codex CLI kostenlos nutzen?
Ja. Codex CLI ist Open Source. Fügen Sie FreeLLMAPI als eigenen Modellanbieter in config.toml hinzu. Das Gateway sendet jede Anfrage an kostenlose Anbieter-Tarife, daher kostet die Inferenz 0 $.
Kann Codex CLI Modelle anderer Anbieter nutzen?
Ja. Fügen Sie einen Block [model_providers.
Unterstützt Codex CLI die Chat-Completions-API?
Nein. Die Referenz zur Codex-Konfiguration sagt, dass responses der einzige unterstützte Wert für wire_api ist. FreeLLMAPI stellt /v1/responses bereit und funktioniert daher als Codex-Anbieter.
Welches kostenlose Modell eignet sich am besten für Codex CLI?
Verwenden Sie ein Modell mit Tool-Aufrufen und mindestens 128K Kontext. Die Tabelle auf dieser Seite zeigt die stärksten kostenlosen Modelle, die heute beide Regeln erfüllen.
Wie behebe ich 'Model metadata for auto not found'?
Fügen Sie model_catalog_url = "http://localhost:3001/v1/codex/models" im Anbieter-Block in ~/.codex/config.toml hinzu. Codex liest dann echte Metadaten für die Modelle des Gateways.
Verwandte Anleitungen
- So nutzen Sie Claude Code kostenlos
- OpenCode mit einer kostenlosen LLM API nutzen
- Aider mit einer kostenlosen LLM-API nutzen
- Beste kostenlose Coding-Modell-APIs
- Gibt es eine kostenlose GPT API?
Quellen
- Codex docs: config reference (geprüft 20 November 2026)
- Codex docs: advanced config and profiles (geprüft 20 November 2026)
- Codex CLI repository (geprüft 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (geprüft 20 November 2026)
- FreeLLMAPI CLI generators (geprüft 20 November 2026)