Strona główna / Poradniki / Codex CLI z darmowymi modelami

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

Otwó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
codex

Polecenie 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
KluczCo robi
model_providerWybiera dostawcę z model_providers. Domyślnie to openai.
env_keyZmienna środowiskowa z kluczem API dostawcy
requires_openai_authfalse oznacza, że Codex nie pyta o logowanie do OpenAI
model_context_windowTokeny kontekstu aktywnego modelu. Polecenie pobiera wartość z aktywnego katalogu.
model_auto_compact_token_limitLiczba tokenów, po której zaczyna się automatyczne kompaktowanie historii. Polecenie ustawia 90% okna kontekstu.
tool_output_token_limitBudż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-codex

Aby 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ę.

Profile: dokumentacja Codex mówi, że Codex 0.134.0 i nowsze nie czyta już tabel [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.

Darmowe modele dla Codex CLI: wywoływanie narzędzi i kontekst 128K+
ModelZa darmo wKontekstDarmowe limity (najlepsza oferta)NarzędziaWizja
GLM 5.3UnoRouter1M1 żądań/min
1 req/min per model
TakNie
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 żądań/min
40 RPM
TakTak
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaTakTak
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceTakNie
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditTakTak
Gemini 3.7 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditTakTak
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 żądań/min
50 żądań/dzień
50 req/day account-wide (1,000 after a $10 purchase)
TakTak
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 żądań/min
50 żądań/dzień
Shared rate limit
TakNie
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 żądań/min
250 żądań/dzień
70,000 tokenów/min
~6M
TakTak
Gemini 3.6 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayTakTak

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

ProblemPrzyczynaRozwiązanie
Codex prosi o logowanie przez ChatGPTmodel_provider nie jest ustawione, więc Codex używa openaiUstaw model_provider = "freellmapi"
401 "Invalid API key"FREELLMAPI_API_KEY nie jest ustawione w tej powłoceWyeksportuj zmienną albo użyj npx freellmapi launch-codex
"Model metadata for auto not found"Codex nie zna identyfikatorów modeli bramyDodaj model_catalog_url
Błędy przy wire_api = "chat"Codex obsługuje tylko Responses APIUstaw wire_api = "responses"
Ustawienia profilu są ignorowaneCodex 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 limitDodaj klucze od większej liczby dostawców albo poczekaj na koniec okresu wstrzymania
Używaj wszystkich tych modeli przez jeden klucz. FreeLLMAPI to router o otwartym kodzie, uruchamiany na własnym serwerze. Łączy wszystkie te darmowe plany za jednym punktem końcowym zgodnym z OpenAI i przełącza się na inny dostawcę, gdy limit zostanie przekroczony. Przeglądaj katalog lub uruchom.

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.] z base_url, env_key i wire_api = "responses", a potem ustaw model_provider. Dostawca musi udostępniać Responses API.

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

Źródła

Wszystkie poradniki · Przeglądaj wszystkie darmowe modele