Tarefas completas com agente (Claude Code)

Aula 1 · Uma tarefa em vários passos (10 min)

Um agente faz mais de um passo por pedido: lê, calcula, escreve arquivos. Numere os passos no pedido e diga onde gravar. Os testes usaram o Claude Code em modo não interativo, com o comando claude -p "<pedido>" --permission-mode acceptEdits rodado dentro da pasta de teste. A criação dos arquivos e a alteração de notas.txt foram testadas nesse modo. A revisão da Aula 3 e o desfazer da Aula 4 foram testados com --permission-mode default, e cada passo diz o modo usado. A tela interativa de aprovação não foi testada. Pedido usado:

Leia vendas_loja_modelo_out2026.csv e notas.txt. Faca em etapas: 1) escreva relatorio.md nesta pasta com 3 achados sobre as vendas e uma tabela de total por canal; 2) crie checklist.md nesta pasta com 4 proximos passos baseados nas notas. Use so os dados dos arquivos.

O que aconteceu no teste (27/10/2026, Windows, modo não interativo claude -p):

• Com --permission-mode default e um pedido parecido (sem a expressão "nesta pasta"), o agente não gravou na pasta. Disse que a permissão de escrita foi negada, guardou os dois arquivos em um diretório de rascunho da própria sessão e avisou. Lição: no modo default, em sessão não interativa, a gravação é negada; confira com ls onde os arquivos foram parar. A documentação oficial confirma: em claude -p, as chamadas que precisam de aprovação são negadas, a menos que exista uma regra de permissão que as libere.
• Com --permission-mode acceptEdits, ele criou relatorio.md e checklist.md na pasta. A documentação oficial descreve o acceptEdits assim: ele cria e edita arquivos no diretório de trabalho sem perguntar.
• O modo, sozinho, muda o resultado. Num teste separado, com a mesma frase nos dois ("crie saudacao.md nesta pasta"), default negou a gravação e acceptEdits criou o arquivo.

Aula 2 · Acompanhe e confira os números (10 min)

Abra o relatorio.md e confira contra a planilha. No teste, a planilha tinha 15 registros e o cálculo feito fora da IA (Python) deu R$ 6.791,20 e 36 unidades. O relatório trouxe os mesmos valores, inclusive o total por canal (Site R$ 2.620,70, Instagram R$ 2.399,70, WhatsApp R$ 1.770,80) e o ticket médio (R$ 354,16 no WhatsApp).

Na primeira execução, a resposta falada do agente disse "72,9%" para um valor que o cálculo dá como 72,97%. Diferença pequena, mas é o tipo de coisa que só aparece se você conferir. Faça o mesmo: some uma coluna na própria planilha e compare com o relatório antes de usar.

Leia também o checklist: cada passo deve vir de uma linha do notas.txt ou de um número do relatório. Passo sem origem nos arquivos é invenção do agente.

Aula 3 · Revise o que mudou (10 min)

1. Faça uma alteração em arquivo que já está no commit. No teste, com --permission-mode acceptEdits, o pedido foi acrescentar a notas.txt a linha "Decisao: priorizar calca e jaqueta no WhatsApp em novembro." O git diff mostrou uma linha adicionada e nenhuma removida.
2. Peça a revisão ao próprio agente, sem autorizar edição (modo default no teste):

Esta pasta e um repositorio git. Rode git status e git diff e me diga em linguagem simples o que mudou desde o ultimo commit. Nao altere nada.

No teste, o agente rodou git status e git diff sem pedir permissão. Antes da alteração de notas.txt, ele listou corretamente os dois arquivos novos (relatorio.md, checklist.md). Depois da alteração, num pedido para listar arquivo por arquivo, acertou: notas.txt alterado (uma linha a mais, mostrada no diff) e dois arquivos novos. A conferência feita à parte, com git status --short e git diff, deu o mesmo resultado. Faça essa dupla conferência: o agente resume, o git prova.

Como ler: no git status, M é arquivo alterado e ?? é arquivo novo que o git ainda não conhece. No git diff, linha com + foi acrescentada e linha com - foi removida. O git pode avisar sobre fim de linha (LF e CRLF) no Windows; é aviso de formato, não mudança de conteúdo.

Aula 4 · Aprove ou desfaça (10 min)

Antes de rodar o comando abaixo: git checkout -- arquivo descarta, sem volta, as alterações ainda não gravadas daquele arquivo. Use só na pasta de teste, com um arquivo fictício que você aceita perder.

Dois casos, com resultados diferentes:

1. Arquivo que já estava no commit e foi alterado (notas.txt). Peça, no modo default (o modo do teste): Desfaca a alteracao feita em notas.txt, voltando ao ultimo commit (git checkout -- notas.txt). Nao apague nenhum outro arquivo. No teste o arquivo voltou às duas linhas originais e os dois arquivos novos ficaram intactos. (Neste teste, o modo default barrou o primeiro comando, pelo PowerShell, duas vezes, e o agente repetiu o pedido por outra ferramenta, o Bash, que passou. Leia o que o agente tentou, e não só o que ele conseguiu. A documentação oficial só garante leituras livres nesse modo.)
2. Arquivo novo que o git não conhece (checklist.md). No teste, em modo default, apagar é definitivo: o agente avisou no teste que, por não estar no git, "não há como recuperá-lo pelo histórico". Se você quer poder desfazer arquivo novo, faça git add e commit antes de seguir, ou copie para outro lugar. No teste, o Remove-Item foi barrado duas vezes e o agente apagou com rm pelo Bash.

Aprovar é simples: o que você conferiu e quer manter, faça commit (git add nome-do-arquivo e git commit -m "mensagem"). A partir daí o arquivo tem ponto de retorno.

Aula 5 · Os limites da pasta (5 min)

Peça ao agente algo fora da pasta de teste. No teste, ele não leu nem gravou:

• Leitura de um arquivo em outra pasta, nos modos default e acceptEdits: recusou. Disse que o arquivo está fora do diretório de trabalho e que o acesso não foi autorizado. Sugeriu rodar em sessão interativa e aprovar o pedido, adicionar a pasta com /add-dir, ou copiar o arquivo para dentro da pasta de trabalho. Não tentou contornar por outro caminho.
• Gravação em outra pasta com acceptEdits: bloqueada, nada foi criado.

Isso confere com a documentação oficial: no acceptEdits, a aprovação automática vale só para a pasta de trabalho e diretórios adicionais; edição fora ainda pede permissão.

Liberar uma segunda pasta, testado: com --add-dir "C:\caminho\da\outra\pasta" no comando, o agente leu um arquivo dessa pasta e devolveu o texto exato; sem a opção, o mesmo pedido foi recusado. Numa sessão interativa, o equivalente é o comando /add-dir, que a documentação oficial cita. Regra prática: abra o agente na pasta certa e libere outra pasta só se tiver certeza do motivo.