Prześlij opinię

Zgłoszenie błędu w Claude Code, Codex albo Cursorze zostaje naprawione, gdy zawiera minimalną reprodukcję i diagnostykę, o którą prosi dany dostawca: /bug i log debugowania dla Claude Code, /feedback i codex doctor --json dla Codex oraz numer buildu dla Cursora. Prośby o funkcje, luki bezpieczeństwa i poprawki do tego przewodnika mają osobne kanały.

Ta strona jest dla programistów, którzy trafili na błąd narzędzia, i dla tech leadów, którzy decydują, jakie opinie opuszczają firmę. Znasz ten scenariusz: agent skasował plik, którego nie miał ruszać, zgłosiłeś „rozwalił mi repo”, a tydzień później issue zamknięto jako „nie da się odtworzyć”. W zgłoszeniu brakowało wersji, logu i reprodukcji, którą ktoś inny mógłby uruchomić.

Co daje zgłoszenie błędu, które da się odtworzyć

• Dwuminutową procedurę, która zbiera właściwą diagnostykę dla każdego narzędzia, zanim stan błędu przepadnie.
• Dwa prompty do skopiowania: jeden zmniejsza nieudaną sesję do minimalnego skryptu reprodukcji, drugi sprawdza duplikaty i pisze szkic zgłoszenia.
• Sposób, by udowodnić, że zgłoszenie jest trafne, a potem że poprawka działa, bez ponownego czytania całej sesji.
• Dokładne ustawienia, którymi zespół ogranicza lub wyłącza to, co wysyłają /bug, /feedback i ankiety sesji.
• Właściwy prywatny kanał dla luk bezpieczeństwa i właściwy kanał dla błędów w tym przewodniku.

Jakiego kanału używa każde narzędzie?

Jeśli narzędzie ma polecenie wbudowane, zacznij od niego. Dołącza kontekst sesji, którego zwykle brakuje w ręcznie pisanym zgłoszeniu.

Cel	Claude Code	Codex	Cursor
Błąd, w narzędziu	/bug (alias /share) albo /feedback	/feedback („send logs to maintainers”)	Nie zweryfikowano ścieżki w narzędziu; zobacz wiersz forum
Błąd, publiczny tracker	issues anthropics/claude-code (szablon błędu)	issues openai/codex	Forum społeczności Cursora
Prośba o funkcję	Issue na GitHubie, szablon feature request	Issue na GitHubie albo głos na istniejące	Forum Cursora
Luka bezpieczeństwa	Anthropic na HackerOne	OpenAI na Bugcrowd	E-mail security-reports@cursor.com, zgodnie z SECURITY.md w cursor/cursor
Wkład w kod	Brak przewodnika dla kontrybutorów w repozytorium	Nieprzyjmowany („We do not accept external code contributions or pull requests”)	Zamknięty kod
Pomoc społeczności	Claude Developers Discord	Tracker zgłoszeń	Forum Cursora

Wiersze dla Claude Code i Codex sprawdzono 2026-09-26 na Claude Code v2.1.283, codex-cli 0.157.1 oraz plikach SECURITY.md, szablonach zgłoszeń i docs/contributing.md obu repozytoriów. Strony Cursora nie dało się pobrać z tego środowiska 2026-09-26, więc kolumna Cursora opiera się na forum i pliku SECURITY.md w publicznym repozytorium cursor/cursor i nie twierdzi niczego o dokumentach diagnostycznych Cursora.

Jak zgłosić błąd, który opiekunowie odtworzą?

