Strona główna → Poradniki → Codex z własnym API: konfiguracja config.toml dla Codex CLI i Codex desktop

Codex z własnym API: konfiguracja config.toml dla Codex CLI i Codex desktop

Codex czyta dostawcę z jednego pliku. Pięć linii konfiguracji i jedna zmienna środowiskowa przełączają jednocześnie narzędzie wiersza poleceń i aplikację desktopową — a większość awarii bierze się ze zmiennej, nie z konfiguracji.

Konfiguracja

Dodaj dostawcę w config.toml i ustaw go jako domyślnego:

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

Liczą się trzy szczegóły. base_url kończy się na /v1, bo Codex sam dopisuje /responses. wire_api = "responses" sprawia, że Codex używa Responses API, które obsługuje ta bramka. A env_key to nazwa zmiennej środowiskowej, nie sam klucz.

Gdzie jest plik

• macOS / Linux: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

Utwórz folder i plik, jeśli ich nie ma. Aplikacja desktopowa Codex czyta ten sam plik co narzędzie wiersza poleceń, więc jedna zmiana działa w obu. Jeśli nie chcesz ręcznie edytować TOML, CC Switch może go zapisać za ciebie — zobacz przewodnik po aplikacjach desktopowych.

Ustawienie klucza tak, by Codex go widział

macOS / Linux — dopisz go do profilu powłoki:

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows — zapisz go dla swojego konta użytkownika:

setx APICLAN_API_KEY "sk-your-key"

Tu psuje się większość konfiguracji. Zmienna ustawiona przez export lub $env: istnieje tylko w tym terminalu; aplikacja desktopowa uruchomiona z Docka lub menu Start nigdy jej nie widzi. setx w Windows zapisuje ją na stałe, ale odczytują ją tylko programy uruchomione później — zamknij Codex całkowicie i otwórz ponownie.

Wybór modelu i poziomu rozumowania

Zmień model w konfiguracji albo przełącz w sesji poleceniem /model:

Model	Dobry do
gpt-6.1-sol, gpt-5.6-terra	Codzienne programowanie, poprawki, testy — najtańszy na wywołanie
gpt-5.6-sol	Gdy prompty są dostrojone do GPT-5.6
gpt-6-astra	Trudnych problemów, w których lepsza odpowiedź jest warta pięciokrotnej ceny

model_reasoning_effort przyjmuje low, medium, high i xhigh. Wyższy poziom pisze więcej: na gpt-5.6-sol mediana wywołania przy high zwróciła tu 373 tokeny wyjścia, a przy medium 139 — 2,7 razy więcej, wszystko liczone jako wyjście. Zacznij od medium. Ceny są w przewodniku po cenach API OpenAI.

Jak wygląda tu ruch z Codex

W ostatnich 30 dniach 87% wszystkich wywołań GPT na tej bramce pochodziło z Codex, każde przez /v1/responses ze strumieniowaniem. Mediana wywołania:

• niosła ok. 67 000 tokenów kontekstu, 86% z cache
• trwała łącznie 14 sekund, pierwszy token po 10
• zwróciła 214 tokenów wyjścia

Cztery najczęstsze błędy

• 401 Unauthorized → Codex nie widzi APICLAN_API_KEY. Ustaw ją jak wyżej i uruchom Codex całkowicie od nowa. echo $APICLAN_API_KEY w tym samym środowisku powinno wypisać klucz.
• 404 lub strona HTML → w base_url brakuje /v1 albo występuje dwa razy.
• model not found → nazwa modelu jest błędna albo twój klucz należy do grupy bez tego modelu. Wiążąca jest lista z GET https://apiclan.us/v1/models.
• stream disconnected lub przekroczenie czasu przy długich zadaniach → bardzo długie rozumowanie przekracza cierpliwość proxy. Zmień base_url na https://api.apiclan.us/v1, który omija 100-sekundowy limit.

Claude Code stosuje odwrotną konwencję — bez /v1 — opisaną w przewodniku po base URL dla Claude Code.

Zacznij korzystać

Bez abonamentu, bez minimum miesięcznego, bez rozmowy z handlowcem. Doładuj w USDT i płać za to, czego używasz — 1 USDT to 2 kredyty salda API.

Przeczytaj 30-sekundowy szybki start

Język: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Ceny na tej stronie są uzupełniane automatycznie z rzeczywistych danych rozliczeniowych. Warunki stron trzecich cytujemy z ich dokumentacji.