OpenAI Codex: czym jest, instalacja i dostęp regionalny

Słowo „Codex” w wynikach wyszukiwania oznacza trzy różne rzeczy, a osoby, które wpisują je po raz pierwszy, zwykle nie rozumieją, na co trafiły. Istniał model Codex — został wycofany w 2023 roku; dziś ta nazwa należy do programu-agenta, a w obiegu jest jeszcze kilkanaście innych produktów o tej samej nazwie.

Opisuję tylko jeden Codex: agenta programistycznego OpenAI. Co robi, gdzie działa, ile kosztuje, jak zainstalować go w pięć minut i co OpenAI mówi o poszczególnych krajach. Wszystko opiera się na oficjalnej dokumentacji, a linki do każdej liczby znajdują się na końcu.

Dodatkowe materiały o konfigurowaniu narzędzi znajdziesz w dokumentacji Ailoot.

Czym jest OpenAI Codex?#

Porównaj go ze zwykłym czatem. W czacie kopiujesz fragment kodu, wklejasz go, otrzymujesz odpowiedź, a potem kopiujesz ją z powrotem. Agent działa inaczej: opisujesz zadanie zwykłym językiem, a on otwiera odpowiednie pliki w folderze projektu, wprowadza zmiany, uruchamia kontrole i pokazuje wynik.

OpenAI opisuje go jednym zdaniem w swoim repozytorium:

Lokalnie oznacza, że program jest pobierany na Twoje urządzenie, gdzie może widzieć Twoje pliki i uruchamiać polecenia w folderze. Do chmury trafia tylko zapytanie do modelu.

Kod open source jest dostępny na GitHubie na licencji Apache-2.0. Na 1 sierpnia 2026 roku repozytorium ma 103 000 gwiazdek, a najnowsza wersja, 0.146.0, została wydana 29 lipca. Aktualizacje pojawiają się niemal codziennie, więc Twoja wersja najprawdopodobniej będzie już inna.

Czym Codex z 2026 roku różni się od starego, wycofanego Codexu?#

Ludzie często je mylą, ponieważ oba produkty są oficjalne i pochodzą od OpenAI. Różnią się datami.

Pierwszym była rodzina modeli: code-davinci-001, code-davinci-002, code-cushman-001, code-cushman-002. Robiły tylko jedną rzecz — uzupełniały kod — i zasilały pierwszą wersję GitHub Copilot. Na liście wycofanych modeli OpenAI wszystkie cztery znajdują się w jednym wierszu: ogłoszono je 20 marca 2023 roku, wycofano 23 marca, a jako zalecany zamiennik wskazano gpt-4o.

Drugi produkt to program instalowany na komputerze. Pakiet @openai/codex pojawił się w rejestrze npm 16 kwietnia 2025 roku. Model używany w środku jest z czasem zastępowany nowszym, a sam program pozostaje ten sam.

Wszelkie instrukcje dotyczące Codexu sprzed kwietnia 2025 roku opisują wycofany produkt. Jeśli znajdziesz materiały, które nazywają Codex modelem i sugerują wywoływanie go przez code-davinci-002, zamknij je.

Gdzie działa Codex: w terminalu, edytorze, przeglądarce czy aplikacji?#

Nie musisz wybierać tylko jednego sposobu. Logowanie i konto są takie same. Różni się jedynie to, gdzie wygodniej Ci pracować.

Rozszerzenie działa inaczej w Xcode i JetBrains niż w pozostałych edytorach:

Chmura działa inaczej niż pozostałe cztery opcje. Zadanie trafia do kontenera OpenAI, gdzie z GitHuba pobierana jest kopia repozytorium. Agent pracuje bez użycia Twojego komputera, a Ty później przeglądasz wynik i decydujesz, czy przenieść zmiany do własnej kopii. Konfiguracja obejmuje trzy kroki: połączenie z GitHubem, utworzenie środowiska z wymaganymi zależnościami i przypisanie zadania.

Jeśli logujesz się kluczem API, działają terminal, edytor i aplikacja. Klucz nie umożliwia korzystania z chmury ani powiązanych z nią funkcji, takich jak automatyczny przegląd kodu i uruchamianie zadań ze Slacka. Aby z nich korzystać, musisz zalogować się na konto ChatGPT.

Jaki model działa w Codexie?#

OpenAI podsumowuje to jednym zdaniem:

Obok modelu znajduje się drugi element sterujący: poziom wysiłku rozumowania. Dostępne są cztery ustawienia: Low (w aplikacji i edytorze nazywane Light), Medium, High oraz Extra High. OpenAI zaleca używanie najniższego poziomu, który zapewnia oczekiwany rezultat, i podnoszenie go, gdy zadanie wymaga planowania.

