Startseite / Anleitungen / Codex CLI mit kostenlosen Modellen nutzen

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/responses werden 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
codex

Der 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üsselWas er bewirkt
model_providerWählt den Anbieter aus model_providers. Der Standard ist openai.
env_keyDie Umgebungsvariable mit dem API-Schlüssel des Anbieters
requires_openai_authfalse bedeutet, dass Codex keine Anmeldung bei OpenAI verlangt
model_context_windowDie Kontext-Tokens des aktiven Modells. Der Befehl übernimmt den Wert aus Ihrem Live-Katalog.
model_auto_compact_token_limitDie Token-Anzahl, ab der die automatische Verdichtung des Verlaufs startet. Der Befehl setzt 90 % des Kontextfensters.
tool_output_token_limitDas 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-codex

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

Profile: Die Dokumentation von Codex sagt, dass Codex 0.134.0 und neuer die Tabellen [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.

Kostenlose Modelle für Codex CLI: Tool-Aufrufe und mehr als 128K Kontext
ModellKostenlos beiKontextKostenlose Limits (bestes Angebot)ToolsBildverarbeitung
GLM 5.3UnoRouter1M1 Anfragen/Min.
1 req/min per model
JaNein
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 Anfragen/Min.
40 RPM
JaJa
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaJaJa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceJaNein
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditJaJa
Gemini 3.7 FlashGoogle AI Studio1M10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditJaJa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 Anfragen/Min.
50 Anfragen/Tag
50 req/day account-wide (1,000 after a $10 purchase)
JaJa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 Anfragen/Min.
50 Anfragen/Tag
Shared rate limit
JaNein
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 Anfragen/Min.
250 Anfragen/Tag
70,000 Token/Min.
~6M
JaJa
Gemini 3.6 FlashGoogle AI Studio1M10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayJaJa

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

ProblemUrsacheLösung
Codex fordert Sie auf, sich mit ChatGPT anzumeldenmodel_provider ist nicht gesetzt, daher verwendet Codex openaiSetzen Sie model_provider = "freellmapi"
401 "Invalid API key"FREELLMAPI_API_KEY ist in dieser Shell nicht gesetztExportieren Sie die Variable oder verwenden Sie npx freellmapi launch-codex
"Model metadata for auto not found"Codex kennt die Modell-IDs des Gateways nichtFügen Sie model_catalog_url hinzu
Fehler mit wire_api = "chat"Codex unterstützt nur die Responses APISetzen Sie wire_api = "responses"
Profileinstellungen werden ignoriertCodex 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 LimitFügen Sie Schlüssel von weiteren Anbietern hinzu oder warten Sie auf die Abkühlzeiten
Nutzen Sie alle diese Modelle über einen einzigen Schlüssel. FreeLLMAPI ist ein Open-Source-Router, den Sie selbst hosten. Er stellt alle diese kostenlosen Angebote hinter einem einzigen OpenAI-kompatiblen Endpunkt bereit und wechselt zum nächsten Anbieter, wenn ein Anbieter das Limit erreicht. Katalog ansehen oder Jetzt starten.

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.] mit base_url, env_key und wire_api = "responses" hinzu und setzen Sie dann model_provider. Der Anbieter muss die Responses API bereitstellen.

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

Quellen

Alle Anleitungen · Alle kostenlosen Modelle ansehen