Deixe o Agente Usar o Terminal — aula do módulo Artefatos e Fluxo Avançado, na trilha Começando com Antigravity: do Zero ao Primeiro Resultado da formação…
Leitura de aproximadamente 4 minutos.
Módulo: Artefatos e Fluxo Avançado · Curso: Começando com Antigravity: do Zero ao Primeiro Resultado · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código
Quando o agente pede para executar um comando, ele está pedindo para rodar algo de verdade na sua máquina. Muita gente desliga essa permissão por precaução, e o receio faz sentido.
Só que a alternativa é pior. Sem terminal, o agente escreve o código e te diz que funciona — e você descobre que não funciona depois, sozinho, sem o contexto da conversa. Com terminal, ele roda, lê a mensagem de erro, conserta e só então te entrega.
A regra prática, dita uma vez: deixe ele executar, mas leia o comando antes de aprovar, do mesmo jeito que você leria um diff. Comando que cria coisa, aprove. Comando que apaga, leia duas vezes.
O relatório do primeiro módulo roda em três segundos. O problema nunca foi o tempo — é que alguém precisa lembrar de rodar. Vamos tirar isso da sua cabeça.
Escreva umagendar-relatorio.ps1que agende orelatorio-csv.ps1para rodar toda
segunda-feira às 8h sobre ovendas.csv, usando oschtasksque já vem no Windows — sem
admin, sem serviço, sem instalar nada. O padrão é simulação: mostre na tela a linha exata
que seria executada e só execute com-Aplicar. Inclua-Listarpara consultar e
-Remover para cancelar. Rode o script e me mostre a saída real.A última frase é o assunto da aula: rode o script e me mostre a saída real. Sem ela, você recebe um script plausível e um parágrafo confiante.
O agente rodou. E o terminal respondeu:
ERRO: O valor da opção '/TR' não pode ter mais de 261 caractere(s).
O agendador de tarefas do Windows tem um limite de 261 caracteres no comando a executar. A primeira versão montava a linha inteira do PowerShell — com caminho completo do script, do CSV e todos os parâmetros — dentro do agendador. Com caminho longo, estoura.
A correção:
O /TR do schtasks não aceita mais de 261 caracteres e meu caminho é longo. Gere um
atalho .cmd curto ao lado do CSV com a linha completa do PowerShell, e aponte a tarefa
para esse.cmd. Se a criação da tarefa falhar, apague o.cmdque você criou.
Repare na última frase: limpeza em caso de falha. Sem ela, uma tentativa fracassada deixa lixo na sua pasta, e a segunda tentativa começa de um estado sujo.
Este bloco é o valor inteiro do terminal em miniatura. Se o agente não tivesse rodado, o script quebrado estaria na sua máquina, e você descobriria na segunda-feira que o relatório não veio.
powershell -NoProfile -ExecutionPolicy Bypass -File .\agendar-relatorio.ps1 -Script .\relatorio-csv.ps1 -Csv .\vendas.csv
Simulação: a linha do schtasks aparece inteira na tela e nada é criado. Leia a linha.
powershell -NoProfile -ExecutionPolicy Bypass -File .\agendar-relatorio.ps1 -Script .\relatorio-csv.ps1 -Csv .\vendas.csv -Aplicar
Saída medida: Agendado. O relatorio passa a rodar sozinho. — em 0,99 s, sem nenhum pedido de privilégio de administrador.
powershell -NoProfile -ExecutionPolicy Bypass -File .\agendar-relatorio.ps1 -Listar
Saída medida: Hora da próxima execução: 24/08/2026 08:00:00 · Status: Pronto.
Agora a prova. Apague o HTML gerado e dispare a tarefa manualmente pelo agendador do Windows. O arquivo reaparece na pasta: relatorio-vendas.html, 7.373 bytes.
Esse número não é "parecido" com o do primeiro módulo. É o mesmo, byte por byte — produzido sem ninguém na frente da máquina.
powershell -NoProfile -ExecutionPolicy Bypass -File .\agendar-relatorio.ps1 -Remover -Aplicar
Saída medida: Tarefa removida. A consulta seguinte confirma que ela não existe mais.
Isso não é detalhe de arrumação. Automação agendada é a única coisa desta trilha que continua acontecendo depois que você fecha o editor e esquece. Se você não sabe desligar, você não deveria ter ligado.
Faça o inventário do que você agendou de vez em quando. Uma tarefa esquecida rodando sobre um arquivo que mudou de formato gera erro silencioso toda semana.
Terminal de agente existe no Claude Code, no Codex, no OpenCode e no Cursor. Muda o nome do painel; não muda o método: leia o comando, aprove, e cobre a saída real.