Dostępne są też dwa wyższe tryby. Max daje modelowi więcej czasu na zadanie. Ultra dzieli pracę na części i przydziela je równolegle subagentom. Dokumentacja wprost stwierdza, że większość zadań nie wymaga żadnego z nich.

Dostępna jest również osobna pozycja gpt-5.3-codex-spark — wersja badawcza do szybkich iteracji, dostępna wyłącznie w planie Pro.

Wybór modelu i poziomu wysiłku rozumowania to już inżynieria kontekstu: decydujesz, ile agent ma myśleć i jakie informacje otrzyma do zadania.

Ile kosztuje Codex i co obejmują plany?#

Ceny sprawdziłem na oficjalnej stronie cennika 1 sierpnia 2026 roku.

Business kosztuje $25 za miejsce przy rozliczeniu miesięcznym, zamiast $20.

A teraz limity. OpenAI nie podaje jednej stałej liczby:

Zamiast jednej liczby OpenAI publikuje zakres: liczbę wiadomości, które możesz wysłać w ciągu pięciu godzin, pracując na własnym komputerze. Wartości dla Plus i Business są takie same:

W planie Pro za 100 dolarów wszystkie wartości mnoży się przez pięć, a w planie Pro za 200 dolarów — przez dwadzieścia. OpenAI wspomina też o limitach tygodniowych oprócz pięciogodzinnego okna, ale nie publikuje dla nich konkretnych wartości.

Dziesięciokrotny zakres dla jednego modelu ma proste wyjaśnienie. Jedna wiadomość może zużyć 1% albo 10% dziennego limitu, bo liczy się ilość wykonanej pracy, a liczba zapytań ma niewielkie znaczenie. Szczegółowo wyjaśniłem, jak tokeny są wykorzystywane w praktyce, na przykładzie Claude’a w artykule Limity Claude Pro i Max — mechanizm jest dokładnie taki sam.

Po wyczerpaniu limitu masz trzy możliwości: kupić dodatkowe kredyty bez zmiany planu, przełączyć się na lżejszy model albo rozpocząć sesję z kluczem API i płacić za wykorzystane tokeny.

Jakie ograniczenia regionalne dotyczą Codexu?#

OpenAI publicznie udostępnia oficjalną listę obsługiwanych krajów i terytoriów. Białorusi na niej nie ma. Kazachstan, Armenia, Gruzja, Turcja, Serbia i Ukraina są na liście.

Na tej samej stronie czytamy:

Instalacja i uruchomienie programu to jedno, a dostęp do modelu to drugie. Weryfikacja kraju odbywa się przy logowaniu: zarówno logowanie przez ChatGPT, jak i logowanie kluczem API prowadzi do konta OpenAI.

Zgłoszenia na GitHubie pokazują, jak wygląda odmowa związana z krajem. W styczniu 2026 roku programista z Wenezueli napisał, że używał Codexu 0.88.0 w PowerShellu i za każdym razem otrzymywał ten sam komunikat:

{
  "error": {
    "code": "unsupported_country_region_territory",
    "message": "Country, region, or territory not supported",
    "type": "request_forbidden"
  }
}

Kod unsupported_country_region_territory i status 403 wskazują na odmowę związaną z krajem. Jeśli je widzisz, oznacza to, że niczego nie zepsułeś podczas instalacji i Node nie ma z tym nic wspólnego.

Jest też druga przeszkoda, której dokumentacja w ogóle nie opisuje, a która w praktyce pojawia się częściej: weryfikacja numeru telefonu. Zgłoszenie „Phone number verification doesn’t work” ma 206 komentarzy; drugie, dotyczące starego numeru, do którego nie ma już dostępu i którego nie można zmienić, pozostaje otwarte od czerwca 2026 roku i ma 71 komentarzy. Powtarza się ta sama historia: ChatGPT działa w przeglądarce na tym samym koncie, ale Codex prosi o weryfikację telefonu i nie ma sposobu, by ją ominąć. OpenAI nie publikuje listy krajów, których numery telefonów akceptuje, więc nie można wcześniej sprawdzić, czy Twój numer zadziała.

Nie opisuję sposobów obejścia ograniczeń; ten artykuł dotyczy działania narzędzia.

Anthropic także publikuje listę obsługiwanych krajów, a zasada działania jest taka sama. Materiały, które przedstawiają jedno narzędzie jako „dozwolone”, a drugie jako „zablokowane”, po prostu wprowadzają czytelników w błąd — formalnie oba są w takiej samej sytuacji. Obie listy się zmieniają, więc sprawdzaj ich aktualne wersje.

