Codex rehberi — Codex CLI kurulumu, abonelik yerine API anahtarı ve görev başı maliyet

Codex, OpenAI'nin yapay zekâ kodlama aracısıdır. En temel kullanım şekli, terminalde çalıştırılan Codex CLI'yi (npm install -g @openai/codex) kurmak, üzerinde çalışılacak proje klasöründe codex komutunu çalıştırmak ve ne yapılacağını Çince anlatmaktır. Başlamak için iki yol vardır: ChatGPT planıyla (Plus, Pro, Business vb.) giriş yapmak ve plan kotası içinde kullanmak veya API anahtarıyla çalıştırıp kullanılan token kadar ödeme yapmak. Çince rehberlerin çoğu yalnızca ilk yolu anlatır; bu yazı ise ikinci yolu ele alır — abonelik olmadan Codex CLI çalıştırma ayarları, göreve göre model seçimi ve bir görevin gerçekte ne kadar tuttuğu.

Codex, kodu sohbet penceresine yapıştırdığınız bir araç değildir; proje içinde dosya okuyan, dosya değiştiren, test ve komut çalıştıran bir aracıdır. Onay almadan doğrudan yapılabilecek eylemleri başlattıktan sonra /permissions ile ayarlayın.

Codex'i kullanmanın iki yolu

API anahtarıyla çalıştırıldığında maliyet, ChatGPT planı kotasından ayrı hesaplanır. OpenAI API anahtarı doğrudan kullanılabilir; ancak bu yazı Responses API ile uyumlu bir uç noktaya bağlanmayı anlatır: aynı anahtarla GPT-6 Astra ile GPT-5.6 Terra arasında geçiş yapılabilir. Örneğin GPT-5.6 Sol için OpenAI'nin resmî fiyatı $5,00 / $30,00(OpenAI şu anda promosyon fiyatıyla $4,00 / $20,00 sunuyor; resmi fiyatlandırma sayfasına göre en az 21 Kasım 2026 tarihine kadar) iken burada 1M token başına $2,00 / $12,00 olur (fiyatlar elle yazılmaz, bu sitenin kataloğundan doğrudan okunur).

Codex CLI'yi kurma — npm veya Homebrew

# npm（有 Node.js 就能用，macOS / Linux / Windows 通用）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

Her ikisi de OpenAI'nin resmî README'sinde yer alan kurulum yöntemleridir; Windows'ta da aynı npm komutuyla kurulabilir. Kurulumdan sonra proje klasöründe codex yazmanız yeterlidir. ChatGPT ile giriş yapacaksanız işlem burada tamamlanır ve aşağıdaki ayarlar atlanabilir.

API anahtarıyla çalıştırma — config.toml dosyasına bir bölüm ekleme

Önce hesap açın, en az $10 yükleyin ve ardından API anahtarı sayfasında bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir; hemen güvenli bir yere kaydedin. Sonra Codex ayar dosyasına bir sağlayıcı bölümü ekleyin:

# ~/.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"        # 唯一有效的值，省略也一樣

En kolay hata yapılan yer env_key alanıdır: buraya anahtarın kendisini değil, anahtarın tutulduğu ortam değişkeninin adını yazın. Anahtar ayar dosyasında görünmez; bu nedenle config.toml dosyasını güvenle git'e gönderebilir veya soru sormak için bir foruma yapıştırabilirsiniz.

# 把金鑰放進 env_key 指定名稱的變數（金鑰以 sk-kn- 開頭）
export KUNAVO_API_KEY="sk-kn-..."

# 寫進 shell 的設定檔，就不必每次都 export
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Windows PowerShell'de setx KUNAVO_API_KEY sk-kn-... çalıştırıp yeni bir terminal açabilirsiniz; ayar dosyası %USERPROFILE%\.codex\config.toml konumundadır. Codex'i başlatmadan önce tek bir istekle anahtarın ve uç noktanın çalıştığını doğrulayın; böylece sonradan oluşan hataların hangi bölümden kaynaklandığını anlamak daha kolay olur.

# 懷疑 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": "只回 OK"}'

JSON döndürülmesi, anahtarın ve uç noktanın düzgün çalıştığı anlamına gelir; kalan sorun config.toml tarafındadır. Ayar alanlarının açıklaması Codex CLI entegrasyon belgelerinde (İngilizce), Codex içinde Claude modellerini çağırma yöntemi ise Codex CLI API anahtarı rehberinde (İngilizce) yer alır.

İlk görev

# 1. 進到要處理的專案資料夾，啟動 Codex
cd ~/work/my-app
codex

# 2. 讓它產生 AGENTS.md 草稿（寫測試怎麼跑、專案規則的檔案）
> /init

# 3. 之後直接用中文交代。附上檔名，做得更快也更省
> src/utils/date.test.ts 一直失敗，找出原因修好，並確認測試通過

/init tarafından oluşturulan AGENTS.md, “kod okunarak anlaşılamayan kuralların” yazıldığı dosyadır — testlerin nasıl çalıştırılacağı, hangi kütüphanelerin kullanılacağı, hangi yolların değiştirilemeyeceği — ve sonraki her çalışma oturumunda otomatik olarak okunur. Oluşturulan içerik yalnızca bir taslaktır; kendiniz bir kez düzenlemeyi unutmayın.

