Como usar GPT-5.6 no Codex

Em 9 de julho de 2026, a OpenAI disponibilizou o GPT-5.6 geralmente para todos através do ChatGPT, Codex e da API, com um lançamento global ao longo de aproximadamente 24 horas. Para quem usa o Codex, isso trouxe uma nova família de modelos padrão: Sol, Terra e Luna, seis níveis de esforço de raciocínio e um modo Ultra que executa quatro agentes em paralelo.

Experimente o Apidog hoje

Se você usa o Codex na nuvem, na IDE ou pelo Codex CLI, agora precisa tomar decisões que antes não existiam: qual modelo usar, qual esforço de raciocínio aplicar e quando o modo Ultra justifica o consumo adicional de tokens.

Este guia mostra como selecionar Sol, Terra ou Luna para tarefas de codificação agêntica, quando usar o modo Ultra e como validar o código de API gerado pelo Codex com o Apidog.

Resumo

• O GPT-5.6 chegou ao Codex em GA em 9 de julho de 2026. Sol, Terra e Luna são selecionáveis conforme o plano ChatGPT.
• Sol é o modelo para raciocínio profundo; Terra é o padrão equilibrado; Luna prioriza velocidade, custo e volume.
• O modo Ultra executa quatro agentes em paralelo e está disponível no Codex a partir do plano Plus.
• Segundo a OpenAI, o Ultra eleva o resultado no Terminal-Bench 2.1 de 88,8% para 91,9%.
• Use Ultra em refatorações amplas e tarefas paralelizáveis, não em correções pequenas de um arquivo.
• Os seis níveis de esforço permitem ajustar profundidade de raciocínio, latência e uso de tokens por tarefa.
• O GPT-5.6 tende a produzir respostas mais curtas que o GPT-5.5; revise diretivas antigas como “seja conciso”.
• Valide endpoints e integrações gerados pelo Codex antes do merge usando o Apidog.

O que chegou ao Codex em 9 de julho

O lançamento GA trouxe a família completa GPT-5.6 para o Codex. O seletor de modelos passou a listar a nova geração, limitada pelos recursos do seu plano ChatGPT. No mesmo dia, Sol, Terra e Luna também chegaram ao GitHub Copilot.

Três pontos são importantes:

O número identifica a geração; os nomes identificam os níveis.

• gpt-5.6-sol é o modelo principal, voltado a raciocínio profundo.
• O alias padrão gpt-5.6 aponta para Sol.
• gpt-5.6-terra é o modelo equilibrado, posicionado como competitivo com o GPT-5.5 por aproximadamente metade do preço.
• gpt-5.6-luna é o modelo mais rápido e econômico, voltado a tarefas de alto volume e baixa latência.

Ultra é um modo de execução, não um modelo.

Ele distribui uma tarefa entre quatro agentes paralelos e consolida os resultados. No Codex, está disponível a partir do plano Plus.

Esforço de raciocínio virou um controle de primeira classe.

Agora há seis níveis: nenhum, baixo, médio, alto, xalto e máximo. Isso permite escolher explicitamente quanto raciocínio uma tarefa merece.

Seus arquivos de instruções, configurações de aprovação e fluxo de trabalho do Codex continuam os mesmos. A principal mudança está nos modelos e controles disponíveis.

Escolhendo Sol, Terra ou Luna para codificação

A escolha não deve ser “qual modelo é melhor?”, mas sim:

Qual modelo oferece profundidade suficiente para esta tarefa sem desperdiçar tempo e tokens?

Modelo	Ponto ideal para codificação	Quando usar
gpt-5.6-sol	Trabalho agêntico em várias etapas, depuração em vários arquivos, mudanças de arquitetura e cadeias longas de ferramentas	Quando a tarefa levaria horas ou quando errar é caro
gpt-5.6-terra	Funcionalidades, testes, revisões, refatorações médias e trabalho diário	Como modelo padrão para a maioria das sessões
gpt-5.6-luna	Boilerplate, scripts rápidos, mensagens de commit e primeiros rascunhos	Quando velocidade é mais importante que profundidade

Para começar, use esta estratégia:

Tarefa pequena e mecânica?     → Luna
Tarefa cotidiana de produto?   → Terra
Problema complexo ou amplo?    → Sol

Segundo os números de lançamento da OpenAI, Sol alcança 88,8% no Terminal-Bench 2.1, chegando a 91,9% com o modo Ultra. Esses números são relatados pelo fornecedor e exigem validação independente.

Também vale observar que nenhum modelo domina todos os benchmarks. No SWE-Bench Pro, o relatório da OpenAI mostra Claude Fable 5 à frente, com 80,3% contra 64,6% do Sol.

Consulte os documentos da OpenAI sobre os modelos atuais para confirmar IDs e disponibilidade em cada interface.