Jak zainstalować Codex: instrukcja krok po kroku#

Tutaj zaczyna się część techniczna, dla osób, które mają już aktywne konto OpenAI.

1. Zainstaluj program

   Wybierz metodę odpowiednią dla swojego systemu. Później używaj tej samej metody, aby zaktualizować program do najnowszej wersji.

2. Otwórz folder projektu

   Agent działa w folderze, z którego go uruchomiono. Przed wykonaniem pierwszego polecenia przejdź do tego folderu.

3. Zaloguj się na konto

   Przy pierwszym uruchomieniu codex zaproponuje zalogowanie. Otworzy się przeglądarka, a po zalogowaniu sterowanie wróci do terminala.

4. Zleć pierwsze zadanie

   Opisz, czego potrzebujesz, zwykłym językiem. Zacznij od czegoś nieszkodliwego, na przykład poproś o opis projektu.

Polecenie instalacyjne dla macOS i Linuxa:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

W Windows użyj tego samego instalatora w PowerShellu:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Jeśli masz już Node, możesz zainstalować program przez npm:

npm install -g @openai/codex

Na macOS możesz też użyć Homebrew. Pamiętaj o --cask; bez tego zainstalujesz niewłaściwy program:

brew install --cask codex

Na Linuxie i WSL2 piaskownica opiera się na bubblewrap, który trzeba wcześniej zainstalować:

sudo apt install bubblewrap

W Fedorze i systemach pokrewnych użyj sudo dnf install bubblewrap. WSL w wersji 1 był obsługiwany do wersji 0.114; od wersji 0.115 piaskownica korzysta z bubblewrap, a WSL1 przestał działać. W Windows wszystko działa jednak również bez WSL, dzięki własnej, wbudowanej piaskownicy.

Co zrobić przy pierwszym uruchomieniu?#

Aby zacząć, przejdź do folderu projektu i wpisz codex; otworzy się sesja. Następnie opisz zadanie zwykłym językiem, bez specjalnej składni.

Pięć poleceń na pierwsze minuty:

1. /status - model, polityka zatwierdzania i foldery uznawane przez agenta za jego obszar roboczy.
2. /permissions - bieżący tryb dostępu i sposób przełączania między trybami.
3. /model - zmiana modelu i poziomu wysiłku rozumowania.
4. /init - tworzy plik AGENTS.md opisujący projekt; więcej na ten temat w następnej sekcji.
5. /review - osobny przegląd zmian bez edytowania plików.

Oprócz zwykłego codex przydatne są trzy polecenia terminala:

codex resume                    # return to the previous conversation in this folder
codex exec "fix the tests"      # one-off run without a dialogue, for scripts
codex --image screenshot.png    # attach an image to the task

Na stronach dokumentacji terminala i rozszerzenia OpenAI powtarza tę samą radę: wykonuj commit przed zadaniem i po nim. Agent sam edytuje pliki, więc już od pierwszego dnia warto móc cofnąć zmiany jednym poleceniem.

Jak wyjaśnić Codexowi projekt za pomocą AGENTS.md?#

Kolejność jest ściśle określona, a dokumentacja podaje ją już w pierwszym zdaniu tej sekcji:

Najpierw Codex odczytuje plik globalny ~/.codex/AGENTS.md, w którym zapisujesz zasady dotyczące wszystkich projektów. Następnie odczytuje pliki w samym projekcie: po jednym pliku na folder, od głównego folderu repozytorium do bieżącego folderu. Są łączone od góry do dołu, a plik znajdujący się bliżej zastępuje bardziej oddalony. Oznacza to, że zasada w services/payments ma pierwszeństwo przed ogólną zasadą z folderu głównego.

Prosty plik może wyglądać tak:

# AGENTS.md

## How to work with this project

- Run tests with `npm test`; don't run them one file at a time.
- Install packages with pnpm.
- Ask me before adding a new production dependency.
- Do not touch the `legacy/` folder at all.

Łączny limit plików wynosi 32 kilobajty. Po jego przekroczeniu kolejne pliki po prostu przestają być dodawane, bez powiadomienia. Zbyt duży AGENTS.md również zużywa ten limit przy każdym uruchomieniu, ponieważ cały plik trafia do kontekstu.

Jeśli znasz CLAUDE.md, mechanizm wyda Ci się znajomy: to ta sama metoda pod inną nazwą. Plik z zasadami projektu stanowi fundament Second Brain: agent poznaje Twoją pracę, zanim zdążysz cokolwiek wyjaśnić. W artykule AGENTS.md i CLAUDE.md razem opisałem, jak używać obu plików w jednym projekcie.

