Limite de uso do Codex atingido: como saber qual teto você bateu e o que fazer até o reset

Fala aí, beleza? Tu tá no meio de uma refatoração com o Codex, o agente tá indo bem e, do nada, ele para e avisa que o uso acabou 😛

Este guia é pra quem usa o Codex logado com a conta do ChatGPT, seja no CLI, na extensão de IDE, no app ou na web (e se bater dúvida na hora de logar, confira se está no site oficial do ChatGPT)

Um detalhe confunde muita gente: a cota do Codex é a mesma do ChatGPT Work, do ChatGPT for Excel e dos Workspace Agents, quando eles existem no seu plano

Já o chat comum fica de fora: conversar no ChatGPT normal não gasta essa cota, segundo a central de ajuda da OpenAI

Como identificar o teto que bloqueou o Codex: janela de 5 horas, semanal ou saldo de créditos

O jeito de saber qual teto fechou é olhar o painel de uso, que mostra a cota restante e o horário de cada reset

No ChatGPT desktop ele fica em Settings → Usage, e no app do Codex se chama Usage & Billing (fonte)

No CLI tu tem dois comandos: /status mostra o ID do chat, o uso de contexto e os limites de uso, e /usage mostra a atividade de tokens, os limites e os créditos de reset disponíveis (referência do CLI)

E se liga: a cota não equivale a um número fixo de mensagens ou tarefas

Quanto trabalho ela cobre depende do plano, do modelo, da tarefa e das configurações, então não adianta contar prompts

As fontes desses dados são a página de preços do Codex e as páginas da central de ajuda da OpenAI sobre os planos Pro, os resets pagos e o rate card do Codex

O aviso de bloqueio aparece no alerta de uso

Em algumas contas pessoais Plus e Pro, esse alerta pode vir com um ícone de lua: é a oferta de Luna Reserve, que explico mais abaixo

Erro comum: confiar na primeira leitura do /status

Tome cuidado! Uma issue aberta no repositório openai/codex relata que o /status devolve dados de limite desatualizados na primeira execução e só mostra o valor atual na segunda

Então rode duas vezes antes de concluir qual teto bateu:

/status
/status

Como prevenir

Antes de começar uma tarefa longa, rode /usage e veja quanto sobra da cota e quando é o próximo reset

É bem mais tranquilo decidir antes do que descobrir no meio de uma migração 🙂

O que fazer nos primeiros minutos depois do bloqueio sem perder o fio da tarefa

A ideia aqui é simples: o Codex parou, mas o seu repositório não

Usa esse tempo pra deixar tudo pronto pra retomada, assim tu não depende da memória (nem da sua, nem da sessão)

1. Anote o objetivo e o próximo passo fora do Codex

Crie um arquivo de notas no próprio repositório com o que estava sendo feito, o que já foi feito e qual é o próximo passo concreto

Um exemplo didático do formato:

# NOTAS-CODEX.md
Objetivo: migrar o módulo de pagamentos para a nova API
Feito: rotas de checkout e testes do checkout
Próximo passo: adaptar o webhook de confirmação
Pendente de revisão: arquivo de configuração alterado pelo agente

2. Revise as mudanças com /diff

Rode /diff pra ver o diff do Git: alterações staged, não staged e arquivos ainda não rastreados

Isso mostra exatamente o que o agente mexeu antes de tu dar commit ou rodar os testes

O erro comum aqui é ignorar os arquivos não rastreados, que não aparecem num diff normal e podem ser justamente o arquivo novo que o Codex criou

3. Rode os testes localmente

Use o comando de testes que o seu projeto já tem, o mesmo que tu rodaria sem IA nenhuma

Não existe comando universal aqui: cada stack tem o seu, e o importante é saber se o que o Codex deixou está de pé

4. Faça commit ou stash do que estiver aprovado

O que passou na revisão e nos testes vai pra commit, e o que ainda está pela metade vai pro stash

Assim tu tem um ponto seguro pra voltar se a próxima sessão sair torta

5. No reset, retome com codex resume

codex resume continua uma sessão interativa pelo ID ou retoma o chat mais recente

codex resume

O erro comum deste passo: por padrão, ele fica restrito ao diretório atual, então se tu abrir o terminal em outra pasta a sessão some da lista

Nesse caso, use --all pra ver as sessões de todos os diretórios:

codex resume --all

Como verificar que deu certo

A sessão retomada mostra o histórico da conversa, e o /status (rodado duas vezes, lembra?) mostra a cota renovada

Se a cota ainda aparecer zerada, confira no painel de uso o horário do reset

E lembra: a nova janela de 5 horas só começa quando você manda a primeira mensagem depois que a anterior termina

Hábitos que gastam a cota do Codex à toa

A maior parte do consumo exagerado vem de contexto grande e de configuração pesada em tarefa leve

A OpenAI diz que projetos maiores, tarefas longas e sessões extensas que exigem mais contexto gastam bem mais por mensagem

Sessão longa com contexto acumulado

