API anahtarıyla Codex CLI — yapılandırma, modeller ve oturum maliyeti

Codex CLI, OpenAI'ın açık kaynaklı terminal kodlama ajanıdır ve hem ChatGPT oturum açma yöntemiyle hem de API anahtarıyla çalışır. Anlaşılması gereken yol, anahtar yoludur: token başına ücretlendirilir, aylık aboneliği yoktur ve CLI'yi başka bir sağlayıcıya — veya başka bir model ailesine — yönlendirmenize izin veren tek yoldur. Bu kılavuzda çalışan yapılandırma, çoğu gateway'i devre dışı bırakan gereksinim, bir oturumun maliyeti ve Brezilya'dan Pix ile nasıl ödeme yapılacağı açıklanır.

Önemli olan tek gereksinim

Codex CLI, OpenAI'ın Responses API'siyle konuşur ve yalnızca onunla: model_providers bloğu sadece wire_api = "responses" kabul eder. Yalnızca /v1/chat/completions sunan bir gateway yapılandırılamaz — “OpenAI uyumlu” uç noktaların önemli bir kısmının burada başarısız olmasının nedeni budur. Kunavo, sohbet uç noktasıyla birlikte POST /v1/responses sunar; bu nedenle aşağıdaki blok uyarlama gerektirmeden çalışır.

Yapılandırma

# ~/.codex/config.toml
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"

env_key, ortam değişkeninin adıdır; anahtarın kendisi değildir: Codex anahtarı yapılandırma dosyasına hiçbir zaman kaydetmez.

# O Codex lê a chave da variável indicada em env_key.
export KUNAVO_API_KEY="sk-kn-..."     # crie em kunavo.com/app/keys

# Deixe persistente (escolha o arquivo que o seu shell realmente carrega):
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

codex "explique a estrutura deste repositório"

Kaydolduktan ve $10 yükledikten sonra dashboard'da anahtarı oluşturun — anahtar yalnızca bir kez görüntülenir.

Brezilya'dan ödeme — uluslararası kart olmadan Pix

Brezilyalı geliştirici için engel nadiren TOML dosyasıdır; ödeme yöntemidir. OpenAI API'sine doğrudan ödeme yapmak, yurt dışı alışverişlere açık uluslararası kredi kartı gerektirir. Kunavo'da ödeme sayfası Stripe tarafından işlenir ve Brezilya'dan ödeme yapanlar için Pix ödeme yöntemi olarak görünür — tutar real cinsindendir ve işlem anında tamamlanır. Uluslararası kartlar (Visa, Mastercard, American Express), Apple Pay ve Google Pay'i tercih edenler için kullanılmaya devam eder.

Token başına ücretler USD cinsinden belirlenir: Pix'te Stripe, ödeme sırasında dönüşümü Brezilya reali cinsinden gösterir; kartta dönüşüm, kartı veren kuruluşun kuruna göre yapılır (IOF'yi ve bankanızın uygulamasındaki uluslararası işlem ücretini kontrol edin) — Pix ile bakiye yükleme adımları API'ye Pix ile nasıl ödeme yapılacağı kılavuzunda yer alır. Cüzdan ön ödemelidir — minimum yükleme $10'dır; abonelik ve otomatik yenileme yoktur, bakiye hiçbir zaman sona ermez.

Hangi model kullanılmalı

gpt-5-6-sol, kod için ayarlanmış GPT'dir ve bu CLI için doğal varsayılan seçenektir. 1M token başına fiyatı $2,00 / $12,00 olarak belirlenmiştir; karşılaştırma fiyatı ise $5,00 / $30,00 olarak verilmiştir (OpenAI'nin liste fiyatında — bugün OpenAI $4,00 / $20,00 promosyon fiyatı uyguluyor; fiyatlandırma sayfasına göre en az 21 Kasım 2026 tarihine kadar geçerli). Eksiksiz ücretler fiyatlandırma sayfasında yer alır.

Codex CLI'da Claude modellerini çalıştırma

Bu genellikle şaşırtıcıdır: Codex CLI modele değil, protokole bağlıdır. Responses biçimiyle konuşur ve bu uç noktanın arkasındaki herhangi bir sohbet modeli yanıt verir. claude-opus-5'e yönlendirin; araç çağrıları da dahil olmak üzere uçtan uca çalışır. Böylece ajan dosyaları okumaya, düzenleme önermeye ve komut çalıştırmaya devam eder.

# Mesmo bloco de provider, outro modelo — sem chave nova, sem config nova.
model          = "claude-opus-5"
model_provider = "kunavo"

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

Gateway, Responses isteğini Anthropic'e özgü Messages API'sine, yanıtı da tekrar Responses biçimine çevirir. Dürüst bir uyarı: Codex, yalnızca Responses'a özgü bir modelin tüketebileceği opak reasoning öğeleri gönderir ve bunlar GPT olmayan bir upstream'e giden yolda atılır. Model, önceki turun özel taslağını kaybeder; dayandığı görünür döküm korunur. Uygulamada bu, uzun akıl yürütme zincirlerinde bir miktar süreklilik kaybına yol açar; yaygın düzenle-çalıştır-düzelt döngülerinde ise kayıp yaratmaz.

Özellikle Claude istiyorsanız Claude Code bunun için tasarlanmıştır ve cache_control alanını çeviri yapmadan iletir. Ancak Codex CLI'ın sandbox'ını tercih ediyor ve arkasında Claude kullanmak istiyorsanız bu kombinasyon da mümkündür.

Bir oturumun maliyeti

Agentic CLI'lar her adımda sistem istemini, görev geçmişini ve dosya bağlamını yeniden gönderir; bu nedenle token'lar adım sayısının düşündürdüğünden daha hızlı birikir. Tipik bir adım yaklaşık 25.000 girdi token'ı ve 1.200 çıktı token'ı içerir:

Yani Pix ile yapılan $10'lık bir yükleme, yaklaşık 8 adet 20 adımlı agentic görevi karşılar. Başarısız istekler de ücretlendirilmez — bir oturumun ortasındaki 5xx faturalandırmada satıra dönüşmez.

Bir şey çalışmadığında

Codex'i suçlamadan önce anahtarın ve uç noktanın yanıt verdiğini kanıtlayın:

# Confirme a chave e o endpoint antes de culpar o Codex.
curl https://api.kunavo.com/v1/responses \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-6-sol",
    "input": "Responda OK e nada mais."
  }'

• 404 — sağlayıcı /v1/responses uç noktasını uygulamıyor veya base_url zaten /responses yolunu içeriyor. Codex yolu kendisi ekler: temel adres /v1 ile biter.
• 401 — env_key alanında belirtilen değişken, Codex'i açan kabukta boştur. Aynı terminalde echo $KUNAVO_API_KEY ile kontrol edin.
• 402 — yetersiz bakiye: billing bölümünden yükleme yapın (Pix anında hesaba geçer).
• model_not_found — model slug'ı katalogda mevcut değil; /models adresinden kontrol edin.

Sık sorulan sorular