Home / Gidsen / Codex CLI gebruiken met gratis modellen

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

Open 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
codex

Het 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
SleutelWat het doet
model_providerKiest de provider uit model_providers. De standaard is openai.
env_keyDe omgevingsvariabele die de API-sleutel van de provider bevat
requires_openai_authfalse betekent dat Codex niet om een OpenAI-login vraagt
model_context_windowDe contexttokens van het actieve model. Het commando neemt de waarde uit je live catalogus.
model_auto_compact_token_limitHet aantal tokens dat de automatische compactie van de geschiedenis start. Het commando stelt 90% van het contextvenster in.
tool_output_token_limitHet 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-codex

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

Profielen: de documentatie van Codex zegt dat Codex 0.134.0 en later de tabellen [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.

Gratis modellen voor Codex CLI: tool calling en 128K+ context
ModelGratis opContextGratis limieten (beste aanbod)ToolsVision
GLM 5.3UnoRouter1M1 aanvragen/min
1 req/min per model
JaNee
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 aanvragen/min
40 RPM
JaJa
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaJaJa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceJaNee
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditJaJa
Gemini 3.7 FlashGoogle AI Studio1M10 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditJaJa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 aanvragen/min
50 aanvragen/dag
50 req/day account-wide (1,000 after a $10 purchase)
JaJa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 aanvragen/min
50 aanvragen/dag
Shared rate limit
JaNee
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 aanvragen/min
250 aanvragen/dag
70,000 tokens/min
~6M
JaJa
Gemini 3.6 FlashGoogle AI Studio1M10 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayJaJa

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

ProbleemOorzaakOplossing
Codex vraagt je in te loggen met ChatGPTmodel_provider is niet ingesteld, dus Codex gebruikt openaiStel model_provider = "freellmapi" in
401 "Invalid API key"FREELLMAPI_API_KEY is niet ingesteld in deze shellExporteer de variabele, of gebruik npx freellmapi launch-codex
"Model metadata for auto not found"Codex kent de model-id's van de gateway nietVoeg model_catalog_url toe
Fouten met wire_api = "chat"Codex ondersteunt alleen de Responses APIStel wire_api = "responses" in
Profielinstellingen worden genegeerdCodex 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 limietVoeg sleutels van meer providers toe, of wacht op de cooldowns
Gebruik elk van deze met één sleutel. FreeLLMAPI is een open-source router die u zelf host. Die zet al deze gratis tarieven achter één eindpunt dat compatibel is met OpenAI. Bij een snelheidslimiet schakelt de router automatisch over. Bekijk de catalogus of live gaan.

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.] toe met base_url, env_key en wire_api = "responses", en stel daarna model_provider in. De provider moet de Responses API aanbieden.

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

Bronnen

Alle gidsen · Bekijk alle gratis modellen