Twoje pierwsze zadanie w Codex

Zainstalowałeś wszystko, uwierzytelniłeś się, skonfigurowałeś tryb zatwierdzania, napisałeś AGENTS.md i podłączyłeś serwery MCP. Teraz czas faktycznie użyć Codex do prawdziwej pracy. Ten przewodnik przeprowadza to samo zadanie na wszystkich czterech powierzchniach, abyś poczuł różnice i wybrał preferowany workflow.

Co wyniesiesz z tego przewodnika

• Ukończone zadanie od początku do końca: prompt, wykonanie, przegląd zmian
• Doświadczenie uruchamiania tego samego zadania w Aplikacji, CLI, rozszerzeniu IDE i Cloud
• Zrozumienie jak tryby zatwierdzania, worktree i sandboxing wpływają na workflow
• Zestaw wzorców promptów do ponownego użycia dla typowych zadań Codex
• Pewność do rozpoczęcia delegowania prawdziwej pracy do Codex

Zadanie

Poprosimy Codex o coś praktycznego, czego każdy projekt potrzebuje: znalezienie buga lub brakującego przypadku brzegowego w obsłudze błędów, naprawienie go i dodanie testu. To ćwiczy odczytywanie plików, analizę kodu, generowanie kodu, wykonywanie poleceń (uruchamianie testów) i świadomość Git.

Dokładny prompt którego użyjemy:

Find an error handling gap in this project's API routes -- a place where an
exception could crash the server or return a misleading response. Fix it with
proper error handling and add a test that proves the fix works. Run the tests
to confirm they pass.

To jest celowo otwarte. Codex musi przeszukać twoją bazę kodu, zidentyfikować prawdziwy problem, zaimplementować poprawkę i ją zwalidować. Jeśli twój projekt nie ma tras API, dostosuj prompt do swojej bazy kodu.

Uruchamianie zadania na każdej powierzchni

Aplikacja

Workflow w Aplikacji

1. Otwórz aplikację Codex i wybierz swój projekt.

2. Kliknij New Thread. Wybierz tryb Local aby pracować bezpośrednio w katalogu projektu, lub Worktree aby izolować zmiany w worktree Git.

3. Wklej prompt do kompozytora i wyślij.

4. Obserwuj pracę Codex. Aplikacja pokazuje postęp w czasie rzeczywistym: czytane pliki, analiza, edycje kodu, wykonywanie poleceń. Jeśli twoja polityka zatwierdzania to on-failure, Codex pisze kod autonomicznie ale pauzuje przed uruchomieniem poleceń jak npm test.

5. Gdy Codex skończy, przełącz się na panel Review aby zobaczyć pełny diff wszystkich zmian.

6. Użyj wbudowanego terminala (Cmd + J) aby ręcznie zweryfikować zmiany jeśli chcesz: uruchom testy, sprawdź serwer, przejrzyj pliki.

Funkcje specyficzne dla Aplikacji podczas zadania:

• Wiele wątków może działać równolegle. Rozpocznij to zadanie, a następnie otwórz nowy wątek dla innego zadania w oczekiwaniu.
• Jeśli wybrałeś tryb Worktree, zmiany są izolowane. Twój główny branch pozostaje czysty.
• Dyktowanie głosowe działa: przytrzymaj Ctrl + M aby wypowiedzieć prompt zamiast go wpisywać.
• Powiadomienia pojawiają się gdy zadanie w tle się zakończy.

Wskazówka

Prompt na równoległe drugie zadanie w Aplikacji:

Podczas gdy pierwsze zadanie działa, otwórz nowy wątek i spróbuj:

Review the project's README and update it to reflect the current API endpoints, dependencies, and setup instructions

Oba zadania działają jednocześnie bez wzajemnych zakłóceń (zwłaszcza w trybie Worktree).

CLI

Workflow w CLI

1. Przejdź do katalogu projektu w terminalu.

2. Uruchom TUI Codex:

   codex

3. Wklej prompt i naciśnij Enter.

4. Codex pracuje w terminalu: widzisz odczytywanie plików, analizę, strumieniowane edycje kodu i żądania wykonania poleceń. W trybie zatwierdzania auto-edit edycje są automatyczne, ale polecenia wymagają zatwierdzenia.