Evite usar Sol com esforço máximo para tudo. Em tarefas comuns, Terra normalmente entrega o resultado necessário com menor custo e menor tempo de espera.

Modo Ultra no Codex

O modo Ultra executa quatro agentes em paralelo e combina os resultados. Ele existe principalmente para reduzir o tempo total de tarefas grandes, não para melhorar automaticamente qualquer correção de código.

Quando usar Ultra

Use Ultra quando houver trabalho que possa ser dividido em frentes independentes:

• Refatorações que afetam muitos arquivos.
• Migrações de framework ou versão de API.
• Atualizações com muitos pontos de chamada semelhantes, mas não idênticos.
• Depuração urgente em que várias hipóteses precisam ser investigadas ao mesmo tempo.

Exemplo de prompt adequado para Ultra:

Migre o módulo de autenticação de JWT próprio para o novo SDK.

Divida o trabalho em:
1. Mapear todos os consumidores do token atual.
2. Atualizar middleware e validação de claims.
3. Atualizar clientes HTTP e testes de integração.
4. Identificar mudanças de configuração e documentação.

Quando não usar Ultra

Prefira uma execução única, normalmente com Sol, quando a tarefa for serial ou pequena:

• Correção em um único arquivo.
• Ajuste pontual em um endpoint.
• Tarefa em que cada etapa depende estritamente da anterior.
• Trabalho próximo do limite de uso ou da janela de cobrança.

O modo Ultra consome os limites de uso do Codex mais rapidamente porque quatro agentes processam a tarefa.

A melhor forma de pensar no Ultra é como uma alavanca de tempo:

• Sol único: menor consumo, execução mais linear.
• Ultra: maior consumo, potencialmente menor tempo de conclusão em trabalhos paralelizáveis.

Para uma análise detalhada de prompts e divisão de tarefas, veja como funciona o modo Ultra do GPT-5.6.

Ajustando o esforço de raciocínio

O GPT-5.6 oferece seis níveis de esforço:

nenhum → baixo → médio → alto → xalto → máximo

Use o esforço como um controle de orçamento: mais esforço pode melhorar a investigação e o planejamento, mas aumenta tempo e uso de tokens.

Esforço	Tarefas recomendadas
Nenhum / baixo	Renomeações, formatação, edições mecânicas e testes baseados em modelos claros
Médio	Funcionalidades padrão, revisões de código e endpoints diretos
Alto	Depuração em vários arquivos, investigação de desempenho e bases desconhecidas
Xalto / máximo	Condições de corrida, corrupção de memória e bugs persistentes

Uma configuração inicial prática:

Luna:  baixo
Terra: médio
Sol:   alto

Antes de aumentar esforço, teste primeiro o nível atual e um nível abaixo. O GPT-5.6 pode alcançar resultados equivalentes aos da geração anterior com menos esforço, liberando margem no seu limite de uso.

Também revise seus arquivos de instruções. Como o GPT-5.6 já tende a responder de forma mais curta que o GPT-5.5, remova diretivas redundantes como:

Seja conciso.
Pule o preâmbulo.
Não explique.

Empilhar regras de brevidade pode produzir diffs curtos demais e pouco justificados.

O que cada plano ChatGPT recebe no Codex

A disponibilidade depende do plano e pode mudar. Este é um instantâneo baseado no centro de ajuda da OpenAI.

Plano	Modelos GPT-5.6	Modo Ultra no Codex	Observações
Gratuito / Go	Terra no ChatGPT	Não	Codex não está incluído nos níveis gratuitos
Plus	Sol, Terra e Luna	Sim	Sol com esforço médio e superior; controle de esforço por modelo
Pro	Sol, Terra, Luna e Sol Pro	Sim	Limites maiores; Ultra também no ChatGPT Work
Empresarial / Enterprise	Sol, Terra, Luna e Sol Pro	Sim	Ultra via ChatGPT Work; controles administrativos

Duas conclusões práticas:

1. O plano Plus já fornece o seletor completo de modelos e o modo Ultra no Codex.
2. A diferença principal entre Plus e Pro para codificação está em limites de uso e Sol Pro, não no acesso básico aos três modelos.

Para uso via API, o texto original indica os seguintes preços por milhão de tokens de entrada/saída:

Modelo	Entrada	Saída
Sol	US$ 5	US$ 30
Terra	US$ 2,50	US$ 15
Luna	US$ 1	US$ 6

Verifique o código gerado pelo Codex com o Apidog

Grande parte do código produzido por agentes envolve APIs:

• Manipuladores de rota.
• Clientes HTTP.
• Consumidores de webhook.
• Fixtures de teste.
• Validação de payloads.
• Integrações com serviços externos.

