Dokümantasyon

Codex CLI

Codex yalnızca Responses API'yi konuşur. config.toml dosyasındaki tek bir sağlayıcı bloğu, onu Kunavo'nun kendi /v1/responses yüzeyine yönlendirir; anahtar dosyada değil, bir ortam değişkeninde tutulur.

Anahtarın ortamda kalması ve yapılandırma dosyasına hiç girmemesi için ~/.codex/config.toml içinde env_key içeren bir [model_providers.kunavo] bloğu.

~/.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"     # the NAME of the variable, not the key
# wire_api defaults to "responses", which is the only supported value

wire_api artık yalnızca bir geçerli değere sahiptir: "responses"; belirtilmediğinde varsayılan da budur. Codex'ten Chat Completions desteği kaldırıldı. Bu nedenle wire_api = "chat" yazmanızı söyleyen eski kılavuzlar güncelliğini yitirmiştir; gerçek bir /v1/responses rotası olmayan hiçbir uç nokta Codex'ten kullanılamaz. Kunavo bu rotayı doğrudan sunar.

env_key, anahtarın kendisini değil, bir ortam değişkeninin adını içerir. OpenAI tarafında bu bilinçli bir tercihtir: config.toml insanların depoya eklediği ve sorun bildirimlerine yapıştırdığı bir dosyadır.

Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Codex CLI kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Yukarıdaki bloğu ~/.codex/config.toml dosyasına ekleyin; dosya yoksa oluşturun.
env_key tarafından belirtilen değişkeni dışa aktarın: export KUNAVO_API_KEY=sk-kn-...
codex komutunu çalıştırın. Üst düzeydeki model_provider bloğu seçer; model ise bloğun içindeki kimliği seçer.
Dosyayı düzenlemek yerine oturum başına model değiştirmek için codex -m <model id> kullanın veya birkaç sağlayıcı bloğunu tutup model_provider değerini değiştirin.

Codex yapılandırma dosyası başvurusu ile 6 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber Codex CLI API anahtarı kılavuzu içindedir.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Codex CLI içinde çalışır.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Model kimliği	Kunavo giriş / çıkış	Codex CLI içinde kullanım alanı
`gpt-5-6-sol`	$2.00 / $12.00	varsayılan Codex eşleştirmesi — Responses'ı doğrudan destekler, istekleri doğrudan iletir
`gpt-6-sol`	$0.80 / $4.00	Karmaşık kodlama ve ajanlar için OpenAI GPT-6 — aynı Responses yolu, 5.6 Sol'dan daha düşük ücretle
`gpt-6-luna`	$0.04 / $0.20	yüksek hacimli veya düşük eforlu işlemler için en ucuz GPT-6
`gpt-5-6-terra`	$0.70 / $4.20	düzenleme ağırlıklı oturumlar için daha ucuz bir GPT katmanı
`claude-sonnet-5`	$1.40 / $7.00	Responses üzerinden kullanılan GPT dışı bir model — ağ geçidinde dönüştürülür
`claude-opus-5`	$3.50 / $17.50	akıl yürütme derinliğinin ücreti karşılamaya değer olduğu planlama işlemleri

Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Sık sorulan sorular

Codex CLI'ı özel bir API uç noktasına nasıl yönlendiririm?

~/.codex/config.toml dosyasına name, base_url ve env_key içeren bir [model_providers.<id>] tablosu ekleyin; ardından üst düzey model_provider değerini bu kimliğe, model değerini ise çalıştırmak istediğiniz kimliğe ayarlayın. base_url hizmetin /v1 köküdür; env_key, anahtarın tutulduğu ortam değişkeninin adını belirtir, böylece anahtar dosyanın kendisinde yer almaz.

Codex CLI hangi wire_api değerine ihtiyaç duyar?

"responses" — yapılandırma başvurusu, bunun desteklenen tek değer ve belirtilmediğinde varsayılan olduğunu belirtir. Codex'ten Chat Completions desteği kaldırıldı. Bu nedenle yalnızca /v1/chat/completions uygulayan bir uç nokta, yapılandırması ne olursa olsun Codex'ten kullanılamaz. Uç nokta gerçek bir /v1/responses rotası sunmalıdır.

Codex CLI Claude modellerini çalıştırabilir mi?

Uç nokta bunları Responses API üzerinden sunuyorsa evet. Codex, base_url hangi adresi gösteriyorsa oraya Responses biçiminde istek gönderir ve model kimliğini olduğu gibi iletir. Dolayısıyla Responses'ı modelin kendi biçimine dönüştüren bir ağ geçidi, Claude veya Gemini kimliklerini Codex'e sunabilir. Codex, yanıtı hangi sağlayıcının verdiğini bilmez.

Codex CLI API anahtarını nerede saklar?

config.toml dosyasında değil, sağlayıcı bloğunun env_key alanında belirtilen ortam değişkeninde. Codex değişkeni başlangıçta okur; böylece anahtar kabuk profilinizde veya gizli bilgi yöneticinizde kalır ve yapılandırma dosyasını depoya güvenle ekleyebilir, hata raporuna yapıştırabilirsiniz.