# Okna kontekstu i limity tokenów w agentach programistycznych

URL: https://developertoolkit.ai/pl/workflows/context/context-windows/
Description: Co wypełnia okno kontekstu agenta, dlaczego większe okno nie usuwa dryfu oraz kiedy kompaktować, czyścić, rozgałęziać albo delegować pracę.

Okno kontekstu agenta programistycznego to budżet tokenów, który model czyta od nowa w każdej turze: prompt systemowy, instrukcje repozytorium, schematy narzędzi, odczyty plików, wyniki komend i historię rozmowy. Programiści oraz tech leadzi zarządzają tym oknem świadomie — decydując, kiedy kompaktować, resetować, rozgałęziać lub delegować — ponieważ przestrzeganie reguł słabnie na długo przed osiągnięciem twardego limitu tokenów.

Po czterdziestu minutach debugowania agent przeczytał dwanaście plików, sześć razy uruchomił testy i znalazł przyczynę błędu. Prosisz o poprawkę, a on edytuje zły moduł, wraca do rozwiązania odrzuconego dwadzieścia minut temu i pomija wymagany test regresji. Nic się nie wywróciło; automatyczne kompaktowanie streściło rozmowę i po cichu zgubiło wczesne ograniczenia.

## Co naprawdę zapełnia okno kontekstu i dlaczego większe okno nie rozwiązuje problemu

Każda tura ponownie wysyła całe aktywne okno, więc największym konsumentem rzadko są twoje prompty. Okno zapełniają przede wszystkim eksploracyjne odczyty plików i rozwlekłe logi komend:

| Konsument kontekstu | Kiedy trafia do okna | Jak go ograniczyć |
| --- | --- | --- |
| Prompt systemowy i metadane środowiska | Stały narzut w każdej turze | Zarządzany przez narzędzie |
| `AGENTS.md`, `CLAUDE.md`, reguły stałe | Start sesji i ponowne wstrzyknięcie po kompaktowaniu | [Przytnij pliki instrukcji](/pl/workflows/context/pruning-context-files/); szczegóły przenieś do reguł ścieżkowych i skilli |
| Schematy narzędzi MCP | Start sesji lub wykrywanie na żądanie | Usuń nieużywane serwery; stosuj [higienę MCP](/pl/ecosystem/mcp/) |
| Odczyty plików | Za każdym razem, gdy agent otwiera kod | Wskazuj konkretne pliki i symbole; szerokie rozpoznanie deleguj subagentowi |
| Wyniki komend | Każde uruchomienie testów, builda lub wyszukiwania | Uruchamiaj zawężone testy (`--silent`), przerywaj na pierwszym błędzie i skracaj logi |
| Historia rozmowy | Narasta w każdej turze | Kompaktuj świadomie na granicach faz albo zaczynaj świeżą sesję |

Większe okno kontekstu odsuwa wymuszone kompaktowanie, ale nie likwiduje rozproszenia uwagi modelu. Instrukcje z początku długiej sesji konkurują z setkami tysięcy tokenów diffów, śladów stosu i zrzutów plików. Traktuj okno kontekstu jak budżet roboczy na jeden rezultat, nigdy jak trwały magazyn.

## Kiedy kompaktować, czyścić, rozgałęziać lub delegować

Wybieraj działanie według tego, czego wciąż potrzebujesz z bieżącego transkryptu, zamiast czekać, aż wskaźnik wejdzie na czerwone pole:

| Sytuacja | Strategia | Dlaczego działa |
| --- | --- | --- |
| To samo zadanie, przejście od diagnozy do implementacji | **Kompaktowanie z celem** | Zachowuje decyzje, odrzucone podejścia i kryteria akceptacji, wyrzucając szum eksploracji |
| Rozpoczęcie niezwiązanego zgłoszenia lub błędu | **Reset / nowa sesja** | Usuwa stare odczyty plików, które ściągają edycje w stronę obcych modułów |
| Sprawdzenie alternatywnej architektury bez utraty bieżącej ścieżki | **Rozgałęzienie (fork/branch)** | Zachowuje czysty punkt kontrolny do porównania rozwiązań na tych samych testach |
| Szerokie przeszukiwanie repo, triaż logów lub review tylko do odczytu | **Delegacja do subagenta** | Zamyka ciężkie odczyty w osobnym oknie; do głównego wątku wraca krótkie podsumowanie |
| Praca rozłożona na wiele sesji lub uruchomienia w tle | **Zapis stanu na dysku** | Pliki przetrwają każde kompaktowanie, reset i restart narzędzia |

Dwie zasady zamieniają tę tabelę w codzienny nawyk:

1. **Kompaktuj na granicach faz, zanim odpali się auto-kompaktowanie.** Automatyczne streszczenie zgaduje, co ma znaczenie; ręczne kompaktowanie z jasnym celem zachowuje dokładne kryteria akceptacji, odrzucone podejścia i komendę weryfikacji.
2. **Wszystko, co musi przetrwać reset, zapisuj na dysku.** Specyfikacje i plany commituj w repozytorium, a roboczy stan sesji trzymaj w ignorowanym przez Git pliku przekazania, takim jak `.agent/handoff.md`.

### Jak trzy narzędzia udostępniają kontrolę okna

Dokładne polecenia slash, wskaźniki statusu i progi kompaktowania zmieniają się między wydaniami. Bieżącą składnię sprawdzaj w oficjalnej dokumentacji, trzymając się tego samego wzorca:

**Claude Code**

    Sprawdzaj podział użycia okna według kategorii (prompt systemowy, pliki pamięci, narzędzia, wiadomości), kompaktuj z jawnym zakresem zachowania, czyść kontekst między zadaniami, rozgałęziaj sesje i deleguj eksplorację do własnych subagentów w `.claude/agents/`. Główny `CLAUDE.md` wraca po kompaktowaniu, natomiast reguły ścieżkowe ładują się ponownie dopiero przy odczycie pasujących plików; lekki hook `SessionStart` dla kompaktowania może automatycznie wstrzykiwać plik przekazania z dysku. Zobacz [dokumentację Claude Code](https://code.claude.com/docs) i [własnych subagentów](/pl/claude-code/automate/custom-subagents/).

**Codex**

    Monitoruj zużycie tokenów i konfigurację w widoku statusu sesji, kompaktuj albo resetuj wątek między zadaniami, rozgałęziaj sesje dla alternatywnych podejść i w razie potrzeby dostosowuj rozmiar okna lub próg kompaktowania w konfiguracji użytkownika. Hałaśliwe rozpoznanie oddawaj subagentom, a po kompaktowaniu ponownie wczytuj notatkę przekazania z dysku ręcznie lub przez hook kompaktowania. Zobacz [dokumentację OpenAI Codex](https://developers.openai.com/codex).

**Cursor**

    Otwieraj nowy czat Agent dla każdego zadania, wskazuj konkretne pliki bezpośrednio zamiast pozwalać agentowi skanować całe katalogi i deleguj szerokie rozpoznanie do subagentów. Gdy długi czat zaczyna dryfować, zaktualizuj `.agent/handoff.md` i uruchom świeży czat ze wskazaniem tego pliku. Zobacz [dokumentację Cursora](https://cursor.com/docs).

## Prowadź wieloetapowe zadanie bez utraty ograniczeń

Stosuj tę pięciokrokową pętlę zawsze, gdy poprawka, migracja lub funkcja przekracza jedną skupioną sesję:

1. **Zakotwicz jeden rezultat na dysku.** Zapisz cel, kryteria akceptacji i dokładną komendę weryfikacji w ignorowanym `.agent/handoff.md` albo w zacommitowanej [specyfikacji](/pl/workflows/plan/spec-driven-development/).

2. **Eksploruj tanio albo deleguj.** Ogranicz wyszukiwanie do konkretnych punktów wejścia i krótkich fragmentów kodu albo oddaj rozpoznanie subagentowi tylko do odczytu, który dopisze 15-liniowe podsumowanie do pliku przekazania.

3. **Rób punkt kontrolny przed zmianą fazy.** Po zakończeniu diagnozy niech agent zaktualizuje `.agent/handoff.md` o podjęte decyzje i odrzucone podejścia, a potem skompaktuj sesję z określonym celem — lub wyczyść okno i wystartuj od pliku przekazania.

4. **Przywracaj trwałe ograniczenia automatycznie.** W Claude Code podepnij lekki hook kompaktowania, aby kluczowy stan zadania wracał bez ręcznego kopiowania:

   ```json title=".claude/settings.json"
   {
     "hooks": {
       "SessionStart": [
         {
           "matcher": "compact",
           "hooks": [
             { "type": "command", "command": "cat .agent/handoff.md 2>/dev/null || true" }
           ]
         }
       ]
     }
   }
   ```

5. **Resetuj czysto dla kolejnego zadania.** Gdy testy przejdą, a zmiana jest gotowa, zacznij następny ticket w świeżej sesji zamiast wracać do starego wątku.

**Prompt do skopiowania: tania eksploracja kontekstu**

```text
Map how subscription cancellation works before editing any code:
- Search first; never read whole directories.
- Inspect only the functions on the cancellation path across at most four files.
- Ignore generated clients and archived folders.
Write a 15-line summary into .agent/handoff.md under "## Flow": entry point,
call sequence (file:line), persistence layer, and open questions. Do not edit code.
```

**Prompt do skopiowania: notatka przekazania odporna na reset**

```text
Update .agent/handoff.md so a fresh session with zero prior memory can continue:
## Goal and acceptance criteria (verbatim, never reworded)
## Done (changed files, one line each with rationale)
## Decisions and rejected approaches (what we chose, what we ruled out, and why)
## Current state (exact test command and current pass/fail results)
## Next step (one concrete action)
Keep under 60 lines. Reference file:line instead of pasting code blocks.
```

## Zweryfikuj, czy ograniczenia przetrwały kompaktowanie lub reset

Nie czytaj tysiąclinijkowego transkryptu, żeby zgadywać, czy agent nadal pamięta ustalenia. Wystarczą cztery szybkie kontrole:

- **Powtórz i porównaj.** Zaraz po kompaktowaniu lub resecie poproś agenta o dosłowne zacytowanie kryteriów akceptacji i odrzuconych podejść. Porównaj z `.agent/handoff.md`; każdy brak oznacza dryf — zatrzymaj pracę i wczytaj plik przed kolejną edycją.
- **Wykonywalna wyrocznia zamiast pamięci.** Powiąż kryteria akceptacji z nieprzechodzącymi testami jeszcze przed implementacją ([siła wyroczni](/pl/workflows/test/oracle-strength/)). To, czy model „pamięta” regułę, traci znaczenie, gdy zestaw testów natychmiast sygnalizuje naruszenie.
- **Kontrola zakresu diffu.** Porównaj `git diff --stat` z planowanym zakresem. Niezapowiedziane pliki ujawniają utratę kontekstu i rozlanie zakresu.
- **Audyt stałego narzutu.** Uruchom `npx @wondelai/harness-audit --lang pl`, aby upewnić się, że przerośnięte pliki instrukcji lub nadmiarowe serwery MCP nie zajmują połowy okna przed pierwszym promptem ([przewodnik po harness-audit](/pl/workflows/harness/harness-audit-guide/)).

## Kiedy okno kontekstu działa przeciwko tobie

- **Agent łamie regułę, której przestrzegał godzinę wcześniej.** Zasada żyła wyłącznie w rozmowie albo w regule ścieżkowej streszczonej podczas kompaktowania. Przenieś trwałe granice do głównego `AGENTS.md`, twarde zasady wymuszaj [hookami](/pl/workflows/harness/agent-hooks/), a po kompaktowaniu przywracaj `.agent/handoff.md`.
- **Kolejne kompaktowania dają coraz gorsze edycje.** Wyjście narzędzi (pełne logi testów i builda) wypiera decyzje z okna. Zaktualizuj `.agent/handoff.md`, całkowicie zresetuj sesję i przełącz się na zawężone testy (`check:changed`) wypisujące wyłącznie błędy.
- **Połowa okna jest zajęta przed pierwszym promptem.** Stały narzut z przerośniętych plików instrukcji, rozrośniętej pamięci automatycznej lub dziesiątek aktywnych narzędzi MCP dusi sesję. Przeprowadź [protokół ablacji](/pl/workflows/context/pruning-context-files/) i usuń zbędne serwery MCP.
- **Agent czyta dwadzieścia plików, by odpowiedzieć na wąskie pytanie.** Szerokie rozpoznanie poszło w głównym wątku. Przerwij, wskaż docelowe pliki albo deleguj pytanie subagentowi tylko do odczytu.
- **Koszt tokenów rośnie bez proporcjonalnego postępu.** Ponowne wysyłanie ogromnego okna w każdej turze mnoży koszt iteracji. Utrzymuj krótkie sesje, czyść kontekst między zadaniami i łącz dyscyplinę okna ze strategiami dla [dużych baz kodu](/pl/workflows/build/large-codebases/).

## Oficjalna dokumentacja i kolejne kroki

Aktualne wskaźniki zużycia okna, komendy kompaktowania i konfigurację subagentów sprawdzaj w oficjalnej dokumentacji: [Claude Code](https://code.claude.com/docs), [OpenAI Codex](https://developers.openai.com/codex), [Cursor](https://cursor.com/docs) oraz [MCP](https://modelcontextprotocol.io).

- [Przycinanie plików kontekstu](/pl/workflows/context/pruning-context-files/) — Zmniejsz stały narzut zawsze ładowanych instrukcji protokołem ablacji.
- [AGENTS.md i zwięzły kontekst](/pl/workflows/context/agents-md-context/) — Zbuduj krótki kontrakt główny odporny na resety w każdym narzędziu.
- [Własni subagenci](/pl/claude-code/automate/custom-subagents/) — Przenoś hałaśliwe rozpoznanie i niezależne review do izolowanych okien.
- [Praca w dużych bazach kodu](/pl/workflows/build/large-codebases/) — Dziel złożone repozytoria tak, aby każda sesja mieściła się w ciasnym budżecie kontekstu.