1. Zbierz diagnostykę, zanim cokolwiek zrestartujesz. Nowa sesja często gubi stan błędu, więc zacznij od tego.

   Claude Code

   W sesji, która zachowała się źle:

   /status     # version, model, account, connectivity
   /doctor     # installation and configuration checkup; can fix what it finds
   /debug the Edit tool rewrote a file outside the working directory
   /export bug-session.txt

   /debug włącza logowanie od tej chwili i analizuje log, więc złapie kolejne wystąpienie, a nie to, które już minęło. Żeby nagrać cały przebieg, uruchom w terminalu ponownie z plikiem logu i odtwórz błąd:

   claude --version
   claude --debug-file ./cc-debug.log

   Z powłoki claude doctor sprawdza instalację bez otwierania sesji. Zanotuj, czy zadziałał hook, czy brał udział serwer MCP i czy sesja szła z --dangerously-skip-permissions, bo każda z tych rzeczy zmienia zachowanie.

   Codex

   W TUI:

   /status        # session configuration and token usage
   /debug-config  # config layers and where each requirement came from

   Następnie w terminalu:

   codex --version
   codex doctor --json > codex-doctor.json   # redacted, machine-readable report

   Podaj, gdzie uruchamiasz Codex (CLI, rozszerzenie IDE, aplikacja desktopowa albo chmura) i używane uprawnienia. Sandbox tylko do odczytu wyjaśnia wiele zgłoszeń „odmówił edycji pliku”, zanim ktokolwiek zajrzy do logu.

   Cursor

   Zapisz dokładny numer buildu Cursora i godzinę nieudanego zapytania oraz dołącz każdy identyfikator żądania lub błędu, który Cursor ci pokaże. Cursor ma zamknięty kod, więc to te dane pozwalają jego zespołowi znaleźć żądanie po swojej stronie.

   Odtwórz błąd jeszcze raz z wyłączonymi rozszerzeniami. Jeśli problem zniknie, wymień rozszerzenie w zgłoszeniu.

2. Zmniejsz błąd do minimalnej reprodukcji. Opiekun uruchomi 20-linijkowy skrypt; nikt nie odtworzy twojej dwugodzinnej sesji. Poproś agenta, by zbudował ją w katalogu roboczym, a nie w projekcie, w którym wystąpił błąd.

   Prompt do skopiowania: zamień nieudaną sesję w minimalną reprodukcję

   The previous turns show a bug in the coding agent itself, not in my code:
   the agent's edit to src/api/users.ts was applied to src/api/user.ts instead.
   
   In a new directory /tmp/agent-repro, build the smallest reproduction of this:
   1. Create only the files needed to trigger it, with placeholder content.
   2. Write REPRO.md with: exact steps, the prompt to paste, the expected result,
      and the actual result from this session.
   3. Write check.sh that exits 1 while the bug is present and 0 once it is fixed,
      by inspecting the files on disk after the steps run.
   4. Do not copy any code, secrets, hostnames, or customer data from this project.
   Stop after writing the files and list them.

3. Usuń dane wrażliwe, zanim cokolwiek opuści twój komputer. Przeszukaj log, eksport i reprodukcję pod kątem kluczy, tokenów, wewnętrznych nazw hostów i danych klientów. Gdy Claude Code zapisuje lokalną paczkę zgłoszenia, usuwa z niej znane wzorce kluczy API i tokenów; kod źródłowy i zawartość plików zawsze trafiają do niej bez zmian, więc sprawdź je sam.

4. Poszukaj duplikatów, potem napisz szkic zgłoszenia. Istniejące issue uzupełnione o twoje dowody dostaje więcej uwagi niż nowe, które opiekunowie zamkną jako duplikat.

   Prompt do skopiowania: sprawdź duplikaty i napisz szkic zgłoszenia

   Use the gh CLI to search open and closed issues in anthropics/claude-code
   for this bug: run `gh issue list --repo anthropics/claude-code --state all
   --search "<three key words from REPRO.md>" --limit 20` with two or three
   different keyword sets.
   
   If an issue matches, show it and draft a comment that adds only what is new:
   my version, the reproduction from /tmp/agent-repro, and check.sh output.
   
   If nothing matches, draft a new issue using the template sections below and
   the files in /tmp/agent-repro. Keep it under 300 words, one bug per issue.
   Do not post anything; print the draft for me to review.

   Przy błędzie w Codex zamień anthropics/claude-code na openai/codex. W przypadku Cursora przeszukaj forum ręcznie.

5. Wyślij zgłoszenie z sesją, jeśli narzędzie na to pozwala. W Claude Code /bug otwiera ekran zgody, na którym wybierasz, ile historii dołączyć. W Codex /feedback wysyła logi, a wysyłkę logów możesz odrzucić i przesłać samą notatkę (codex-cli 0.157.1). Wklej link do zgłoszenia do trackera zespołu, żeby obejście miało właściciela.

Użyj tego szkieletu w publicznym zgłoszeniu. Szablon błędu Claude Code pyta też, czy to regresja i jaka była ostatnia działająca wersja, oraz każe potwierdzić, że przeszukałeś istniejące zgłoszenia, zgłaszasz jeden błąd i masz najnowszą wersję.

