Agent View: claude agents

Podgląd badawczy v2.1.139+

Agent view, otwierany komendą claude agents, to pojedynczy dashboard dla każdej działającej w tle sesji Claude Code na twojej maszynie. Każdy wiersz to pełna rozmowa, która działa bez podłączonego terminala. Uruchamiasz nowe sesje z inputu na dole, podglądasz dowolny wiersz, aby zobaczyć ostatni output, dołączasz do pełnego transkryptu i wkraczasz tylko gdy któraś sesja cię potrzebuje.

Funkcja zadebiutowała 11 maja 2026 razem z Claude Code v2.1.139 jako podgląd badawczy na planach Pro, Max, Team, Enterprise i Claude API. Zweryfikuj wersję komendą claude --version przed poleganiem na tej funkcji.

Podgląd badawczy

Interfejs i skróty klawiszowe mogą się zmieniać. Traktuj workflow budowane wokół claude agents jako eksperymenty, nie krytyczną infrastrukturę.

Szybki start

1. Otwórz agent view. Z terminala:

   claude agents

   Widok przejmuje terminal. Naciśnij Esc w dowolnym momencie, aby wrócić do shella — sesje pracują dalej i pojawią się ponownie przy następnym otwarciu widoku.

2. Uruchom sesję. Wpisz zadanie w input na dole i naciśnij Enter. Nowa sesja w tle startuje i pojawia się jako wiersz pokazujący, czy pracuje, czeka na ciebie, czy już skończyła. Każdy prompt tworzy własną nową sesję, więc wpisanie dwóch promptów uruchamia dwie równoległe sesje.

3. Podejrzyj i odpowiedz. Zaznacz wiersz strzałkami i naciśnij Space, aby otworzyć panel podglądu — najnowszy output lub pytanie, na które sesja jest zablokowana. Wpisz odpowiedź i naciśnij Enter, aby ją wysłać bez opuszczania agent view.

4. Dołącz i odłącz. Naciśnij Enter lub → na wierszu, aby dołączyć do pełnej rozmowy. Naciśnij ← na pustym promptcie, aby odłączyć się i wrócić do tabeli. Odłączenie nigdy nie zatrzymuje sesji w tle.

5. Wprowadź istniejącą sesję. Wewnątrz dowolnej otwartej sesji uruchom /bg, aby przenieść ją do tła, lub naciśnij ← na pustym promptcie, aby zbackground’ować i otworzyć agent view w jednym kroku.

Możesz używać claude agents jako głównego punktu wejścia zamiast claude: uruchamiaj wszystko z dashboardu, dołączaj, gdy chcesz pełnego transkryptu, naciskaj ←, aby wrócić.

Odczytaj stan sesji

Każdy wiersz zaczyna się od ikony, której kolor pokazuje stan sesji, a kształt wskazuje, czy proces nadrzędny żyje.

Stan (kolor)

Stan	Ikona	Znaczenie
Working	Animowana	Claude aktywnie uruchamia narzędzia lub generuje odpowiedź
Needs input	Żółty	Claude czeka na pytanie lub decyzję o uprawnieniu od ciebie
Idle	Przygaszony	Nic do zrobienia; gotowy na twój następny prompt
Completed	Zielony	Zadanie zakończone pomyślnie
Failed	Czerwony	Zadanie zakończone błędem
Stopped	Szary	Zatrzymane przez Ctrl+X lub claude stop

Proces (kształt)

Kształt	Znaczenie
✻ / ✽	Proces sesji żyje; odpowiada natychmiast
∙	Proces zakończył się; peek/reply/attach dalej działają i restartują z miejsca przerwania
✢	Sesja /loop śpiąca między iteracjami. Wiersz pokazuje liczbę uruchomień i odliczanie

Sesje w tle nie potrzebują otwartego terminala. Osobny proces supervisora je uruchamia, więc możesz zamknąć agent view, zamknąć shell albo uruchomić nową interaktywną sesję, a uruchomiona praca dalej działa.

Status pull requesta

Gdy sesja otwiera pull requesta, na prawym brzegu wiersza pojawia się kropka statusu, linkowana do PR w terminalach wspierających hyperlinki.

