Codex CLI gebruiken met gratis modellen
Codex CLI is de open-source coding-agent van OpenAI voor de terminal. Hij kan een eigen modelprovider gebruiken. Deze gids koppelt Codex CLI via FreeLLMAPI aan gratis modellen van andere providers. Codex spreekt de Responses API, en FreeLLMAPI biedt die aan op /v1/responses.
Code, modelnamen en labels uit de live catalogus worden in het Engels getoond.
Hoe het werkt
Codex CLI stuurt aanvragen in het OpenAI Responses-formaat. De documentatie van Codex zegt dat responses de enige ondersteunde waarde van wire_api is. Een provider voor Codex moet dus /v1/responses aanbieden. FreeLLMAPI biedt dit eindpunt aan. Het vertaalt elke aanvraag en stuurt die naar een gratis model, bijvoorbeeld Gemini, GPT-OSS, Qwen of GLM.
- Je krijgt: de Codex CLI-agent, zijn tools en zijn bewerkingslus, op gratis modellen.
- Je krijgt niet: de eigen GPT-modellen van OpenAI via je ChatGPT-plan. Aanvragen gaan naar de gratis providers in je FreeLLMAPI-pool.
- Beperking: invoer van afbeeldingen op
/v1/responseswordt nog niet ondersteund. Gebruik tekstprompts.
Stap 1: installeer FreeLLMAPI en Codex CLI
Installeer beide
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexOpen http://localhost:3001. Voeg ten minste twee gratis providersleutels toe op de pagina Keys. Kopieer je uniforme sleutel van dezelfde pagina. Op macOS kun je Codex ook installeren met brew install --cask codex.
Stap 2: verbind Codex CLI
Het installatiecommando voegt een provider toe aan ~/.codex/config.toml. Het maakt eerst een back-up en voegt het nieuwe blok samen, zodat je andere instellingen behouden blijven.
Eén commando
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexHet commando schrijft deze instellingen, met waarden uit je live catalogus. De sleutel staat niet in het bestand. Codex leest die uit de omgevingsvariabele FREELLMAPI_API_KEY, dus exporteer de variabele in elke shell waarin je Codex draait.
~/.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| Sleutel | Wat het doet |
|---|---|
model_provider | Kiest de provider uit model_providers. De standaard is openai. |
env_key | De omgevingsvariabele die de API-sleutel van de provider bevat |
requires_openai_auth | false betekent dat Codex niet om een OpenAI-login vraagt |
model_context_window | De contexttokens van het actieve model. Het commando neemt de waarde uit je live catalogus. |
model_auto_compact_token_limit | Het aantal tokens dat de automatische compactie van de geschiedenis start. Het commando stelt 90% van het contextvenster in. |
tool_output_token_limit | Het tokenbudget voor elke tooluitvoer die Codex in de geschiedenis bewaart |
Om de sleutel uit bestanden en uit je shellprofiel te houden, gebruik je de launcher. Die start Codex met de sleutel alleen in de omgeving:
Launcher zonder opslag
npx freellmapi launch-codexOm zeker te weten dat de aanvragen naar de gateway gaan, draai je npx freellmapi doctor. Het controleert de geroute header Authorization, de catalogus en een live test. Het aanvraaglog van het dashboard toont daarna elke Codex-aanroep. De responseheader X-Routed-Via noemt de provider en het model dat antwoordde. Als een aanvraag is overgeschakeld, noemt X-Fallback-Trail elke mislukte stap en de reden.
[profiles.NAME] uit config.toml niet meer lezen. Profielen zijn nu aparte bestanden, bijvoorbeeld ~/.codex/NAME.config.toml. Gebruik de standaardopzet hierboven met een recente versie van Codex.Verwijder de waarschuwing over modelmetadata
Codex toont bij elke run "Model metadata for auto not found". Codex kent de model-id's van de gateway niet. Om echte metadata te geven, zoals het contextvenster en de ondersteuning voor afbeeldingen, voeg je een URL van de modelcatalogus toe aan de provider:
Toevoegen aan [model_providers.freellmapi]
model_catalog_url = "http://localhost:3001/v1/codex/models"De catalogus behoudt de eigen standaard systeemprompt en toolinstellingen van Codex. Alleen de waarschuwing en het contextvenster veranderen.
Kies modellen voor Codex CLI
Codex is een agent. Hij voert shell-commando's uit en bewerkt bestanden via toolaanroepen. Gebruik modellen met tool calling en een groot contextvenster. De tabel toont de gratis modellen die vandaag aan beide regels voldoen.
| Model | Gratis op | Context | Gratis limieten (beste aanbod) | Tools | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 aanvragen/min 1 req/min per model | Ja | Nee |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 aanvragen/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 | Nee |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/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 aanvragen/min 50 aanvragen/dag 50 req/day account-wide (1,000 after a $10 purchase) | Ja | Ja |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 aanvragen/min 50 aanvragen/dag Shared rate limit | Ja | Nee |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 aanvragen/min 250 aanvragen/dag 70,000 tokens/min ~6M | Ja | Ja |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ja | Ja |
Toont 12 van 109 overeenkomende gratis modellen. Bekijk alle modellen.
Actuele gegevens uit de FreeLLMAPI-catalogus (versie 2026.11.19, gecontroleerd 2026-11-19). Gratis limieten veranderen vaak. De catalogus wordt elke dag gecontroleerd.
Houd model = "auto" aan zodat de router voor elke aanvraag een model kiest. Om één model vast te zetten, draai je npx freellmapi setup-codex --url http://localhost:3001 --model <id>. Je kunt ook model = "auto:smart" of model = "auto:fast" instellen in config.toml.
Gratis tiers hebben limieten per minuut en per dag. Wanneer een provider een 429-fout stuurt, stuurt FreeLLMAPI de aanvraag naar het volgende model in de keten. Voeg voor lange Codex-sessies sleutels van vier of meer providers toe. Codex compacteert zijn geschiedenis wanneer die model_auto_compact_token_limit bereikt. Een lagere waarde stuurt kleinere aanvragen, wat helpt op gratis tiers met lage limieten voor tokens per minuut.
Probleemoplossing
| Probleem | Oorzaak | Oplossing |
|---|---|---|
| Codex vraagt je in te loggen met ChatGPT | model_provider is niet ingesteld, dus Codex gebruikt openai | Stel model_provider = "freellmapi" in |
401 "Invalid API key" | FREELLMAPI_API_KEY is niet ingesteld in deze shell | Exporteer de variabele, of gebruik npx freellmapi launch-codex |
"Model metadata for auto not found" | Codex kent de model-id's van de gateway niet | Voeg model_catalog_url toe |
Fouten met wire_api = "chat" | Codex ondersteunt alleen de Responses API | Stel wire_api = "responses" in |
| Profielinstellingen worden genegeerd | Codex 0.134.0 en later negeert de tabellen [profiles.NAME] | Gebruik de standaardopzet van de provider, of een apart profielbestand |
| "Alle modellen rate-limited na N pogingen" | Alle sleutels zitten op hun limiet | Voeg sleutels van meer providers toe, of wacht op de cooldowns |
Veelgestelde vragen
Kan ik Codex CLI gratis gebruiken?
Ja. Codex CLI is open source. Voeg FreeLLMAPI toe als eigen modelprovider in config.toml. De gateway stuurt elke aanvraag naar gratis providertiers, dus de kosten van inferentie zijn $0.
Kan Codex CLI modellen van andere providers gebruiken?
Ja. Voeg een blok [model_providers.
Ondersteunt Codex CLI de Chat Completions API?
Nee. De configuratiereferentie van Codex zegt dat responses de enige ondersteunde waarde van wire_api is. FreeLLMAPI biedt /v1/responses aan, dus het werkt als Codex-provider.
Welk gratis model is het beste voor Codex CLI?
Gebruik een model met tool calling en ten minste 128K context. De tabel op deze pagina toont de sterkste gratis modellen die vandaag aan beide regels voldoen.
Hoe los ik 'Model metadata for auto not found' op?
Voeg model_catalog_url = "http://localhost:3001/v1/codex/models" toe aan het providerblok in ~/.codex/config.toml. Codex leest dan echte metadata voor de modellen van de gateway.
Gerelateerde gidsen
- Claude Code gratis gebruiken
- OpenCode gebruiken met een gratis LLM API
- Aider gebruiken met een gratis LLM-API
- Beste gratis API's voor codemodellen
- Is er een gratis GPT API?
Bronnen
- Codex docs: config reference (gecontroleerd 20 November 2026)
- Codex docs: advanced config and profiles (gecontroleerd 20 November 2026)
- Codex CLI repository (gecontroleerd 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (gecontroleerd 20 November 2026)
- FreeLLMAPI CLI generators (gecontroleerd 20 November 2026)