Custo do Codex — quanto uma tarefa real custa pela API e quando a assinatura vale a pena

O Codex tem dois preços, e quase toda resposta à pergunta “Quanto custa o Codex?” menciona apenas um. Na assinatura do ChatGPT, o Codex está incluído em uma tarifa mensal fixa com limites de uso definidos pela OpenAI. Com uma chave de API, você paga por token — entrada, entrada em cache e saída — sem tarifa fixa: no Kunavo, GPT-5.6 Sol, o modelo que recomendamos como padrão para o Codex, custa $2,00 por 1M de tokens de entrada, $0,20 para entrada em cache e $12,00 para saída, e uma tarefa real com 20 etapas custa cerca de $0,62 ($1,29 sem cache). Qual caminho é mais barato é decidido por uma divisão: tarifa mensal ÷ custo por tarefa. Quem trabalha diariamente de forma intensa e interativa tende a se beneficiar mais da assinatura; quem trabalha em lotes ou de forma automatizada, da API.

Esta página deliberadamente não reproduz os níveis de assinatura da OpenAI — eles mudam, e uma cópia estará errada na semana seguinte; o estado atual é informado pela página de preços do ChatGPT da OpenAI. Em vez disso, ela calcula o que as comparações de assinatura deixam de fora: o preço por token, uma tarefa real linha a linha e o ponto de equilíbrio, que você preenche com o preço da sua própria assinatura. Tarifas verificadas em 3 de outubro de 2026; os preços do Kunavo vêm ao vivo do catálogo de modelos.

Assinatura ou chave de API: os dois caminhos

Os dois caminhos não são combinados, mas também não são mutuamente exclusivos: você pode manter a assinatura e usar a chave apenas nos dias em que o limite estiver esgotado — por meio de model_provider em config.toml.

Preços do Codex por token: os modelos adequados para o Codex

A entrada em cache custa 0,10 vez o preço de entrada; as gravações no cache custam 1,25 vezes o preço de entrada nos modelos GPT-5.6 Sol/Terra e GPT-6 Astra. A coluna da OpenAI vem do mesmo catálogo, para que você possa verificar em vez de acreditar — em GPT-5.6 Sol, o Kunavo está cerca de 60% abaixo do preço público, cerca de 40% abaixo do preço promocional atualmente cobrado pela OpenAI. Todos os dados do modelo estão na página sobre GPT-5.6 Sol.

Uma tarefa real, linha a linha

O Codex é agêntico: uma solicitação se transforma em muitas chamadas de modelo cobradas. A unidade que conta é a etapa — ler o contexto, propor uma alteração ou executar um comando, informar. Como a ferramenta reenvia o contexto a cada etapa, uma etapa típica tem cerca de 25.000 tokens de entrada e 1.200 de saída. A maior parte da entrada se repete (instruções, arquivos já lidos) e vem do cache: presumimos 20.000 tokens em cache e 5.000 novos tokens, contando os novos como gravação no cache a 1,25 vez — o caso pessimista.

Para substituir a suposição pelos seus próprios números, pegue o usage da resposta da API — entrada total, entrada em cache, saída — e insira-o aqui:

# Was eine Codex-Aufgabe gekostet hat, aus dem usage der API.
IN, OUT = 2.00, 12.00   # USD pro 1M Tokens (gpt-5-6-sol auf Kunavo)
LESEN, SCHREIBEN = 0.10, 1.25   # Cache-Faktoren auf den Input-Preis

def kosten(input_gesamt, gecacht, output, geschrieben=0):
    neu = input_gesamt - gecacht - geschrieben
    return (neu * IN
            + gecacht * IN * LESEN
            + geschrieben * IN * SCHREIBEN
            + output * OUT) / 1_000_000   # Output inkl. Reasoning

# 20 Schritte: 500.000 Input (400.000 gecacht, 100.000 geschrieben), 24.000 Output
print(round(kosten(500_000, 400_000, 24_000, 100_000), 2))

O ponto de equilíbrio — uma divisão

Não é preciso mais para decidir: tarifa mensal ÷ custo de uma tarefa = tarefas por mês que a assinatura precisa substituir para valer a pena. Com a tarefa acima em GPT-5.6 Sol:

Os valores mensais são exemplos arredondados para substituição, não a lista de preços da OpenAI. O veredito honesto depende do formato do seu uso:

• Diário e intenso, interativo: cinco tarefas por dia útil equivalem a cerca de 110 por mês — $67,98 na cobrança por token em GPT-5.6 Sol. Uma assinatura abaixo desse valor é mais barata, desde que seus limites de uso comportem esse volume.
• Em lotes: três dias intensos por mês com 15 tarefas totalizam $9,27. Isso fica abaixo de qualquer tarifa mensal, e um mês sem programação custa $0.
• Automatizado (CI, scripts, agentes sem supervisão): aqui a chave é o formato natural — uma por tarefa, com limite mensal de gastos por chave (a API responde com 402 quando ele é atingido) e lista de permissões de IP, ambos em /app/keys.