Co Codex robi samodzielnie, a co wymaga zatwierdzenia?#

Te dwa ustawienia często są mylone, dlatego OpenAI wyjaśnia różnicę jednym zdaniem:

Przełączenie przeglądu na automatyczny nie zmienia granic folderu roboczego. Automatyzacja usuwa jedynie konieczność klikania; nie zmienia uprawnień agenta.

Aplikacja i edytor mają trzy tryby dostępu. Ask for approval jest zawsze dostępny i zalecany na początek. Approve for me i Full access trzeba najpierw włączyć w ustawieniach.

Terminal ma własne zasady: program sprawdza folder i proponuje odpowiedni zestaw uprawnień.

W trybie lokalnym dostęp do sieci jest domyślnie wyłączony. Agent uruchamia polecenia, które sam wymyślił, więc domyślnie nie powinien mieć dostępu do internetu.

Nawet w folderze roboczym agent nie może odczytywać niektórych lokalizacji w żadnym trybie: .git, .agents i .codex. Użyj /status, aby sprawdzić, które foldery agent obecnie uznaje za swój obszar roboczy.

Istnieje też tryb pełnego dostępu — flaga --dangerously-bypass-approvals-and-sandbox. Dokumentacja oznacza go jako bardziej ryzykowny i opisuje jako „niezalecany”. Nazwa flagi mówi sama za siebie; nie mam nic do dodania.

Codex czy Claude Code: co wybrać?#

Różnica między tymi narzędziami jest mniejsza, niż można wywnioskować z internetowych dyskusji. Oba czytają projekt i samodzielnie edytują pliki, a przed wyjściem poza folder pytają o zgodę.

Na początku najlepiej sprawdzić, za co już płacisz. Jeśli masz subskrypcję ChatGPT, Codex jest już w niej zawarty i nie musisz płacić osobno. Szczegółowe porównanie z pomiarami przygotowałem w osobnym artykule Codex kontra Claude Code, a jeśli chcesz przenieść ustawienia pracy z jednego narzędzia do drugiego, skorzystaj z poradnika migracji.

Co najczęściej psuje się przy pierwszym uruchomieniu?#

Ta lista opiera się na zgłoszeniach w repozytorium projektu. Nie ma tu zgadywania; każdy punkt pochodzi od osoby, która napotkała dany problem.

1. Zainstalowano niewłaściwy pakiet. npm install -g codex bez prefiksu instaluje generator statycznych stron z 2011 roku. Prawidłowy pakiet to @openai/codex.
2. Nie zainstalowano bubblewrap. Bez niego w Linuxie i WSL2 piaskownica się nie uruchamia. Codex przełącza się na wbudowany mechanizm zastępczy i zgłasza problem przy starcie. Instalacja wymaga jednego polecenia.
3. Odmowa dostępu ze względu na kraj. Kod unsupported_country_region_territory i status 403 pojawiają się podczas logowania. Nie ma to związku z instalacją.
4. Wymagana jest weryfikacja telefonu. Nie dotyczy to wszystkich i nie opisano tego w dokumentacji. Nie ma oficjalnego sposobu na zastąpienie niedostępnego numeru; zgłoszenie dotyczące tego problemu pozostaje otwarte od czerwca 2026 roku.
5. Limit użycia wyczerpuje się wcześniej, niż oczekiwano. Zgłoszenie „Tokens burn up very quickly” jest najczęściej omawiane w całym repozytorium i ma 627 komentarzy. Pomóc może przejście na lżejszy model i obniżenie poziomu wysiłku rozumowania.

Język interfejsu nie wpływa na pracę agenta: język zadania nie musi być zgodny z językiem interfejsu.

Co zrobić dalej#

Pierwsza godzina pracy z agentem zawsze sprowadza się do tego samego: sprawdzenia, jak daleko może posunąć się samodzielnie. Możesz się tego dowiedzieć tylko na własnym projekcie; przykład z dokumentacji Ci tego nie pokaże.

Oto kolejność, którą polecam na początek:

1. Zainstaluj program i zaloguj się na aktywne konto OpenAI.
2. Otwórz folder prawdziwego projektu i uruchom codex.
3. Sprawdź /status i /permissions, jawnie wybierz dostęp tylko do odczytu dla zadania inspekcji i potwierdź aktywny tryb przed pytaniem o organizację projektu.
4. Utwórz commit i zleć pierwsze zadanie edycyjne.
5. Napisz trzywierszowy plik AGENTS.md i porównaj odpowiedzi agenta przed jego dodaniem i po nim.

Dodatkowe materiały znajdziesz w dokumentacji Ailoot.