Como usar Codex /goal: continuação, controles, critérios de conclusão e orçamento de tokens

Se você envia «continue» ao Codex repetidamente, uma opção é usar /goal para manter os critérios de conclusão. Isso é útil para reproduzir um erro, corrigi-lo e escolher a próxima etapa conforme os resultados dos testes. Não é apenas uma instrução para trabalhar por muito tempo: mantém no mesmo chat as condições que determinam quando terminar.

Este guia explica quando usar o recurso, como os controles do aplicativo para desktop e da CLI diferem e o que verificar quando o trabalho para. Também esclarece por que o orçamento de tokens de um objetivo não equivale à cota restante do seu plano nem a um limite de cobrança.

Especificações verificadas: 7 de outubro de 2026. Esta explicação se baseia na documentação oficial da OpenAI. Não executamos o modo de objetivos para este artigo nem medimos sua duração, consumo ou efeito sobre os resultados.

1. O que /goal faz: solicitações comuns, /plan e dot

/goal define um objetivo contínuo em um chat do Codex. Se um teste falhar durante o processo, o Codex pode escolher a próxima ação com base nos critérios de conclusão originais. A OpenAI cita investigação de erros, melhorias de desempenho, migrações e pesquisa documental como exemplos nos quais a próxima etapa depende dos resultados da investigação.

A explicação oficial descreve um objetivo como um estado salvo no chat atual. Não é uma memória global aplicada automaticamente a outros chats nem uma regra para todo o repositório. O código, os testes e os documentos necessários ainda precisam estar acessíveis a partir desse chat. Fonte: OpenAI Cookbook: Using Goals in Codex.

Criar um plano, por si só, não inicia a continuação automática do modo de objetivos. Usar /goal também não garante uma revisão independente por outro modelo. Para entender a diferença em relação ao dot, consulte como usar o dot, seus preços e a delegação ao Codex. Para saber como fornecer informações, consulte engenharia de contexto.

2. Como começar no desktop, na CLI e no IDE

Embora compartilhem /goal, os controles após o início variam conforme a interface. O guia oficial de trabalhos prolongados explica como começar no desktop, na CLI e na extensão do IDE. A seção sobre a web descreve como informar ao ChatGPT Work o resultado, as restrições e os critérios de avaliação; isso não comprova que a interface web tenha o mesmo comando e os mesmos controles.

Para a CLI, o OpenAI Cookbook indica suporte ao Codex 0.128.0 ou posterior. A referência de configuração atual descreve features.goals como um recurso estável e habilitado por padrão. Não suponha que seja necessário adicionar à configuração instruções antigas para habilitar um recurso experimental. Se ele não aparecer, verifique a interface, a versão e as orientações oficiais atuais.

Fontes: Trabalhos prolongados, Comandos de barra do desktop e Referência de configuração. As instruções deste artigo explicam a função dos controles; não são uma lista de rótulos de botões verificados em cada versão do aplicativo.

3. Critérios de conclusão: tornar objetivos vagos verificáveis

«Deixe com alta qualidade» ou «continue até terminar» dificulta decidir o que conta como concluído. Os critérios de conclusão devem descrever resultados que você possa verificar. Especifique larguras de tela, comportamento após salvar, resultados de testes ou documentos a comparar.

Na CLI, o texto do objetivo deve conter de 1 a 4.000 caracteres. Em vez de inserir uma especificação longa inteira, indique um arquivo de especificações e mantenha no objetivo o resultado, as principais restrições e os critérios de verificação. Fornecer um arquivo não transfere automaticamente o histórico de outro chat. Fonte: Comandos de barra do Codex CLI.

Se a especificação ainda não estiver definida, você pode pedir primeiro: «Não implemente ainda. Esclareça os requisitos e prepare uma proposta de /goal». Depois de analisar com /plan, leia o objetivo proposto, verifique as restrições e o escopo e então comece.

4. Exemplos de instruções para erros, interfaces e pesquisa

As instruções abaixo foram criadas para este artigo. Não são exemplos de execuções bem-sucedidas que realizamos. Verifique primeiro se testes e um navegador estão disponíveis e inclua a exigência de informar como não realizadas as verificações indisponíveis.

Correção de erros: separar o problema reproduzido dos testes de regressão

