Przejdź do głównej zawartości
Developer Toolkit

Instalacja

Masz plan ChatGPT obejmujący Codex, a teraz wpatrujesz się w stronę pobrań, zastanawiając się, którego klienta zainstalować najpierw. Po skonfigurowaniu lokalne klienty współdzielą uwierzytelnianie i konfigurację Codex.

Co wyniesiesz z tego przewodnika

Dział zatytułowany „Co wyniesiesz z tego przewodnika”
  • Aplikacja desktopowa ChatGPT z trybem Codex zainstalowana na macOS albo Windows
  • Codex CLI dostępne globalnie przez polecenie codex
  • Rozszerzenie Codex IDE działające w VS Code, Cursor lub Windsurf oraz zrozumienie osobnych integracji JetBrains i Xcode
  • Wszystkie trzy powierzchnie współdzielące ten sam katalog konfiguracji ~/.codex/
  • Weryfikacja że każda powierzchnia uruchamia się i uwierzytelnia poprawnie

Instalacja ChatGPT Codex na desktopie (macOS lub Windows)

Dział zatytułowany „Instalacja ChatGPT Codex na desktopie (macOS lub Windows)”

Codex jest teraz trybem w nowej aplikacji desktopowej ChatGPT na macOS i Windows. Zapewnia równoległe wątki, izolację worktree, wbudowane narzędzia Git, automatyzacje i zintegrowany terminal. Jeśli używasz samodzielnej aplikacji Codex, zaktualizuj ją normalnie: stanie się nową aplikacją ChatGPT i zachowa istniejące zadania oraz projekty Codex. Zobacz przewodnik migracji OpenAI.

  1. Otwórz oficjalną stronę pobierania ChatGPT i wybierz macOS. Strona udostępnia odpowiednią bieżącą wersję.

  2. Otwórz instalator i dodaj ChatGPT do folderu Aplikacje.

  3. Uruchom ChatGPT z Aplikacji. macOS może poprosić o potwierdzenie otwarcia aplikacji od zidentyfikowanego dewelopera — kliknij Otwórz.

  4. Zaloguj się kontem ChatGPT, gdy zostaniesz poproszony.

  5. W selektorze trybu wybierz Codex, a następnie otwórz folder projektu.

Instalacja Codex CLI

Dział zatytułowany „Instalacja Codex CLI”

CLI jest open-source, zbudowane w Rust i działa na macOS, Linux i Windows. Samodzielny instalator jest podstawową ścieżką i nie wymaga Node.js.

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

Instalator dodaje bieżący samodzielny build do PATH użytkownika. Uruchom go ponownie, aby zaktualizować, albo użyj codex update z bieżącej instalacji.

Po instalacji uruchom codex --version (bieżące wydanie opisane tutaj to 0.144.1), a następnie codex. Pierwsze uruchomienie poprosi o logowanie przez ChatGPT albo klucz API.

Instalacja rozszerzenia IDE

Dział zatytułowany „Instalacja rozszerzenia IDE”

Rozszerzenie OpenAI Codex jest przeznaczone dla VS Code i zgodnych forków, takich jak Cursor oraz Windsurf. JetBrains i Xcode udostępniają osobne integracje Codex; nie są to buildy rozszerzenia VS Code.

Zainstaluj z Visual Studio Code Marketplace lub otwórz VS Code i wyszukaj “Codex” w panelu Rozszerzenia.

Po instalacji ikona Codex pojawi się w lewym panelu bocznym. Kliknij ją, zaloguj się i jesteś gotowy.

Przenoszenie Codex do prawego panelu bocznego

Dział zatytułowany „Przenoszenie Codex do prawego panelu bocznego”

Większość deweloperów preferuje panel Codex po prawej stronie edytora, zachowując eksplorator plików po lewej.

W VS Code wystarczy przeciągnąć ikonę Codex z lewego panelu bocznego na prawy. W Cursor może być konieczne tymczasowe ustawienie orientacji paska aktywności na vertical w ustawieniach Workbench, restart, przeciągnięcie ikony, a następnie przywrócenie horizontal.

Jak powierzchnie są połączone

Dział zatytułowany „Jak powierzchnie są połączone”

Lokalne klienty OpenAI (ChatGPT desktop, CLI i rozszerzenie rodziny VS Code) mogą współdzielić konfigurację i zapisane poświadczenia, gdy używają tego samego CODEX_HOME:

Współdzielony zasóbLokalizacja
Konfiguracja użytkownika~/.codex/config.toml
Uwierzytelnianie~/.codex/auth.json lub systemowy keyring
Serwery MCPZdefiniowane w config.toml, współdzielone przez wszystkie powierzchnie
AGENTS.mdCzytany z ~/.codex/AGENTS.md (globalny) i katalogu głównego projektu (poziom projektu)

Oznacza to, że lokalne klienty OpenAI możesz skonfigurować raz. Nie kopiuje to ustawień do środowisk Codex Cloud, JetBrains AI ani Xcode; skonfiguruj je we własnym interfejsie lub ustawieniach workspace’u.

Tryb Codex w aplikacji desktopowej ChatGPT i rozszerzenie IDE również synchronizują się, gdy oba są otwarte w tym samym projekcie. Aplikacja desktopowa śledzi pliki przeglądane w edytorze (Auto Context), a wątki rozpoczęte na jednej powierzchni pojawiają się na drugiej.

Gdy coś nie działa

Dział zatytułowany „Gdy coś nie działa”

Aplikacja nie otwiera się na macOS: Pobierz ponownie bieżący build ChatGPT z chatgpt.com/download zamiast polegać na starej nazwie pliku DMG Codex. Sprawdź Ustawienia systemowe > Prywatność i bezpieczeństwo, jeśli macOS blokuje aplikację.

Instalacja CLI przez npm nie powiodła się: Upewnij się, że Node.js 16+ jest zainstalowany (node --version). Przy błędach EACCES użyj samodzielnego instalatora albo skonfiguruj prefix npm należący do użytkownika zamiast sudo.

Rozszerzenie IDE nie jest widoczne: W Cursor rozszerzenie może być ukryte w zwiniętej sekcji poziomego paska aktywności. Poszukaj menu przepełnienia >> na pasku lub tymczasowo przełącz na orientację pionową.

Uwierzytelnianie nie utrzymuje się: Sprawdź czy ~/.codex/auth.json istnieje po zalogowaniu. Jeśli go brak, twój systemowy magazyn poświadczeń może być w użyciu. Zobacz przewodnik uwierzytelniania po konfigurację przechowywania poświadczeń.

“codex: command not found” po instalacji Homebrew: Uruchom brew link codex lub upewnij się że /opt/homebrew/bin jest w twoim PATH.

Co dalej

Dział zatytułowany „Co dalej”
Skonfiguruj uwierzytelnianie Skonfiguruj dostęp przez subskrypcję ChatGPT lub rozliczanie kluczem API

Zobacz co nowego na platformie.

Polityka prywatności Regulamin