5. Po zakończeniu pracy Codex użyj /review aby uruchomić lokalny przegląd kodu zmian.

6. Sprawdź diff za pomocą Git:

   git diff

Funkcje specyficzne dla CLI podczas zadania:

• Użyj /model aby zmienić model w trakcie sesji jeśli chcesz spróbować innego podejścia.
• Użyj /undo aby cofnąć zmiany z ostatniej tury.
• Przekieruj zadanie do nieinteraktywnego wykonania: codex exec "your prompt here".
• Wejście obrazów: przeciągnij i upuść zrzuty ekranu do terminala jeśli musisz pokazać Codex wizualny bug.

Wskazówka

Prompt do trybu nieinteraktywnego (skryptowanie):

Uruchom to samo zadanie bez TUI:

codex exec "Find an error handling gap in this project's API routes. Fix it and add a test."

To jest przydatne dla pipeline-ów CI/CD, zadań cron lub skryptowania Codex w większe workflow.

Rozszerzenie IDE

Workflow w rozszerzeniu IDE

1. Otwórz projekt w VS Code (lub Cursor/Windsurf).

2. Otwórz panel boczny Codex.

3. Upewnij się że wybrany jest tryb Agent (nie tryb Chat). Tryb Agent pozwala Codex czytać pliki, uruchamiać polecenia i zapisywać zmiany.

4. Wklej prompt i wyślij.

5. Codex pracuje w twoim IDE: edycje plików pojawiają się w edytorze, diff-y są pokazywane inline, a polecenia uruchamiają się w zintegrowanym terminalu.

6. Przejrzyj zmiany w wbudowanym widoku diff Git w VS Code.

Funkcje specyficzne dla rozszerzenia IDE podczas zadania:

• Odwołania @file: wpisz @src/routes/auth.ts aby wskazać Codex na konkretny plik jako kontekst.
• Auto Context: jeśli Aplikacja jest również otwarta, rozszerzenie IDE synchronizuje które pliki przeglądasz.
• Delegacja do Cloud: kliknij ikonę Cloud aby odciążyć zadanie do Codex Cloud zamiast uruchamiać lokalnie.
• Tryb zatwierdzania mapuje się na nazwy specyficzne dla IDE: Chat (pytaj o wszystko), Agent (auto-edit), Agent (Full Access) (nigdy nie pytaj).

Wskazówka

Prompt z odwołaniami do plików:

Dla bardziej ukierunkowanej pracy odwołuj się bezpośrednio do plików:

Look at @src/routes/users.ts and @src/routes/orders.ts -- find error handling gaps, fix them, and add tests

Składnia @file daje Codex natychmiastowy kontekst bez wyszukiwania.

Cloud

Workflow w Cloud

1. Otwórz chatgpt.com/codex.

2. Wybierz skonfigurowane środowisko (repozytorium które wcześniej połączyłeś).

3. Kliknij New Task i wklej prompt.

4. Codex uruchamia środowisko w chmurze, klonuje twoje repozytorium, instaluje zależności (używając twoich poleceń konfiguracji środowiska) i zaczyna pracować.

5. Monitoruj postęp w czasie rzeczywistym w widoku logów, lub zamknij przeglądarkę i pozwól mu działać w tle.

6. Gdy zadanie się zakończy, przejrzyj proponowane zmiany w widoku diff.

7. Kliknij Create PR aby zamienić zmiany w pull request, lub Check out locally aby przetestować branch na swoim komputerze:

   git fetch
   git checkout <branch-name>

Funkcje specyficzne dla Cloud podczas zadania:

• Zadania działają w tle. Zamknij laptop, a zadanie nadal trwa.
• Widok diff pokazuje wszystkie zmiany zanim się na cokolwiek zdecydujesz.
• Możesz iterować: wysyłaj wiadomości kontynuujące w tym samym wątku aby dopieścić wynik.
• PR-y utworzone z Cloud zawierają czysty diff i opis.

Wskazówka

Prompt do wyzwolenia zadania w chmurze z GitHub:

Zamiast używać chatgpt.com/codex, przejdź do issue na GitHub i skomentuj:

@codex find and fix error handling gaps in the API routes, add tests, and open a PR

Codex uruchamia ten sam workflow, ale tworzy PR automatycznie.

Czego się spodziewać