Kolor kropki	Status pull requesta
Żółty	Czeka na checks/review lub checks zawiodły
Zielony	Checks przeszły, brak blokującego review
Fioletowy	Zmergowany
Szary	Draft lub closed

Dla większości autonomicznych zadań ten wiersz jest całym interfejsem — przejrzyj i zmerguj PR, gdy kropka stanie się zielona.

Podgląd i odpowiedź bez dołączania

Naciśnij Space na zaznaczonym wierszu, aby otworzyć panel podglądu. Pokazuje on najnowszy output sesji, jakiekolwiek pytanie blokujące i otwarte pull requesty.

Wpisz w panelu podglądu i naciśnij Enter, aby wysłać odpowiedź. Gdy sesja zadaje pytanie wielokrotnego wyboru, naciśnij klawisz cyfry, aby wybrać. Dla innych zablokowanych sesji naciśnij Tab, aby wypełnić input sugerowaną odpowiedzią, którą możesz edytować. Poprzedź odpowiedź !, aby wysłać komendę Bash zamiast tego.

Użyj ↑ i ↓, aby podglądać sąsiednie sesje bez zamykania panelu; → dołącza.

Dołącz do sesji

Naciśnij Enter lub → na wierszu, aby dołączyć. Agent view zostaje zastąpiony pełną interaktywną sesją, dokładnie tak jakbyś uruchomił claude w tym katalogu. Claude wystawia krótkie podsumowanie tego, co działo się pod twoją nieobecność.

Podczas gdy jesteś podłączony, sesja zachowuje się jak każda inna sesja Claude Code — każda komenda, skrót i funkcja działa. Naciśnij ← na pustym promptcie, aby się odłączyć. Jeśli dialog ma fokus i nie reaguje na ←, naciśnij Ctrl+Z, aby odłączyć natychmiast.

←, Ctrl+C, Ctrl+D, Ctrl+Z i /exit zostawiają sesję w tle działającą. Aby zakończyć sesję od środka, uruchom /stop. Możesz wyłączyć skrót ← w /config, jeśli przypadkowo go używasz.

Organizuj i filtruj

Agent view grupuje sesje tak, że te wymagające uwagi są na górze — Ready for review i Needs input powyżej Working i Completed. Naciśnij Ctrl+S, aby przełączyć grupowanie na by-directory i z powrotem. Twój wybór jest zachowywany między uruchomieniami.

W obrębie grupy:

• Ctrl+T — przypnij sesję na górę
• Shift+↑ / Shift+↓ — zmień kolejność
• Ctrl+R — zmień nazwę sesji
• Enter na nagłówku grupy — zwiń ją
• Ctrl+X — zatrzymaj sesję; naciśnij ponownie w ciągu 2 sekund, aby ją usunąć (z worktree)

Wpisuj w inpucie dispatcha, aby filtrować listę zamiast uruchamiać:

Filtr	Pokazuje
a:<name>	Sesje uruchamiające nazwany agent
s:<state>	Sesje w danym stanie, np. s:working, s:blocked
#<number> lub URL PR	Sesję pracującą nad tym pull requestem

Skróty klawiszowe

Naciśnij ? w agent view, aby zobaczyć każdy skrót w kontekście.

Skrót	Działanie
↑ / ↓	Poruszanie się między wierszami
Enter	Dołącz do wybranej sesji lub uruchom, jeśli jest tekst w inpucie
Space	Otwórz / zamknij panel podglądu
Shift+Enter	Uruchom i dołącz natychmiast
→	Dołącz do wybranej sesji
Alt+1..Alt+9	Dołącz do sesji 1–9 w bieżącej grupie
Tab	Na pustym inpucie: przeglądaj subagenty. W innym przypadku: zastosuj podpowiedź
Ctrl+S	Przełącz grupowanie między stanem a katalogiem
Ctrl+T	Przypnij / odepnij wybraną sesję
Ctrl+R	Zmień nazwę wybranej sesji
Ctrl+G	Otwórz prompt dispatcha w $EDITOR
Ctrl+X	Zatrzymaj sesję; naciśnij ponownie w ciągu 2 sekund, aby usunąć
Shift+↑ / Shift+↓	Zmień kolejność wybranej sesji
Esc	Zamknij panel podglądu, wyczyść input lub wyjdź
Ctrl+C	Wyczyść input; naciśnij dwa razy, aby wyjść
?	Pokaż wszystkie skróty

