Table of Contents

Codex CLI pasuje do przepływu pracy opartego na powłoce, z jawnymi poleceniami i uruchomieniami obsługiwanymi przez skrypty. Codex w aplikacji desktopowej pasuje do pracy zorganizowanej wokół projektów, rozmów, wyników wizualnych i paneli przeglądu. Wybierz interfejs zgodnie ze sposobem nadzorowania pracy, zachowując ten sam model, repozytorium i zasady wykonywania.

Uwaga dotycząca nazwy: Dokumentacja dawnej aplikacji Codex firmy OpenAI przekierowuje teraz do dokumentacji aplikacji desktopowej ChatGPT . W tym przewodniku używamy określenia „Codex desktop” dla przepływu pracy programistycznej w aplikacji. Nie utożsamiamy zwykłej rozmowy bez dostępu do repozytorium z agentem programistycznym.

Najważniejsze wnioski

  • Użyj CLI do łączenia poleceń powłoki i powtarzalnych uruchomień programistycznych.
  • Użyj aplikacji desktopowej do organizacji projektów, przeglądu wizualnego i zarządzania zadaniami zaplanowanymi.
  • Jawnie określ miejsce wykonywania, zwłaszcza podczas pracy przez połączenia zdalne.
  • Interfejs nie gwarantuje lepszego kodu ani nie tworzy niezależnego limitu wnioskowania.

Zakres i data: Oficjalną dokumentację sprawdzono 10 października 2026 roku. Zalecenia dotyczą przepływu pracy, a nie zmierzonej wydajności modelu. Wymagane są repozytorium, działające testy i odpowiedni dostęp do konta. Na małą próbę między interfejsami przeznacz godzinę.

Porównanie przepływów pracy

Potrzeba Codex CLI Codex desktop
Rozpoczęcie pracy z repozytorium Uruchomienie z katalogu powłoki Wybór projektu i środowiska wykonywania
Powtórzenie zadania ze skryptu codex exec Przygotowanie promptów i wizualna inspekcja wyników
Inspekcja kilku zadań Praca w terminalu lub sesji Organizacja projektów i rozmów
Przegląd zmian Polecenia terminala i elementy sterujące przeglądu Panele różnic i przeglądu
Zarządzanie harmonogramami Zewnętrzny uruchamiacz zadań wokół skryptu Interfejs zarządzania zadaniami zaplanowanymi
Izolowanie zmian Wybór osobnego checkoutu lub worktree Zintegrowany przepływ pracy worktree

Wspólne podstawy agenta mają znaczenie. OpenAI opisuje CLI, aplikację i rozszerzenie IDE jako interfejsy wokół środowiska uruchomieniowego agenta w artykule Codex jako platforma . Środowisko uruchomieniowe zarządza stanem, narzędziami i zasadami. Różnice między interfejsami nadal wpływają na dostarczany kontekst i sposób inspekcji wyniku.

Gdzie pasuje CLI

codex

Uruchom z właściwego repozytorium. Przewodnik CLI opisuje interaktywną inspekcję, edycję, polecenia i przegląd. Wybierz tę ścieżkę, gdy Twój istniejący przepływ pracy opiera się na sesjach terminala i wynikach poleceń.

codex exec "Identify the documented test command. Do not modify files."

Użyj codex exec do ograniczonego zadania uruchamianego ze skryptu. Dokumentacja trybu nieinteraktywnego wyjaśnia sposób wyświetlania postępu i końcowego wyniku. Podczas badania zastosuj odpowiednią zasadę wykonywania tylko do odczytu. Zdanie nakazujące brak edycji jest instrukcją, a nie wymuszoną granicą systemu plików.

Skrypt produkcyjny wymaga więcej niż ten przykład. Określ dane uwierzytelniające, wybór repozytorium, limit czasu, uprawnienia, przechowywanie wyników i obsługę błędów. Przed uznaniem automatycznych zmian za gotowe zleć zadaniu wygenerowanie dowodów dla osoby przeprowadzającej przegląd. Przechowuj kontrakt wykonywania w kontroli wersji, aby kolejny operator znał zakres uprawnień agenta.

Gdzie pasuje aplikacja desktopowa

Aplikacja desktopowa organizuje powiązaną pracę w jednym obszarze roboczym. Aktualna dokumentacja aplikacji OpenAI opisuje przełączanie projektów, inspekcję plików, połączone narzędzia i zadania długotrwałe. Obsługuje to przepływ, w którym przechodzisz między implementacją, wyrenderowanym artefaktem i przeglądem bez odtwarzania kontekstu z wielu okien terminala.

Przegląd jest konkretnym wyróżnikiem. Dokumentacja przeglądu kodu opisuje wyświetlanie opisów, zmienionych plików, komentarzy i kontroli. Użyj tych widoków do zbadania poprawki, a następnie zdecyduj, czy spełnia wymaganie. Osoba dokonująca przeglądu nadal potrzebuje niezależnych dowodów zachowania wykraczającego poza różnicę.