## What happened
The agent applied an edit meant for src/api/users.ts to src/api/user.ts.

## Reproduction
Steps and prompt: see REPRO.md (attached). `check.sh` exits 1 on the affected version.

## Expected / actual
Expected: edit lands in users.ts. Actual: user.ts is modified, users.ts is unchanged.

## Environment
- Tool and version: claude --version / codex --version / Cursor build
- Model and permission mode: from /status
- OS and shell:
- Diagnostics: debug log excerpt / codex-doctor.json / Cursor error or request identifier

## Last version that worked (if known)

Jak udowodnić, że zgłoszenie jest trafne, bez ponownego czytania sesji?

Wyrocznią jest check.sh z kroku 2. Zamienia „wydaje mi się, że agent zrobił coś dziwnego” w sygnał zaliczone/niezaliczone, który każdy może uruchomić, więc ani ty, ani opiekun nie musicie czytać transkryptu od nowa.

• Przed zgłoszeniem: uruchom check.sh dwa razy na bieżącej wersji. Musi zawieść za każdym razem. Reprodukcja, która zawodzi raz na pięć uruchomień, też się przyda, ale napisz o tym w zgłoszeniu.
• Między wersjami: zainstaluj poprzednią wersję, uruchom sprawdzenie i wpisz wynik do zgłoszenia. „Zawodzi na 2.1.283, przechodzi na 2.1.274” pozwala opiekunom szybko znaleźć zmianę.
• Gdy dostawca wyda poprawkę: zaktualizuj, uruchom check.sh i usuń obejście dopiero wtedy, gdy skrypt zwróci 0. Właściciel obejścia w twoim trackerze zatwierdza ten wynik.
• W twoim repozytorium: jeśli błąd uszkodził jakiś typ plików, dodaj test albo regułę lintera, która wykryje to uszkodzenie. Ten test chroni cię, gdyby regresja wróciła, zanim dostawca odpowie.

Ten sam nawyk „najpierw wyrocznia” przy błędach aplikacji opisują strony debugowanie z Claude Code i polowanie na błędy z Codex.

Jak zgłosić regresję po aktualizacji?

Na regresje dostawcy reagują najszybciej, bo para wersji zawęża poszukiwania.

Claude Code

Claude Code ma dwa kanały wydań. 2026-10-17 latest to v2.1.302, a stable to v2.1.292 (dist-tagi npm); stable jest zwykle około tygodnia w tyle i pomija wydania z poważnymi regresjami. Żeby potwierdzić regresję, zainstaluj poprzednią wersję i uruchom sprawdzenie ponownie. Przy instalacji natywnej (domyślnej) użyj claude install z numerem wersji (sprawdzone na Claude Code v2.1.286, 2026-09-30):

claude install 2.1.274
export DISABLE_AUTOUPDATER=1   # stops the background updater moving you back to latest
claude --version               # must print 2.1.274 before you trust the result
./check.sh; echo "exit: $?"

Jeśli instalowałeś przez npm, zamiast pierwszej linii uruchom npm install -g @anthropic-ai/claude-code@2.1.274. Nie mieszaj obu metod: instalacja npm na komputerze z instalacją natywną dodaje drugą kopię, którą zgłasza /doctor, i to ona nie musi być tym claude, które jest w PATH. Zanim uruchomisz check.sh, potwierdź wersję poleceniem claude --version. DISABLE_AUTOUPDATER=1 opisuje dokumentacja zmiennych środowiskowych Claude Code (sprawdzone 2026-09-26); po teście usuń tę zmienną.

Żeby chronić zespół przed świeżymi regresjami, ustaw "autoUpdatesChannel": "stable" w settings.json albo przez /config i wymuś to ustawieniami zarządzanymi.

Codex

Przypnij ostatnią działającą wersję i uruchom sprawdzenie ponownie:

npm install -g @openai/codex@LAST_GOOD_VERSION
codex --version && ./check.sh; echo "exit: $?"

Zamień LAST_GOOD_VERSION na wersję sprzed aktualizacji (listę pokazuje npm view @openai/codex versions). Wrócisz poleceniem npm install -g @openai/codex@latest.

Cursor

Zapisz build sprzed aktualizacji i po niej. Jeśli używasz wersji przedpremierowych, przed zgłoszeniem odtwórz błąd raz na stabilnym buildzie i napisz, który sprawdziłeś.

