Codex CLI: własny klucz zamiast subskrypcji

Codex to nie podpowiadacz w edytorze, a samodzielny wykonawca. Ty formułujesz zadanie słowami, on sam decyduje, które pliki przeczytać, jakie komendy wykonać i co zmienić. Ma do dyspozycji około dziesięciu narzędzi: uruchamianie komend, czytanie plików, prowadzenie planu pracy, pytanie użytkownika o doprecyzowanie, tworzenie agentów potomnych do podzadań.

Dwa tryby pracy. Interaktywny — codex bez argumentów, dialog w terminalu z pokazywaniem każdego kroku. Nieinteraktywny — codex exec "task", jednorazowe uruchomienie do wyniku: wygodne w skryptach i CI.

Bezpieczeństwo jest wbudowane: domyślnie agent pracuje w piaskownicy i pyta o potwierdzenie przed zmianami. Poziom kontroli ustawia się w konfiguracji — od „pytaj o wszystko” do w pełni autonomicznego uruchomienia z prawem zapisu w katalogu roboczym.

Jeszcze jedna osobliwość to stan rozmowy. Codex nie prosi serwera o zapamiętywanie czegokolwiek: cały wątek trzyma u siebie i wysyła go w całości przy każdej turze. Dla ciebie oznacza to, że korespondencja nie zalega po stronie providera modelu, a zmiana endpointu nie psuje rozpoczętej sesji.

Różnica względem Claude Code i innych agentów terminalowych tkwi właśnie w protokole. Codex komunikuje się z modelem przez Responses API, gdzie rozmowa opisywana jest nie płaską listą wiadomości, a strumieniem elementów: tekst, wywołanie narzędzia, wynik wywołania, blok rozumowania. Narzędziu daje to bardziej rygorystyczny model dialogu, a tobie — konieczność posiadania endpointu, który ten protokół rozumie.

Szybka droga — instalator. Komenda npx @joingonka/setup --tool codex sama dopisze do ~/.codex/config.toml blok dostawcy z wire_api = "responses", model i jego rzeczywiste okno kontekstu, zachowując twoje komentarze i pozostałe ustawienia, a następnie żywym zapytaniem sprawdzi klucz i model. Jeśli w konfiguracji wybrany jest już inny dostawca, instalator go nie ruszy i podpowie komendę do jednorazowego uruchomienia. Klucz zapisuje wprost w pliku (uprawnienia 600), w polu experimental_bearer_token — jedynym, w którym Codex może przechowywać klucz literalnie; sam Codex uznaje je za eksperymentalne. Wariant ręczny poniżej obywa się bez zmiennej środowiskowej.

Codex przechowuje ustawienia w ~/.codex/config.toml. Własnego dostawcę opisuje blok [model_providers.*], a kluczowym polem jest tu wire_api: bez niego Codex spróbuje rozmawiać przez Chat Completions i nie złoży pętli agentowej.

# ~/.codex/config.toml
model_provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"

[model_providers.joingonka]
name = "JoinGonka Gateway"
base_url = "https://gate.joingonka.ai/v1"
env_key = "JOINGONKA_API_KEY"
wire_api = "responses"

Klucz nie jest zapisywany w pliku: env_key wskazuje nazwę zmiennej środowiskowej, z której Codex go pobierze. Nazwa zmiennej jest własna, nie OPENAI_API_KEY — dzięki temu konfiguracja nie przechwytuje twoich innych narzędzi pracujących z OpenAI.

export JOINGONKA_API_KEY=jg-your-key

Pole model ustawia model domyślny, a model_provider — który z opisanych bloków ma być użyty. Oba można nadpisać w momencie uruchomienia, więc jedna konfiguracja spokojnie obsługuje kilku dostawców: produkcyjnego, eksperymentalnego i zapasowego.

Klucz wydawany jest w panelu użytkownika po rejestracji, tam też widać saldo i wydatki. Jeśli wolisz nie ruszać wspólnej konfiguracji, ten sam blok można przekazać jednorazowo przez -c: codex -c model_provider=joingonka …. A aby utrzymać kilka niezależnych konfiguracji, wskaż katalog ustawień zmienną CODEX_HOME.

Najszybszy sposób, by sprawdzić, czy konfiguracja działa, to jednorazowe uruchomienie:

codex exec "Answer in one line: what is 17*3?"

W nagłówku odpowiedzi Codex wypisuje, z kim pracuje: model, provider: joingonka, tryb piaskownicy i identyfikator sesji. Jeśli widnieje tam twój dostawca, a na dole przyszła odpowiedź — połączenie żyje.

