Limites de uso do Codex: por que você atingiu o limite e como continuar

Identifique o limite em um minuto

Não deduza a causa apenas pelo status 429. Leia o código de erro específico e o corpo da resposta e, em seguida, siga a documentação atual do provedor para esse erro.

Por que você não pode confiar em um número fixo de mensagens

Segundo a Central de Ajuda da OpenAI, consultada em 14 de agosto de 2026, o uso do Codex depende do tamanho e da complexidade da tarefa, do modelo selecionado e de onde a tarefa é executada. Uma pequena edição local e uma tarefa longa envolvendo um repositório grande consomem a franquia de maneiras diferentes. Por isso, uma fórmula como “N mensagens a cada cinco horas” pode ficar desatualizada rapidamente e não prevê o uso real de forma confiável.

Para tarefas pagas com créditos segundo a tabela atual baseada em tokens, as variáveis mensuráveis são o modelo selecionado e os tokens de entrada, entrada em cache e saída da tarefa. Abra a tabela de preços atual do Codex e use as informações exibidas no seu próprio Workspace para identificar a tabela e a unidade atualmente aplicáveis antes de estimar os custos.

O que fazer ao atingir o limite do plano Codex

1. Abra a página Usage ou o banner do limite e registre exatamente o que a sua conta oferece: créditos, uma renovação disponível, um upgrade ou a espera até a renovação do limite. Confira também se outros recursos com agentes disponíveis no Workspace consumiram o pool compartilhado. Se a sua função atual não permitir adicionar créditos ou gerenciar o faturamento, entre em contato com o owner ou admin do Workspace; as ações disponíveis continuam dependendo do plano, da sua função no Workspace e das permissões do administrador.
2. Salve as alterações ainda não commitadas e registre brevemente o próximo passo da tarefa. Não execute novamente uma interação longa na esperança de que ela passe.
3. Escolha como continuar: use a opção oficial do seu plano atual ou mude para um fluxo separado via API. Não combine esses orçamentos no mesmo cálculo.

Transfira com segurança uma tarefa urgente para um fluxo via API

A opção via API é útil quando você precisa de um orçamento separado e mensurável, e não de recursos adicionais da assinatura. Com a BetterToken, o processo é o seguinte:

1. Crie sua própria API Key no Workspace e selecione um Model ID atual na página Setup atual ou no model plaza do seu Workspace. Não presuma um nome fixo para o grupo.
2. Descubra o CODEX_HOME real antes de criar qualquer arquivo. Um valor personalizado de CODEX_HOME tem prioridade; caso contrário, ele costuma corresponder a ~/.codex no macOS/Linux e a %USERPROFILE%\.codex no Windows.

No macOS/Linux, exiba o diretório efetivo sem alterar a variável:

printf '%s\n' "${CODEX_HOME:-$HOME/.codex}"

No PowerShell:

if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE ".codex" }

Crie $CODEX_HOME/bt.config.toml exatamente nesse diretório:

model = "YOUR_MODEL_ID"
model_provider = "bettertoken"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-093&utm_content=codex-usage-limits-kak-prodolzhit"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

O arquivo $CODEX_HOME/bt.config.toml corresponde ao comando --profile bt. Ele não substitui o $CODEX_HOME/config.toml principal, portanto o provider oficial continua disponível. Os nomes precisam coincidir exatamente: model_provider = "bettertoken" no nível raiz aponta para [model_providers.bettertoken]. Substitua YOUR_MODEL_ID pelo API ID completo e atual do Setup, do model plaza ou do guia vigente.

Esse fluxo com --profile é específico do Codex CLI. O Codex Desktop usa os mesmos campos de custom provider, mas consulte o guia atual da BetterToken para saber como selecionar a configuração e iniciar o cliente. Para a extensão do VS Code, siga o guia separado; não copie o profile do CLI nem seu método de autenticação sem verificar as instruções atuais da extensão.

3. Exporte a chave no shell e confirme apenas que a variável não está vazia, sem exibir seu valor:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"
test -n "$BETTERTOKEN_API_KEY" && echo "BETTERTOKEN_API_KEY is set"

4. Inicie o Codex CLI com o novo profile:

codex --profile bt

Em seguida, envie uma pequena solicitação somente leitura, por exemplo:

Leia README.md e resuma sua finalidade. Não modifique nenhum arquivo.