O Codex pode acelerar a produção desse código, mas não elimina a necessidade de verificar contratos, status HTTP, schemas e casos de borda.

Use este fluxo de trabalho:

1. Forneça a especificação OpenAPI ao Codex

Inclua sua especificação no repositório ou aponte para ela nas instruções do agente.

Use `openapi.yaml` como fonte de verdade.
Não invente campos, endpoints, parâmetros ou códigos de status.
Atualize os testes de integração para refletir a especificação.

Isso reduz o risco de o agente adivinhar nomes de campos ou formatos de payload.

2. Gere a integração

Deixe o Codex implementar rotas, clientes, testes e adaptadores. Para esse tipo de trabalho, Terra ou Sol com esforço médio a alto são boas opções.

Exemplo:

Implemente o cliente para POST /v1/orders conforme openapi.yaml.

Requisitos:
- Validar campos obrigatórios.
- Mapear respostas 201, 400 e 422.
- Adicionar testes para payload válido e inválido.
- Não alterar o contrato OpenAPI.

3. Teste os endpoints antes do merge

Importe a mesma especificação no Apidog e valide os endpoints que o Codex gerou ou consome.

Verifique principalmente:

• Códigos de status.
• Headers obrigatórios.
• Schemas de resposta.
• Tipos de conteúdo.
• Campos renomeados.
• Valores nulos e opcionais.
• Casos de borda.

Um teste guiado por especificação ajuda a encontrar incompatibilidades introduzidas silenciosamente pelo agente.

4. Simule APIs ainda não implantadas

Se o Codex estiver construindo contra uma API que ainda não existe em produção, crie um mock baseado na especificação. Assim, a integração é testada contra contratos reais antes do backend final estar disponível.

Se quiser colocar essa validação dentro do loop do agente, conecte o Apidog CLI ao Codex para executar conjuntos de testes de API durante a própria tarefa. Veja o passo a passo em como usar o Apidog CLI no Codex.

O que ainda está em adaptação

O GPT-5.6 no Codex é recente, então vale acompanhar alguns pontos:

• Irregularidade no lançamento: o GA foi distribuído ao longo de aproximadamente 24 horas. Algumas regiões ou interfaces podem atualizar em ritmos diferentes.
• Especificações ainda relatadas: a janela de contexto de 1 milhão de tokens e saída máxima de 128 mil tokens são informações reportadas em cobertura inicial, não uma folha de especificações confirmada.
• Benchmarks fornecidos pelo fornecedor: resultados como Terminal-Bench são divulgados pela própria OpenAI; avaliações independentes podem trazer outra perspectiva.
• Detalhes de planos podem mudar: a OpenAI costuma ajustar limites e disponibilidade após lançamentos.

Não é necessário esperar para experimentar. Execute algumas tarefas representativas do backlog com diferentes combinações de modelo e esforço antes de definir o padrão da equipe.

FAQ

Qual modelo GPT-5.6 devo usar como padrão no Codex?

Use Terra como padrão. Ele é voltado ao trabalho cotidiano de funcionalidades, testes, revisões e refatorações médias.

Mude para Sol quando a tarefa envolver muitos arquivos, arquitetura complexa ou longas cadeias de raciocínio. Use Luna para boilerplate, scripts rápidos e tarefas mecânicas.

Posso usar GPT-5.6 no Codex sem um plano pago?

Não diretamente. O Codex requer um plano pago do ChatGPT, e o acesso gratuito ao GPT-5.6 no ChatGPT é limitado ao Terra.

A API não tem a mesma restrição de plano. Para alternativas de teste e baixo custo, consulte como usar o Codex gratuitamente.

O modo Ultra consome meus limites mais rapidamente?

Sim. O modo Ultra executa quatro agentes em paralelo, então uma única tarefa pode consumir várias vezes mais tokens que uma execução normal.

Reserve-o para tarefas grandes que possam ser divididas entre agentes.

Ultra é o mesmo que Sol Pro?

Não.

• Sol Pro é uma configuração de raciocínio com foco em qualidade em um único modelo.
• Ultra é um modo multiagente que paraleliza o trabalho.

Sol Pro busca uma resposta melhor. Ultra busca reduzir o tempo de execução de tarefas grandes.

Próximos passos

Uma configuração prática para a maioria dos desenvolvedores é:

Padrão: Terra com esforço médio
Tarefas difíceis: Sol com esforço alto
Refatorações amplas e urgentes: modo Ultra
Tarefas rápidas e repetitivas: Luna com esforço baixo

Independentemente do modelo escolhido, trate a saída do agente como código que precisa de revisão e validação. Forneça a especificação OpenAPI ao Codex, gere a integração com base no contrato e valide cada endpoint no Apidog antes do merge.

Gerar código mais rápido só é útil quando a verificação acompanha o mesmo ritmo.