Zarządzanie kontekstem w agentach programistycznych

Zarządzanie kontekstem w agentach programistycznych to kontrola nad tym, co Claude Code, Codex lub Cursor trzyma w oknie kontekstu: pliki instrukcji, odczytane pliki, wyniki komend i rozmowę. Za mało kontekstu zmusza agenta do zgadywania, za dużo odciąga go od wcześniejszych instrukcji. Rozwiązaniem jest wąski zakres, reset we właściwym momencie i sprawdzenie, z czego agent korzysta.

Rano agent czysto naprawił błąd. Po południu, w tym samym czacie, edytuje moduł, którego twoje reguły zabraniają dotykać. Ta sekcja jest dla programistów, którzy codziennie pracują z agentami, i dla tech leadów odpowiedzialnych za pliki instrukcji ładowane przez cały zespół.

Która strona o kontekście rozwiąże twój problem?

Zacznij od objawu; każda strona odpowiada za jedną warstwę kontekstu.

Objaw	Strona
Agent zapomina reguły w trakcie sesji albo jakość spada po automatycznym kompaktowaniu kontekstu	Okna kontekstu i limity tokenów
Agent ignoruje lub źle odczytuje CLAUDE.md, AGENTS.md albo reguły Cursora (Rules)	Dokumentacja jako kontekst
Plik instrukcji urósł do setek linii jednorazowych poprawek	Przycinanie plików kontekstu
Agent czyta cały katalog, żeby zmienić jedną funkcję	Struktura projektu dla agentów
Agent nie znajduje właściwego kodu albo trafia na złą kopię	Wyszukiwanie i indeksowanie kodu
Każda nowa sesja od nowa odkrywa to, co ustaliła poprzednia	Długookresowe zachowywanie kontekstu
Rachunek za tokeny rośnie szybciej niż dostarczona praca	Optymalizacja kosztów kontekstu

Trzy nawyki, które zapobiegają problemom z kontekstem

Dobry prompt niesie intencję (co zmienić i co znaczy „gotowe”) oraz stan (pliki, błędy i wyniki testów opisujące obecny kod). Złym sesjom brakuje jednego z nich albo intencja ginie pod stanem. Trzy nawyki utrzymują równowagę:

1. Jedno zadanie na sesję. Pozostałości eksploracji z poprzedniego zadania sprawiają, że agent edytuje nie te pliki.
2. Wskazuj konkretne pliki. Podawaj funkcję albo plik, nie katalog, żeby agent czytał tylko to, czego potrzebuje.
3. Trzymaj krótki plik instrukcji. Komendy budowania, testów i lintera plus konwencje, które agent myli, żeby żadna sesja nie wydawała tokenów na ich ponowne odkrywanie.

Komendy różnią się między narzędziami:

Claude Code

• Pomiar: /context rysuje bieżące zużycie jako siatkę z podziałem na kategorie.
• Reset: /clear zaczyna nową sesję z pustym kontekstem; poprzednią wznowisz przez /resume.
• Kompaktowanie: /compact z opisem tego, co zachować, np. /compact keep the acceptance criteria and the test command.
• Wskazanie plików: wpisz @ i ścieżkę, żeby dołączyć plik do promptu.
• Instrukcje: CLAUDE.md; edytujesz go przez /memory. Od v2.1.277 (oba kanały wydań w dniu 2026-10-12) Claude Code czyta AGENTS.md, gdy projekt nie ma CLAUDE.md (v2.1.281 na Bedrocku, Google Cloud, Foundry i bramkach LLM); przełączysz to w sekcji Project instructions w /config.

Sprawdzone 26.09.2026 na Claude Code 2.1.283 (kanał latest).

Codex

• Pomiar: /status pokazuje konfigurację sesji i zużycie tokenów.
• Reset: /new zaczyna nowy czat; /clear dodatkowo czyści terminal.
• Kompaktowanie: /compact streszcza rozmowę, żeby nie przekroczyć limitu kontekstu.
• Wskazanie plików: /mention dołącza plik; uruchamiaj we właściwym katalogu przez codex -C DIR.
• Instrukcje: AGENTS.md; /init go tworzy. Codex ładuje AGENTS.md projektu tylko wtedy, gdy projekt jest zaufany (od 0.150.0); jeśli wygląda na ignorowany, najpierw sprawdź zaufanie.

Sprawdzone 26.09.2026 na Codex CLI 0.157.1.

Cursor

