Codex CLI z darmowymi modelami
Codex CLI to agent kodujący OpenAI o otwartym kodzie, działający w terminalu. Może używać własnego dostawcy modeli. Ten poradnik łączy Codex CLI z darmowymi modelami od innych dostawców przez FreeLLMAPI. Codex korzysta z Responses API, a FreeLLMAPI udostępnia je pod /v1/responses.
Kod, nazwy modeli i etykiety z katalogu na żywo są podane po angielsku.
Jak to działa
Codex CLI wysyła żądania w formacie OpenAI Responses. Dokumentacja Codex mówi, że responses to jedyna obsługiwana wartość wire_api. Dostawca dla Codex musi więc udostępniać /v1/responses. FreeLLMAPI udostępnia ten punkt końcowy. Tłumaczy każde żądanie i wysyła je do darmowego modelu, na przykład Gemini, GPT-OSS, Qwen lub GLM.
- Zyskujesz: agenta Codex CLI, jego narzędzia i pętlę edycji na darmowych modelach.
- Nie zyskujesz: własnych modeli GPT od OpenAI w ramach planu ChatGPT. Żądania idą do darmowych dostawców z Twojej puli FreeLLMAPI.
- Ograniczenie: wejście obrazów na
/v1/responsesnie jest jeszcze obsługiwane. Używaj promptów tekstowych.
Krok 1: zainstaluj FreeLLMAPI i Codex CLI
Zainstaluj oba
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexOtwórz http://localhost:3001. Dodaj co najmniej dwa klucze darmowych dostawców na stronie Keys. Skopiuj swój wspólny klucz z tej samej strony. Na macOS możesz też zainstalować Codex poleceniem brew install --cask codex.
Krok 2: połącz Codex CLI
Polecenie konfiguracji dodaje dostawcę do ~/.codex/config.toml. Najpierw tworzy kopię zapasową i scala nowy blok, więc Twoje inne ustawienia zostają.
Jedno polecenie
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexPolecenie zapisuje te ustawienia z wartościami z aktywnego katalogu. Klucza nie ma w pliku. Codex odczytuje go ze zmiennej środowiskowej FREELLMAPI_API_KEY, więc wyeksportuj tę zmienną w każdej powłoce, w której uruchamiasz Codex.
~/.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| Klucz | Co robi |
|---|---|
model_provider | Wybiera dostawcę z model_providers. Domyślnie to openai. |
env_key | Zmienna środowiskowa z kluczem API dostawcy |
requires_openai_auth | false oznacza, że Codex nie pyta o logowanie do OpenAI |
model_context_window | Tokeny kontekstu aktywnego modelu. Polecenie pobiera wartość z aktywnego katalogu. |
model_auto_compact_token_limit | Liczba tokenów, po której zaczyna się automatyczne kompaktowanie historii. Polecenie ustawia 90% okna kontekstu. |
tool_output_token_limit | Budżet tokenów dla wyniku każdego narzędzia, który Codex zachowuje w historii |
Aby klucz nie trafiał do plików ani do profilu powłoki, użyj launchera. Uruchamia Codex z kluczem tylko w jego środowisku:
Launcher bez zapisu
npx freellmapi launch-codexAby sprawdzić, czy żądania idą do bramy, uruchom npx freellmapi doctor. Sprawdza przekierowany nagłówek Authorization, katalog i próbę na żywo. Dziennik żądań w panelu pokazuje potem każde wywołanie Codex. Nagłówek odpowiedzi X-Routed-Via podaje dostawcę i model, który odpowiedział. Jeśli żądanie przeszło na inny model, X-Fallback-Trail podaje każdy nieudany krok i jego przyczynę.
[profiles.NAME] z config.toml. Profile są teraz osobnymi plikami, na przykład ~/.codex/NAME.config.toml. Przy aktualnej wersji Codex użyj powyższej konfiguracji domyślnej.Usuń ostrzeżenie o metadanych modelu
Codex wypisuje przy każdym uruchomieniu "Model metadata for auto not found". Codex nie zna identyfikatorów modeli bramy. Aby podać mu prawdziwe metadane, takie jak okno kontekstu i obsługa obrazów, dodaj do dostawcy adres katalogu modeli:
Dodaj do [model_providers.freellmapi]
model_catalog_url = "http://localhost:3001/v1/codex/models"Katalog zachowuje domyślny prompt systemowy i ustawienia narzędzi Codex. Zmieniają się tylko ostrzeżenie i okno kontekstu.
Wybierz modele dla Codex CLI
Codex to agent. Uruchamia polecenia powłoki i edytuje pliki przez wywołania narzędzi. Używaj modeli z wywoływaniem narzędzi i dużym oknem kontekstu. Tabela pokazuje darmowe modele, które dziś spełniają oba warunki.
| Model | Za darmo w | Kontekst | Darmowe limity (najlepsza oferta) | Narzędzia | Wizja |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 żądań/min 1 req/min per model | Tak | Nie |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 żądań/min 40 RPM | Tak | Tak |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Tak | Tak |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Tak | Nie |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Tak | Tak |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Tak | Tak |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 żądań/min 50 żądań/dzień 50 req/day account-wide (1,000 after a $10 purchase) | Tak | Tak |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 żądań/min 50 żądań/dzień Shared rate limit | Tak | Nie |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 żądań/min 250 żądań/dzień 70,000 tokenów/min ~6M | Tak | Tak |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Tak | Tak |
Pokazano 12 z 109 pasujących darmowych modeli. Zobacz wszystkie modele.
Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.
Zostaw model = "auto", aby router wybierał model dla każdego żądania. Aby przypisać jeden model, uruchom npx freellmapi setup-codex --url http://localhost:3001 --model <id>. Możesz też ustawić model = "auto:smart" lub model = "auto:fast" w config.toml.
Darmowe plany mają limity na minutę i na dzień. Gdy dostawca wyśle błąd 429, FreeLLMAPI wysyła żądanie do następnego modelu w łańcuchu. Przy długich sesjach Codex dodaj klucze od czterech lub więcej dostawców. Codex kompaktuje historię, gdy osiągnie model_auto_compact_token_limit. Niższa wartość wysyła mniejsze żądania, co pomaga na darmowych planach z niskimi limitami tokenów na minutę.
Rozwiązywanie problemów
| Problem | Przyczyna | Rozwiązanie |
|---|---|---|
| Codex prosi o logowanie przez ChatGPT | model_provider nie jest ustawione, więc Codex używa openai | Ustaw model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY nie jest ustawione w tej powłoce | Wyeksportuj zmienną albo użyj npx freellmapi launch-codex |
"Model metadata for auto not found" | Codex nie zna identyfikatorów modeli bramy | Dodaj model_catalog_url |
Błędy przy wire_api = "chat" | Codex obsługuje tylko Responses API | Ustaw wire_api = "responses" |
| Ustawienia profilu są ignorowane | Codex 0.134.0 i nowsze ignoruje tabele [profiles.NAME] | Użyj domyślnej konfiguracji dostawcy albo osobnego pliku profilu |
| "Wszystkie modele osiągnęły limit po N próbach" | Wszystkie klucze mają wyczerpany limit | Dodaj klucze od większej liczby dostawców albo poczekaj na koniec okresu wstrzymania |
Najczęstsze pytania
Czy mogę używać Codex CLI za darmo?
Tak. Codex CLI ma otwarty kod. Dodaj FreeLLMAPI jako własnego dostawcę modeli w config.toml. Brama wysyła każde żądanie do darmowych planów dostawców, więc wnioskowanie kosztuje $0.
Czy Codex CLI może używać modeli od innych dostawców?
Tak. Dodaj blok [model_providers.
Czy Codex CLI obsługuje API Chat Completions?
Nie. Opis konfiguracji Codex mówi, że responses to jedyna obsługiwana wartość wire_api. FreeLLMAPI udostępnia /v1/responses, więc działa jako dostawca dla Codex.
Który darmowy model jest najlepszy dla Codex CLI?
Użyj modelu z wywoływaniem narzędzi i kontekstem co najmniej 128K. Tabela na tej stronie pokazuje najmocniejsze darmowe modele, które dziś spełniają oba warunki.
Jak usunąć ostrzeżenie 'Model metadata for auto not found'?
Dodaj model_catalog_url = "http://localhost:3001/v1/codex/models" do bloku dostawcy w ~/.codex/config.toml. Codex odczyta wtedy prawdziwe metadane modeli bramy.
Powiązane poradniki
- Jak używać Claude Code za darmo
- Używaj OpenCode z darmowym API LLM
- Aider z darmowym API LLM
- Najlepsze darmowe API modeli do kodowania
- Czy istnieje darmowe API GPT?
Źródła
- Codex docs: config reference (sprawdzono 20 November 2026)
- Codex docs: advanced config and profiles (sprawdzono 20 November 2026)
- Codex CLI repository (sprawdzono 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (sprawdzono 20 November 2026)
- FreeLLMAPI CLI generators (sprawdzono 20 November 2026)