/goal Corrija «desfazer exclusão» neste aplicativo de tarefas para permitir restaurar o último item excluído à posição e ao estado de conclusão originais.
Preserve o comportamento existente de adicionar itens, alternar a conclusão, excluir e salvar.
Reproduza o problema primeiro. Após corrigi-lo, verifique a posição restaurada, o estado de conclusão, a prevenção de restaurações duplicadas, exclusões consecutivas e o salvamento após a restauração.
Altere apenas os arquivos e testes relacionados. Não adicione dependências, publique externamente, faça push ou compras.
Se não puder executar uma verificação, informe o motivo e o ambiente necessário. Inclua no relatório final os arquivos alterados, os comandos executados e seus resultados e as verificações não realizadas.

Pedir apenas «passar nos testes» pode fazer uma alteração que remove funcionalidades parecer atender ao objetivo. Incluir o comportamento a preservar e o escopo permitido das alterações fornece critérios para escolher como corrigir o problema.

Melhorias de interface: especificar requisitos de exibição e interação

/goal Faça esta tela se adaptar às larguras de 390px e 1280px sem transbordamento horizontal, mantendo os botões de conclusão e exclusão utilizáveis com nomes longos de tarefas.
Não altere a estrutura de dados nem o formato de armazenamento existentes.
Verifique ambas as larguras em um navegador real disponível. Teste adicionar itens, alternar a conclusão, excluir, o salvamento após recarregar e a interação por teclado.
Se o teste no navegador não estiver disponível, não considere a inspeção de imagens ou código como aprovação da interação real. Informe essas verificações como não realizadas.
Não publique, faça push, realize compras ou altere configurações do dispositivo.

As larguras são condições de teste desta solicitação, não larguras de tela garantidas pelo produto. Distinga também os resultados de interações em um navegador real daqueles baseados apenas na inspeção de código ou imagens.

Pesquisa: preservar evidências em vez de preencher campos desconhecidos

/goal Compare as condições de retenção de dados, uso para treinamento e exclusão dos dois serviços indicados usando documentos oficiais públicos.
Relacione cada afirmação a uma URL de fonte e às condições do texto consultado, e produza uma tabela comparativa e uma explicação.
Para os pontos sem explicação encontrada após a pesquisa, identifique os documentos consultados e as informações ausentes. Não preencha a tabela com suposições.
Não faça login, altere configurações, conecte aplicativos, envie arquivos ou realize compras.
Ao final, apresente separadamente as especificações confirmadas, as interpretações e os pontos investigados que não conseguiu confirmar.

Decidir «continuar indefinidamente até encontrar todas as respostas» deixa a pesquisa sem ponto de chegada. Mesmo quando uma informação não é pública, você pode definir como resultado um relatório das fontes consultadas e das perguntas restantes.

5. Pausar, retomar, editar e remover um objetivo

No desktop, use a linha de progresso do objetivo acima do campo de mensagem. A documentação da CLI apresenta os comandos abaixo. Não interprete esta tabela da CLI como uma lista de ações dos botões do desktop.

Você pode fornecer informações ou restrições adicionais no mesmo chat durante o trabalho. Declare explicitamente mudanças de decisão, como «não publique ainda» ou «cancele as alterações desta função». Após editar o objetivo, verifique se os resultados dos testes anteriores bastam para demonstrar que os novos critérios de conclusão foram atendidos.

Fontes dos controles: Comandos de objetivos da CLI e Controles de objetivos do desktop.

6. Orçamentos de tokens, cotas de uso e preços

Para trabalhos contínuos, diferencie quando interromper o trabalho do objetivo de quanto ele consome da cota do plano. Mesmo com orçamento restante no objetivo, limites de uso da conta ou problemas no ambiente de execução podem impedir a continuação.

Usar /goal gera uma cobrança adicional?

Nos materiais oficiais de preços que consultamos, não encontramos uma cobrança independente por cada início de /goal. No entanto, o processamento repetido pelo modelo consome o uso normal do Codex. Ativar o modo de objetivos não torna os ciclos de testes, correções e verificações gratuitos e ilimitados.

A OpenAI explica que Work e Codex compartilham uma cota de uso e que o consumo varia conforme o modelo, a tarefa e outros fatores. Continuar com créditos adicionais após esgotar a cota do plano também precisa ser distinguido da cobrança separada com uma chave de API. Fonte: Preços e limites de uso do Work e Codex. Para escolher planos e entender as redefinições, consulte a comparação de preços e cotas de uso do ChatGPT Pro.

O que os números do orçamento permitem confirmar?

A documentação oficial do App Server para desenvolvedores lista o campo do objetivo tokenBudget, o campo de consumo tokensUsed e o campo de medição de tempo timeUsedSeconds. Isso confirma um mecanismo para registrar orçamento e progresso no estado interno do objetivo. Não é uma instrução para digitar os nomes desses campos RPC como opções da CLI destinadas ao usuário.

