claude agents (agent view) în Claude Code CLI

claude agents [--cwd <cale>] [--json [--all]] [opțiuni]

Ce face claude agents (agent view)

Agent view, deschis cu claude agents, este un singur ecran pentru toate sesiunile în fundal: ce rulează, ce așteaptă răspunsul tău și ce s-a terminat. Fiecare sesiune în fundal este o conversație Claude Code completă, care continuă fără un terminal atașat. Funcția a apărut în v2.1.139 ca research preview, iar interfața și tastele se pot schimba.

Scrii un prompt în câmpul de jos și apeși Enter: pornește o sesiune nouă, afișată ca rând, grupată după stare. Fiecare prompt pornește propria sesiune, nu continuă una existentă. Selectezi un rând cu săgețile, Space deschide panoul de peek (ultimul output sau întrebarea în așteptare), iar Enter sau → te atașează la conversația completă. ← pe un prompt gol te detașează, iar Esc te întoarce în shell. Implicit lista arată sesiunile din toate proiectele; --cwd o restrânge la un director.

--permission-mode, --model, --effort și --agent setează valorile implicite pentru sesiunile pornite din agent view. Comanda acceptă și --settings, --setting-sources, --add-dir, --plugin-dir și --mcp-config, pe care le transmite sesiunilor. claude agents --json afișează sesiunile active ca tablou JSON și iese; este modul suportat de a citi starea din scripturi. Deschiderea agent view cere un terminal interactiv.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
--cwd <cale>	Arată doar sesiunile pornite în directorul dat (inclusiv cele mutate într-un worktree de sub el).
--json	Afișează sesiunile active ca tablou JSON și iese.
--all	Cu --json, include și sesiunile în fundal terminate.
--permission-mode <mod>	Modul de permisiuni implicit pentru sesiunile pornite din agent view.
--model <model>	Modelul implicit pentru sesiunile pornite.
--effort <nivel>	Efortul implicit; aceleași valori ca flag-ul principal --effort, inclusiv ultracode.
--agent <nume>	Subagentul folosit când promptul nu numește unul prin @nume sau ca prim cuvânt.
--dangerously-skip-permissions	Prescurtare pentru --permission-mode bypassPermissions; afișează avertismentul de bypass dacă nu l-ai acceptat înainte.
--restricted	Pornește fiecare sesiune în mod restricționat, ca flag-ul principal --restricted. Din v2.1.248.
--settings, --setting-sources, --add-dir, --plugin-dir, --mcp-config, --strict-mcp-config	Configurație aplicată sesiunilor pornite. Repetă --add-dir, --plugin-dir și --mcp-config pentru fiecare valoare.

Exemple practice de terminal

Exemplul 1: Agent view doar pentru un proiect

claude agents --cwd ~/projects/my-app

Exemplul 2: Valori implicite pentru sesiunile pornite

Valorile active apar în subsolul de sub câmpul de dispatch.

claude agents --permission-mode plan --model opus --effort high

Exemplul 3: Citirea stării sesiunilor dintr-un script

Câmpul state al unei sesiuni în fundal are una dintre valorile working, blocked, done, failed sau stopped. blocked înseamnă că sesiunea are nevoie de tine.

claude agents --json --all | jq '.[] | {id, state}'

Greșeli frecvente și bune practici

• claude agents afișează lista subagenților și iese: agent view nu e disponibil în mediul tău. Rulează claude update și verifică dacă nu l-a oprit setarea disableAgentView sau variabila CLAUDE_CODE_DISABLE_AGENT_VIEW.
• Pui --add-dir sau --mcp-config înainte de agents; claude agents --json eșuează apoi cu unknown option. Forma cu mai multe valori separate prin spațiu (--add-dir a b c) nu este suportată.
• Pornești zece sesiuni deodată fără să ții cont de limite. Sesiunile în fundal consumă din cota abonamentului la fel ca cele interactive, deci zece sesiuni folosesc cota de aproximativ zece ori mai repede.

Comenzi înrudite

• claude-attach
• claude-logs
• slash-background
• claude-daemon