A OpenAI lançou o GPT-5.5 em 23 de abril de 2026 e, junto com o lançamento, liberou o Codex para todos os planos do ChatGPT, incluindo Free e Go, por tempo limitado. O caminho gratuito mais rápido para acessar o novo modelo é instalar o Codex CLI, autenticar com sua conta ChatGPT e usar o GPT-5.5 direto do terminal, sem precisar de chave de API ou cartão de crédito.
Este tutorial mostra como instalar, autenticar, trocar de modelo, acompanhar limites e integrar o Codex em um fluxo de trabalho real de desenvolvimento. Para detalhes do modelo, confira O que é GPT-5.5. Para outros métodos gratuitos, veja nosso guia GPT-5.5 gratuito.
TL;DR
- Codex CLI roda o GPT-5.5 no seu repositório local, com janela de contexto de 400K.
- Todos os planos ChatGPT (Free, Go, Plus, Pro, Business, Enterprise, Edu) têm acesso ao Codex; Free e Go são temporários.
- Instale com
npm install -g @openai/codexoubrew install codex. - Login via OAuth (navegador) ou fluxo de código do dispositivo (máquinas sem tela).
- Troque de modelo com
/model gpt-5.5; cheque limites com/status. - Combine com Apidog para pré-construir e testar chamadas de API para produção.
Por que o Codex é o caminho gratuito mais fácil
A API da OpenAI é paga por padrão; o GPT-5.5 no endpoint de Respostas custa $5/milhão tokens de entrada e $30/milhão de saída. O Codex contorna isso: encapsula o modelo em um CLI autenticado com sua conta ChatGPT. O plano do usuário define o limite de uso; o modelo é o GPT-5.5 real.
Instalar o Codex CLI
Instale de uma das formas abaixo:
# npm (multiplataforma)
npm install -g @openai/codex
# ou Homebrew (macOS / Linux)
brew install codex
Verifique a instalação:
codex --version
A versão deve ser >= 0.28.0; versões anteriores não listam o GPT-5.5.
Autenticar com uma conta ChatGPT
Execute o CLI na primeira vez para iniciar o login.
OAuth via navegador (máquinas locais)
codex
Uma aba do navegador será aberta. Faça login com seu e-mail do ChatGPT. O CLI armazena a sessão para as próximas execuções.
Fluxo de código do dispositivo (máquinas sem tela/servidores)
codex login --device-auth
O terminal exibe um código e uma URL. Abra a URL em outro dispositivo, cole o código e confirme. O login é concluído automaticamente na máquina remota.
Fallback: chave de API
Se preferir usar uma chave paga:
printenv OPENAI_API_KEY | codex login --with-api-key
Esse método debita o uso na conta da chave, não do plano ChatGPT. Ideal para times com organização paga.
Escolha o GPT-5.5 como modelo
O Codex seleciona automaticamente o modelo “recomendado”; nos planos pagos, já é o gpt-5.5. Em Free e Go, você pode precisar trocar manualmente.
Durante a sessão
/model gpt-5.5
Pela flag ao iniciar
codex --model gpt-5.5
Verificar cota restante
/status
Mostra orçamentos semanais de mensagens, janela de contexto e validade do acesso Free/Go.
Primeira sessão: exemplo prático
O Codex abre uma interface de terminal fullscreen, lê o repositório, executa comandos e edita arquivos. Exemplo de uso:
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 resume o arquivo e imprime os itens. Em seguida:
> Refactor deploy.sh so it exits on any failed step, and add a dry-run flag. Keep backwards compatibility.
O GPT-5.5 sugere um diff, aguarda aprovação e aplica. Teste inline:
> Run the deploy test suite and show me the failing case.
O CLI traz a saída dos testes. Se falhar, peça ajustes ao modelo até passar.
O GPT-5.5 foi ajustado para esse ciclo: múltiplos arquivos, uso de ferramentas, comandos no terminal. Veja a publicação de lançamento da OpenAI para benchmarks.
O que o Codex entrega além da API bruta
O CLI encapsula:
- Contexto do repositório: Lê a árvore de arquivos, indexa e passa handles em vez de colar conteúdo. A janela de contexto de 400K fica disponível para ferramentas e output.
- Execução de comandos com aprovação: O modelo sugere comandos, você aprova antes de rodar (controle de segurança).
- Pré-visualização de diff: Cada edição é apresentada como diff unificado para aceitar/rejeitar/editar.
- Persistência de sessão: O histórico fica salvo por projeto; reabra e continue de onde parou.
Sem o Codex, você teria que implementar cada recurso manualmente usando a API. Veja o guia da API GPT-5.5 para a versão bare-metal, mas para o dia a dia, o CLI é mais ergonômico.
Limites de taxa e tetos por plano
Estrutura vigente em abril/2026:
| Plano | Acesso GPT-5.5 no Codex | Teto semanal |
|---|---|---|
| Free | Sim (tempo limitado) | Apertado; protótipo |
| Go | Sim (tempo limitado), 2× limites Free | Pequeno |
| Plus | Sim | Médio |
| Pro | Sim, tetos maiores (solo) | Alto |
| Business | Sim, por usuário | Alto por assento |
| Enterprise / Edu | Sim, por contrato | Personalizado |
Ao atingir o teto, o Codex retorna erro explícito. Use /status para rastrear o saldo.
Integração com Editor e IDE
O login do Codex também vale para a extensão VS Code, plugin JetBrains e app cloud do Codex. Após o login no CLI, a IDE reutiliza as credenciais — sem novo login.
Para usuários Apidog:
- Prototipe uma requisição no Codex CLI (
execute o prompt GPT-5.5 contra este arquivo). - Exporte prompt e resposta para uma coleção Apidog e compartilhe.
- Troque o Codex por uma chamada de API direta quando passar para uma chave paga.
Veja Apidog no VS Code para integrar tudo no mesmo editor.
Segurança nos planos Free e Go
Duas configurações para proteger seu fluxo de trabalho logo no início:
-
Sempre aprove escritas de arquivos. Em
~/.codex/config.json, defina"autoApproveWrites": false. O padrão já é seguro no Free, mas no Go algumas edições triviais podem ser aplicadas automaticamente. -
Delimite o workspace. Execute o Codex a partir do diretório do projeto. O CLI lê a partir do diretório atual; rodar em
~dá acesso à sua home inteira.
O GPT-5.5 passou por auditoria de segurança, veja detalhes. Mesmo assim, revise sempre o diff antes de aplicar.
Quando migrar do caminho gratuito
O acesso Free/Go é temporário. Planeje migrar quando:
- Estourar a cota semanal — para trabalho real, mude para Plus ou Pro.
- Precisar da API direta — para cargas maiores, siga o guia da API GPT-5.5.
- Faturamento por assento — para equipes, confira a análise de preços.
A migração mantém o mesmo modelo; muda só a interface e o faturamento.
FAQ
O Codex roda o GPT-5.5 Pro?
Não. O CLI usa o GPT-5.5 padrão; o Pro está só no ChatGPT web e, futuramente, na API.
Posso usar o Codex sem conta ChatGPT?
Não. É necessário login ChatGPT ou chave de API. O acesso gratuito depende do login.
Por quanto tempo dura o Free/Go?
A OpenAI avisou que é “por tempo limitado” — conte algumas semanas/meses e planeje migrar.
O Codex funciona offline?
Não. Cada chamada vai para a infraestrutura da OpenAI.
Qual a diferença para o ChatGPT web?
O Codex roda no seu terminal, acessa sistema de arquivos, shell e contexto de repositório — o web não.


Top comments (0)