Odzyskiwanie po bledach

Codex wlasnie uruchomil npm install i nie powiodlo sie bo twoj projekt uzywa pnpm. Probowal zaimportowac modul ktory nie istnieje. Wszedl w kroliLa nore coraz bardziej zlych poprawek bledu typow. Albo po prostu przestal odpowiadac w trakcie zadania. To nie sa przypadki brzegowe — to normalne czesci pracy z agentem AI, a sposob w jaki odzyskujesz kontrole decyduje o tym, czy Codex pozostaje produktywny czy marnuje twoje popoludnie.

Co wyniesiesz z tego przewodnika

• Mentalny model pieciu najczestszych kategorii awarii Codex
• Techniki odzyskiwania dla kazdego typu awarii na wszystkich powierzchniach
• System cofania i strategia checkpointow Git dla bezpiecznego wycofywania
• Wzorce wychodzenia z petli bledow
• Szablony promptow do szybkiego przywrocenia Codex na wlasciwe tory

Piec kategorii awarii

Kazda awaria Codex wpada do jednego z tych kublow:

Kategoria	Co sie stalo	Typowy objaw
Sandbox/Uprawnienia	Codex probowal uzyskac dostep do czegos poza dozwolonym zakresem	”Permission denied,” “Sandboxed operation blocked”
Wykonanie polecenia	Polecenie shell nie powiodlo sie	Bledy npm, nieudane testy, bledy kompilacji
Zly kierunek	Codex zaimplementowal zle podejscie lub zle zrozumial zadanie	Kod ktory sie kompiluje ale nie spelnia wymagan
Przepelnienie kontekstu	Konwersacja rozrosla sie zbyt dlugo i Codex zgubil wczesniejsze instrukcje	Powtarzanie pracy, zaprzeczanie wczesniejszym decyzjom
Siec/Polaczenie	Serwer MCP padl, API przekroczylo timeout lub token uwierzytelniania wygasl	”Connection reset,” “Server not responding,” wstrzymany postep

Odzyskiwanie po bledach sandbox i uprawnien

Problem

Codex dziala w sandboxie ktory ogranicza dostep do systemu plikow i sieci. W trybie workspace-write (domyslnym) Codex moze zapisywac tylko w katalogu twojego projektu. Jesli zadanie wymaga zapisywania gdzie indziej lub wykonywania polaczen sieciowych, sandbox je blokuje.

Odzyskiwanie

Rozszerz sandbox

Jesli zadanie uprawnione wymaga szerszego dostepu, dostosuj sandbox w config.toml:

# Pozwol na pelny dostep do systemu plikow i sieci (uzywaj ostroznie)
sandbox_mode = "danger-full-access"

Lub nadpisz dla pojedynczej sesji:

codex --sandbox-mode danger-full-access

Zatwierdzaj indywidualnie

W trybie zatwierdzania on-request Codex pauzuje przed kazda ograniczona akcja. Przejrzyj kazde zadanie i zatwierdz lub odmow:

• Approve once: Pozwol na te konkretna akcje, pytaj ponownie nastepnym razem.
• Approve for session: Pozwol na ten typ akcji do konca sesji.

Daje to precyzyjna kontrole bez szerokiego otwierania sandboxa.

Zmien podejscie

Czasem sandbox jest prawidlowy a podejscie jest zle. Popros Codex o znalezienie alternatywy:

The sandbox blocked writing to /usr/local/. Instead of modifying system files,
create a local configuration in the project directory that achieves the same result.

Wskazówka

Prompt do diagnozowania problemow z sandboxem:

What permissions and sandbox restrictions are currently active? List what you can
and cannot do in terms of filesystem access and network calls.

Pomaga to zrozumiec co Codex widzi zanim zdecydujesz czy rozszerzyc sandbox.

Odzyskiwanie po bledach wykonania polecen

Problem

Codex uruchamia polecenie i nie powiedzie sie. Moze npm install nie powiodl sie bo projekt uzywa pnpm. Moze python manage.py test nie powiodl sie bo baza danych nie dziala. Moze blad kompilacji kaskadowal w nieudane testy.

Odzyskiwanie

1. Przeczytaj wyjscie bledu. Codex pokazuje pelne stderr. Czesto komunikat bledu mowi dokladnie co jest nie tak.

2. Pozwol Codex probowac naprawic. W wielu przypadkach Codex automatycznie czyta blad, diagnozuje przyczyne i proponuje poprawke. Pozwol mu raz ziterowac zanim interweniujesz.

3. Podaj brakujacy kontekst. Jesli Codex zgadl zly menedzer pakietow lub runner testow, powiedz mu wprost:

   This project uses pnpm, not npm. The test command is "pnpm vitest", not "npm test".
   Update your approach and try again.