Dalej warto sprawdzić to, po co właściwie stawia się Codex — pracę z plikami. Umieść w katalogu niewielki plik z oczywistym błędem i poproś, by go znalazł:

codex exec "Read calc.py and tell me in one sentence whether it has a bug."

Agent powinien sam wywołać narzędzie do czytania, otworzyć plik i odpowiedzieć konkretnie — ze wskazaniem linii. Jeśli tak się stało, pełny cykl agentowy (zapytanie → wywołanie narzędzia → wynik → odpowiedź) przez bramę składa się poprawnie.

Jeśli coś poszło nie tak, diagnozę zwykle odczytasz wprost z komunikatu:

Pierwsze zapytanie w sesji może zająć kilka sekund: Codex wysyła duży prompt systemowy i opis wszystkich swoich narzędzi, a węzeł sieci musi przyjąć zadanie. Kolejne odpowiedzi przychodzą szybciej.

Wszystkie modele sieci są dostępne w tej samej cenie, więc wybór dotyczy zachowania, a nie budżetu. Poniżej wynik testu na żywo tego samego zadania (odczyt pliku i wyszukiwanie błędu) przez Codex na DeepSeek V4 Flash i MiniMax M2.7; GLM-5.3 Flash pojawił się w sieci po zakończeniu testu — dla niego podano specyfikację modelu.

Domyślna rekomendacja to DeepSeek V4 Flash: praca agentowa szybko napotyka barierę objętości kontekstu, a 380K tokenów daje możliwość utrzymania wielu plików w pamięci jednocześnie. Jeśli zadanie wymaga przemyślenia zawiłej logiki — wybierz GLM-5.3 Flash, ale zarezerwuj margines w max_tokens: część budżetu odpowiedzi jest przeznaczana na rozumowanie. Model zmienia się za pomocą jednej linii model w config lub flagi -c model=… bez edycji pliku.

Aktualna lista modeli sieci zawsze dostępna pod GET https://gate.joingonka.ai/v1/models.

Narzędzia agentowe zużywają tokeny inaczej niż czat: do każdej Twojej frazy Codex dodaje prompt systemowy i opis wszystkich narzędzi, a następnie prowadzi wieloetapowy dialog z modelem. W przykładowym teście proste zadanie „odczytaj plik i znajdź błąd” kosztowało około 18-20 tysięcy tokenów. To normalna cena za autonomię i właśnie dlatego cena za token ma kluczowe znaczenie.

Przez JoinGonka Gateway tokeny kosztują $0.0069 za milion na wejściu i $0.021 za milion na wyjściu — cena jest taka sama dla wszystkich modeli w sieci i jest pobierana na tej stronie z aktywnego źródła.

Dla porównania — jak wyglądają płatne opcje u samego Codex oraz u konkurencji:

Płatność następuje za faktyczne zużycie, bez miesięcznego abonamentu i bez limitów liczby zapytań: brak pięciogodzinnych okien, limitów „promptów” i mnożników w godzinach szczytu. Saldo zasilane jest kryptowalutą, stan konta i zużycie dzienne są widoczne w panelu użytkownika. Szczegółowa analiza ekonomiczna znajduje się w artykule o najtańszym API.

Historię dialogu przechowuje sam Codex. Wysyła ją w całości z każdym zapytaniem i nie prosi serwera o zapamiętywanie czegokolwiek — my również nie przechowujemy korespondencji. Twój kod i prompt nie pozostają na bramce po udzieleniu odpowiedzi.

Wyszukiwanie w internecie działa. Codex ogłasza narzędzie wyszukiwania w każdym zapytaniu, a bramka je przyjmuje: wyszukiwanie odbywa się po naszej stronie, wyniki są wstrzykiwane do odpowiedzi modelu.

Narzędzia są własne, nie chmurowe. Codex wykonuje polecenia i czyta pliki lokalnie, na Twoim komputerze, więc dostęp do projektu nie zależy od dostawcy modelu.

Piaskownica (Sandbox). W systemie Linux Codex używa bubblewrap do izolacji uruchamianych poleceń. Jeśli nie ma go w systemie, Codex ostrzeże Cię i użyje wbudowanej kopii — nie wpływa to na działanie, ale pakiet wygodniej jest zainstalować za pomocą standardowego menedżera.

Jeśli potrzebujesz pracy z obrazami — zrzut ekranu interfejsu, schemat na zdjęciu — użyj do takich zadań narzędzia z modelem posiadającym funkcje wizyjne: w sieci Gonka modele są tekstowe. Dla kodu, poleceń i plików nie stanowi to ograniczenia.

Inne agenty terminalowe, jeśli Codex nie był odpowiedni: szybki start API pokazuje, jak w kilka minut podłączyć dowolne kompatybilne narzędzie.