5. Verifique a solicitação e seu uso no Workspace antes de continuar com uma tarefa maior. O exemplo atual completo está disponível no guia de configuração do Codex.

Não coloque uma chave real em um repositório, artigo, captura de tela ou arquivo de profile. O valor deve vir de uma variável de ambiente.

Evite perder trabalho ao fazer a troca

Crie um arquivo curto de handoff, sem segredos:

Objetivo: corrigir o teste X que está falhando.
Já verificado: A e B.
Arquivos alterados: path/to/file.
Próximo passo seguro: executar um teste específico.
Proibido: commit, deploy, exclusão de dados.

Antes de abrir outra cópia de trabalho, verifique o estado atual, salve as alterações rastreadas em um patch compatível com arquivos binários e liste os arquivos não rastreados separadamente:

git status --short
git diff --binary HEAD > ../codex-handoff.patch
git ls-files --others --exclude-standard -z > ../codex-handoff-untracked.zlist

O patch não inclui arquivos não rastreados. Antes de copiar qualquer coisa, revise ../codex-handoff-untracked.zlist e exclua arquivos .env, chaves privadas, credenciais e quaisquer outros segredos. Mantenha apenas os caminhos aprovados explicitamente; não presuma que um arquivo não rastreado possa ser descartado ou transferido com segurança.

Crie um novo worktree a partir do HEAD atual, confira o patch antes de aplicá-lo e confirme o estado resultante:

git worktree list
git branch --list codex/api-handoff
git worktree add -b codex/api-handoff ../project-api-handoff HEAD
if test -s ../codex-handoff.patch; then
  git -C ../project-api-handoff apply --check ../codex-handoff.patch
  git -C ../project-api-handoff apply ../codex-handoff.patch
fi
while IFS= read -r -d '' path; do
  mkdir -p -- "../project-api-handoff/$(dirname -- "$path")"
  cp -p -- "$path" "../project-api-handoff/$path"
done < ../codex-handoff-untracked.zlist
git -C ../project-api-handoff status --short

O bloco if pula git apply quando o patch de arquivos rastreados está vazio. O loop de cópia fica fora desse bloco, portanto os arquivos não rastreados revisados ainda são transferidos. Se ../project-api-handoff ou codex/api-handoff já existir, escolha outro caminho ou nome de branch ainda não utilizado. Não exclua um worktree, branch, patch ou arquivo não rastreado existente apenas para reutilizar um nome em conflito.

Inicie a nova sessão de API com a nota de handoff e o estado de trabalho verificado, em vez de usar todo o histórico da conversa. Isso reduz o uso, diminui o risco de estouro do contexto e reduz a chance de ações já concluídas serem repetidas.

Se você receber 429

Verifique os itens a seguir, nesta ordem:

1. O código de erro específico, o corpo da resposta, os cabeçalhos da resposta e a documentação do provedor para esse erro.
2. Se vários agentes ou jobs de CI estão usando a mesma chave.
3. Se o saldo está zerado ou o orçamento de gastos do Workspace foi atingido.
4. Se o erro ainda ocorre em uma única solicitação pequena após qualquer intervalo recomendado para esse erro específico.

Se o erro específico e a documentação do provedor indicarem uma limitação temporária de taxa, use backoff exponencial limitado com jitter. Não repita indefinidamente: solicitações repetidas aumentam a fila e podem consumir orçamento depois que o serviço se recuperar.

Faça a escolha final

• Se o banner do Codex oferecer créditos ou uma renovação e você quiser manter o mesmo fluxo baseado no plano, use a opção oficial disponível.
• Se você precisar de um orçamento separado para automação, CI ou uma tarefa urgente, configure um fluxo via API e acompanhe o uso separadamente.
• Se o problema for a janela de contexto, reduza o contexto ou inicie uma nova sessão. Gastar mais ou esperar a renovação do limite não resolverá o problema.
• Se o problema for um 429 da API, siga o código de erro específico, o corpo da resposta e a documentação do provedor; se o saldo estiver zerado, corrija o orçamento antes de tentar novamente.

Antes de transferir um trabalho urgente no Codex CLI, abra o guia atual de configuração da BetterToken para o Codex, crie uma chave separada, descubra o CODEX_HOME real, crie $CODEX_HOME/bt.config.toml, execute codex --profile bt e verifique uma solicitação pequena antes de continuar. Para a extensão do VS Code, use o guia de configuração separado.