Komut verme ipucu Claude Code ile aynıdır: dosya adlarını ve yolları ekleyin, büyük görevleri tek seferde göndermeyin. Keşif için daha az token harcanır, sonuç daha hızlı ve doğru olur, fatura da düşer.

Göreve göre model seçimi — Bir görevin gerçek maliyeti

API anahtarıyla çalıştırmanın en büyük avantajı, işin ağırlığına göre model seçebilmenizdir. model yalnızca uç noktadaki model adıdır; model değiştirmek için yeni anahtar veya ek ayar gerekmez.

# config.toml 的預設（gpt-5-6-sol）不動，只有這次啟動換模型
codex -m gpt-6-astra     # 找不到原因的 bug、跨模組的修改
codex -m gpt-5-6-terra   # 例行修改、大量取代、整理日誌這類輕量工作

“Bir görev” hesabında başarısız bir testi düzeltmek 20 adım kabul edilir. Her adım 25.000 giriş token'ı (sistem istemi + konuşma geçmişi + okunan dosyalar) ve 1.200 çıkış token'ı (bir değişiklik veya açıklama) içerir; dolayısıyla bir görev 500.000 giriş ve 24.000 çıkış token'ıdır. GPT-5.6 Sol kullanıldığında maliyet yaklaşık $1,29; aynı token sayısını doğrudan OpenAI'ye ödemek, mevcut promosyon fiyatıyla $2,48 (liste fiyatıyla $3,22) tutar. Daha ucuz modeller doğru sonuca ulaşmak için daha fazla gidip gelme gerektirebilir; bu nedenle pratikte bir denemede çözülmezse bir üst modele geçilir.

Bu hesap önbelleği içermez. Codex her adımda konuşma geçmişini yeniden gönderir; önbellekten okunan girişler, giriş birim fiyatının 0.10 katı üzerinden ücretlendirilir (GPT-5.6 Sol için 1M token başına $0,20), önbelleğe yeni yazılan bölüm ise giriş birim fiyatının 1.25 katıdır. Ayrıca GPT-5.6 serisi ve GPT-6 Astra'da tek isteğin istemi 272K token'ı aşarsa tüm istek girişte 2 kat, çıkışta 1.5 kat üzerinden ücretlendirilir; bu nedenle aynı çalışma oturumuna çok fazla iş sıkıştırmayın, bir görev için oturumu yeniden başlatmak daha güvenlidir. Akıl yürütme modellerinin düşünme token'ları çıkış ücreti üzerinden fiyatlandırılır; soru zorlaştıkça çıkış artar. Gerçek tutar için yanıttaki usage ve kullanım kayıtlarına bakın. Model özellikleri GPT-5.6 Sol model sayfasında, tüm modellerin ücretleri ise fiyat listesinde yer alır.

Yaygın hatalar

Dürüstçe — ChatGPT planı ne zaman daha hesaplıdır?

Her gün Codex ile birkaç saat ileri geri çalışıyorsanız sabit aylık ücretli plan genellikle daha ucuzdur. Kullandıkça öde, token kullanımıyla doğru orantılıdır; ne kadar fazla ve istikrarlı kullanırsanız aylık ücretin avantajı o kadar büyür. Başabaş noktası “aylık ücret ÷ bir görevin maliyeti”dir ve planlar arasındaki başabaş noktası Codex maliyetleri sayfasında hesaplanmıştır.

Önceden bilinmesi gereken iki konu daha vardır. OpenAI belgelerine göre ChatGPT çalışma alanına veya bulut hizmetlerine bağlı özellikler, API anahtarı kullanıldığında sınırlı olabilir veya kullanılamayabilir. Ayrıca Kunavo yolu paylaşılan kapasite kullanır; özel kota veya sözleşmeyle güvence altına alınmış SLA yoktur. Garantili kota ya da SLA gerekiyorsa doğrudan OpenAI ile sözleşme yapmak daha uygundur.

Buna karşılık API anahtarı; kullanımı değişken olanlar, göreve göre model seçmek isteyenler, ekip içinde sınırları ve kullanım kayıtlarını anahtar bazında ayırmak isteyenler ve yalnızca plan kotası tükendiği gün çalışmaya devam etmek isteyenler için uygundur. İkisi birlikte kullanılabilir: config.toml içindeki model_provider satırını silerek ChatGPT girişine dönün; her başlatmada geçiş yapmak için Codex'in --profile özelliğini kullanabilirsiniz.

Ödemeler uluslararası kredi kartıyla (JCB dahil), Apple Pay veya Google Pay ile yapılır; Tayvan’da yerel ödeme yöntemi yoktur — JKOPay ve LINE Pay kullanılabilir yöntemler arasında değildir. Ön ödemeli sistemde kart yalnızca yükleme sırasında bir kez çekilir, bakiyenin süresi dolmaz ve başarısız istekler ücretlendirilmez. Codex ile Claude Code arasında kararsızsanız Claude Code vs Codex CLI (İngilizce) sayfasına, Claude Code’un ücretlendirmesi için Claude Code ücretleri sayfasına bakabilirsiniz.

Sık sorulan sorular