Sintoma: cada mensagem nova parece comer um pedaço maior da cota

Causa: o histórico inteiro da sessão vai junto como contexto

Solução: rode /compact, que resume o chat visível e troca os turnos anteriores por um resumo com os pontos principais

Tarefa na nuvem quando o local resolveria

Sintoma: a cota cai rápido em tarefas que nem eram tão grandes

Causa: tarefas na nuvem podem gastar mais da cota que mensagens locais

Solução: deixe a nuvem pra quando ela fizer diferença de verdade e resolva o resto localmente

Raciocínio alto em tarefa simples

Sintoma: renomear uma variável custa quase o mesmo que depurar um bug cabeludo

Causa: o esforço alto ajuda em problemas difíceis, mas pode gastar mais da cota

Solução: use esforço baixo em tarefa simples, que dá respostas mais rápidas e faz a cota durar mais

Modo Fast ligado sem necessidade

Sintoma: respostas rápidas, mas a cota some na mesma velocidade

Causa: o modo Fast usa mais da cota incluída

Solução: ligue só quando a velocidade realmente importar

Projeto inteiro no contexto

Sintoma: até pergunta pontual fica cara

Causa: quanto mais contexto a tarefa exige, mais ela gasta por mensagem

Solução: aponte o agente pro recorte que importa (os arquivos e a pasta da tarefa) em vez de pedir pra ele entender o repositório todo

Como prevenir

Escolha o modelo e o esforço de raciocínio por tarefa, não por hábito, e cheque o /usage antes das tarefas grandes

Saídas legítimas para continuar antes do reset

Dá pra seguir antes do reset pelos caminhos oficiais, cada um com o perfil pra quem serve e o limite dele

Comprar créditos

Para quem serve: contas Plus e Pro que bateram o limite e precisam seguir agora

O uso incluído no plano é gasto primeiro e, depois do limite, o consumo sai do saldo de créditos

A compra fica em Settings > Usage (ChatGPT) ou em Usage & Billing (app do Codex), se estiver disponível pra sua conta, e a recarga automática pode ser ligada no mesmo lugar

Limite: os créditos valem por 12 meses a partir da compra, expiram sem acumular e não são transferíveis (fonte)

Reset semanal pago

Para quem serve: Plus e Pro que precisam da cota de volta na hora

Dá pra comprar em Usage settings no ChatGPT Desktop antes de bater o limite, ou pela oferta no app depois de bater o limite semanal

A compra restaura na hora o uso de 5 horas e o semanal

Limite: ela só adianta a cota semanal normal, não é cota extra

E o próximo reset semanal automático passa pra 7 dias depois do primeiro pedido no Work ou no Codex feito após o reset

Reset guardado (banked reset)

Para quem serve: quem vê um aviso como 1 reset available no resumo de uso

É um reset promocional e único, guardado na conta até ser usado ou expirar (não é crédito comprado)

Pra aplicar, vá em settings → usage no app desktop ou na web, escolha o resumo que mostra o reset disponível e confirme

Limite: ele renova as janelas de 5 horas e semanal e muda a data do reset semanal, e depois de expirado não volta (fonte)

Luna Reserve

Para quem serve: algumas contas pessoais Plus e Pro (não existe no Business nem no Enterprise)

Dá uso adicional com o modelo Luna depois que o uso normal se esgota, e é aquele alerta que às vezes aparece com o ícone de lua

Limite: não restaura o uso normal, tem limite próprio e a disponibilidade pode mudar (fonte)

Créditos do workspace no Business

Para quem serve: assentos padrão do ChatGPT Business

Limite: só funciona se o workspace tiver comprado créditos; aí o uso elegível continua pelo saldo compartilhado depois do limite do plano

Login com chave de API

Para quem serve: quem prefere pagar por uso em vez de esperar a janela do plano

O Codex aceita login com a conta do ChatGPT ou com uma chave de API, gerada no dashboard da OpenAI (fonte)

Limite: com a chave, o Codex cobra o preço padrão da API em vez de usar a cota do plano, então o gasto sai do seu bolso a cada uso

Mudar de plano

Para quem serve: quem vive batendo na janela de 5 horas

Pro 100 (US$ 100/mês), Pro 200 (US$ 200/mês) e Pro 500 (US$ 500/mês) hoje não têm limite de 5 horas no Work e no Codex

Limite: o semanal pode continuar valendo, então trocar de plano não significa uso infinito

Codex do zero: curso gratuito no canal

Se tu ainda tá pegando o jeito do Codex, o canal do Hora de Codar tem um curso gratuito que passa pela ferramenta, com skills e um projeto

Próximo passo: monte sua rotina de checagem de cota no Codex

Antes da próxima tarefa longa, rode /usage e o /status duas vezes, e anote quanto sobra e quando é o reset

Com isso na mão, decide antes de começar: esperar o reset, comprar créditos ou ir pela chave de API

E se tu alterna entre agentes, vale comparar com o funcionamento do limite de uso do Claude Code, que tem outras regras e outro jeito de retomar

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.