Uruchom nowe agenty

Trzy miejsca, w których można startować sesje w tle:

Z agent view

Wpisz prompt w input i naciśnij Enter. Sesja zostanie nazwana automatycznie z promptu; zmień nazwę później przez Ctrl+R. Wklej obraz w prompt, aby załączyć screenshot lub diagram.

Input	Efekt
<agent-name> <prompt>	Jeśli pierwsze słowo pasuje do nazwy subagenta, on uruchamia się jako główny
@<agent-name>	Wzmianka o subagencie gdziekolwiek w prompcie uruchamia go jako głównego
@<repo>	Wzmianka o repo siostrzanym, aby uruchomić sesję tam
/<skill>	Zasugeruj skill jako prompt
#<number> lub URL PR	Jeśli sesja już pracuje nad tym PR, wybiera ją zamiast uruchamiania nowej
Shift+Enter	Uruchom i natychmiast dołącz

Z wewnątrz sesji

/bg

Przenieś bieżącą rozmowę do sesji w tle. Przekaż ostatnią instrukcję w tej samej linii — /bg run the test suite and fix any failures. Backgrounding startuje świeży proces, który wznawia z zapisanej rozmowy; Claude prosi o potwierdzenie, jeśli subagenty lub komendy w tle wciąż działają.

Z terminala

claude --bg "investigate the flaky SettingsChangeDetector test"

Aby uruchomić konkretny subagent jako głównego agenta sesji:

claude --agent code-reviewer --bg "address review comments on PR 1234"

Po backgroundowaniu Claude wypisuje krótkie ID sesji i komendy do zarządzania nią.

Zarządzaj sesjami z shella

Każda sesja w tle ma krótkie ID (wypisywane przez claude --bg, także nazwa katalogu pod ~/.claude/jobs/).

Komenda	Cel
claude agents	Otwórz agent view
claude attach <id>	Dołącz do sesji w tym terminalu
claude logs <id>	Wypisz ostatni output sesji
claude stop <id>	Zatrzymaj sesję. Akceptuje też claude kill
claude respawn <id>	Zrestartuj zatrzymaną sesję z zachowaniem rozmowy
claude respawn --all	Zrestartuj każdą zatrzymaną sesję
claude rm <id>	Usuń sesję. Sprząta jej worktree, jeśli nie ma niezatwierdzonych zmian

To są sposoby skryptowania agent view — np. zadanie cron, które respawnuje sesje po wybudzeniu laptopa.

Jak edycje plików są izolowane

Każda sesja w tle — agent view, /bg lub claude --bg — startuje w twoim katalogu roboczym. Przed edycją plików Claude przenosi sesję do izolowanego git worktree pod .claude/worktrees/, więc równoległe sesje czytają ten sam checkout, ale każda pisze do swojego. Poza repozytorium git sesje piszą bezpośrednio i nie są izolowane od siebie.

Worktree jest usuwany razem z sesją, więc zmerguj lub wypchnij zmiany, które chcesz zachować, przed usunięciem. Aby subagent zawsze działał we własnym worktree, niezależnie od sposobu uruchomienia:

---
name: code-reviewer
isolation: worktree
---

Permission mode i ustawienia

Uruchomiona sesja czyta swoje ustawienia i permission mode z katalogu, w którym działa — tak samo jak claude uruchomione tam. Aby nadpisać z shella:

claude --bg --permission-mode plan "draft the implementation plan for the new pricing page"

Użycie bypassPermissions lub auto w ten sposób jest odrzucane, dopóki nie zaakceptujesz tego trybu uruchamiając claude z nim raz interaktywnie, ponieważ te tryby pozwalają sesji, której nie obserwujesz, działać bez zatwierdzania.

