Bateu o limite do Codex CLI no meio da tarefa? Como retomar a sessão sem reexplicar o projeto

Fala aí, beleza? Tu tá no meio de uma refatoração, o Codex CLI já entendeu o projeto inteiro e, do nada, a sessão trava

Pode ter sido o limite de uso da sua conta do ChatGPT ou a janela de contexto que lotou, e cada um pede uma saída diferente 🙂

O caminho aqui tem três partes: descobrir qual limite você bateu, deixar o essencial do projeto registrado fora do chat e voltar exatamente para a conversa certa. Só precisa do Codex CLI instalado e logado na sua conta

Qual limite você bateu: uso da conta ou janela de contexto?

São dois problemas diferentes que parecem iguais na hora do susto

O limite da conta é quanto do Codex o seu plano libera. O limite de contexto é quanto de conversa cabe na memória de trabalho do modelo naquela sessão

Como diagnosticar com o /status:

Dentro do Codex CLI, rode:

/status

Segundo a documentação de slash commands, ele mostra a configuração da sessão, o ID da conversa, o uso de contexto e o uso restante da conta com os horários de reset, incluindo as janelas de 5 horas e semanal

Aí fica fácil: se o contexto está lá em cima e a conta ainda tem saldo, o problema é a sessão. Se a conta zerou, é o plano

Como funciona o limite da conta em cada plano?

Pela página de pricing do Codex, os planos Plus e Business têm limite por janela de 5 horas e também limite semanal

Já os planos Pro hoje não têm limite de 5 horas, só o teto semanal

E as quantidades de mensagens que a OpenAI publica? São estimativas, não limites fixos. O consumo varia conforme o modelo escolhido e a complexidade da tarefa, então não adianta decorar número: confira o seu no /status 😉

O que fazer quando o contexto encheu:

Sessão longa demais acumula histórico até não caber mais

A saída é o /compact, que resume a conversa visível para liberar tokens da janela de contexto, mantendo os pontos principais

/compact

O que fazer quando a conta esgotou:

Aqui tu tem duas opções: esperar o reset da janela (o horário aparece no /status) ou, se estiver no Plus ou no Pro, comprar créditos adicionais para continuar sem trocar de plano

Detalhe importante da Central de Ajuda da OpenAI: o uso incluído no plano é consumido primeiro, e só depois entra o saldo de créditos

O saldo, o uso recente e a compra de créditos ficam no ChatGPT (web e app Codex), em Codex Settings > Usage. Ali também dá para ligar o Auto top-up (recarga automática) para usuários elegíveis

Tome cuidado! Esse painel é do ChatGPT, não é um comando do CLI. No terminal, quem te mostra o uso é o /status

Como evitar que aconteça de novo:

• Rode /status antes de começar uma tarefa longa e veja quanto sobra na janela de 5 horas e na semanal
• Use /compact em sessões extensas antes que o contexto lote

Como registrar o estado da tarefa no AGENTS.md antes de parar

O porquê vem antes do como: o histórico do chat é frágil, e se tu precisar abrir uma sessão nova, tudo que só existia ali some

O AGENTS.md resolve isso. Segundo as boas práticas do Codex, ele é um arquivo aberto, uma espécie de README para agentes, carregado automaticamente no contexto. É o lugar indicado para registrar como o Codex deve trabalhar no repositório

Se você conhece o README do projeto, a ideia é bem parecida, só que escrito para a IA ler 😀

1. Gere o arquivo inicial com /init. Se o projeto ainda não tem AGENTS.md, rode o comando abaixo na pasta do projeto e o Codex cria um arquivo inicial no diretório atual

/init

2. Entenda os níveis e coloque cada coisa no lugar certo. O AGENTS.md pode existir em vários níveis: um global em ~/.codex para padrões pessoais, um na raiz do repositório para o padrão do projeto e outros em subpastas para regras locais. Erro comum deste passo: jogar preferência pessoal no arquivo do repositório (ou regra do projeto no global) e misturar tudo

3. Escreva o essencial do projeto. O exemplo abaixo é didático, só para mostrar o tipo de conteúdo; adapte aos comandos e convenções reais do seu repositório:

# AGENTS.md

## Como trabalhar neste repositório
- Rode os testes antes de considerar uma tarefa concluída
- Siga o padrão de pastas já existente em src/
- Não altere arquivos de configuração sem pedir antes

