Instalacja Codex CLI na Macu i w Windowsie

Codex CLI to asystent AI od OpenAI, który działa w terminalu. Terminal to okno, w którym wpisujesz komendy zamiast klikać. Codex pracuje na plikach w jednym folderze, wewnątrz piaskownicy (sandbox): to bezpieczne ogrodzenie, które ogranicza, czego może dotknąć. Ty decydujesz, na ile samodzielnie może działać Codex, zanim zapyta Cię o zgodę.

Zanim zaczniesz, sprawdź konto. Tabela planów OpenAI wymienia Codex CLI dla planów ChatGPT Plus, Pro, Business, Edu i Enterprise oraz dla klucza API OpenAI. Klucz API to tajny kod, który rozlicza Cię za każde użycie. Plany Free i Go obejmują Codexa w aplikacji ChatGPT na komputer, ale nie w CLI. Plany się zmieniają, więc przed zakupem sprawdź stronę z cennikiem OpenAI. Płacisz bezpośrednio OpenAI.

Dopiero zaczynasz z terminalem? Najpierw przeczytaj Jak otworzyć terminal.

Otwórz terminal

• Mac: naciśnij Command + Spacja, wpisz Terminal, a potem naciśnij Return.
• Windows: naciśnij klawisz Windows, wpisz PowerShell, a potem naciśnij Enter. OpenAI zaleca uruchomić komendę dla Windowsa w nowym oknie PowerShell.

Wklej komendę instalacyjną

Skopiuj komendę dla swojego komputera, wklej ją do terminala i naciśnij Return lub Enter.

Mac (i Linux):

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

Windows PowerShell:

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

Poczekaj, aż komenda się zakończy i wiersz poleceń wróci.

Jeśli już używasz npm (narzędzia do instalowania programów) lub Homebrew (instalatora aplikacji na Maca), OpenAI podaje też takie komendy:

$ npm install -g @openai/codex

$ brew install --cask codex

Otwórz nowe okno terminala

Zamknij okno i otwórz nowe. Nowe okno znajduje programy zainstalowane chwilę wcześniej.

Sprawdź, czy się udało

$ codex --version

Zobaczysz numer wersji. Jeśli zamiast niego zobaczysz błąd, przejdź niżej do części Jeśli to nie zadziałało.

Przejdź do folderu projektu

Codex pracuje na folderze, w którym go uruchomisz. Zacznij w folderze testowym, a nie w takim, w którym leżą ważne pliki. Poradnik Foldery w terminalu pokazuje, jak taki folder utworzyć i do niego wejść.

Uruchom Codexa i zaloguj się

$ codex

Za pierwszym razem wybierz Sign in with ChatGPT. Otworzy się okno przeglądarki. Zaloguj się, a przeglądarka odeśle Cię z powrotem do Codexa.

Jeśli wolisz użyć klucza API, OpenAI podaje taką komendę. Odczytuje ona klucz z ustawienia o nazwie OPENAI_API_KEY:

$ printenv OPENAI_API_KEY | codex login --with-api-key

Dalej przeczytaj Pierwsza sesja z Codexem.

Jeśli to nie zadziałało

A parameter cannot be found that matches parameter name 'fsSL' (Windows)

Do PowerShella trafiła komenda dla Maca. W PowerShellu curl to inny program, który nie przyjmuje takich opcji. Pomoc instalacyjna Anthropic wyjaśnia ten sam komunikat PowerShella. Użyj komendy dla Windowsa z góry strony.

Terminal pisze, że nie znajduje codex

Okno było otwarte jeszcze przed instalacją, więc nie zna nowego programu. Zamknij okno, otwórz nowe i wpisz ponownie codex --version. Jeśli to nadal nie działa, uruchom jeszcze raz komendę instalacyjną i przeczytaj jej ostatnie wiersze. Poszukaj komunikatu o PATH (liście folderów, w których terminal szuka programów).

Logowanie w przeglądarce się nie kończy

Tak bywa na zdalnym komputerze albo na serwerze bez przeglądarki. OpenAI proponuje logowanie kodem urządzenia (device code). Najpierw włącz logowanie kodem urządzenia w ustawieniach bezpieczeństwa ChatGPT. Potem uruchom:

$ codex login --device-auth

Otwórz pokazany link na dowolnym urządzeniu, zaloguj się i wpisz kod.

Codex nie uruchamia się po aktualizacji

OpenAI usunęło stare ustawienie, approval_policy = "untrusted", a ta linia może blokować uruchomienie Codexa. Otwórz plik z ustawieniami Codexa, ~/.codex/config.toml, i usuń tę linię. Bezpieczny zamiennik znajdziesz na stronie OpenAI o zatwierdzeniach i bezpieczeństwie.