Odzyskiwanie po błędach

Codex właśnie uruchomił npm install i nie powiodło się bo twój projekt używa pnpm. Próbował zaimportować moduł który nie istnieje. Wszedł w króliczą norę coraz bardziej złych poprawek błędu typów. Albo po prostu przestał odpowiadać w trakcie zadania. To nie są przypadki brzegowe — to normalne części pracy z agentem AI, a sposób w jaki odzyskujesz kontrolę decyduje o tym, czy Codex pozostaje produktywny czy marnuje twoje popołudnie.

Co wyniesiesz z tego przewodnika

• Mentalny model pięciu najczęstszych kategorii awarii Codex
• Techniki odzyskiwania dla każdego typu awarii na wszystkich powierzchniach
• System cofania i strategia checkpointów Git dla bezpiecznego wycofywania
• Wzorce wychodzenia z pętli błędów
• Szablony promptów do szybkiego przywrócenia Codex na właściwe tory

Pięć kategorii awarii

Każda awaria Codex wpada do jednego z tych kubłów:

Kategoria	Co się stało	Typowy objaw
Sandbox/Uprawnienia	Codex próbował uzyskać dostęp do czegoś poza dozwolonym zakresem	”Permission denied,” “Sandboxed operation blocked”
Wykonanie polecenia	Polecenie shell nie powiodło się	Błędy npm, nieudane testy, błędy kompilacji
Zły kierunek	Codex zaimplementował złe podejście lub źle zrozumiał zadanie	Kod który się kompiluje ale nie spełnia wymagań
Przepełnienie kontekstu	Konwersacja rozrosła się zbyt długo i Codex zgubił wcześniejsze instrukcje	Powtarzanie pracy, zaprzeczanie wcześniejszym decyzjom
Sieć/Połączenie	Serwer MCP padł, API przekroczyło timeout lub token uwierzytelniania wygasł	”Connection reset,” “Server not responding,” wstrzymany postęp

Odzyskiwanie po błędach sandbox i uprawnień

Problem

Codex działa w sandboxie który ogranicza dostęp do systemu plików i sieci. W trybie workspace-write (domyślnym) Codex może zapisywać tylko w katalogu twojego projektu. Jeśli zadanie wymaga zapisywania gdzie indziej lub wykonywania połączeń sieciowych, sandbox je blokuje.

Odzyskiwanie

Rozszerz sandbox

Jeśli zadanie uprawnione wymaga szerszego dostępu, dostosuj sandbox w config.toml:

# Pozwól na pełny dostęp do systemu plików i sieci (używaj ostrożnie)
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 każdą ograniczoną akcją. Przejrzyj każde żądanie i zatwierdź lub odmów:

• Approve once: Pozwól na tę konkretną akcję, pytaj ponownie następnym razem.
• Approve for session: Pozwól na ten typ akcji do końca sesji.

Daje to precyzyjną kontrolę bez szerokiego otwierania sandboxa.

Zmień podejście

Czasem sandbox jest prawidłowy a podejście jest złe. Poproś 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 problemów 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 zrozumieć co Codex widzi zanim zdecydujesz czy rozszerzyć sandbox.

Odzyskiwanie po błędach wykonania poleceń

Problem

Codex uruchamia polecenie i nie powiedzie się. Może npm install nie powiódł się bo projekt używa pnpm. Może python manage.py test nie powiódł się bo baza danych nie działa. Może błąd kompilacji kaskadował w nieudane testy.

Odzyskiwanie

1. Przeczytaj wyjście błędu. Codex pokazuje pełne stderr. Często komunikat błędu mówi dokładnie co jest nie tak.

2. Pozwól Codex próbować naprawić. W wielu przypadkach Codex automatycznie czyta błąd, diagnozuje przyczynę i proponuje poprawkę. Pozwól mu raz ziterować zanim interweniujesz.

3. Podaj brakujący kontekst. Jeśli Codex zgadł zły menedżer pakietów lub runner testów, 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. Jeśli to powtarzający się błąd, dodaj poprawne polecenia do AGENTS.md aby Codex dobrze trafił następnym 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 złym kierunku

Problem

To najtrudniejsza awaria. Codex nie zgłosił błędu — kod się kompiluje, może nawet przechodzi testy — ale zaimplementował coś złego. Użył Express zamiast Fastify. Dodał endpoint REST gdy chciałeś GraphQL. Zrestrukturyzował kod w sposób który działa ale nie pasuje do twojej architektury.

Odzyskiwanie

Cofnij w Aplikacji

Panel przeglądu Aplikacji Codex pozwala cofnąć na dowolnym poziomie szczegółowości:

• Revert all: Odrzuć wszystko i zacznij od nowa.
• Revert file: Zachowaj dobre pliki, odrzuć złe.
• Revert hunk: Zachowaj dobre zmiany w pliku, odrzuć konkretne hunki.

Po cofnięciu wyślij wiadomość kontynuującą z jaśniejszymi ograniczeniami.

Cofnij w CLI

CLI obsługuje cofanie przez zrzuty Git ghost per-tura:

/undo

Cofa to stan do momentu przed ostatnią turą. Możesz cofnąć wiele tur.

Alternatywnie użyj Git bezpośrednio:

git checkout -- .

Przekieruj

Czasem nie musisz cofać — musisz przekierować. Powiedz Codex co poszło źle 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 złym kierunku jest wczesne wyłapanie. Przejrzyj kilka pierwszych edycji plików zanim Codex zakończy całe zadanie. Jeśli idzie w złym kierunku, przerwij (Esc w CLI, stop w Aplikacji) i przekieruj natychmiast zamiast czekać na ukończony ale zły rezultat.

