Preços do Codex — quanto custa uma tarefa por token e o ponto de equilíbrio com um plano

O Codex é vendido em dois eixos diferentes, por isso “quanto custa o Codex” não tem uma única resposta. Um plano do ChatGPT inclui o Codex em uma taxa mensal fixa com limites de uso. Uma chave de API cobra por token, não tem taxa mensal nem limites e não custa nada em um mês em que você não programa. Qual é mais barato é uma questão de aritmética, e a conta é curta.

Este guia não reproduz os níveis de plano da OpenAI — eles mudam, e uma página que os lista fica errada na semana seguinte à mudança. Ele apresenta o lado por token, uma tarefa calculada como exemplo e um ponto de equilíbrio que você preenche com o preço do seu plano no dia em que ler isto.

Quanto custa uma tarefa do Codex por token

O Codex é agêntico: uma coisa que você solicita envolve várias idas e vindas cobradas. Portanto, a unidade que importa é a etapa — uma chamada de modelo que lê o contexto, propõe algo e responde —, não a solicitação nem a hora.

Uma etapa aqui corresponde a 25.000 tokens de entrada e 1.200 de saída — o mesmo dimensionamento usado neste site na página do Claude Code, portanto os dois são comparáveis. As tarifas vêm do catálogo no momento da renderização, não de uma tabela digitada manualmente, e cada uma é impressa ao lado do preço de tabela da própria OpenAI para que você possa verificar, em vez de confiar.

O ponto de equilíbrio

Esta é a decisão inteira, e ela exige uma única divisão. Um plano vale seu preço apenas se economizar mais que seu preço em gastos por token:

# Break-even, in tasks per month.
#
#   plan_price_per_month / cost_per_task = tasks the plan must save you
#
# With a 20-step task on GPT-5.6 Sol at Kunavo rates:
#
#   cost_per_task = $1.29
#
#   $20 plan  ->  $20  / $1.29  = 16 tasks/month
#   $100 plan ->  $100 / $1.29  = 78 tasks/month
#
# Fewer than that and per-token is cheaper. More and the plan is.
# Substitute whatever your plan actually costs today.

Na prática, duas coisas o distorcem, ambas na mesma direção. Os planos têm janelas de uso, portanto os dias de uso intenso para os quais você comprou o plano são os dias em que você tem mais probabilidade de atingir um limite — e um limite atingido é capacidade pela qual você pagou, mas não recebeu. A cobrança por token não tem janela; a fatura apenas acompanha o trabalho. Em contrapartida, o custo de um plano é previsível e uma fatura por token não é, o que tem algum valor no orçamento de uma equipe.

Executando a CLI do Codex com uma chave cobrada por token

A CLI do Codex lê um provedor personalizado do arquivo de configuração. Uma restrição elimina a maioria dos gateways: wire_api aceita apenas "responses", portanto o endpoint precisa oferecer POST /v1/responses — não apenas chat completions.

# ~/.codex/config.toml — Codex CLI on a per-token key instead of a plan.
model = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"
wire_api = "responses"

A chave nunca vai para o arquivo: env_key nomeia uma variável de ambiente que o Codex lê na inicialização, mantendo a configuração segura para commit. O passo a passo completo, incluindo a função de cada campo e como distinguir uma falha de protocolo de uma falha de autenticação, está na página de chave de API da CLI do Codex. Se você operar o Codex por meio de um alternador de provedores, a configuração do CC Switch cobre ambas as direções.

Três coisas que alteram o número real

Tokens de raciocínio. Modelos da classe Codex produzem tokens internos cobrados à tarifa de saída que não aparecem no diff que você vê. Uma estimativa baseada no tamanho da saída visível subestima uma tarefa com muito raciocínio, às vezes por uma margem grande. Leia a saída cobrada nos seus dados de uso, não na resposta.

Cache de prompts. Ferramentas agênticas reenviam o mesmo contexto a cada etapa, portanto a maior parte desses 25.000 tokens de entrada não muda entre os turnos. A entrada em cache no protocolo da OpenAI é cobrada a um décimo da tarifa de entrada, o que, em uma sessão longa, é a maior alavanca disponível — maior que trocar de modelo. A calculadora de preços da OpenAI tem um campo para isso.

Tentativas repetidas. Uma solicitação que consumiu tokens e depois falhou no downstream ainda é cobrada. Em uma rede instável ou diante de um upstream limitado por taxa, isso representa uma porcentagem real e fica invisível em qualquer estimativa por solicitação.

Codex ou Claude Code

Eles estão vinculados a protocolos em direções opostas — o Codex fala a Responses API, enquanto o Claude Code fala Anthropic Messages —, mas ambos são CLIs agênticas cobradas por etapa, portanto a aritmética acima é transferida sem alterações. A comparação por etapa entre as duas famílias está em Claude Code vs Codex, e o lado do Claude no ponto de equilíbrio está em limites do Claude Pro e Max. Uma chave no Kunavo alcança ambos, então a escolha continua sendo um argumento de --model, não uma segunda conta. Se a pergunta for qual superfície da OpenAI abrir, em vez de qual CLI instalar, Codex vs ChatGPT explica o que uma franquia compartilhada de plano faz quando uma das duas portas é agêntica.

Perguntas frequentes