4. Zaktualizuj AGENTS.md. Jesli to powtarzajacy sie blad, dodaj poprawne polecenia do AGENTS.md aby Codex dobrze trafil nastepnym razem.

Wskazówka

Prompt po nieudanym poleceniu:

The last command failed. Read the error output, identify the root cause, fix the
underlying issue (not just the symptom), and retry. If the fix requires changing
your approach, explain why before making changes.

Odzyskiwanie po zlym kierunku

Problem

To najtrudniejsza awaria. Codex nie zglosil bledu — kod sie kompiluje, moze nawet przechodzi testy — ale zaimplementowal cos zlego. Uzyl Express zamiast Fastify. Dodal endpoint REST gdy chcialeS GraphQL. Zrestrukturyzowal kod w sposob ktory dziala ale nie pasuje do twojej architektury.

Odzyskiwanie

Cofnij w Aplikacji

Panel przegladu Aplikacji Codex pozwala cofnac na dowolnym poziomie szczegolowosci:

• Revert all: Odrzuc wszystko i zacznij od nowa.
• Revert file: Zachowaj dobre pliki, odrzuc zle.
• Revert hunk: Zachowaj dobre zmiany w pliku, odrzuc konkretne hunki.

Po cofnieciu wyslij wiadomosc kontynuujaca z jasniejszymiograniczeniami.

Cofnij w CLI

CLI obsluguje cofanie przez zrzuty Git ghost per-tura:

/undo

Cofa to stan do momentu przed ostatnia tura. Mozesz cofnac wiele tur.

Alternatywnie uzyj Git bezposrednio:

git checkout -- .

Przekieruj

Czasem nie musisz cofac — musisz przekierowac. Powiedz Codex co poszlo zle i czego chcesz zamiast tego:

Stop. You used Express but this project uses Fastify. Revert the Express-specific
changes and re-implement using Fastify's route handler pattern. Check AGENTS.md
for the project's framework before making changes.

Kluczem do odzyskiwania po zlym kierunku jest wczesne wylapanie. Przejrzyj kilka pierwszych edycji plikow zanim Codex zakonczy cale zadanie. Jesli idzie w zlym kierunku, przerwij (Esc w CLI, stop w Aplikacji) i przekieruj natychmiast zamiast czekac na ukonczony ale zly rezultat.

Wskazówka

Prompt zapobiegajacy zlemu kierunkowi zanim sie zdarzy:

Before writing any code, outline your implementation plan in 3-5 bullet points.
Include which framework, libraries, and patterns you will use. Wait for my
approval before implementing.

Wymusza to na Codex konsultacje przed zaangazowaniem sie w podejscie.

Odzyskiwanie po przepelnieniu kontekstu

Problem

Po dlugiej konwersacji Codex zaczyna zapominac wczesniejsze instrukcje, powtarzac prace ktora juz wykonal lub zaprzeczac decyzjom z wczesniejszej czesci watku. Okno kontekstu sie zapelnilo i starsze wiadomosci sa kompresowane lub odrzucane.

Odzyskiwanie

1. Zapisz stan do AGENTS.md lub pliku podsumowania:

   Summarize everything we have accomplished in this session: decisions made,
   files changed, patterns established. Save this summary to docs/session-state.md.

2. Rozpocznij nowy watek (Aplikacja) lub rozpocznij swieZa konwersacje (CLI):

   /new

3. Wznow z zapisanym kontekstem:

   Read docs/session-state.md for context from our previous session. Continue
   from where we left off -- the next task is implementing the payment webhook handler.

Uwaga

Przepelnienie kontekstu jest ciche. Codex nie ostrzega gdy zaczyna odrzucac wczesniejsze wiadomosci. Jesli zauwaZysz powtorzenia lub sprzecznosci, prawdopodobnie jest to problem z kontekstem. Wyczysc i wznow proaktywnie dla dlugich zadan.

Odzyskiwanie po bledach sieci i polaczenia

Awarie serwera MCP

Jesli serwer MCP przestaje odpowiadac:

# Sprawdz status serwera
codex mcp list

# Serwer moze potrzebowac restartu -- zamknij i otworz ponownie Codex
# Lub wylacz uszkodzony serwer i kontynuuj bez niego

W Aplikacji przejdz do Ustawienia > MCP i przelacz serwer z wylaczonego na wlaczony.

Timeouty API

Jesli sam Codex przestaje odpowiadac (timeout API modelu):

• CLI: Nacisnij Esc aby anulowac bieZace zadanie, a nastepnie ponow prompt.
• Aplikacja: Kliknij przycisk stop na watku, poczekaj chwile, a nastepnie wyslij kontynuacje.
• Rozszerzenie IDE: Anuluj zadanie i sprobuj ponownie.

Jesli timeouty sie utrzymuja, sprawdz polaczenie sieciowe. Codex wymaga stabilnego polaczenia internetowego do komunikacji z API OpenAI.

