Claude Code CLI: Programação com IA · Capítulo 22 de 23 · 18 min
Montar o painel que se atualiza e o processo que roda sozinho
Quando vale trocar o relatório feito à mão por um painel vivo ou por um agente que roda sozinho.
Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA.
Com a governança resolvida, o próximo passo é tirar você do comando das tarefas repetidas. Você já sabe pedir ao Claude que leia a planilha, cruze com o histórico e escreva o parecer, mas isso depende de você abrir a sessão, digitar o pedido e esperar a resposta. Duas frustrações costumam aparecer quase juntas. Na primeira, o gestor quer que o número da operação chegue vivo, atualizado, sem alguém rodar o relatório toda segunda-feira. Na segunda, existe uma rotina que se repete idêntica todo dia, e manter uma pessoa no comando dela virou desperdício. O degrau seguinte resolve as duas: a saída deixa de ser um texto que você lê e passa a ser uma página que se atualiza sozinha ou um processo que roda sem ninguém apertando o botão.
Dois movimentos diferentes moram nesse mesmo degrau. Um é tornar a saída viva: em vez de um relatório congelado no horário em que foi gerado, uma página que se reescreve conforme os dados mudam. O outro é tornar o processo autônomo: em vez de você conduzir a sessão passo a passo, um agente em código conduz sozinho. Os dois elevam a régua de responsabilidade, porque agora algo acontece sem a sua supervisão direta a cada movimento.
Comece pelo mais simples de operar, que é o número vivo. No claude.ai, a saída de uma sessão pode virar um Artifact: uma página compartilhável que se atualiza no próprio lugar conforme a sessão trabalha. O recurso está em beta nos planos Team e Enterprise. A diferença que importa para gestão está no que uma versão publicada consegue fazer sozinha: ela puxa dados ao vivo e age pelos conectores MCP (as tomadas que ligam o Claude a outros sistemas) de cada pessoa que abre a página. É isso que transforma um Artifact em dashboard vivo (painel de números que se atualiza sozinho) ou em ferramenta interativa, em vez de uma foto estática do momento em que foi criado.
Um Artifact publicado que puxa dados ao vivo age pelos conectores MCP de cada pessoa que abre a página, e não pelos seus. Isso é vantagem e risco ao mesmo tempo. A vantagem: cada leitor enxerga a sua fatia legítima, com as próprias credenciais, sem você intermediar acesso. O risco: você precisa saber a quais fontes o painel se conecta antes de espalhar o link, porque a página vai agir com o crachá de quem estiver do outro lado.
Um dashboard vivo com dado sensível merece o mesmo cuidado de um relatório financeiro que sai da sala de reunião. Use os papéis de editor e controle o alcance dos links de compartilhamento disponíveis em Team e Enterprise. Link público é para número que você mostraria a qualquer pessoa. Painel de receita, pipeline ou folha de pagamento fica restrito a quem tem direito de ver.
Mostrar o número vivo é uma coisa. Fazer o processo rodar sozinho é outra, e aqui a interface para de ser o caminho. O Cowork é produto de interface: você conversa com ele e ele executa dentro do aplicativo, mas não existe API pública (a porta pela qual outro programa o acionaria) para ligá-lo de fora. Quando a automação precisa virar código, surgem dois caminhos oficiais. O Claude Agent SDK, em Python e TypeScript, é a mesma base sobre a qual o Claude Code e o próprio Cowork foram construídos: com ele, o seu time monta um agente sob medida em código (um programa que executa a tarefa sozinho). Os Managed Agents são agentes hospedados pela Anthropic e acionados via Claude API, para quando o agente precisa rodar no servidor, dentro de um processo de produção, sem depender de alguém com o app aberto.
Cowork
produto de interface, sem API pública
você conversa e ele executa dentro do app
Agent SDK (Python / TypeScript)
seu time monta um agente próprio em código
mesma base do Claude Code e do Cowork
Managed Agents
agente hospedado pela Anthropic, via Claude API
roda no servidor, dentro de um processo de produçãoPense assim. O Cowork é o profissional que trabalha ao seu lado na mesa, ótimo enquanto você está ali conversando com ele. O Agent SDK é contratar a engenharia para construir um robô próprio, que executa exatamente o seu fluxo e roda na sua infraestrutura. Os Managed Agents são alugar esse robô já montado e hospedado, plugado direto no seu sistema pela API. Os dois últimos são degraus de desenvolvimento e quase sempre envolvem o seu TI ou um desenvolvedor. Se você não programa, o seu papel aqui é desenhar a regra de negócio e o critério de sucesso, e deixar quem programa cuidar da montagem.
Antes de partir para um agente autônomo, padronize o que já se repete. Uma skill é uma tarefa recorrente empacotada em uma pasta com um arquivo SKILL.md, carregada sob demanda quando o contexto pede. Os antigos comandos de barra customizados foram unificados nesse formato, e já existe uma skill embutida, a /dataviz, para gerar gráficos. Na prática, quase toda empresa tem de cinco a dez tarefas que valem virar skill: o fechamento semanal, o padrão de resposta para um tipo de chamado, a checagem de uma cláusula de contrato. Quando o volume cresce, o Claude chega a escrever um script que orquestra dezenas a centenas de sub-agentes, cada um cuidando de um pedaço. Os sub-agentes rodam em segundo plano por padrão e podem, eles mesmos, abrir novos sub-agentes, com o encadeamento limitado a cinco níveis.
Suponha uma pequena rede de pet shops cujo gerente monta toda segunda o mesmo fechamento de vendas por loja: essa é a primeira candidata a skill. Escolha a sua tarefa equivalente, rode o pedido abaixo para empacotá-la e acione a skill na sessão seguinte. Se o resultado sair igual ao que você fazia à mão, sem repetir as instruções, a skill está pronta, e a régua abaixo diz se ela merece subir mais um degrau.
A tarefa se repete igual?
|
+-------------+-------------+
| |
NAO SIM
| |
Mantenha assistido E reversivel e de baixo risco?
(voce conduz a sessao) |
+-------------+-------------+
| |
NAO SIM
| |
Tem julgamento, risco ou Automatize de ponta a ponta
dado sensivel? (Agent SDK ou Managed Agents)
|
Humano no laco:
Claude propoe, pessoa aprovaMantenha o humano no laço quando a tarefa envolve julgamento, risco ou dado sensível: aqui o Claude propõe e a pessoa aprova. Automatize de ponta a ponta quando a tarefa é repetível, reversível e de baixo risco, o tipo de trabalho que, se sair errado, você desfaz sem estrago. Na dúvida, comece com a pessoa aprovando cada rodada e só remova esse aval depois de ver o agente acertar muitas vezes seguidas.
Suba um degrau de cada vez. O dashboard vivo com Artifacts entrega valor sem exigir uma linha de código do seu lado e ensina você a confiar na saída automática. Só depois que o painel virou rotina confiável vale acionar o TI para um agente que roda sozinho, retomando as seis perguntas do capítulo de governança, que nesta altura do curso você já respondeu.
Escolha uma entrega que hoje você refaz na mão toda semana. Decida primeiro a natureza dela: pede um número vivo (candidata a dashboard com Artifacts) ou um processo autônomo (candidata a Agent SDK ou Managed Agents, com o TI ao lado)? Depois passe-a pela régua: repetível, reversível e de baixo risco vai para automação total; julgamento, risco ou dado sensível fica com humano no laço. Escreva em uma linha qual degrau ela merece e por quê.
Uma correção sobre o Artifact descrito acima: em setembro de 2026, a documentação do Claude Code lista o recurso nos planos Pro, Max, Team e Enterprise, com a sessão conectada pelo /login. A página nasce privada e só chega a outras pessoas quando você compartilha pelo cabeçalho dela.
Para o processo que roda sozinho, a documentação oficial oferece quatro portas, da mais simples à mais montada. As quatro usam o mesmo motor, o Agent SDK: o kit que entrega as ferramentas e o laço de trabalho do Claude Code a outros programas, como o motor de um carro vendido para outra montadora.
Quatro portas para automatizar, da mais simples à mais montada
| Caminho | O que faz | Como começa | Onde roda |
|---|---|---|---|
| Modo headless (claude -p) | Executa um pedido sem abrir a conversa e devolve o resultado, como deixar um recado e receber a resposta por escrito | claude --bare -p "Resuma o README.md" --allowedTools "Read" | Na sua máquina ou num servidor |
| Agent SDK | O mesmo laço do Claude Code dentro de um programa da sua empresa | Pacotes oficiais de Python e TypeScript | Onde o seu time hospedar |
| GitHub Actions | O Claude responde a menções @claude em pull requests e issues e pode abrir a correção | /install-github-app, com acesso de administrador ao repositório | Nos servidores do GitHub |
| Rotinas | Pedido, repositórios e conectores empacotados, disparados por agenda, chamada de API ou evento do GitHub | /schedule ou claude.ai/code/routines | Na nuvem da Anthropic, com o notebook fechado |
As rotinas estão em versão de pesquisa e rodam no intervalo mínimo de uma hora. Fluxo do GitHub montado com @beta deve passar para @v1.
Duas opções do modo headless merecem entrar em todo script. A --bare pula a leitura de hooks, skills, plugins, conexões MCP, memória e CLAUDE.md, e faz o resultado sair igual em qualquer máquina; a documentação avisa que ela vai virar o padrão do -p numa versão futura. A --output-format json devolve, junto da resposta, o campo total_cost_usd, com o custo da execução em dólares.
Suponha uma loja virtual de cosméticos que fecha as vendas do dia às 23h. Uma rotina agendada abre o repositório do relatório, puxa os pedidos pelo conector e publica o resumo, sem depender do computador do gerente ligado. Vigilância de minuto em minuto fica com o /loop, dentro de uma sessão aberta. Escolha a entrega que você refaz toda semana e rode-a uma vez com claude -p e --output-format json: acertou quando o resultado sair sem você abrir a conversa e o total_cost_usd mostrar quanto a execução custou.
Os sub-agentes mudaram de comportamento no trimestre. Desde o início de julho, os que o Claude cria numa sessão interativa rodam em segundo plano por padrão, e você segue conversando. Desde a versão 2.1.232, de 13 de agosto de 2026, o modo fork vem ligado: o sub-agente herda a conversa inteira, e o comando /subtask dispara um à mão. Na versão 2.1.224, de 7 de agosto, sessões abertas na mesma máquina passaram a trocar mensagens entre si, no macOS e no Linux.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Auditar o SEO técnico do site com três sub-agentes
Funciona com a pasta do código do site ou só com o endereço público. Os auditores leem e testam; nenhum altera arquivo.
Passo 1: Crie os três auditores em .claude/agents/
Indexação (robots.txt, sitemap, canonical, noindex e códigos de resposta), metadados (title, description, H1, hreflang e dados estruturados) e links (links quebrados, redirecionamentos em cadeia e imagens sem texto alternativo).
Deu certo quando: os três arquivos estão em .claude/agents/, cada um com name, description e tools no cabeçalho.
Erro comum: dar a ferramenta Edit aos auditores; numa auditoria, sub-agente só lê.
Passo 2: Escolha o modelo de cada auditor pelo custo
Leitura mecânica de cabeçalhos roda bem no Sonnet ou no Haiku. Deixe o modelo mais caro para a consolidação na conversa principal.
Deu certo quando: cada arquivo traz a linha model com o modelo escolhido.
Erro comum: deixar todos herdarem o modelo da sessão e pagar o mais caro por trabalho repetitivo.
Passo 3: Peça a auditoria em paralelo sobre o sitemap
Use o pedido do bloco abaixo. Os três trabalham ao mesmo tempo, cada um com contexto próprio, e devolvem só a tabela.
Deu certo quando: a conversa principal recebe três tabelas com URL, problema, gravidade e evidência.
Erro comum: aceitar achado sem evidência; peça a linha do HTML ou o código de resposta de cada problema.
Passo 4: Consolide e priorize no modo plan
Com Shift+Tab no modo plan, peça um plano que agrupe os achados por impacto e esforço antes de qualquer correção.
Deu certo quando: o arquivo auditoria/AAAA-MM-DD.md traz a lista priorizada com responsável sugerido.
Erro comum: deixar o Claude corrigir tudo na mesma rodada, sem a revisão de quem cuida do site.
Passo 5: Confira três achados à mão
Abra o código-fonte da página ou use a inspeção de URL do Search Console nos três problemas de maior gravidade.
Deu certo quando: os três se confirmam na fonte.
Erro comum: levar ao cliente uma lista que ninguém conferiu.
No fim você tem: um relatório de SEO técnico priorizado, com evidência por URL, produzido em paralelo e conferido por amostra.
---
name: auditor-indexacao
description: Audita a indexação de um site: robots.txt, sitemap, canonical, noindex e códigos de resposta. Use em auditorias de SEO técnico.
tools: Read, Grep, Glob, Bash, WebFetch
model: sonnet
---
Você audita a indexação e não altera nenhum arquivo.
Para cada URL recebida, confira o código de resposta, a tag canonical,
a meta robots e a presença no sitemap.
Devolva só uma tabela: URL | problema | gravidade (alta, média, baixa) | evidência.
Sem evidência, não registre o problema.Analista de SEO de um e-commerce de moda com 4 mil páginas de produto
Varejo online
Dor
A auditoria técnica mensal levava dois dias de rastreamento e planilha, e saía sempre atrasada em relação aos lançamentos de coleção.
Solução
Três sub-agentes auditores sobre as 50 páginas de maior receita, com evidência por URL e consolidação no modo plan antes de abrir chamado para o time do site.
Resultado
A auditoria das páginas que mais vendem passa a sair no mesmo dia do lançamento, e o rastreamento completo fica para o fechamento do trimestre.
Cenário construído para fins didáticos. Números não correspondem a cliente específico.
Para sites grandes, divida por seção, como categorias, produtos e blog, em vez de mandar milhares de URLs de uma vez: cada sessão tem limite de sub-agentes rodando ao mesmo tempo, 20 por padrão desde a versão 2.1.217. Acertou quando a primeira auditoria trouxer os cinco problemas prioritários com evidência e os três conferidos à mão se confirmarem.
Perguntas frequentes deste capítulo
Preciso saber programar para ter um dashboard vivo?
Qual a diferença prática entre Agent SDK e Managed Agents?
Um Artifact compartilhado expõe os meus dados para quem abrir a página?
Quando eu não devo automatizar de ponta a ponta?
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- CursoSetup Completo: do zero ao Claude Code
- Veja o que o Claude Code faz antes de instalarsugerido pelo grafoApresenta o conceito “Claude Code”, usado em “Montar o painel que se atualiza e o processo que roda sozinho”.
- Agent Mode: a IA que executa sob supervisãosugerido pelo grafoApresenta o conceito “Agent”, usado em “Montar o painel que se atualiza e o processo que roda sozinho”.
- CursoAgentes de código para executivossugerido pelo grafo3 capítulos de “Claude Code CLI: Programação com IA” usam conceitos apresentados em “Agentes de código para executivos”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Agentes de IA Autônomos: Do Conceito à ProduçãoClaude Agent SDKExaminar conexões de Claude Agent SDK
- Letramento em IA para ExecutivosDecida quando a IA pode agir sozinhaExaminar conexões de Decida quando a IA pode agir sozinha
- Gestão de Projetos GEODefinir quais decisões delegar a um agente de IAExaminar conexões de Definir quais decisões delegar a um agente de IA
- Automação com n8n e Make: Fluxos InteligentesPrimeiro Cenário no MakeExaminar conexões de Primeiro Cenário no Make
Voltar ao capítulo anterior: Colocar o Claude no time com segurança e um piloto medido
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Claude Code CLI: Programação com IA
- 19Decidir entre Claude e Gemini pelo lugar onde o time já trabalha
- 20Pesar preço, tempo real e maturidade antes de contratar o Grok
- 21Colocar o Claude no time com segurança e um piloto medido
- 22Montar o painel que se atualiza e o processo que roda sozinho
- 23Operar uma semana real com IA e medir o que mudou