Um detalhe aponta na mesma direção: os dias completos pelos quais você assina são exatamente os dias em que atinge o limite — e um limite atingido é capacidade paga que não é entregue. Em contrapartida, uma tarifa mensal é previsível e uma cobrança por token não é, o que importa no orçamento da equipe.

Executar o Codex CLI com uma chave de API

Uma limitação exclui a maioria dos gateways: o Codex CLI aceita apenas wire_api = "responses", portanto o endpoint precisa disponibilizar POST /v1/responses, não apenas Chat Completions. O Kunavo disponibiliza ambos:

# ~/.codex/config.toml — Codex CLI mit einem Key pro Token statt Abo.
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"     # der NAME der Variablen, nicht der Key
wire_api = "responses"         # der einzige erlaubte Wert (und der Standard)

export KUNAVO_API_KEY=sk-kn-...   # anlegen unter /app/keys

codex                          # Modell aus config.toml (gpt-5-6-sol)
codex -m gpt-5-6-terra           # mechanische Aufgabe: das günstigste Modell
codex -m gpt-6-astra             # nur, wenn GPT-5.6 Sol nicht weiterkam

A chave nunca fica no arquivo: env_key é o nome de uma variável de ambiente que o Codex lê ao iniciar. Cada campo explica o guia de integração do Codex CLI; a configuração detalhada, com os erros 401 e 404 típicos, está no guia da chave de API do Codex CLI (ambos em inglês).

O que altera a cobrança real

Tokens de raciocínio. Os modelos GPT pensam antes de responder, e esse pensamento é cobrado como saída, sem aparecer no diff. A cada 1.000 tokens de saída adicionais por etapa, somam-se GPT-5.6 Sol $0,012; em uma tarefa com 20 etapas, $0,24. O que importa é a saída calculada no usage, não o tamanho da resposta.

Cache. A maior alavanca, maior que trocar de modelo: a mesma tarefa custa $1,29 sem cache e $0,62 com cache. Sessões com contexto estável são as que mais se beneficiam. A calculadora de preços da API da OpenAI tem um campo para isso.

Contexto longo. A família GPT-5.6 e o GPT-6 Astra cobram, acima de 272.000 tokens de prompt, a solicitação INTEIRA a 2 vezes o preço de input e 1,5 vez o preço de output. Começar uma nova sessão quando ela fica grande demais é mais barato do que continuar expandindo-a.

Modelo por etapa. A mesma tarefa com 20 etapas custa $0,22 em GPT-5.6 Terra, $0,62 em GPT-5.6 Sol e $1,14 em GPT-6 Astra. Use GPT-6 Astra nos pontos em que GPT-5.6 Sol não conseguiu avançar.

Falhas. Na Kunavo, solicitações com falha não são cobradas. Uma nova tentativa bem-sucedida, porém, é uma chamada normal e cobrada.

Pagando da Alemanha

Os preços dos tokens estão em dólares americanos, e o carregamento é feito pelo checkout da Stripe: cartões (Visa, Mastercard, American Express), Apple Pay, Google Pay e Link. O débito direto SEPA não é oferecido atualmente; um cartão de débito vinculado à conta-corrente funciona normalmente. O Pay by Bank também não está disponível para compradores na Alemanha: ele aparece no checkout apenas para compradores no Reino Unido, na Irlanda e na Finlândia, e, para a Alemanha, a Stripe ainda o oferece apenas como prévia privada (atualizado em: 3 de outubro de 2026).

É um saldo pré-pago: carregamento mínimo de $10, sem assinatura, e o saldo nunca expira. Carregamentos maiores recebem um bônus — $100 se tornam $110,00, e $1.000 se tornam $1.200,00. De acordo com o cálculo acima, $10 são suficientes para cerca de 16 tarefas de 20 etapas em GPT-5.6 Sol. Os detalhes estão na documentação de cobrança.

Falando com franqueza: quando a Kunavo não é a escolha certa

A contrapartida em relação ao caminho direto para a OpenAI é a capacidade compartilhada: não há cota dedicada nem SLA contratual. Quem precisa de cota garantida ou de um SLA por contrato deve ir diretamente à OpenAI. E quem usa o Codex intensamente e de forma interativa todos os dias pode pagar menos com uma assinatura, como mostra o cálculo acima. O que a chave oferece é o restante: nenhuma taxa fixa, tarifas abaixo da tabela e uma chave para GPT e Claude.

Codex ou Claude Code

Ambos são CLIs agênticos cobrados por etapa — o cálculo desta página vale para os dois; apenas a tarifa muda. A página do Claude com a mesma unidade está em Preços do Claude, a questão dos limites de assinatura em Limites do Claude, e a comparação de ferramentas em Claude Code vs Codex (em inglês). Com uma chave da Kunavo, você acessa ambos, e a escolha se torna um argumento de -m em vez de uma segunda conta.

Perguntas frequentes