A mesma documentação explica que substituir um objetivo por outro redefine as medições de uso do objetivo. Isso não afirma que a cota restante do plano seja recuperada. Um campo de medição de tempo também não demonstra que seja possível garantir uma parada após duas horas. Fonte: Gestão de objetivos do App Server.

7. O que verificar quando o trabalho para

Um objetivo ativo não resolve automaticamente todas as interrupções. Verifique primeiro o objetivo atual e o último resultado e depois investigue nesta ordem.

Segundo o Cookbook, a continuação automática ocorre quando o chat está ocioso, o objetivo está ativo e dentro do orçamento e não há outros processamentos ou entradas do usuário pendentes. Trabalho apenas de planejamento não aciona a continuação, e interrupções pausam o objetivo. Se um turno de continuação não fizer nenhuma chamada a ferramentas, a próxima continuação automática é suprimida para evitar repetições improdutivas.

Ao atingir o orçamento, o projeto oficial interrompe o trabalho substantivo e informa progresso, obstáculos e próximas etapas. Esgotar o orçamento e alcançar o objetivo são coisas diferentes. Antes de retomar, verifique o trabalho restante e os custos previstos.

Iniciar /goal não amplia permissões nem recursos conectados. A documentação oficial informa que o recurso segue o sandbox e a política de aprovação existentes. Ele não transfere automaticamente o trabalho local para a nuvem. Se você prevê perder a conexão, a orientação é pausar e retomar quando o ambiente estiver disponível. Fonte: Permissões e condições de continuação para trabalhos prolongados.

Se aparecer um erro do modelo como «Selected model is at capacity», investigue conforme essa mensagem. A investigação e solução do erro at capacity do Codex explica isso separadamente dos limites de uso.

8. Evidências a verificar no relatório de conclusão

Uma resposta dizendo «concluído» não comprova que o resultado solicitado foi verificado. Procure evidências que correspondam ao objetivo original. Mesmo que os testes tenham passado, verificações de interação não realizadas não devem ser consideradas aprovadas.

Se faltarem evidências, envie uma instrução específica no mesmo chat: «teste o salvamento após recarregar» ou «mostre o texto original e as condições desta afirmação». Se adicionar critérios de conclusão, atualize também o objetivo. Se quiser que outro agente verifique o trabalho, solicite isso explicitamente à parte e diferencie a revisão baseada apenas no relatório do agente das verificações que realmente repetem a execução.

Você também pode pedir requisitos, implementação e verificação no desenvolvimento comum com Codex. O valor do modo de objetivos está em manter critérios de conclusão ao longo de várias etapas e usá-los para escolher o que fazer em seguida. Para as diferenças entre produtos e formas de execução, consulte a comparação entre Claude Code e Codex.

9. Antes de começar

Se uma alteração ou explicação bastar, uma solicitação comum é adequada. Considere /goal para trabalhos repetidos com os mesmos critérios de conclusão, quando a próxima etapa depende dos resultados da investigação. Escolha com base em resultados verificáveis, não no tempo de execução.

10. Perguntas frequentes

Posso deixar de enviar «continue» a cada vez?

Quando o objetivo está ativo e as condições de continuação automática são atendidas, o trabalho pode avançar à próxima etapa após um turno. Ainda pode parar por aprovação pendente, limite de orçamento ou um obstáculo. O recurso não elimina a necessidade de decisões humanas.

/goal funciona apenas na nuvem? Continua se eu fechar o PC?

Não é exclusivo da nuvem. Está documentado para desktop, Codex CLI e extensão do IDE. O ambiente necessário para continuar depende de onde o trabalho é executado. Definir um objetivo não comprova, por si só, que o trabalho continuará em um PC local desligado.

O orçamento de tokens garante um limite de cobrança?

Ele não pode ser garantido como um limite estrito de cobrança. O orçamento do objetivo é separado das cotas do plano, dos créditos adicionais e da cobrança da API. Nos materiais oficiais consultados, não encontramos uma explicação da relação exata entre os contadores do objetivo e o valor cobrado.

É o mesmo que usar o dot?

/goal gerencia um objetivo e a continuação dentro do mesmo chat do Codex. O dot também cuida da assistência contínua, da delegação a outras tarefas e da coordenação. Para um pequeno trabalho de desenvolvimento, uma solicitação direta ao Codex pode bastar. Escolha conforme sua finalidade e a quem deseja confiar a gestão do progresso.