Niezależnie od użytej powierzchni, Codex podąża tym samym ogólnym wzorcem:

1. Eksploracja: Codex odczytuje strukturę projektu, identyfikuje istotne pliki i poznaje układ bazy kodu.

2. Analiza: Szuka konkretnego wzorca o który prosiłeś (luk w obsłudze błędów w tym przypadku), ewaluując wielu kandydatów.

3. Implementacja: Codex edytuje pliki, dodając odpowiednią obsługę błędów, bloki try-catch, walidacje lub cokolwiek wymaga poprawka.

4. Testowanie: Tworzy lub aktualizuje pliki testowe, a następnie uruchamia zestaw testów aby zweryfikować że poprawka działa.

5. Podsumowanie: Codex raportuje co znalazł, co zmienił i wyniki testów.

Jakość w dużej mierze zależy od twojego AGENTS.md. Jeśli określiłeś framework testowy (vitest, jest, pytest), polecenie uruchamiania testów i konwencje kodu, Codex ich przestrzega. Jeśli nie, zgaduje — i czasem zgaduje źle.

Wzorce promptów do ponownego użycia

Oto prompty które dobrze działają dla typowych pierwszych zadań. Używaj ich jako szablonów.

Wskazówka

Prompt do polowania na bugi:

Scan this codebase for potential null pointer exceptions, unhandled promise rejections,
or missing error boundaries. Focus on the most critical user-facing code paths. Fix
the top 3 issues you find and add tests for each fix.

Wskazówka

Prompt do refaktoryzacji:

The authentication middleware in src/middleware/auth.ts has grown to 200+ lines.
Refactor it into smaller, testable functions. Each function should have a single
responsibility. Update existing tests to match the new structure and add tests
for any previously untested paths.

Wskazówka

Prompt do dodania funkcji:

Add rate limiting to the POST /api/login endpoint. Use a sliding window algorithm
with a limit of 5 attempts per minute per IP address. Return a 429 response with
a Retry-After header when the limit is exceeded. Add integration tests that verify
both the happy path and the rate-limited path.

Wybór odpowiedniej powierzchni dla zadania

Po uruchomieniu tego samego zadania na wszystkich czterech powierzchniach zauważysz, że każda ma swoje mocne strony:

Typ zadania	Najlepsza powierzchnia	Dlaczego
Szybka poprawka buga w jednym pliku	CLI lub rozszerzenie IDE	Szybkie, minimalne przełączanie kontekstu
Wieloplikowa refaktoryzacja	Aplikacja (tryb Worktree)	Izolowane zmiany, równoległe wątki
Długotrwała migracja	Cloud	Działa w tle, nie blokuje twojego komputera
Workflow oparty o PR	Cloud + GitHub	Tworzy PR bezpośrednio, integruje się z przeglądami
Eksploracyjne debugowanie	CLI (interaktywne TUI)	Szybka iteracja, /undo do cofania
Zmiany wizualne (praca nad UI)	Rozszerzenie IDE	Widzisz zmiany w edytorze, użyj Playwright MCP do zrzutów ekranu

Gdy coś nie działa

Codex edytuje złe pliki: Twój AGENTS.md może nie mieć kontekstu architektury. Dodaj jawne ścieżki: “API routes are in src/routes/, NOT in src/api/.”

Testy nie przechodzą po poprawce Codex: Codex mógł użyć złego frameworka testowego lub runnera. Sprawdź czy twój AGENTS.md ma dokładne polecenie testowe (pnpm vitest, nie npm test).

Codex utknął w pętli: Może ponawiać nieudane polecenie. Naciśnij Esc (CLI) lub zatrzymaj wątek (Aplikacja) i przeformułuj prompt z większymi ograniczeniami.

Zadanie Cloud trwa wiecznie: Sprawdź konfigurację środowiska. Jeśli npm install uruchamia się przy każdym zadaniu bo node_modules nie jest cache-owane, zadania trwają dużo dłużej. Zoptymalizuj polecenia konfiguracji.

Prompty zatwierdzania przerywają flow: Przełącz na tryb auto-edit lub never. Zobacz przewodnik konfiguracji po szczegóły.

Co dalej

Przeglądaj pracę agenta Naucz się przeglądać, udoskonalać i mergować zmiany Codex używając panelu przeglądu