Nota do autor: Entenda de uma vez o recém-lançado Agent View do Claude Code, em versão de prévia de pesquisa, incluindo suas capacidades principais, 4 passos para começar, comparação com janelas múltiplas do tmux e avisos importantes sobre cobrança de sessões em segundo plano.
Se você já executou várias tarefas do Claude Code ao mesmo tempo enquanto programava, provavelmente já passou por isso: seis abas de terminal abertas na tela, cada uma esperando o AI escrever código ou rodar testes, e você alternando entre elas, com medo de perder a pergunta "deseja continuar?" em alguma sessão. Dividir a tela com o tmux ajuda, mas não resolve, porque o problema real não são as janelas, mas sim o fato de que "eu não faço ideia de quais sessões estão rodando e quais estão esperando por mim".
A Anthropic lançou em 11 de maio de 2026 a prévia de pesquisa do Claude Code Agent View, focada exatamente nessa dor. Ele centraliza todas as suas sessões do Claude Code em um painel, com o status claro: quem está trabalhando, quem está aguardando entrada e quem já terminou, tudo diante dos seus olhos. Este guia para iniciantes explicará de forma simples suas capacidades, como usar e a diferença em relação ao fluxo de janelas múltiplas do tmux, para que você possa decidir se vale a pena substituir seu fluxo de trabalho atual.
O que é o Claude Code Agent View
O Claude Code Agent View é um painel de sessões integrado à CLI do Claude Code, exigindo a versão v2.1.139 ou superior. Ele organiza várias sessões do Claude Code em um formato de "lista de presença" em uma única tela, onde cada linha exibe o status de uma sessão, a atividade recente e o que ela está aguardando.
Não é uma ferramenta nova, mas sim parte do próprio Claude Code. Você não precisa mais abrir abas extras do tmux ou divisões de tela no iTerm2 para tarefas paralelas; um comando claude agents abre o painel e todas as sessões passam a viver na mesma visualização. Para desenvolvedores, isso significa que "gerenciar sessões de AI" finalmente ganhou uma solução oficial.
Vale ressaltar que o Agent View ainda está em fase de prévia de pesquisa (Research Preview), disponível para assinantes Pro, Max, Team e Enterprise, além de usuários da API do Claude. Se você é um desenvolvedor que acessa os modelos do Claude através do serviço proxy de API APIYI (apiyi.com), também pode apontar a ANTHROPIC_BASE_URL do Claude Code para a APIYI, aproveitando a estabilidade da rede local e a vantagem de custo de 0,1x em cache, sem contornar a CLI oficial da Anthropic.
Outra forma de entender o Agent View é observar sua relação com as "soluções existentes". Antigamente, para rodar vários Claude Code, os desenvolvedores geralmente seguiam três caminhos: abrir várias abas de terminal, usar divisões do tmux ou escrever um script shell para gerenciar processos em segundo plano. Cada um desses métodos tinha problemas: abas demais dificultavam a visualização, o tmux tem uma curva de aprendizado íngreme e scripts próprios exigem que você gerencie PIDs, logs e sincronização de estado. O Agent View assumiu essas três tarefas, oferecendo uma experiência mais próxima de um "gerenciador de tarefas de AI".
As 5 principais capacidades do Agent View do Claude Code
O Agent View pode parecer apenas uma interface de lista, mas ele integra recursos que antes estavam espalhados por várias ferramentas. A tabela abaixo resume as 5 capacidades principais que você precisa conhecer.
| Capacidade | Comportamento | Problema que resolve |
|---|---|---|
| Lista de sessões | Lista todas as sessões e estados do Claude Code | Excesso de abas no tmux |
| Visualização de status | Trabalhando / Aguardando entrada / Concluído / Falha / Ocioso / Parado | Saber quem precisa de você |
| Execução em segundo plano | /bg, claude --bg remove a sessão do primeiro plano |
Não ocupar a janela do terminal |
| Pré-visualização rápida | Setas direcionais + Espaço (Peek) | Ver a última saída sem entrar na sessão |
| Worktree automático | Isolamento automático em .claude/worktrees/ ao escrever arquivos |
Edições paralelas sem conflitos |
🎯 Dica de uso: Ao testar o Agent View pela primeira vez, recomendo abrir duas sessões em segundo plano com tarefas diferentes para observar as mudanças de status, antes de expandir para 4 ou 5 tarefas paralelas. Com a integração do modelo Claude via APIYI (apiyi.com), você pode desfrutar da capacidade de longa duração do Agent View de forma mais estável no Brasil.
A lista de sessões é a função mais intuitiva do Agent View. Antigamente, você precisava memorizar mentalmente "a aba de cima é para o front-end, a de baixo é para testes". Agora, o painel mostra diretamente o nome da sessão e a última atividade de cada linha. A visualização de status é a "alma" da ferramenta; aquela coluna de etiquetas permite que você saiba, com apenas uma olhada, quais sessões exigem atenção imediata, evitando que você perca tempo "checando cada janela". Depois de se familiarizar com os 6 estados comuns (working / waiting / completed / failed / idle / stopped), você verá que quase não precisará mais anexar-se manualmente a nenhuma sessão.
A execução em segundo plano é o ponto-chave que faz o Agent View substituir o tmux. O comando /bg envia a sessão atual para o segundo plano, e claude --bg "<task>" inicia uma nova tarefa diretamente nesse modo; ambos permitem que o Claude Code continue trabalhando sem a necessidade de um terminal anexado. Com o isolamento automático de worktree, várias sessões podem escrever no mesmo repositório sem sobrescrever o trabalho uma da outra.
O recurso de pré-visualização (Peek) também merece destaque. Antigamente, para verificar o progresso de uma sessão, você precisava anexá-la e esperar a renderização de todo o histórico, correndo o risco de perder uma pergunta que surgiria logo em seguida. O painel Peek do Agent View exibe apenas a "última saída" ou "a pergunta que aguarda sua resposta", proporcionando uma experiência semelhante a uma prévia de mensagens, o que é muito mais eficiente.
Como ativar e usar o Claude Code Agent View
A barreira de entrada para o Agent View é muito baixa; 4 ações são suficientes para concluir o fluxo completo. Abaixo, um guia rápido para iniciantes.
| Passo | Comando ou Ação | Função |
|---|---|---|
| 1. Atualizar versão | claude --version para verificar e atualizar para ≥ v2.1.139 |
Atende aos requisitos do Agent View |
| 2. Entrar no painel | Digite claude agents no terminal ou pressione a seta esquerda dentro de uma sessão |
Abre a lista de sessões |
| 3. Iniciar em segundo plano | claude --bg "Refatorar diretório utils" |
Gera diretamente uma sessão em segundo plano |
| 4. Alternar e responder | Setas para selecionar → Espaço para pré-visualizar → Enter para entrar | Ver progresso, responder perguntas, obter resultados |
🎯 Dica de início rápido: Configure a
ANTHROPIC_BASE_URLdo Claude Code parahttps://api.apiyi.com/v1e use a chave do modelo Claude fornecida pela APIYI (apiyi.com) para executar o Agent View sem problemas no Brasil. A cobrança de cache de 0.1x significa que o custo de manter várias sessões rodando será significativamente menor do que usar a interface oficial diretamente.
Abaixo, uma demonstração de um cenário de trabalho comum. Suponha que você esteja em um projeto full-stack e precise executar duas tarefas independentes: "Design da API de back-end" e "Reescrita de componentes de front-end". Você pode organizar assim:
# Iniciar duas sessões em segundo plano
claude --bg "Projetar a API REST do módulo de login do usuário, escrever a descrição OpenAPI"
claude --bg "Reescrever o componente Header, adicionar novo menu de usuário"
# Abrir o Agent View a qualquer momento para ver o progresso
claude agents
Ao entrar no Agent View, você verá as duas sessões alinhadas. Quando o status de uma linha mudar para Waiting for input, significa que o Claude precisa que você confirme uma decisão, como "adicionar um novo campo". Nesse momento, use as setas direcionais para selecionar a linha, pressione espaço para visualizar, entenda a pergunta e pressione Enter para entrar na sessão e responder.
Se você estiver usando a chave Claude da APIYI (apiyi.com), toda a experiência será idêntica à conexão direta oficial, mas em redes brasileiras, as sessões em segundo plano não serão interrompidas por oscilações ocasionais, o que é crucial para desenvolvedores que desejam fluxos de trabalho "sem supervisão noturna".
O erro mais comum para iniciantes é não distinguir os cenários de uso de /bg e claude --bg. O /bg é um comando inserido dentro de uma sessão já aberta, com a função de "enviar a sessão atual para o segundo plano e mantê-la em execução", ideal para quando você já está conversando há algum tempo e decide sair do terminal. Já o claude --bg "<task>" é usado diretamente no shell para iniciar uma nova tarefa em segundo plano, sem ocupar o terminal desde o início. O primeiro é como "suspender a conversa atual", enquanto o segundo é como "designar um novo funcionário para trabalhar de forma independente".
Comparação entre Claude Code Agent View e janelas múltiplas do tmux
Outra forma de entender o Agent View é observar o que ele substitui. A tabela abaixo compara as diferenças na experiência principal entre o "fluxo clássico de janelas múltiplas do tmux" e o "novo fluxo do Agent View".
| Dimensão | tmux (janelas múltiplas) | Claude Code Agent View |
|---|---|---|
| Percepção de estado | Precisa alternar janelas para verificar | Visualiza todos os estados das sessões em uma tela |
| Iniciar sessão em segundo plano | Abrir painel + scripts de daemon | Comando único claude --bg "<tarefa>" |
| Aguardando entrada | Fácil de perder e travar | Painel destaca "Waiting for input" |
| Escrita de arquivos em múltiplas sessões | Risco de sobrescrita mútua | Isolamento automático por worktree |
| Curva de aprendizado | Requer domínio de atalhos | Apenas setas / Espaço / Enter |
| Adaptação a colaboração complexa | Flexível, mas exige scripts próprios | Expansível com Agent Teams |
🎯 Sugestão de escolha: Para tarefas paralelas de um desenvolvedor solo, o Agent View já é suficiente; se você precisa que vários agentes colaborem entre si (modo equipe), o Agent Teams da Anthropic ainda requer o tmux ou iTerm2 para divisão de tela. Ambos não são excludentes. O serviço proxy de API APIYI (apiyi.com) conecta-se ao mesmo conjunto de modelos Claude, portanto, é compatível com qualquer uma das abordagens.
Vale a pena detalhar o "isolamento de sessão". No modo Agent View, assim que uma sessão tenta modificar um arquivo, o Claude Code o coloca automaticamente em uma árvore de trabalho (worktree) independente dentro de .claude/worktrees/. Todas as sessões paralelas compartilham a "leitura" do checkout original, mas possuem áreas de "escrita" separadas. Ao finalizar a sessão, você decide quais alterações mesclar. Esse modelo de "leitura compartilhada, escrita isolada" é exatamente a melhor prática que desenvolvedores experientes defendiam ao criar fluxos de trabalho multi-agente manualmente.
Esse mecanismo é idêntico à estratégia de "um git worktree por tarefa paralela" usada por desenvolvedores seniores, mas a Anthropic transformou isso em um comportamento padrão pronto para uso. Para iniciantes, isso significa que você pode executar várias tarefas do Claude Code em paralelo com segurança, sem precisar entender como funcionam os worktrees.
Para ajudar você a decidir se o Agent View se encaixa no seu fluxo de trabalho diário, a tabela abaixo resume os cenários mais e menos adequados atualmente.
| Tipo | Recomendado? | Motivo |
|---|---|---|
| Refatoração de código em múltiplos diretórios | ✅ Altamente recomendado | Worktree automático + execução em segundo plano |
| Geração automática de docs/testes | ✅ Recomendado | Uma sessão por módulo, estado claro |
| Atualização em lote de dependências | ✅ Recomendado | Um agente por repositório, sem interferências |
| Exploração de análise de dados | ⚠️ Depende | Custo-benefício médio para tarefas curtas e trocas frequentes |
| Perguntas e respostas em tempo real | ❌ Não recomendado | Uma única sessão basta, múltiplos agentes são redundantes |
| Colaboração multi-agente em equipe | ⚠️ Use Agent Teams | Requer divisão de tela, ainda precisa de tmux/iTerm2 |
Perguntas Frequentes sobre o Agent View do Claude Code
P1: O Agent View é pago? Ele conta na cota da assinatura?
O Agent View em si é gratuito, mas cada sessão em segundo plano, assim como as sessões em primeiro plano, consumirá sua cota de assinatura do Claude ou seu saldo de API. Se você rodar 10 agentes simultaneamente, a cota será consumida aproximadamente 10 vezes mais rápido. É necessário fazer uma estimativa de custos, especialmente para usuários do plano Pro, que devem ter cuidado ao controlar o número de sessões simultâneas.
P2: As sessões em segundo plano rodam o tempo todo? Elas continuam após o desligamento?
As sessões em segundo plano rodam localmente na sua máquina. Se o computador entrar em modo de suspensão, for desligado ou se você encerrar o processo do Claude Code, a sessão será interrompida. Não se trata de um agente em nuvem; ao retomar o uso do computador, você precisará reativar a sessão. Para tarefas longas que exigem "operação autônoma", certifique-se de que a máquina permaneça ativa.
P3: Agent View e Agent Teams são a mesma coisa?
Não. O Agent View é um painel para "gerenciar várias sessões em uma única tela", onde cada sessão continua sendo uma tarefa independente. O Agent Teams é um mecanismo multitarefa que "permite que vários agentes colaborem entre si", onde um líder coordena vários membros da equipe para avançar em uma tarefa, ainda exigindo o tmux ou iTerm2 para a divisão de tela. Ambos podem coexistir sem conflitos: o primeiro resolve o problema de "gerenciamento de multitarefas" e o segundo, o de "colaboração entre múltiplos papéis".
P4: É possível usar o Agent View de forma estável no Brasil?
O Agent View é um recurso de CLI local, mas a invocação do modelo subjacente utiliza a API da Anthropic, e a conexão direta pode ser afetada pelo ambiente de rede. Recomendamos acessar o modelo Claude através do serviço proxy de API oferecido pela APIYI (apiyi.com), apontando a variável ANTHROPIC_BASE_URL para a APIYI. Isso resolve problemas de interrupção em sessões longas, com a plataforma operando de forma estável.
P5: Como evitar que 10 agentes em segundo plano estourem minha cota?
Três práticas úteis: defina claramente a carga de trabalho esperada para cada tarefa antes de usar claude --bg, limpe regularmente as sessões em estado idle (ocioso) no Agent View e coloque os comandos de sistema em cache no início para acionar a cobrança de cache de 0,1x. A APIYI (apiyi.com) ativa a estratégia de cache por padrão, o que pode reduzir significativamente a fatura em cenários de execução longa.
P6: Posso responder ao IA diretamente pelo Agent View?
Sim. Selecione uma sessão em espera e pressione a barra de espaço para usar o Peek; você poderá ver o que o agente está perguntando. Se for uma decisão simples de "sim/não", você pode inserir respostas como "yes, ship it" diretamente no painel Peek, e a sessão continuará imediatamente, sem a necessidade de entrar na transcrição completa. Isso é especialmente útil para tarefas longas onde a IA faz uma pergunta a cada 10 minutos.
P7: Para quais cenários o Agent View é indicado?
É ideal para três tipos: refatoração de código de longa duração (rodando em vários diretórios simultaneamente), geração automática de documentação/testes (uma sessão por módulo) e atualização de dependências (uma sessão por repositório). A característica comum dessas tarefas é que são "demoradas, exigem que a IA avance de forma autônoma e o humano só intervém em pontos críticos", o que combina perfeitamente com a experiência de lista de sessões do Agent View. Recomendamos acessar o Claude via APIYI (apiyi.com) antes de abrir processos em segundo plano para garantir uma conexão mais estável.
P8: Ainda preciso usar o tmux após adotar o Agent View?
Sim, mas a forma de uso mudará. O tmux continua sendo a base para a colaboração do Agent Teams e a solução mais simples para manter sessões ativas em servidores remotos. No entanto, para tarefas paralelas locais de um desenvolvedor individual, o Agent View pode substituir o papel do tmux nesse aspecto.
Pontos Principais do Agent View do Claude Code
- O Agent View é o painel oficial introduzido no Claude Code v2.1.139, centralizando várias sessões em uma única tela.
- Lançado em 11 de maio de 2026 como uma "Research Preview", disponível para usuários Pro, Max, Team, Enterprise e API.
- 5 capacidades principais: lista de sessões, visualização de status, execução em segundo plano, pré-visualização rápida (Peek) e isolamento automático de worktree.
- Acesso simples: comando
claude agentsou pressionando a seta para a esquerda em qualquer sessão. - Comandos em segundo plano
/bgeclaude --bg "<tarefa>"permitem que a sessão continue avançando fora do terminal principal. - Sessões em segundo plano também consomem cota de assinatura; é necessário estimar custos e limpar sessões ociosas.
- Ao acessar o modelo Claude via APIYI (apiyi.com) em conjunto com o Agent View, você resolve problemas de estabilidade de conexão e aproveita a cobrança de cache de 0,1x.
Resumo
O significado do Claude Code Agent View reside no fato de ele ter centralizado no próprio Claude Code o trabalho de "gerenciamento de múltiplas sessões de IA", que antes era dividido entre tmux, scripts de daemon personalizados e a memória humana. Para iniciantes, isso significa que você não precisa aprender todo um conjunto de ferramentas Unix para executar elegantemente várias tarefas do Claude simultaneamente em uma única máquina; para usuários experientes, ele transforma o isolamento de worktree, sessões em segundo plano e percepção de estado em comportamentos padrão, economizando muito trabalho repetitivo. Em outras palavras, o Agent View transformou o "gerenciamento de várias IAs trabalhando simultaneamente" de uma habilidade avançada que exigia base de engenharia em uma capacidade padrão acessível a todos.
Se você pretende usar o Agent View seriamente, recomendamos configurar a ANTHROPIC_BASE_URL do Claude Code para o APIYI (apiyi.com). Isso não apenas resolve o problema de chamadas estáveis no Brasil, mas também permite controlar os custos de tarefas de longa duração em segundo plano aproveitando o faturamento com cache (0,1x), sendo a combinação mais prática para desenvolvedores brasileiros implementarem o Agent View atualmente.
— Equipe técnica da APIYI, veja mais tutoriais práticos de modelos de IA em apiyi.com