Wskazówka

Prompt zapobiegający złemu kierunkowi zanim się 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 konsultację przed zaangażowaniem się w podejście.

Odzyskiwanie po przepełnieniu kontekstu

Problem

Po długiej konwersacji Codex zaczyna zapominać wcześniejsze instrukcje, powtarzać pracę którą już wykonał lub zaprzeczać decyzjom z wcześniejszej części wątku. Okno kontekstu się zapełniło i starsze wiadomości są 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 wątek (Aplikacja) lub rozpocznij świeżą konwersację (CLI):

   /new

3. Wznów 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

Przepełnienie kontekstu jest ciche. Codex nie ostrzega gdy zaczyna odrzucać wcześniejsze wiadomości. Jeśli zauważysz powtórzenia lub sprzeczności, prawdopodobnie jest to problem z kontekstem. Wyczyść i wznów proaktywnie dla długich zadań.

Odzyskiwanie po błędach sieci i połączenia

Awarie serwera MCP

Jeśli serwer MCP przestaje odpowiadać:

# Sprawdź status serwera
codex mcp list

# Serwer może potrzebować restartu -- zamknij i otwórz ponownie Codex
# Lub wyłącz uszkodzony serwer i kontynuuj bez niego

W Aplikacji przejdź do Ustawienia > MCP i przełącz serwer z wyłączonego na włączony.

Timeouty API

Jeśli sam Codex przestaje odpowiadać (timeout API modelu):

• CLI: Naciśnij Esc aby anulować bieżące żądanie, a następnie ponów prompt.
• Aplikacja: Kliknij przycisk stop na wątku, poczekaj chwilę, a następnie wyślij kontynuację.
• Rozszerzenie IDE: Anuluj zadanie i spróbuj ponownie.

Jeśli timeouty się utrzymują, sprawdź połączenie sieciowe. Codex wymaga stabilnego połączenia internetowego do komunikacji z API OpenAI.

Wygaśnięcie tokena uwierzytelniania

Jeśli pojawiają się błędy uwierzytelniania w trakcie sesji:

# CLI: Ponownie uwierzytelnij
codex login

# Aplikacja: Powinna automatycznie poprosić o ponowne uwierzytelnienie

Strategia checkpointów Git

Najbardziej niezawodna siatka bezpieczeństwa to częste commity Git. Przed każdym ryzykownym zadaniem Codex:

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

Daje to czysty punkt wycofania. Jeśli Codex pójdzie w złym kierunku, zawsze możesz:

git reset --hard HEAD

W Aplikacji Codex użyj trybu Worktree aby automatycznie izolować zmiany. Worktree tworzą oddzielny checkout Git, więc twój główny katalog roboczy pozostaje czysty niezależnie od tego co robi Codex.

Wskazówka

Prompt aby Codex tworzył własne 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 pętli błędów

Najbardziej frustrująca awaria: Codex próbuje naprawić błąd, poprawka tworzy nowy błąd, próbuje naprawić tamten, co tworzy kolejny błąd, i cykl się powtarza. Oto jak się z tego wydostać:

1. Zatrzymaj pętlę. Naciśnij Esc (CLI), kliknij Stop (Aplikacja) lub anuluj (IDE).

2. Cofnij wszystkie iteracje pętli:

   /undo

   Lub cofnij w panelu przeglądu. Wróć do stanu sprzed rozpoczęcia pętli.

3. Zdiagnozuj przyczynę sam. Przeczytaj oryginalny błąd który rozpoczął pętlę.

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 dużego zadania, daj Codex trzy małe.

Szablony promptów 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 złym 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 przepełnienia 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 coś nie działa

Cofanie nie działa: Funkcja undo opiera się na zrzutach Git per-tura. Jeśli wyłączyłeś flagę funkcji undo lub projekt nie jest repozytorium Git, cofanie jest niedostępne. Użyj git checkout -- . jako zapasowego rozwiązania.

Codex ignoruje twoją poprawkę: Wyczyść kontekst i rozpocznij nowy wątek. W długiej konwersacji poprawka w środku może nie nadpisać wcześniejszych (niepoprawnych) instrukcji które mają większą wagę.

Prompty odzyskiwania są ignorowane: Model może być w stanie gdzie ciągle próbuje tego samego podejścia. Rozpocznij zupełnie nową sesję (nowy wątek w Aplikacji, nowe wywołanie codex w CLI) z czystym promptem zawierającym wszystkie ograniczenia od początku.

Zadań Cloud nie można zatrzymać: Zadania Cloud działają asynchronicznie. Jeśli zadanie w chmurze idzie w złym kierunku, nie możesz go przerwać w trakcie wykonywania. Możesz zamknąć wątek i rozpocząć nowy. Zadanie w chmurze może nadal się zakończyć i utworzyć PR, który możesz po prostu zamknąć.

Co dalej

Ukończyłeś całą sekcję szybkiego startu Codex. Możesz instalować, uwierzytelniać, konfigurować, pisać instrukcje, podłączać narzędzia, integrować z GitHub, uruchamiać zadania, przeglądać zmiany i odzyskiwać kontrolę po awariach. Oto gdzie możesz się udać dalej:

Przegląd Codex Wróć do ścieżki nauki Codex po zaawansowane tematy

Współdzielone workflow Poznaj międzynarzędziowe workflow do testowania, debugowania i wdrażania