Codex CLI API anahtarı — çalışan özel sağlayıcı kurulumu

Bir Codex API anahtarı, Codex CLI'nin ChatGPT planı yerine token başına faturalandırabildiği herhangi bir anahtardır: platform.openai.com adresinden alınan bir OpenAI API anahtarı veya Codex'in bir model_providers bloğunda env_key tarafından adlandırılan ortam değişkeninden okuduğu Kunavo'nun sk-kn- gibi bir sağlayıcı anahtarı. Sağlayıcının Responses API'yi sunması gerekir — aşağıdaki tek koşul budur.

Codex CLI, OpenAI'nin açık kaynaklı terminal kodlama ajanıdır ve hem ChatGPT oturum açma bilgisiyle hem de API anahtarıyla çalışır. Anlaşılması gereken rota API anahtarı rotasıdır: aylık ücret olmadan token başına faturalandırılır ve CLI'yi farklı bir sağlayıcıya — hatta tamamen farklı bir model ailesine — yönlendirmenize izin veren tek rotadır. Bu kılavuzda çalışan yapılandırmayı, çoğu ağ geçidinin takıldığı tek koşulu ve bir oturumun gerçekte ne kadara mal olduğunu bulacaksınız.

Önem taşıyan tek koşul

Codex CLI, özel uç noktalar konusunda çoğu araçtan daha katıdır. model_providers bloğunda bir wire_api anahtarı bulunur ve tam olarak tek bir değeri kabul eder: responses. Bu, özel sağlayıcının OpenAI'nin Responses API'sini POST /v1/responses adresinde sunması gerektiği anlamına gelir — çok daha yaygın olan /v1/chat/completions değil. Çoğu OpenAI uyumlu ağ geçidi yalnızca ikincisini sunar; bu nedenle verdiğiniz base_url ne olursa olsun birçoğu Codex CLI'yi hiç çalıştıramaz.

Kunavo her iki yüzeyi de sunduğu için aşağıdaki yapılandırma yazıldığı haliyle çalışır.

Yapılandırma

Codex ~/.codex/config.toml dosyasını okur. Üst düzey iki anahtar modeli ve sağlayıcıyı seçer; sağlayıcı bloğu ona nasıl ulaşılacağını açıklar:

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

Bu dosyada olmayan şeye dikkat edin: anahtarın kendisi. env_key bir ortam değişkenini adlandırır ve Codex anahtarı başlatma sırasında oradan okur — böylece yapılandırma dosyası güvenle commit edilebilir veya paylaşılabilir.

# Codex reads the key from the variable named by env_key.
export KUNAVO_API_KEY="sk-kn-..."     # create at kunavo.com/app/keys

# Persist it (pick the file your shell actually loads):
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

codex "explain the structure of this repository"

kaydolup $10 yükledikten sonra anahtarı dashboard'da oluşturun. Anahtar yalnızca bir kez gösterilir; hemen saklayın. codex başka bir kabukta zaten çalışıyorsa yeniden başlatın — değişkeni istek başına değil, başlatma sırasında okur.

Hata ayıklamadan önce doğrulayın

Bir şey yanlışsa sorunun anahtarda mı, uç noktada mı yoksa CLI'da mı olduğunu öğrenin. Tek bir istek bunu kesinleştirir:

# Confirm the key and the endpoint before blaming 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": "Say OK and nothing else."
  }'

JSON yanıtı, anahtarın ve uç noktanın doğru olduğunu; kalan sorunun config.toml içinde olduğunu gösterir. 401, anahtarın yanlış veya değişkenin bu kabukta boş olduğu anlamına gelir. model üzerindeki 404, slug'ın katalogla eşleşmediğini gösterir.

Hangi model ayarlanmalı

model değeri aynı uç noktadaki yalnızca bir slug'dır; dolayısıyla geçiş tek kelimelik bir düzenlemedir — yeni anahtar veya yeni sağlayıcı bloğu gerekmez.

gpt-5-6-sol, kodlama için ayarlanmış GPT modelidir ve bu CLI için doğal varsayılandır; fiyatı 1 milyon token başına $2,00 / $12,00, OpenAI'nin liste fiyatı ise $5,00 / $30,00 — ancak OpenAI şu anda $4,00 / $20,00 promosyon fiyatı uyguluyor; en az 21 Kasım 2026 tarihine kadar geçerli. Her modelin tam ücretleri fiyatlandırma sayfasında yer alır.

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

Bu birçok kişiyi şaşırtır: Codex CLI protokole bağlıdır, modele değil. Responses kablo biçimini konuşur ve o uç noktanın arkasındaki sohbet modeli yanıt verir. Onu claude-opus-5'e yönlendirdiğinizde uçtan uca çalışır — araç çağrıları da dahil; böylece ajan dosyaları okumaya, düzenleme önermeye ve komutları normal şekilde çalıştırmaya devam eder.

# Same provider block, different model — no new key, no new config.
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"

Ağ geçidi, Responses isteğini Anthropic Messages API'ye ve yanıtı yeniden Responses biçimine çevirir. Dürüst olmak gerekirse bir sınırlama vardır: Codex yalnızca Responses'a özgü bir modelin tüketebileceği opak reasoning öğeleri gönderir ve bunlar GPT olmayan bir üst akışa giderken atılır. Model, önceki turdaki özel not defterini kaybeder; üzerinde çalıştığı görünür döküm korunur. Uygulamada bu, uzun akıl yürütme zincirlerinde biraz süreklilik kaybına yol açar; olağan düzenle-çalıştır-düzelt döngülerinde ise hiç etki yaratmaz.

Bunun iyi bir fikir olup olmadığı, çalışıp çalışmadığından ayrı bir sorudur. Özellikle Claude istiyorsanız Claude Code bunun için geliştirilmiştir ve cache_control alanını çeviri yapmadan aktarır. Ancak Codex CLI'ın sandbox kullanımını tercih ediyor ve Claude'u onun arkasında kullanmak istiyorsanız bu birleşim mümkündür.

Bir oturumun maliyeti

Ajan tabanlı CLI'lar sistem istemini, görev geçmişini ve güncel dosya bağlamını her adımda 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 giriş ve 1.200 çıkış token'ı içerir:

Çıktı ücretleri model aileleri arasında input ücretlerinden çok daha fazla değiştiği için output ağırlıklı işler sıralamayı değiştirir — tek bir örneğe güvenmek yerine kendi sayılarını maliyet hesaplayıcısına girin. Başarısız istekler faturalandırılmaz.

API anahtarı rotası aboneliği ne zaman geçer

ChatGPT planı Codex kullanımını sabit aylık ücretle paketler; API anahtarı yalnızca çalıştırdığınız kadarını faturalandırır. Anahtar rotası, her gün yerine aralıklı kod yaztığınızda, opak bir kullanım hakkı yerine anahtar başına harcama limitleri ve kullanım görünürlüğü istediğinizde veya aboneliğin sunmadığı bir modeli istediğinizde avantajlıdır. Ağır ve günlük kullanıcıysanız dezavantajlıdır — bu hacimde sabit ücreti yenmek zordur. Rotalar birbirini dışlamaz: Codex profilleri ikisini de tutmanıza ve görev başına geçiş yapmanıza izin verir.

Sorun giderme

Sık sorulan sorular