Proces supervisora

Sesje w tle są hostowane przez per-user proces supervisora, oddzielny od twojego terminala i agent view. Startuje automatycznie przy pierwszym backgroundowaniu sesji lub otwarciu agent view; nie zarządzasz nim bezpośrednio.

Sesja, która pracuje, czeka na input lub ma dołączony terminal, utrzymuje swój proces. Gdy sesja kończy i siedzi niedołączona przez ok. godzinę, supervisor zatrzymuje jej proces, aby zwolnić zasoby. Transkrypt i stan zostają na dysku; następnym razem, gdy podejrzysz, odpowiesz lub dołączysz, supervisor startuje świeży proces z miejsca przerwania.

Supervisor obserwuje zainstalowany binarny Claude Code na dysku i restartuje do nowej wersji po tym, jak auto-updater go zastąpi. Sesje w tle to procesy detached — przetrwają restart.

Przechowywanie stanu

Jeśli ustawisz CLAUDE_CONFIG_DIR, supervisor używa tego zamiast ~/.claude i działa jako osobna instancja.

Ścieżka	Zawartość
~/.claude/daemon.log	Log supervisora
~/.claude/daemon/roster.json	Lista uruchomionych sesji (do reconnectu po restarcie)
~/.claude/jobs/<id>/state.json	Stan per-sesja widoczny w agent view

Wyłącz agent view

Aby wyłączyć agenty w tle i agent view całkowicie:

~/.claude/settings.json

{ "disableAgentView": true }

Lub ustaw CLAUDE_CODE_DISABLE_AGENT_VIEW=1. Admini mogą wymusić to przez managed settings.

Rozwiązywanie problemów

claude agents wypisuje subagenty zamiast otwierać widok

Wcześniejsze wersje nie otwierały agent view w każdym środowisku (Bedrock, Vertex AI, Foundry). Uruchom claude update, aby zainstalować najnowszą wersję. Jeśli wciąż się nie otwiera, sprawdź, czy nie został wyłączony przez ustawienie lub zmienną środowiskową.

”Cannot open agents — N background task(s) running”

Sesja, którą próbujesz zbackground’ować, ma trwającą pracę — subagent, workflow lub komendę w tle. Uruchom /tasks, aby zobaczyć, co działa, potem /bg, aby potwierdzić rezygnację z nich.

Prompt odrzucony jako zbyt krótki

Input dispatcha oczekuje opisu zadania, nie jednego słowa. Prompty krótsze niż cztery znaki są odrzucane z komunikatem Too short.

Sesje pokazują się jako failed po wybudzeniu maszyny

Sesje w tle nie przeżywają sleep ani shutdown. Dołącz, podejrzyj lub odpowiedz dowolnej z nich, a wznowi się z miejsca przerwania — albo claude respawn --all, aby zrestartować wszystkie naraz.

.claude/worktrees/ zapełnia się

Worktree są usuwane razem z sesją, która je stworzyła. Jeśli sesja zakończyła się bez sprzątania, wylistuj pozostałości komendą git worktree list w katalogu projektu i usuń każdy przez git worktree remove <path>.

Ograniczenia (podgląd badawczy)

• Limity stawek obowiązują. Sesje w tle konsumują twoją subskrypcję tak samo jak interaktywne — dziesięć równoległych agentów spala kwotę około dziesięć razy szybciej.
• Sesje są lokalne. Działają na twojej maszynie i zatrzymują się przy sleep lub shutdown.
• Worktree umierają razem z sesją. Zmerguj lub wypchnij zmiany przed usunięciem sesji, która edytowała pliki.

Powiązane workflow

Workflow z /goal Sparuj agent view z /goal, aby uruchamiać weryfikowalne cele, które kończą się same.

Subagenty niestandardowe Buduj subagenty, które możesz wywołać przez @name w dispatchu lub uruchomić z --agent.

Workflow wielu plików Kiedy wybrać agent view vs subagents vs agent teams dla pracy równoległej.

Mistrzostwo w komendach slash Wliczając /bg, /background, /stop, /tasks — komendy, których będziesz najczęściej używać wokół agent view.