Twoje pierwsze zadanie w Codex

Zainstalowales wszystko, uwierzytelnieles sie, skonfigurowales tryb zatwierdzania, napisales AGENTS.md i podlaczyles serwery MCP. Teraz czas faktycznie uzyc Codex do prawdziwej pracy. Ten przewodnik przeprowadza to samo zadanie na wszystkich czterech powierzchniach, abys poczul roznice i wybral preferowany workflow.

Co wyniesiesz z tego przewodnika

• Ukonczone zadanie od poczatku do konca: prompt, wykonanie, przeglad zmian
• Doswiadczenie uruchamiania tego samego zadania w Aplikacji, CLI, rozszerzeniu IDE i Cloud
• Zrozumienie jak tryby zatwierdzania, worktree i sandboxing wplywaja na workflow
• Zestaw wzorcow promptow do ponownego uzycia dla typowych zadan Codex
• Pewnosc do rozpoczecia delegowania prawdziwej pracy do Codex

Zadanie

Poprosimy Codex o cos praktycznego, czego kazdy projekt potrzebuje: znalezienie buga lub brakujacego przypadku brzegowego w obsludze bledow, naprawienie go i dodanie testu. To cwicay odczytywanie plikow, analize kodu, generowanie kodu, wykonywanie polecen (uruchamianie testow) i swiadomosc Git.

Dokladny prompt ktorego uzyJemy:

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 przeszukac twoja baze kodu, zidentyfikowac prawdziwy problem, zaimplementowac poprawke i ja zwalidowac. Jesli twoj projekt nie ma tras API, dostosuj prompt do swojej bazy kodu.

Uruchamianie zadania na kazdej powierzchni

Aplikacja

Workflow w Aplikacji

1. Otworz aplikacje Codex i wybierz swoj projekt.

2. Kliknij New Thread. Wybierz tryb Local aby pracowac bezposrednio w katalogu projektu, lub Worktree aby izolowac zmiany w worktree Git.

3. Wklej prompt do kompozytora i wyslij.

4. Obserwuj prace Codex. Aplikacja pokazuje postep w czasie rzeczywistym: czytane pliki, analiza, edycje kodu, wykonywanie polecen. Jesli twoja polityka zatwierdzania to on-failure, Codex pisze kod autonomicznie ale pauzuje przed uruchomieniem polecen jak npm test.

5. Gdy Codex skonczy, przelacz sie na panel Review aby zobaczyc pelny diff wszystkich zmian.

6. Uzyj wbudowanego terminala (Cmd + J) aby recznie zweryfikowac zmiany jesli chcesz: uruchom testy, sprawdz serwer, przejrzyj pliki.

Funkcje specyficzne dla Aplikacji podczas zadania:

• Wiele watkow moze dzialac rownolegle. Rozpocznij to zadanie, a nastepnie otworz nowy watek dla innego zadania w oczekiwaniu.
• Jesli wybrales tryb Worktree, zmiany sa izolowane. Twoj glowny branch pozostaje czysty.
• Dyktowanie glosowe dziala: przytrzymaj Ctrl + M aby wypowiedziec prompt zamiast go wpisywac.
• Powiadomienia pojawiaja sie gdy zadanie w tle sie zakonczy.

Wskazówka

Prompt na rownolegle drugie zadanie w Aplikacji:

Podczas gdy pierwsze zadanie dziala, otworz nowy watek i sprobuj:

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

Oba zadania dzialaja jednoczesnie bez wzajemnych zaklucen (zwlaszcza w trybie Worktree).

CLI

Workflow w CLI

1. Przejdz do katalogu projektu w terminalu.

2. Uruchom TUI Codex:

   codex

3. Wklej prompt i nacisnij Enter.

4. Codex pracuje w terminalu: widzisz odczytywanie plikow, analize, strumieniowane edycje kodu i zadania wykonania polecen. W trybie zatwierdzania auto-edit edycje sa automatyczne, ale polecenia wymagaja zatwierdzenia.

5. Po zakonczeniu pracy Codex uzyj /review aby uruchmic lokalny przeglad kodu zmian.

6. Sprawdz diff za pomoca Git:

   git diff

Funkcje specyficzne dla CLI podczas zadania:

• Uzyj /model aby zmienic model w trakcie sesji jesli chcesz sprobowac innego podejscia.
• Uzyj /undo aby cofnac zmiany z ostatniej tury.
• Przekieruj zadanie do nieinteraktywnego wykonania: codex exec "your prompt here".
• Wejscie obrazow: przeciagnij i upusc zrzuty ekranu do terminala jesli musisz pokazac 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-ow CI/CD, zadan cron lub skryptowania Codex w wieksze workflow.

Rozszerzenie IDE

Workflow w rozszerzeniu IDE

1. Otworz projekt w VS Code (lub Cursor/Windsurf).

2. Otworz panel boczny Codex.

3. Upewnij sie ze wybrany jest tryb Agent (nie tryb Chat). Tryb Agent pozwala Codex czytac pliki, uruchamiac polecenia i zapisywac zmiany.

4. Wklej prompt i wyslij.

5. Codex pracuje w twoim IDE: edycje plikow pojawiaja sie w edytorze, diff-y sa pokazywane inline, a polecenia uruchamiaja sie w zintegrowanym terminalu.

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

Funkcje specyficzne dla rozszerzenia IDE podczas zadania:

• Odwolania @file: wpisz @src/routes/auth.ts aby wskazac Codex na konkretny plik jako kontekst.
• Auto Context: jesli Aplikacja jest rowniez otwarta, rozszerzenie IDE synchronizuje ktore pliki przegladasz.
• Delegacja do Cloud: kliknij ikone Cloud aby odciazyc zadanie do Codex Cloud zamiast uruchamiac lokalnie.
• Tryb zatwierdzania mapuje sie na nazwy specyficzne dla IDE: Chat (pytaj o wszystko), Agent (auto-edit), Agent (Full Access) (nigdy nie pytaj).

Wskazówka

Prompt z odwolaniami do plikow:

Dla bardziej ukierunkowanej pracy odwoluj sie bezposrednio do plikow:

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

Skladnia @file daje Codex natychmiastowy kontekst bez wyszukiwania.

Cloud

Workflow w Cloud

1. Otworz chatgpt.com/codex.

2. Wybierz skonfigurowane srodowisko (repozytorium ktore wczesniej polaczyles).

3. Kliknij New Task i wklej prompt.

4. Codex uruchamia srodowisko w chmurze, klonuje twoje repozytorium, instaluje zaleznosci (uzywajac twoich polecen konfiguracji srodowiska) i zaczyna pracowac.

5. Monitoruj postep w czasie rzeczywistym w widoku logow, lub zamknij przegladarke i pozwol mu dzialac w tle.

6. Gdy zadanie sie zakonczy, przejrzyj proponowane zmiany w widoku diff.

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

   git fetch
   git checkout <branch-name>

Funkcje specyficzne dla Cloud podczas zadania:

• Zadania dzialaja w tle. Zamknij laptop, a zadanie nadal trwa.
• Widok diff pokazuje wszystkie zmiany zanim sie na cokolwiek zdecydujesz.
• Mozesz iterowac: wysylaj wiadomosci kontynuujace w tym samym watku aby dopiescic wynik.
• PR-y utworzone z Cloud zawieraja czysty diff i opis.

Wskazówka

Prompt do wyzwolenia zadania w chmurze z GitHub:

Zamiast uzywac chatgpt.com/codex, przejdz 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 sie spodziewac

Niezaleznie od uzytej powierzchni, Codex podaza tym samym ogolnym wzorcem:

1. Eksploracja: Codex odczytuje strukture projektu, identyfikuje istotne pliki i poznaje uklad bazy kodu.

2. Analiza: Szuka konkretnego wzorca o ktory prosiles (luk w obsludze bledow w tym przypadku), ewaluujac wielu kandydatow.

3. Implementacja: Codex edytuje pliki, dodajac odpowiednia obsluge bledow, bloki try-catch, walidacje lub cokolwiek wymaga poprawka.

4. Testowanie: Tworzy lub aktualizuje pliki testowe, a nastepnie uruchamia zestaw testow aby zweryfikowac ze poprawka dziala.

5. Podsumowanie: Codex raportuje co znalazl, co zmienil i wyniki testow.

Jakosc w duzej mierze zalezy od twojego AGENTS.md. Jesli okresliles framework testowy (vitest, jest, pytest), polecenie uruchamiania testow i konwencje kodu, Codex ich przestrzega. Jesli nie, zgaduje — i czasem zgaduje zle.

Wzorce promptow do ponownego uzycia

Oto prompty ktore dobrze dzialaja dla typowych pierwszych zadan. Uzywaj ich jako szablonow.

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.

Wybor odpowiedniej powierzchni dla zadania

Po uruchomieniu tego samego zadania na wszystkich czterech powierzchniach zauwazysz, ze kazda ma swoje mocne strony:

Typ zadania	Najlepsza powierzchnia	Dlaczego
Szybka poprawka buga w jednym pliku	CLI lub rozszerzenie IDE	Szybkie, minimalne przelaczanie kontekstu
Wieloplikowa refaktoryzacja	Aplikacja (tryb Worktree)	Izolowane zmiany, rownolegle watki
Dlugotrwala migracja	Cloud	Dziala w tle, nie blokuje twojego komputera
Workflow oparty o PR	Cloud + GitHub	Tworzy PR bezposrednio, integruje sie z przegladami
Eksploracyjne debugowanie	CLI (interaktywne TUI)	Szybka iteracja, /undo do cofania
Zmiany wizualne (praca nad UI)	Rozszerzenie IDE	Widzisz zmiany w edytorze, uzyj Playwright MCP do zrzutow ekranu

Gdy cos nie dziala

Codex edytuje zle pliki: Twoj AGENTS.md moze nie miec kontekstu architektury. Dodaj jawne sciezki: “API routes are in src/routes/, NOT in src/api/.”

Testy nie przechodza po poprawce Codex: Codex mogl uzyc zlego frameworka testowego lub runnera. Sprawdz czy twoj AGENTS.md ma dokladne polecenie testowe (pnpm vitest, nie npm test).

Codex utknol w petli: Moze ponawiać nieudane polecenie. Nacisnij Esc (CLI) lub zatrzymaj watek (Aplikacja) i przeformuluj prompt z wiekszymi ograniczeniami.

Zadanie Cloud trwa wiecznie: Sprawdz konfiguracje srodowiska. Jesli npm install uruchamia sie przy kazdym zadaniu bo node_modules nie jest cache-owane, zadania trwaja duzo dluzej. Zoptymalizuj polecenia konfiguracji.

Prompty zatwierdzania przerywaja flow: Przelacz na tryb auto-edit lub never. Zobacz przewodnik konfiguracji po szczegoly.

Co dalej

Przegladaj prace agenta Naucz sie przegladac, udoskonalac i mergowac zmiany Codex uzywajac panelu przegladu