A OpenAI lançou o GPT-5.5 em 23 de abril de 2026 e, como parte do lançamento, disponibilizou o Codex para todos os planos do ChatGPT, incluindo Free e Go, por tempo limitado. Essa única frase no anúncio é o caminho gratuito mais rápido para o novo modelo: instale o Codex CLI, faça login com uma conta ChatGPT e utilize o GPT-5.5 a partir do terminal sem chave de API e sem cartão de crédito.
Este guia aborda a instalação, as opções de autenticação, a troca de modelo, os limites que você encontrará e como integrar o Codex em um fluxo de trabalho de codificação real. Para uma visão geral do modelo subjacente, consulte O que é GPT-5.5. Para outros caminhos gratuitos (créditos de teste, agregadores), consulte nosso guia GPT-5.5 gratuito.
TL;DR
- O Codex CLI executa o GPT-5.5 em seu repositório local com uma janela de contexto de 400 K.
- ChatGPT Free, Go, Plus, Pro, Business, Enterprise e Edu todos têm acesso ao Codex; Free e Go são por **tempo limitado**.
- Instale com
npm install -g @openai/codexoubrew install codex. - Faça login via ChatGPT OAuth em um navegador, ou use o fluxo de código do dispositivo em máquinas sem tela.
- Troque de modelo no meio da sessão com
/model gpt-5.5; verifique a cota com/status. - Emparelhe o CLI com Apidog para que as chamadas de API que você eventualmente executará em produção sejam pré-construídas e testadas.
Por que o Codex é o caminho gratuito mais fácil
A API da OpenAI tem um padrão apenas pago; o GPT-5.5 no endpoint de Respostas custa $5 por milhão de tokens de entrada e $30 por milhão de tokens de saída assim que for disponibilizado geralmente. O Codex contorna isso encapsulando o mesmo modelo em um CLI que autentica com uma conta ChatGPT em vez de uma chave de API. O nível do plano determina o limite de taxa; o modelo em execução por baixo é o verdadeiro GPT-5.5.
Instalar o Codex CLI
Duas formas de instalação suportadas.
# npm (multiplataforma)
npm install -g @openai/codex
# ou Homebrew (macOS / Linux)
brew install codex
Verifique a instalação:
codex --version
Você deve ver uma versão igual ou superior a 0.28.0; versões mais antigas não listam o GPT-5.5 no seletor de modelos.
Autenticar com uma conta ChatGPT
Execute o CLI pela primeira vez e ele solicitará um método de login.
OAuth do Navegador (máquinas locais)
codex
Uma aba do navegador se abrirá. Faça login com o mesmo e-mail que você usa para o ChatGPT. O CLI armazena a sessão em cache para que as execuções subsequentes ignorem o prompt.
Fluxo de Código do Dispositivo (máquinas sem tela, servidores remotos)
codex login --device-auth
O terminal mostra um código curto e uma URL. Abra a URL em qualquer outro dispositivo, cole o código, confirme. A máquina sem tela conclui o login quando a confirmação é realizada.
Fallback de Chave de API
Se você já tem uma chave de API paga e a prefere:
printenv OPENAI_API_KEY | codex login --with-api-key
Este caminho cobra a conta de faturamento da chave em vez do plano ChatGPT. Use-o se você deseja o Codex, mas quer que o uso seja atribuído à organização de API paga de uma equipe.
Escolha o GPT-5.5 como modelo
O Codex padroniza para o que a OpenAI marca como “recomendado” para o seu plano. Em todos os planos pagos, isso já é gpt-5.5. Nos planos Free e Go, você pode precisar mudar manualmente.
Durante a sessão
/model gpt-5.5
O CLI exibe o modelo ativo e os limites de taxa específicos do plano.
Pela flag de inicialização
codex --model gpt-5.5
Verificar cota restante
/status
A saída mostra os orçamentos semanais de mensagens, a janela de contexto e o tempo de expiração da janela de teste atual de Free/Go, caso você esteja em um desses planos.
Primeira sessão: um exemplo realista
O Codex inicia em uma interface de terminal em tela cheia que pode ler seu repositório, executar comandos e editar arquivos. Uma primeira sessão normal se parece com isto:
cd ~/Projects/my-app
codex --model gpt-5.5
Dentro da sessão:
> Read README.md, then open scripts/deploy.sh and summarize what it does in five bullets.
O Codex abre o arquivo, resume e imprime os itens. Acompanhamento:
> Refactor deploy.sh so it exits on any failed step, and add a dry-run flag. Keep backwards compatibility.
O GPT-5.5 propõe uma diferença (diff), aguarda aprovação e a aplica. Execute testes inline:
> Run the deploy test suite and show me the failing case.
O CLI transmite a saída do teste de volta para a sessão. Se algo falhar, peça ao modelo para corrigir; o loop continua até ficar verde.
Esta é a carga de trabalho para a qual o GPT-5.5 é ajustado. A publicação de lançamento da OpenAI coloca a pontuação SWE-bench em 88,7%, um aumento em relação aos 74% no GPT-5.4; o salto aparece exatamente neste trabalho de múltiplos arquivos, uso de ferramentas e dirigido por terminal.
O que o Codex oferece que as chamadas de API brutas não oferecem
Quatro coisas que o CLI encapsula em torno do modelo:
- Contexto do repositório. O Codex lê a árvore de arquivos, indexa arquivos relevantes e fornece ao modelo handles de arquivo em vez de conteúdo colado. A janela de contexto de 400 K permanece em grande parte vazia para chamadas de ferramentas e saída.
- Execução de comandos com aprovações. O modelo sugere um comando; você aprova antes que ele seja executado. Este é o controle de segurança que impede que a codificação agentic inunde seu shell.
- Pré-visualizações de diff antes de escritas. Cada edição de arquivo é pré-visualizada como um diff unificado; rejeite, aceite ou edite antes de confirmar.
- Persistência de sessão. Cada projeto recebe um histórico de sessão. Reabra o CLI amanhã e o contexto será retomado de onde você parou.
Sem o Codex, você teria que reconstruir cada um desses recursos por conta própria, usando a API de Respostas. Nosso guia da API GPT-5.5 mostra a versão bare-metal, se desejar, mas para a codificação diária, o CLI se destaca em ergonomia.
Limites de taxa e tetos por plano
Os números exatos variam, mas a estrutura em 23 de abril de 2026 é a seguinte.
| Plano | Acesso GPT-5.5 no Codex | Teto semanal |
|---|---|---|
| Free | Sim (tempo limitado) | Apertado; tamanho de protótipo |
| Go | Sim (tempo limitado), 2× limites Free | Pequeno |
| Plus | Sim | Médio |
| Pro | Sim, maiores tetos para usuários solo | Alto |
| Business | Sim, baseado em assento | Alto por assento |
| Enterprise / Edu | Sim, baseado em contrato | Personalizado |
Quando você atinge o teto, o Codex retorna um erro específico do plano em vez de degradar silenciosamente. /status mostra a contagem exata restante.
Integração com Editor e IDE
O mesmo login do Codex suporta a extensão VS Code, o plugin JetBrains e o aplicativo em nuvem do Codex. Após fazer login via CLI, a extensão da IDE reutiliza as credenciais em cache; sem segundo login.
Para usuários Apidog, o emparelhamento útil é:
- Prototipe uma requisição dentro do Codex CLI (
execute o prompt GPT-5.5 contra este arquivo). - Exporte o prompt e a saída estruturada para uma coleção Apidog para compartilhar com colegas de equipe.
- Troque o caminho do Codex por uma chamada de API direta assim que o contrato se estabilizar e você passar para uma chave paga.
Consulte Apidog no VS Code para saber como integrar a coleção no mesmo editor em que você está executando o Codex.
Mantendo o fluxo de trabalho seguro nos planos Free e Go
Duas salvaguardas que valem a pena configurar no primeiro dia:
- Sempre aprovar escritas de arquivo. Em
~/.codex/config.json, defina"autoApproveWrites": false. O padrão já é seguro no Free, mas em algumas configurações Go-tier, o Codex aplicará automaticamente as diferenças que considera triviais. - Delimitar o espaço de trabalho. Execute
codexapenas a partir do diretório do projeto. O escopo de leitura do CLI começa a partir do diretório de trabalho; abri-lo em~concede acesso a toda a pasta inicial.
A OpenAI submeteu o GPT-5.5 a uma revisão de segurança por terceiros antes do lançamento, e a cobertura do lançamento da CNBC detalha os testes de segurança cibernética (red-teaming). Mesmo assim, o CLI ainda está sendo executado em sua máquina; as regras usuais sobre a revisão de diferenças (diffs) antes de aplicá-las ainda se aplicam.
Quando sair do caminho gratuito
A formulação “tempo limitado” no anúncio da OpenAI significa que o Codex Free e Go eventualmente exigirão uma atualização. Três gatilhos para planejar:
- Cota excedida semanalmente. Você está fazendo trabalho real; hora de mudar para Plus ou Pro.
- Você quer a API direta. Sua carga de trabalho cresceu além do CLI; o guia da API GPT-5.5 aborda a migração.
- Sua equipe precisa de faturamento por assento. Business ou Enterprise via a análise de preços.
Cada migração mantém o modelo subjacente o mesmo; apenas o faturamento e a interface mudam.
FAQ
O Codex também executa o GPT-5.5 Pro? O Pro não está atualmente exposto dentro do Codex. O CLI usa o modelo padrão GPT-5.5 em todos os planos; o Pro permanece no ChatGPT e (eventualmente) na API direta.
Posso usar o Codex sem uma conta ChatGPT? Não. Ou um login no ChatGPT ou uma chave de API da OpenAI; o Codex precisa de um deles. O caminho gratuito depende do login no ChatGPT.
Por quanto tempo durará o acesso Free e Go? A OpenAI o chamou explicitamente de “por tempo limitado”. Considere algumas semanas a alguns meses e planeje fazer um upgrade se o uso aumentar.
O Codex funciona offline? Não. Toda chamada GPT-5.5 é uma viagem de ida e volta à infraestrutura da OpenAI.
Qual a diferença entre isso e o aplicativo web do ChatGPT? O Codex é executado em uma sessão de terminal com seu sistema de arquivos local, acesso ao shell e contexto de repositório. O aplicativo web não possui nenhum desses recursos.