## Tarefa em andamento
- Refatorando o módulo de autenticação
- Feito: extração do serviço de login
- Falta: atualizar os testes do fluxo de logout

A seção de tarefa em andamento é uma escolha prática, não um campo obrigatório: mantenha curta e apague quando terminar, porque o foco oficial do arquivo é como o Codex deve trabalhar no repo

4. Transforme erro repetido em regra. A própria OpenAI recomenda: se o Codex repetir o mesmo erro, peça uma retrospectiva e atualize o AGENTS.md. Assim a correção vale para as próximas sessões, e não só para aquela conversa

Erro comum: deixar todo o contexto só no chat e depender do histórico. O que entra automaticamente em qualquer sessão nova é o AGENTS.md, não a conversa antiga

Checagem: abra uma sessão nova do Codex no projeto e peça uma tarefa simples. Se ele seguir as instruções do arquivo, tá funcionando

Como retomar a sessão certa com codex resume

Agora a parte que mais gente procura: voltar para a conversa que parou, com o histórico todo, sem reexplicar nada

Tudo aqui está na página de features do Codex CLI

1. Abra o seletor de sessões. O comando abaixo mostra as sessões interativas recentes para tu escolher qual continuar. Por padrão, a lista se limita ao diretório atual

codex resume

2. Vá direto na mais recente. Se a sessão que caiu foi a última, o --last pula o seletor e reabre ela na hora

codex resume --last

3. Procure fora do diretório atual. Quando a sessão foi iniciada em outra pasta, use o --all para listar também essas. Erro comum deste passo: rodar codex resume em outro diretório, não achar a sessão e concluir que ela sumiu (ela só não aparece na lista padrão)

codex resume --all

4. Retome uma sessão específica pelo ID. O ID aparece no seletor, no /status ou nos arquivos em ~/.codex/sessions/. Por isso vale anotar o ID que o /status mostrou antes de parar

codex resume <SESSION_ID>

5. Troque de conversa sem sair do CLI. Já está dentro do Codex? O /resume reabre uma conversa salva e recarrega o histórico da conversa escolhida para continuar de onde parou, sem alterar o histórico original

/resume

6. Retome automações também. Execuções não interativas (scripts, CI e etc) têm o próprio comando de retomada

codex exec resume --last
codex exec resume <SESSION_ID>

Checagem final: na sessão retomada, rode /status e confira se o ID é o da conversa que tu queria e como está o uso de contexto. Se o contexto já estiver alto, vale um /compact antes de seguir

O que muda nos limites do Codex em dezembro de 2026

A OpenAI anunciou na Central de Ajuda, na página de limites de uso atualizada em 31/10/2026, que a partir de dezembro de 2026 os planos Plus, Pro e Business terão uma cota única medida em tokens, compartilhada entre ChatGPT e Codex

O chat Instant não entra na conta. A mudança foi noticiada pelo AlternativeTo

Na prática: quem usa muito o ChatGPT no dia a dia vai ver isso pesar no que sobra para o Codex

Ainda não há detalhe oficial de como a cota unificada vai aparecer no CLI nem se as janelas de 5 horas e semanal mudam, então o hábito de checar o /status antes de tarefa longa fica ainda mais importante

Quer ver o Codex CLI em ação?

Se tu curte aprender vendo, o vídeo abaixo mostra o Codex CLI rodando na prática 😀

Próximo passo: deixar o projeto pronto para a próxima interrupção

Abre o projeto hoje e cria (ou revisa) o AGENTS.md: o jeito de trabalhar no repo, os comandos que o agente deve rodar e uma linha sobre a tarefa em andamento

Depois anota num canto o codex resume --last e o hábito de pegar o ID no /status antes de parar. Na próxima trava, são dois minutos para voltar ao ponto

Se tu alterna entre agentes, se liga que cada um tem seus próprios comandos e arquivo de contexto. Para o lado da Anthropic, o caminho está no post sobre o limite de uso do Claude Code, e a mesma lógica aplicada ao Google está em retomar sessão no Gemini CLI

Até o próximo post! 🙂

Quer aprender mais sobre inteligência artificial e programação na prática? Conheça o canal Hora de Codar no YouTube e acompanhe os próximos vídeos.