Wypróbuj aplikację desktopową przy zadaniu wizualnym. Poproś o małą poprawkę układu ze zrzutem ekranu i jawnymi wymaganiami dotyczącymi widoku. Porównaj wysiłek potrzebny do dołączenia kontekstu, inspekcji wyniku i zlecenia jednej korekty. Mierz osobno czas przeglądu przez człowieka i czas odpowiedzi modelu.

Automatyzacja terminala i panele przeglądu desktopowego połączone z tym samym repozytorium i niezależną listą kontrolną walidacji

Podczas porównywania interfejsów zachowaj stałe repozytorium i kryteria akceptacji

Worktree i miejsce wykonywania

Worktree to kolejny checkout repozytorium Git. Przewodnik po worktree OpenAI opisuje izolowane równoległe rozmowy oraz przenoszenie pracy między lokalnym checkoutem a zarządzanym worktree. Pliki i polecenia pozostają na komputerze lub w środowisku programistycznym obsługującym projekt.

Izolacja nie scala wyniku. Przejrzyj różnicę, uruchom kontrole i zdecyduj, jak wprowadzić zmiany do właściwej gałęzi. Zależności, ignorowane pliki i usługi zewnętrzne także wymagają uwagi podczas rozpoczynania pracy ze świeżego checkoutu.

Przed zadaniem Potwierdź
Repozytorium Właściwy projekt i rewizja bazowa
Checkout Istniejący katalog lub izolowany worktree
Host wykonywania Komputer zawierający pliki i narzędzia
Środowisko Runtime, zależności i usługi testowe
Uprawnienia Dozwolone zapisy plików i dostęp do sieci

W porównaniu używaj tego samego środowiska. Zadanie desktopowe na skonfigurowanej stacji roboczej i zadanie CLI w minimalnym kontenerze testują coś więcej niż preferencję interfejsu. Zapisz różnice środowiskowe, zanim przypiszesz awarie klientowi.

Harmonogramy i uprawnienia

Aplikacja desktopowa zapewnia zarządzanie harmonogramami. Przewodnik po zadaniach zaplanowanych OpenAI odróżnia interfejs zarządzania od CLI. Lokalne zadania zaplanowane wymagają dostępności odpowiedniego komputera i aplikacji. Harmonogram powłoki uruchamiający codex exec to osobny układ operacyjny.

Uprawnienia dotyczą środowiska wykonywania. Sprawdź efektywny profil, zamiast wyciągać wnioski z terminalowego lub graficznego monitu. Dokumentacja uprawnień OpenAI opisuje granice systemu plików i sieci. Zgoda GUI i zasada piaskownicy rozwiązują różne problemy.

Dostęp do konta wymaga osobnej kontroli. Potwierdź aktywne logowanie, dostępny model i widok użycia w każdym interfejsie. Nie zakładaj, że otwarcie drugiego klienta tworzy niezależny limit. Zapisz ścieżkę rozliczeń przed porównaniem kosztów zadania.

Próba trwająca godzinę

  1. Przygotuj jedną ograniczoną zmianę z niezależnym testem akceptacji i czystą bazą.
  2. Uruchom ją w obu interfejsach z osobnych checkoutów, przy zgodnych ustawieniach modelu i zasad.
  3. Poproś o jedną korektę po inspekcji pierwszej poprawki.
  4. Przejrzyj końcową różnicę i uruchom te same polecenia weryfikacyjne.
  5. Zapisz swój wysiłek związany z dostarczaniem kontekstu, znajdowaniem wyników i zatwierdzaniem rezultatu.

Wybierz CLI, jeśli zadanie łatwiej powtarzać i kontrolować za pomocą narzędzi powłoki. Wybierz aplikację desktopową, jeśli organizacja projektów i przegląd wizualny ograniczają wysiłek nadzoru. Instalowanie obu interfejsów ma sens, gdy każdy obsługuje inną część przepływu pracy.

Zachowaj zapis próby razem z wynikiem. Zapisz początkową rewizję, wybrany model, host wykonywania, profil uprawnień, uruchomione polecenia i końcowy wynik weryfikacji. Bez tych pól późniejsze porównanie interfejsów będzie także porównaniem ukrytych zmian środowiska.

Rozwiązywanie problemów i kolejne kroki

Brakujący plik zwykle wymaga kontroli środowiska. Sprawdź projekt, checkout i host wykonywania, zanim poprosisz agenta o odtworzenie czegokolwiek. Przy różnych wynikach testów porównaj wybór runtime i konfigurację zależności. Przy zatrzymanym lokalnym harmonogramie potwierdź dostępność aplikacji i komputera.

Porównuj dostawców osobno. Użyj głównego porównania CLI dla alternatyw terminalowych oraz głównego porównania GUI dla edytorów graficznych i rozszerzeń. Zachowaj model i zapis zadania z tej próby na potrzeby przyszłych aktualizacji.