Edição em Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Corrija e verifique uma checagem falha do repositório com um Goal de IA

> Defina um Goal limitado no Claude Code ou Codex CLI para uma checagem que já falha, depois confira o comando original e o diff final antes de aceitar a correção.

By BIG CHANGE Editorial

Published: 2026-10-20T05:48:37.854Z
Updated: 2026-10-20T05:48:37.854Z
Canonical: https://bigchange.ai/blog/ai-goal-failing-repository-check-guide

![Conceptual charcoal illustration of a developer reviewing a code diff beside a laptop showing an unresolved check.](https://bigchange.ai/api/media/file/ai-goal-failing-check-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Um assistente de programação pode continuar trabalhando em uma checagem falha, mas a checagem e o código final ainda precisam da sua revisão. Este guia é para um desenvolvedor responsável por um repositório com um comando de teste, compilação ou análise de estilo que já falha. Usa um Goal delimitado no Claude Code ou, como opção separada, a CLI interativa do Codex. Escolha uma. A conclusão é o comando original passar em uma alteração revisada que preserve o comportamento definido antes. Se isso não puder ser demonstrado, guarde a falha e o bloqueio exato. O procedimento é documental; a BIG CHANGE não executou um Goal nem reparou um repositório para este artigo.

## A grande mudança

- **O que mudou:** Os comandos documentados `/goal` mantêm o objetivo ativo entre turnos, permitindo investigar uma falha, fazer uma mudança limitada e verificar novamente sem nova instrução sua em cada turno.
- **Por que importa:** Você pode definir comando original, arquivos permitidos e comportamento protegido antes do ciclo. As tentativas sucessivas mantêm o mesmo critério de aceitação.
- **O que observar:** Um estado Goal ou veredito do modelo não comprova o reparo. Leia a saída real e o diff final e decida você mesmo se aceita a alteração.

## Antes de começar: registre a falha e os limites

Use um repositório que você tenha autorização para alterar. Leia as instruções locais, incluindo `AGENTS.md` ou `CLAUDE.md` quando existirem, e confira ramificação, edições existentes e arquivos não rastreados. Em Git, estes comandos fornecem o inventário inicial:

```sh
git status --short
git diff --stat
git diff
```

Guarde esse inventário para distinguir as mudanças do assistente do trabalho anterior. Execute a **checagem real que falha** uma vez ou guarde uma execução recente confiável com comando exato, erro completo e estado de saída. Não a substitua por um exemplo deste artigo. Registre antes dependências de serviço, segredo ou plataforma inacessível. Uma mudança única conhecida talvez seja melhor com uma solicitação normal; um Goal ajuda quando cada resultado define a próxima etapa de diagnóstico.

Escreva fora do Goal uma nota curta de aceitação: comando original exato, resultado atual, caminhos e ferramentas permitidos, comportamentos e outras checagens a preservar e decisões que exigem parar e revisar. Proteja explicitamente as edições anteriores sem relação. Não permita apagar ou enfraquecer a checagem para fabricar aprovação. Leia a nota antes de autorizar ferramentas. Pedir uma parada após certo número de turnos pode orientar o modelo, mas não garante limite de gasto.

## 1. Escolha uma única interface Goal

No **Claude Code**, abra a sessão do repositório previsto e confira se `/goal` está disponível. Seu [manual de Goal](https://code.claude.com/docs/en/goal), conferido em 20 de outubro de 2026, informa que depende da confiança no espaço de trabalho e das configurações de hooks. Um Goal pode estar ativo por sessão. Uma condição nova substitui a primeira e inicia imediatamente. O Goal não muda o modo de permissão: o modo manual ainda pode pedir autorização antes das ferramentas; o automático é outro ajuste. Mantenha os controles normais de arquivos, comandos e rede.

Para a **alternativa da CLI interativa do Codex**, confira a versão instalada e a lista de comandos com barra. O [guia prático de Goals](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) da OpenAI informa que começam no Codex 0.128.0. O [guia de uso](https://learn.chatgpt.com/use-cases/follow-goals) documenta a opção `features.goals` se o comando estiver ausente. São verificações para sua instalação; não foram executadas para este artigo:

```sh
codex --version
codex features enable goals
```

Ative a função somente se sua instalação precisar e sua organização permitir. Estas instruções tratam da CLI interativa. Não pressuponha o mesmo suporte em `codex exec` nem em toda versão de desktop. Se continuar ausente, pare e confira versão, configuração e acesso da conta ou espaço de trabalho antes de escolher outra forma.

## 2. Defina a condição delimitada

Use `/goal` seguido da condição revisada. Informe o comando real e os caminhos permitidos, não um teste inventado. Por exemplo: “Faça minha checagem, que já falha, passar usando somente os caminhos e ferramentas da nota de aceitação. Após cada tentativa, mostre comando, resultado completo e arquivos alterados. Preserve comportamento protegido e edições sem relação. Se não puder executar a checagem ou não houver mudança segura dentro do escopo, pare com o erro exato, as alterações tentadas e a informação necessária de mim.” Substitua “minha checagem” pelo comando exato e anexe ou indique a nota revisada antes de começar.

Os dois comandos documentados `/goal` aceitam uma condição não vazia de até 4.000 caracteres. Mantenha restrições detalhadas na nota. No Claude Code, `/goal <condition>` inicia um turno imediatamente. Na CLI interativa do Codex, `/goal <objective>` associa um objetivo persistente à conversa atual. Nenhuma via concede novas autorizações sobre arquivos, comandos ou contas. Se o reparo exigir caminhos maiores, serviço externo, segredo, integração ou implantação, pause para decisão do responsável.

## 3. Acompanhe as evidências durante o trabalho

Peça a saída exata após cada tentativa relevante e a lista de arquivos alterados. Execute `/goal` sem argumento para consultar o estado. O Claude Code mostra tempo decorrido, turnos avaliados, gasto de tokens e motivo mais recente do avaliador após avaliar. O avaliador lê o que Claude apresentou na conversa; **não** executa a checagem nem inspeciona arquivos de forma independente. Portanto, um veredito “met” pede verificação, não prova o reparo. O estado Goal do Codex também precisa da saída real e do diff para estabelecer um resultado.

Mantenha o ciclo no escopo original. Leia comandos propostos antes de permitir, sobretudo os que apagam arquivos, reescrevem histórico, enviam dados para fora ou mudam permissões. Pare se a checagem original for enfraquecida, um arquivo sem relação mudar sem explicação ou dados privados forem expostos. Se não puder autorizar com segurança a próxima ação, registre o estado Goal e peça um plano mais restrito.

## 4. Verifique a conclusão pessoalmente

Quando o assistente relatar sucesso, examine o diff final completo contra o inventário inicial. Confira cada arquivo alterado ou criado com os caminhos permitidos. Execute **o mesmo comando original de checagem** novamente quando viável e guarde saída completa e estado de saída. Execute testes pertinentes não alterados da nota e revise o comportamento a preservar. Uma checagem substituta passar não cumpre o acordo.

Aceite a alteração apenas quando a evidência corresponder à condição revisada e você aprovar o diff. Commit, integração e implantação são decisões autorizadas separadamente. Se a verificação falhar, guarde comando e saída exatos, arquivos alterados, estado Goal e a permissão, dependência ou decisão que falta. Goal pausado, interrompido, impossível, bloqueado ou limitado por orçamento não é reparo concluído.

## Se o Goal parar ou travar

No **Claude Code**, `/goal` mostra a condição e o motivo mais recente; `/goal clear` remove o Goal ativo. Seu [manual](https://code.claude.com/docs/en/goal) diz que uma condição ativa pode voltar ao retomar a sessão, enquanto as bases de tempo, turnos e tokens são reiniciadas. A restauração pelo seletor de sessões foi corrigida em v2.1.239. Falhas de autenticação gerenciada pelo Claude Code, crédito esgotado, estouro irrecuperável de contexto e modelo indisponível podem apagar o Goal. Autenticação gerenciada pelo hospedeiro pode deixá-lo ativo. Outros erros podem mantê-lo e tentar novamente ou pausar; avisos interativos são documentados a partir de v2.1.269. Leia aviso, estado, saída guardada e diff antes de definir ou retomar. Uma nova condição substitui a antiga.

Na **CLI interativa do Codex**, `/goal` mostra o objetivo, enquanto `/goal edit`, `/goal pause`, `/goal resume` e `/goal clear` são controles documentados na [referência de comandos CLI](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-set-or-view-a-task-goal-with-goal). Seu [guia prático](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) distingue conclusão de pausa, interrupção, limite de orçamento ou bloqueio. Inspecione estado atual e evidências reais antes de retomar ou mudar o objetivo. Se um limite de orçamento ou acesso parou o trabalho, pode ser mais útil registrar o bloqueio exato do que tentar outra vez.

Os turnos usam franquia ou créditos da conta; o avaliador separado do Claude Code também usa tokens. Confira controles e limites atuais da sua conta. Uma condição de tempo ou turnos escrita em prosa não garante teto em dólares. Use somente material autorizado, exclua segredos e arquivos privados sem relação e inspecione instruções do repositório antes que o assistente as siga.

Para uma configuração separada, nosso [guia de ambiente Codex Cloud](https://bigchange.ai/blog/codex-cloud-environment-setup-guide) explica conexão e preparação de repositório remoto. Nosso [guia de Team Tasks compartilhadas](https://bigchange.ai/blog/chatgpt-team-tasks-shared-recurring-work-guide) trata do trabalho recorrente no ChatGPT. Nenhuma dessas configurações é necessária para a checagem local descrita.

## Fontes e leituras complementares

- [Claude Code: manter Claude trabalhando em direção a um objetivo](https://code.claude.com/docs/en/goal) descreve `/goal`, visibilidade do avaliador, permissões, retomada, erros e uso. Não verifica um reparo no seu repositório.
- [OpenAI: usar Goals no Codex](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) descreve versão mínima da CLI, contrato do objetivo, ciclo de vida e evidências. Os exemplos não são resultados deste guia.
- [OpenAI: seguir um objetivo](https://learn.chatgpt.com/use-cases/follow-goals) explica a opção de ativação e o objetivo persistente. O acesso depende da instalação e conta.
- [OpenAI: comandos de desenvolvimento do Codex CLI](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-set-or-view-a-task-goal-with-goal) documenta os controles interativos `/goal` . Confira localmente o suporte da CLI.

## Sources

- [Claude Code, manter Claude trabalhando em direção a um objetivo](https://code.claude.com/docs/en/goal) — Documenta Goal de sessão, limites do avaliador, permissões, uso e recuperação por versão. Não estabelece de forma independente sucesso de teste ou reparo.
- [OpenAI, usar Goals no Codex](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) — Documenta versão mínima da CLI, objetivo delimitado, ciclo de vida e evidências. Os exemplos não foram executados para este artigo.
- [OpenAI, seguir um objetivo](https://learn.chatgpt.com/use-cases/follow-goals) — Documenta Goal interativo e opção de ativação. Não estabelece acesso na instalação ou conta do leitor.
- [OpenAI, comandos de desenvolvimento do Codex CLI](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-set-or-view-a-task-goal-with-goal) — Documenta os controles interativos exatos /goal para estado, edit, pause, resume e clear e o limite de 4.000 caracteres; não afirma suporte de codex exec nem de toda versão de desktop.