Uwaga

Wersje przedpremierowe testuj na gałęzi do wyrzucenia albo w jednorazowym sandboksie. Nigdy nie łącz nowego buildu z --dangerously-skip-permissions ani z sandboksem o pełnym dostępie w repozytorium, na którym ci zależy.

Jak napisać prośbę o funkcję, która przejdzie triaż?

Szablon feature request w Claude Code zaczyna się od Problem Statement: jaki problem próbujesz rozwiązać i dlaczego tego potrzebujesz. Przewodnik dla kontrybutorów Codex prosi o przypadek użycia, oczekiwane zachowanie i powód, dla którego usprawni to twoją pracę. Oba nagradzają ten sam kształt:

1. Jedna prośba na zgłoszenie. Szablon Claude Code każe potwierdzić, że to „a single feature request (not multiple features)”.
2. Problem przed rozwiązaniem. „Hooki nie widzą, który subagent wprowadził zmianę, więc nasz log audytowy przypisuje każdą zmianę sesji nadrzędnej” to coś, na czym da się działać. „Dodajcie ID subagentów do hooków” zaprasza do sporu o niewłaściwy projekt.
3. Konkretny przepływ pracy. Wymień pliki, polecenia i ręczny krok, który funkcja by usunęła.
4. Głos zamiast duplikatu. Jeśli zgłoszenie już istnieje, dodaj reakcję i komentarz ze swoim przypadkiem użycia.

Co wysyłają opinie i jak zespół to kontroluje?

Tech lead potrzebuje tej sekcji przed wdrożeniem narzędzia. Fakty o Claude Code pochodzą z jego dokumentów o użyciu danych i zmiennych środowiskowych, sprawdzonych 2026-09-26.

Ustawienie	Claude Code	Codex
Co wysyła zgłoszenie	Rozmowę razem z kodem. Wybierasz bieżącą sesję (domyślnie) albo też inne sesje z tego samego projektu z ostatnich 24 godzin lub 7 dni	Logi, opcjonalnie z dołączonym raportem codex doctor; możesz wysłać notatkę bez logów (codex-cli 0.157.1)
Retencja	Transkrypty wysłane przez /feedback, /bug lub /share: 5 lat	Nie podano w codex-cli 0.157.1
Wyłączenie polecenia	DISABLE_FEEDBACK_COMMAND=1 (starsza nazwa DISABLE_BUG_COMMAND nadal działa)	[feedback] enabled = false w config.toml (ustawienie obecne w codex-cli 0.157.1)
Ankieta sesji	„How is Claude doing?” zapisuje tylko ocenę; CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1 ją wyłącza	—
Opinie szkicowane przez Claude	Claude może kolejkować szkice opinii, które przeglądasz w /feedback; nic nie wychodzi, dopóki nie wyślesz szkicu. Wyłączysz to ustawieniem "feedbackDrafts": "off" w ustawieniach użytkownika lub ustawieniach zarządzanych albo CLAUDE_CODE_SEND_FEEDBACK=0 dla jednej sesji; wyłącza je też DISABLE_FEEDBACK_COMMAND	—
Dostawcy zewnętrzni	W Amazon Bedrock, Agent Platform w Google Cloud (dawniej Vertex AI) lub Microsoft Foundry albo bez danych uwierzytelniających Anthropic raport trafia do ~/.claude/feedback-bundles/ z usuniętymi znanymi wzorcami kluczy i tokenów; nic nie wychodzi, dopóki sam go nie przekażesz	—

Po ankiecie może pojawić się osobne pytanie o przesłanie transkryptu sesji. Odpowiedź Yes wysyła rozmowę, transkrypty subagentów i log sesji, przechowywane do 6 miesięcy. Nic nie zostaje wysłane, dopóki ktoś nie wybierze Yes.

W zespole ustal zasady raz: które narzędzia mogą wysyłać transkrypty, kto sprawdza zgłoszenie, zanim opuści regulowane repozytorium, i gdzie ustawienie jest wymuszane. Zasady opisuje strona prywatność i przetwarzanie danych, a ich wymuszanie – ustawienia zarządzane.

Gdzie zgłaszać luki bezpieczeństwa?

Nigdy nie zgłaszaj luki jako publicznego issue ani przez /bug. Publiczne zgłoszenie ujawnia ją wszystkim, zanim powstanie poprawka.