Wygasniecie tokena uwierzytelniania

Jesli pojawia sie bledy uwierzytelniania w trakcie sesji:

# CLI: Ponownie uwierzytelnij
codex login

# Aplikacja: Powinna automatycznie poprosic o ponowne uwierzytelnienie

Strategia checkpointow Git

Najbardziej niezawodna siatka bezpieczenstwa to czesete commity Git. Przed kazdym ryzykownym zadaniem Codex:

git add -A && git commit -m "checkpoint: before codex refactoring"

Daje to czysty punkt wycofania. Jesli Codex pojdzie w zlym kierunku, zawsze mozesz:

git reset --hard HEAD

W Aplikacji Codex uzyj trybu Worktree aby automatycznie izolowac zmiany. Worktree tworza oddzielny checkout Git, wiec twoj glowny katalog roboczy pozostaje czysty niezaleznie od tego co robi Codex.

Wskazówka

Prompt aby Codex tworzyl wlasne checkpointy:

Before making changes, create a Git commit with the message "checkpoint: pre-codex".
After completing the task, create another commit with a descriptive message. This way
I can easily diff or revert your changes.

Wychodzenie z petli bledow

Najbardziej frustrujaca awaria: Codex probuje naprawic blad, poprawka tworzy nowy blad, probuje naprawic tamten, co tworzy kolejny blad, i cykl sie powtarza. Oto jak sie z tego wydostac:

1. Zatrzymaj petle. Nacisnij Esc (CLI), kliknij Stop (Aplikacja) lub anuluj (IDE).

2. Cofnij wszystkie iteracje petli:

   /undo

   Lub cofnij w panelu przegladu. Wroc do stanu sprzed rozpoczecia petli.

3. Zdiagnozuj przyczyne sam. Przeczytaj oryginalny blad ktory rozpoczal petle.

4. Daj Codex jawne ograniczenia:

   The original error was [paste error]. You tried [approach] which created a
   cascade of new errors. Instead, take this approach: [your idea]. Do not modify
   any files outside of src/auth/. Run the tests after each change to catch
   regressions early.

5. Podziel zadanie na mniejsze kroki. Zamiast jednego duzego zadania, daj Codex trzy male.

Szablony promptow odzyskiwania

Wskazówka

Po nieudanym poleceniu:

The command failed with: [paste error]. Do not retry the same command. Read the
error, identify the root cause, fix the underlying issue, then retry with the
corrected approach.

Wskazówka

Po implementacji w zlym kierunku:

Stop and undo your last changes. You misunderstood the requirement. Here is what
I actually need: [clear requirement]. Before implementing, outline your new
approach and wait for my approval.

Wskazówka

Po objawach przepelnienia kontekstu:

We have been working for a while and I think you may have lost some context.
Read AGENTS.md and docs/session-state.md to refresh your understanding of this
project and our current progress. Summarize what you understand before continuing.

Gdy cos nie dziala

Cofanie nie dziala: Funkcja undo opiera sie na zrzutach Git per-tura. Jesli wylaczyles flage funkcji undo lub projekt nie jest repozytorium Git, cofanie jest niedostepne. Uzyj git checkout -- . jako zapasowego rozwiazania.

Codex ignoruje twoja poprawke: Wyczysc kontekst i rozpocznij nowy watek. W dlugiej konwersacji poprawka w srodku moze nie nadpisac wczesniejszych (niepoprawnych) instrukcji ktore maja wieksza wage.

Prompty odzyskiwania sa ignorowane: Model moze byc w stanie gdzie ciagle probuje tego samego podejscia. Rozpocznij zupelnie nowa sesje (nowy watek w Aplikacji, nowe wywolanie codex w CLI) z czystym promptem zawierajacym wszystkie ograniczenia od poczatku.

Zadan Cloud nie mozna zatrzymac: Zadania Cloud dzialaja asynchronicznie. Jesli zadanie w chmurze idzie w zlym kierunku, nie mozesz go przerwac w trakcie wykonywania. Mozesz zamknac watek i rozpoczac nowy. Zadanie w chmurze moze nadal sie zakonczyc i utworzyc PR, ktory mozesz po prostu zamknac.

Co dalej

Ukonczyles cala sekcje szybkiego startu Codex. Mozesz instalowac, uwierzytelnic, konfigurowac, pisac instrukcje, podlaczac narzedzia, integrowac z GitHub, uruchamiac zadania, przegladac zmiany i odzyskiwac kontrole po awariach. Oto gdzie mozesz sie udac dalej:

Przeglad Codex Wroc do sciezki nauki Codex po zaawansowane tematy

Wspoldzielone workflow Poznaj miedzynarzeddziowe workflow do testowania, debugowania i wdrazania