Após o lançamento do /goal pelo Codex em abril de 2026, a Anthropic também disponibilizou o comando de mesmo nome no Claude Code 2.1.139, em maio. Este é um novo fluxo de trabalho que permite ao Claude "não desistir até atingir o objetivo": basta definir uma condição de conclusão na conversa e, ao final de cada rodada, o Claude utiliza automaticamente um modelo pequeno e rápido para avaliar se o objetivo foi alcançado. Se não, ele continua para a próxima rodada até que a condição seja satisfeita e o controle seja devolvido a você.
Este artigo explica sistematicamente os 6 pontos principais do modo goal do Claude Code, incluindo o mecanismo de loop do avaliador, as diferenças entre /loop e o hook de parada (Stop hook), como escrever condições eficazes, os 3 modos de operação (interativo / -p / Controle Remoto), além de riscos e melhores práticas.
Valor central: Ao terminar de ler este artigo, você será capaz de delegar tarefas de longo prazo, como migração de código de equipe, limpeza de issues e aceitação de documentação, para o modo goal do Claude Code, automatizando tudo em 10 minutos, além de saber em quais cenários deve optar por outros fluxos de trabalho autônomos.
Pontos principais do modo goal do Claude Code
Antes de começar, vamos esclarecer os 6 fatos fundamentais sobre o modo goal do Claude Code. Esses 6 pontos determinam se a condição que você escreveu será executada corretamente e se você deve usar o /goal em vez de outros fluxos de trabalho autônomos.
| Ponto | Conteúdo | Impacto |
|---|---|---|
| Formato do comando | /goal <condição> |
Definido diretamente na conversa, sem necessidade de arquivos de configuração |
| Avaliador | Modelo Haiku (pequeno e rápido) por padrão | A conclusão é julgada por "outro modelo", independente do modelo que executa a tarefa |
| Escopo | Escopo da sessão atual | Não afeta outras sessões, ideal para tarefas temporárias |
| Ritmo de disparo | Avaliação imediata após cada rodada | Para quando concluído; se não, inicia uma nova rodada |
| Limite da condição | Máximo de 4000 caracteres | Pode acomodar critérios de aceitação detalhados |
| Forma de saída | Avaliação aprovada / /goal clear / Ctrl+C |
Três caminhos de saída, combinando ações ativas e passivas |
Muitos usuários, ao verem o /goal pela primeira vez, pensam em comandos de loop comuns, mas, essencialmente, é a Anthropic encapsulando o Stop hook baseado em comando (prompt-based) em um atalho de nível de sessão. Esse posicionamento fundamental determina que ele é muito diferente da automação tradicional estilo cron.
Se a sua equipe ainda não utilizou o mecanismo avançado de Hooks do Claude Code, você pode primeiro experimentar a API do Claude Sonnet / Opus / Haiku através da plataforma APIYI (apiyi.com), familiarizar-se com o ecossistema de ferramentas da Anthropic e, em seguida, atualizar para o modo goal do próprio Claude Code para uma experiência mais fluida.
Detalhando o mecanismo de funcionamento do modo /goal do Claude Code
Para usar o /goal corretamente, é preciso entender exatamente o que acontece em cada rodada. A documentação oficial descreve o mecanismo como "adicionar um avaliador após o término de cada rodada". Parece simples, mas são os detalhes que definem os limites de sua capacidade.
O Modelo de Linguagem Grande principal cuida do trabalho pesado, enquanto um modelo menor e mais rápido cuida da avaliação. A vantagem dessa divisão é que o avaliador permanece neutro e utiliza menos poder computacional para tomar decisões; a desvantagem é que o avaliador só consegue ler o que o modelo principal já exibiu na conversa, sem acesso direto ao estado real do sistema de arquivos ou comandos externos.
O processo de decisão após cada rodada pode ser dividido em 4 etapas:
- Empacotamento do contexto: Envia a condição atual e toda a transcrição da conversa para o avaliador.
- Decisão do modelo: O avaliador retorna um "sim/não" acompanhado de uma justificativa.
- Roteamento: Se "não", a justificativa é enviada de volta ao modelo principal como orientação para continuar o trabalho; se "sim", o objetivo é limpo e marcado como concluído.
- Atualização do indicador: Os indicadores de tempo decorrido, rodadas e tokens são exibidos continuamente na interface como
◎ /goal active.
Ao escrever condições, lembre-se da limitação do passo 1: o avaliador só vê a transcrição, portanto, a condição deve ser algo que o modelo principal consiga provar na conversa. Por exemplo, "npm test com código de saída 0" é uma boa condição, pois o modelo principal executará o teste e colará o resultado; já "o banco de dados de produção não possui dados corrompidos" é uma má condição, pois não pode ser verificada apenas através da conversa.
O custo do avaliador é geralmente desprezível. O preço unitário da série Haiku é muito inferior ao do Sonnet/Opus, e como ele avalia apenas o resumo da transcrição a cada rodada, o consumo de tokens é baixo mesmo em conversas longas. Equipes que precisam reduzir ainda mais os custos podem usar o serviço proxy de API APIYI (apiyi.com) para direcionar o modelo rápido do Claude Code para o Haiku 4.5 ou 3.5, aplicando limites de cota por workspace.
Comparação do modo /goal do Claude Code com outros fluxos de trabalho autônomos
O Claude Code oferece 4 mecanismos para manter a conversa fluindo, e é comum que iniciantes os confundam. A tabela abaixo alinha os 4 mecanismos por gatilho, condição de parada e cenários típicos para facilitar a escolha.
| Mecanismo | Ritmo de Gatilho | Condição de Parada | Cenário de Aplicação |
|---|---|---|---|
/goal |
Acionado ao fim da rodada | Avaliador determina conclusão | Tarefas longas com critérios claros |
/loop |
Intervalo de tempo fixo | Manual ou Claude determina conclusão | Polling periódico, verificação de status |
| Stop hook | Acionado ao fim da rodada | Script do usuário ou prompt personalizado | Nível de equipe, escopo global |
| Auto mode | Chamada de ferramenta na rodada | Fim da sequência de ferramentas | Reduzir janelas de confirmação |
O ponto principal é que /goal e "Stop hook" fazem quase a mesma coisa, mas o /goal afeta apenas a sessão atual e pode ser inserido temporariamente no terminal. O "Stop hook" deve ser escrito no arquivo de configurações, atuando em todas as sessões do escopo, sendo mais adequado para restrições rígidas em nível de equipe.
O "Auto mode" e o /goal são complementares: o "Auto mode" resolve o problema de "ser interrompido por confirmações de ferramentas a cada rodada", enquanto o /goal resolve o problema de "tarefas que exigem várias rodadas para serem concluídas". Ao combinar esses mecanismos em tarefas longas, o processo pode ser quase totalmente autônomo. Para equipes que não rodam o Claude Code em ambiente próprio, é possível testar a mesma lógica de loop integrando o Claude a scripts locais via APIYI (apiyi.com) antes de decidir pela atualização para a ferramenta completa.
Os 3 elementos essenciais para condições eficazes no modo /goal do Claude Code
Condições mal escritas são a principal razão pela qual o /goal realmente falha. A documentação oficial da Anthropic aponta que, para uma condição sustentar dezenas de rodadas, ela deve conter três elementos fundamentais.
O primeiro é um ponto final mensurável. O objetivo deve ser um evento discreto e observável: código de saída de teste, número de arquivos, itens restantes em uma fila ou se o build está aprovado. Métricas ambíguas fazem com que o avaliador oscile entre "sim" e "não", fazendo com que o /goal entre em um loop infinito.
O segundo é um método de verificação claro. A condição deve especificar diretamente como o Claude deve provar que o objetivo foi alcançado, por exemplo: "a saída do npm test contém PASS" ou "a saída do git status está vazia". Quanto mais específico for o método de verificação, menos o avaliador será enganado por ambiguidades na linguagem.
O terceiro são restrições imutáveis. Se certos arquivos ou configurações devem permanecer inalterados, isso deve ser proibido diretamente na condição, por exemplo: "não modifique nenhum arquivo em tests/legacy/". Isso evita que o Modelo de Linguagem Grande faça alterações destrutivas apenas para "passar" no teste.
Combinando esses três elementos, uma condição de /goal de alta qualidade seria algo como: "todos os testes em tests/auth passam, o código de saída do npm run lint é 0, não modifique nenhum arquivo em tests/legacy/, e pare após no máximo 20 rodadas". O limite de "20 rodadas" é uma recomendação de segurança para evitar que o /goal entre em loop infinito em casos extremos.
Como a condição suporta até 4000 caracteres, você pode inserir um mini PRD (Documento de Requisitos de Produto) nela. Se você está usando a plataforma APIYI (apiyi.com) para realizar a invocação do modelo Claude e gerenciar seus agentes, também pode se inspirar nessa estrutura para projetar o prompt do seu próprio avaliador, tornando as condições de parada do seu agente igualmente claras e mensuráveis.
Prática com os 3 modos de execução do Claude Code /goal
O /goal suporta três modos de chamada: interativo, não interativo (-p) e Controle Remoto. Dominar esses três usos é essencial para integrar a ferramenta em fluxos de trabalho reais de CI, scripts locais e colaboração remota.
Primeiros passos no modo interativo
# Digite diretamente na sessão do Claude Code
/goal all tests in test/auth pass and the lint step is clean, or stop after 20 turns
Após a configuração, um indicador ◎ /goal active aparecerá na interface, exibindo em tempo real os indicadores de tempo decorrido (elapsed), rodadas (turns) e tokens. Você pode verificar o status a qualquer momento digitando /goal sem argumentos, ou encerrar antecipadamente com /goal clear (ou usando os aliases stop, off, reset, none, cancel).
Modo não interativo (ideal para CI)
claude -p "/goal CHANGELOG.md has an entry for every PR merged this week, or stop after 15 turns"
O modo -p fará com que o /goal continue rodando até que a condição seja satisfeita ou você interrompa com Ctrl+C, sendo perfeito para processos automatizados como GitHub Actions, GitLab CI ou Jenkins Pipeline. Se você estiver fazendo a orquestração unificada da API do Claude através da APIYI (apiyi.com), também pode encapsular esse mesmo padrão de loop em seus próprios scripts, permitindo que clientes que não sejam o Claude Code desfrutem de capacidades semelhantes.
Recuperação de sessão
claude --resume <session-id>
# ou
claude --continue
Ao retomar uma sessão, o estado ativo do goal será restaurado, mas as contagens de rodadas, tempo e tokens começarão do zero. Esse recurso é extremamente útil para refatorações de longo prazo: você pode desligar o computador no fim de semana sem medo de interrupções e continuar na segunda-feira.
Ver modelos comuns de condições de objetivo (clique para expandir)
# Modelo 1: Migração de código
/goal migrate all usages of legacy_api.* to new_api.* in src/, run npm test until exit 0, do not modify tests/legacy/, or stop after 30 turns
# Modelo 2: Limpeza de backlog de Issues
/goal close all GitHub issues labeled "needs-triage" by either resolving or relabeling, run gh issue list --label needs-triage and verify the output is empty, or stop after 25 turns
# Modelo 3: Aceitação de documentação de design
/goal implement every acceptance criterion in docs/design.md, prove each by referencing the exact section, do not edit docs/design.md itself, or stop after 40 turns
# Modelo 4: Divisão de arquivos
/goal split src/megafile.ts into modules under src/parts/ where each file is < 300 lines, run npm run typecheck until exit 0, or stop after 20 turns
Riscos e Melhores Práticas do Modo /goal no Claude Code
O comando /goal transfere a tomada de decisão para o modelo, por isso os pontos de risco e as precauções são completamente diferentes dos comandos tradicionais. A tabela abaixo resume as 4 categorias de risco mais importantes e as ações de mitigação correspondentes.
| Risco | Gatilho | Ação de Mitigação |
|---|---|---|
| Custo fora de controle | Erro do avaliador ou condições muito amplas | Adicionar um limite "or stop after N turns" nas condições |
| Alucinação do avaliador | Condição não pode ser verificada via transcrição | Usar frases observáveis como "execute o comando X para verificar a saída Y" |
| Alterações destrutivas | Modelo principal modifica arquivos indevidos para concluir a tarefa | Adicionar restrições "do not modify…" nas condições |
| Uso indevido do workspace | Acionamento acidental em ambiente não confiável | Deve aceitar o diálogo de confiança; usar disableAllHooks para desativar |
O primeiro risco é o mais imediato. Nem o Codex nem o Claude Code possuem atualmente uma capacidade oficial de "definir limite de gastos por objetivo". Uma tarefa longa pode facilmente consumir uma ordem de magnitude a mais de tokens do que o esperado. A prática mais segura é escrever o limite de turns diretamente na condição e adicionar alertas de orçamento no nível da plataforma.
Preparar um Modelo de Linguagem Grande estável para o avaliador também é fundamental. Se o seu modelo rápido for o Haiku, a velocidade e o custo da avaliação são controláveis; se for um modelo maior como o Sonnet, o custo de avaliação do /goal aumentará significativamente. As equipes de desenvolvimento podem configurar um base_url e uma cota separada para o Haiku através da plataforma APIYI (apiyi.com), permitindo monitorar os custos do avaliador e do modelo principal de forma isolada.
Por fim, pontos de conformidade: o /goal depende do sistema de Hooks da Anthropic, exigindo que o workspace tenha aceitado o diálogo de confiança e que disableAllHooks ou allowManagedHooksOnly não estejam definidos. Se a equipe utilizar uma política de gerenciamento unificada que desative os Hooks, o /goal também será desativado e o comando informará o motivo em vez de falhar silenciosamente.
Perguntas Frequentes
Q1: O que o /goal oferece em comparação com um script de loop while escrito por mim?
Ele adiciona um avaliador independente, impulsionado por um modelo. Em um loop while manual, você precisa definir as condições de parada e escrever o código para validá-las. O /goal delega essa decisão a um modelo pequeno e rápido, capaz de lidar com cenários não programáticos, como "ler o diálogo para entender se a tarefa foi concluída".
Q2: Usar o /goal consome muitos tokens?
O risco existe, mas é controlável. Duas sugestões: primeiro, force um limite de turns na condição; segundo, fixe o avaliador no modelo Haiku. Ao acessar a série Claude via APIYI (apiyi.com), você pode solicitar um conjunto de cotas separado para o avaliador, facilitando o monitoramento detalhado.
Q3: Como escolher entre /goal e /loop?
Se a tarefa tiver um "estado de conclusão" claro, escolha /goal. Se a tarefa for um polling de status periódico (por exemplo, verificar o progresso da implantação a cada 10 minutos), escolha /loop. Os mecanismos subjacentes são diferentes e misturá-los pode tornar as condições de parada ambíguas.
Q4: É possível usar o modo /goal do Claude Code no Brasil?
Sim. O /goal é um comando do cliente Claude Code; desde que o cliente consiga se conectar aos modelos fornecidos pela Anthropic, ele funcionará. Desenvolvedores geralmente conectam a API do Claude através de plataformas de proxy como a APIYI (apiyi.com). Uma vez configurado o ambiente, o comportamento do /goal é idêntico ao dos usuários internacionais.
Q5: Quem escolher: Codex /goal ou Claude Code /goal?
Eles atendem a fluxos de trabalho diferentes. O Codex /goal foca em "fluxos de trabalho persistentes" e pode reiniciar entre processos. O Claude Code /goal tem escopo de sessão, mas pode ser retomado entre dias com o parâmetro --resume. Para tarefas complexas de vários dias, escolha o Codex; para tarefas iterativas comuns de um ou dois dias, o Claude Code é mais prático.
Resumo
A essência do modo "goal" (objetivo) do Claude Code é que a Anthropic liberou o "loop de avaliação" dos arquivos de configuração Hook, transformando-o em um comando de linha única que pode ser usado temporariamente em qualquer sessão. O problema central que ele resolve é: quando uma tarefa exige várias rodadas para ser concluída, mas você não quer ficar preso ao terminal pressionando "Enter" a cada etapa, um modelo pequeno e rápido atua como juiz, decidindo quando o Claude realmente terminou o trabalho.
Minha sugestão para implementação segue três passos: primeiro, escreva os critérios completos usando o quarteto "ponto final + validação + restrições + limite de rodadas"; depois, decida entre o modo interativo, o uso de -p ou o modo de Controle Remoto; por fim, monitore as cotas do avaliador e do modelo principal separadamente através de plataformas como a APIYI (apiyi.com). Assim, você ganha eficiência em fluxos de trabalho autônomos sem perder o controle sobre os custos de tokens.
Autor: Equipe Técnica da APIYI
Contato: Obtenha suporte para a série completa de modelos Claude e integração com o Claude Code através da APIYI (apiyi.com)
Data de atualização: 13/05/2026