• Claude Code: program Anthropic na HackerOne, podlinkowany z pliku SECURITY.md repozytorium.
• Codex: program OpenAI na Bugcrowd, podlinkowany z pliku SECURITY.md repozytorium.
• Cursor: e-mail security-reports@cursor.com, zgodnie z plikiem SECURITY.md w repozytorium cursor/cursor (sprawdzone 2026-09-26). Nigdy nie publikuj luki na forum.

Jeśli agent zrobił coś niebezpiecznego, co nie jest luką, na przykład zignorował skonfigurowaną regułę deny, to zwykły błąd. Zgłoś go normalnym kanałem, z reprodukcją.

Jak zgłosić błąd w tym przewodniku?

Przewodniki na developertoolkit.ai nie są open source, więc nie ma ścieżki przez pull request. Zamiast tego:

• „Ulepsz tę stronę”: przycisk obok każdego artykułu otwiera issue w publicznym repozytorium towarzyszącym ze ścieżką strony w tytule. Napisz, co jest źle, jak powinno być, i podlinkuj źródło, na przykład wpis w changelogu albo wynik --help z numerem wersji.
• E-mail: hello@developertoolkit.ai w każdej innej sprawie; zobacz też stronę kontaktu.
• Discord: serwer społeczności, na którym czytelnicy pytają o przewodniki i zbierane są prośby o funkcje.

Najszybciej poprawiamy zgłoszenie ze źródłem opatrzonym wersją. „Wartość -a on-failure kończy się błędem »invalid value« w codex-cli 0.157.1” łatwo sprawdzić. „To jest nieaktualne” – już nie.

Co idzie nie tak przy zgłaszaniu błędów?

Zamknięte jako „nie da się odtworzyć”. Zgłoszenie opisywało objaw bez reprodukcji. Dodaj REPRO.md, check.sh i parę wersji, a potem poproś o ponowne otwarcie. Nie otwieraj drugiego zgłoszenia.

Sekret wyciekł w logu. Najpierw unieważnij i wymień dane uwierzytelniające. Późniejsza edycja zgłoszenia nie pomoże, bo pierwotny tekst mógł już zostać skopiowany lub zaindeksowany. Potem zedytuj zgłoszenie i powiedz opiekunom, co zostało ujawnione.

/bug albo /feedback nic nie robi. Twoja organizacja mogła ustawić DISABLE_FEEDBACK_COMMAND lub CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC albo korzystasz z dostawcy zewnętrznego (Amazon Bedrock, Agent Platform w Google Cloud, Microsoft Foundry) lub nie masz danych uwierzytelniających Anthropic i raport trafił do ~/.claude/feedback-bundles/. Zanim przekażesz plik, skonsultuj to z administratorem. W Codex sprawdź, czy w konfiguracji feedback.enabled nie ma wartości false.

Twój pull request do Codex zamknięto. Codex nie przyjmuje zewnętrznego kodu. Opublikuj poprawkę jako analizę przyczyny w zgłoszeniu. Przewodnik dla kontrybutorów Codex wymienia właśnie taki wkład jako pożądany.

Błąd występuje tylko na latest. Przełącz zespół na kanał stable, zgłoś regresję z parą wersji i wróć, gdy check.sh przejdzie na nowszym wydaniu.

Zgłoszenie ucichło. Ani szablony zgłoszeń, ani dokumenty dla kontrybutorów i bezpieczeństwa żadnego z repozytoriów nie obiecują czasu odpowiedzi (sprawdzone 2026-09-26). Dodawaj nowe dowody, gdy je masz, na przykład kolejną wersję z błędem albo węższą reprodukcję. Nie pisz komentarzy „+1”; reakcja robi to samo bez powiadamiania każdego subskrybenta.

Dokąd dalej z problemami z narzędziami

• Rozwiązywanie problemów: poprawki typowych problemów z Claude Code, Codex i Cursorem, które warto sprawdzić przed zgłoszeniem.
• Zasoby społeczności: fora, serwery Discord i kanały, na których użytkownicy porównują obejścia.
• FAQ: krótkie odpowiedzi o planach, modelach i konfiguracji.
• Prywatność i przetwarzanie danych: zasady zespołu dotyczące tego, co opuszcza firmę, w tym transkryptów opinii.