• Reset: zaczynaj nowy czat dla każdego zadania.
• Wskazanie plików: oznaczaj przez @ pliki potrzebne do zadania, zamiast pozwalać agentowi przeszukiwać cały projekt.
• Instrukcje: Rules (reguły projektu w Cursorze). Zakres reguł opisuje strona zarządzanie kontekstem w Cursorze.
• Gdy czat dryfuje: zapisz notatkę przekazania i zacznij nowy czat; śledzenie zużycia opisuje zarządzanie tokenami w Cursorze.

Informacje o Cursorze sprawdzone w dokumentacji Cursora 28.08.2026.

Prompty, które ustawiają i sprawdzają kontekst agenta

Prompt do skopiowania: zadanie z intencją i stanem

Task: make POST /api/subscriptions/cancel idempotent. A second cancel request for an
already-cancelled subscription must return 200 with the current state, not 500.

State: the handler is src/routes/subscriptions/cancel.ts; persistence is in
src/db/subscriptions.ts. The failing case is reproduced by
tests/subscriptions/cancel.test.ts ("cancels twice").

Scope: read only those three files and anything they import directly. Do not open
other directories without asking. Done when `npm test -- cancel` passes and no other
file changes.

Prompt do skopiowania: pokaż, na czym pracujesz

Before you change anything, list:
1. Every instruction file and rule you loaded for this session, by path.
2. The constraints from those files that apply to this task, quoted verbatim.
3. The files you have read so far.
4. The command that will prove this task is done.
Mark anything you are assuming rather than reading from a file. Do not edit code yet.

Skąd wiesz, że agent miał właściwy kontekst?

Nie musisz czytać transkryptu. Trzy sprawdzenia zajmują sekundy; czwarte uruchamiasz, gdy edytujesz plik instrukcji:

• Powtórz i porównaj. Uruchom drugi prompt na początku i ponownie po każdym kompaktowaniu. Brakujące lub przeformułowane ograniczenie oznacza utratę kontekstu; zanim agent napisze więcej kodu, odeślij go do pliku.
• Testy jako wyrocznia. Komenda z „done when” rozstrzyga, czy zachowanie istnieje. Zobacz, jak silna jest twoja wyrocznia.
• Zakres diffu. git status --short powinien pokazać tylko pliki wskazane w prompcie, łącznie z nowymi. Nieoczekiwana ścieżka to znak, że agent zgubił zakres.
• Mierz zmiany w plikach instrukcji. Uruchom to samo zadanie w świeżej sesji przed edycją CLAUDE.md lub AGENTS.md i po niej, co najmniej trzy razy w każdym wariancie. Porównuj odsetek udanych przebiegów i git status --short, a nie pojedynczy wynik. /context (Claude Code) albo /status (Codex) pokaże, ile zmiana kosztuje w tokenach.

Za sprawdzenie „powtórz i porównaj” odpowiada programista, za testy i zakres diffu — recenzent. Zmiany we wspólnych plikach instrukcji przechodzą code review z wyznaczonym właścicielem.

Kiedy zarządzanie kontekstem zawodzi

• Znika decyzja podjęta wcześniej w sesji. Kompaktowanie ją pominęło. Zapisuj decyzje i kryteria akceptacji w pliku, który agent czyta ponownie; strona o oknach kontekstu pokazuje notatkę przekazania i hook uruchamiany przy kompaktowaniu.
• Plik instrukcji rośnie, a przestrzeganie reguł spada. Każda linia konkuruje o uwagę. Zarchiwizuj plik, zapisuj błędy agenta i przywracaj linię dopiero wtedy, gdy ten sam błąd powtórzy się dwa razy, zgodnie z protokołem ablacji.
• Agent wykonuje instrukcję, której nikt w zespole nie napisał. Pliki instrukcji są częścią łańcucha dostaw. Recenzuj ich zmiany jak kod i nigdy nie pozwalaj agentowi w CI, który ma dostęp do sekretów, ładować ich z niezaufanej gałęzi. Zobacz, jak ograniczyć to, co ładują agenci w CI.

Dokąd dalej w temacie kontekstu

Okna kontekstu i limity tokenów Zmierz okno i zdecyduj, kiedy stosować kompaktowanie, czyszczenie kontekstu albo delegowanie.

Dokumentacja jako kontekst Pisz pliki instrukcji, które każde narzędzie ładuje i stosuje.

Harness agenta Kontekst obok narzędzi, uprawnień, hooków, skilli i środowisk.

Zwięzły AGENTS.md i CLAUDE.md Krótka, oceniona wersja dobrego pliku instrukcji repozytorium.