Codex nasıl kullanılır — kurulumdan abonelik olmadan API anahtarıyla çalıştırmaya kadar

Codex, OpenAI'nin kodlama ajanıdır. Temel kullanım, terminalde çalışan Codex CLI'ı yüklemek (npm install -g @openai/codex), çalışmak istediğiniz depoda codex komutunu başlatmak ve Japonca talimat vermektir. Başlamanın iki yolu vardır: ChatGPT planıyla (Plus, Pro, Business vb.) oturum açıp kullanım kotası içinde kullanmak veya API anahtarıyla çalıştırıp yalnızca kullanılan tokenlar için ödeme yapmak. Japonca açıklama yazıları neredeyse yalnızca ilk yöntemi ele aldığından, bu sayfa ikinci yöntemi — abonelik olmadan Codex CLI çalıştırma ayarlarını, görev bazında model seçimini ve tek görevin gerçek maliyetini — sırayla açıklar.

Codex, sohbet ekranına kod yapıştırılan bir araç değil; depo içinde dosyaları okuyan, değiştiren, testleri ve komutları çalıştıran bir ajandır. Başlattıktan sonra ne kadarını onaysız bırakacağınızı /permissions ile belirleyebilirsiniz.

Codex'i kullanmanın iki yolu

API anahtarıyla çalıştırıldığında faturalandırma, OpenAI planının kullanım kotasından ayrı sayılır. OpenAI API anahtarını doğrudan kullanabilirsiniz; ancak bu sayfa Responses API uyumlu bir uç noktaya yönlendirme yöntemini ele alır. GPT-6 Astra'dan GPT-5.6 Terra'ya kadar modeller aynı anahtarla değiştirilebilir; örneğin GPT-5.6 Sol için OpenAI liste fiyatı $5,00 / $30,00(OpenAI şu anda promosyon fiyatıyla $4,00 / $20,00 sunuyor. Fiyatlandırma sayfasına göre en az 21 Kasım 2026 tarihine kadar) iken 1M token başına Kunavo fiyatı $2,00 / $12,00 olur (ücretler doğrudan katalogdan okunur).

Kurulum — 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 yöntemlerdir. Windows'ta da npm komutuyla yüklenir. Kurulumdan sonra çalışmak istediğiniz deponun dizininde codex yazarak başlatabilirsiniz. ChatGPT ile oturum açıp kullanacaksanız burada tamamlanır; sonraki ayarlar gerekmez.

API anahtarıyla çalıştırma — config.toml'a tek blok

Önce bir hesap oluşturun, $10'dan başlayarak bakiye yükleyin ve API anahtarı sayfasından bir anahtar oluşturun. Anahtar yalnızca bir kez görüntülenir; hemen kaydedin. Ardından Codex yapılandırma dosyasına bir sağlayıcı bloğu yazın.

# ~/.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"        # 唯一の有効値。省略しても同じ

Burada en kolay karıştırılan nokta env_key değeridir. Yazmanız gereken anahtarın kendisi değil, anahtarı içeren ortam değişkeninin adıdır. Anahtar yapılandırma dosyasına girmediği için config.toml değerini olduğu gibi commit etmek veya soruya yapıştırmak güvenlidir.

# env_key で指定した名前の変数にキーを入れる（キーは sk-kn- で始まる）
export KUNAVO_API_KEY="sk-kn-..."

# 毎回 export しないよう、使っているシェルの設定ファイルに追記しておく
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Windows PowerShell'de setx KUNAVO_API_KEY sk-kn-... komutunu çalıştırdıktan sonra yeni bir terminal açın. Yapılandırma dosyasının konumu %USERPROFILE%\.codex\config.toml. Codex'i başlatmadan önce anahtarın ve uç noktanın doğru olduğunu tek bir istekle doğrulamak, sonraki hata ayıklama sürecini kolaylaştırır.

# Codex を疑う前に、キーとエンドポイントだけを 1 回で確かめる
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önerse anahtar ve uç nokta düzgün çalışıyor demektir; kalan sorun varsa config.toml tarafındadır. Yapılandırma seçeneklerinin ayrıntıları Codex CLI entegrasyon belgelerinde (İngilizce), Claude modellerini Codex'ten çağırma dahil açıklama ise Codex CLI API anahtarı yapılandırma kılavuzunda (İngilizce) yer alır.

İlk görev

# 1. 作業したいリポジトリに入って起動する
cd ~/work/my-app
codex

# 2. AGENTS.md の雛形を作らせる（テストの実行方法や決めごとを書くファイル）
> /init

# 3. あとは日本語で頼む。ファイル名を添えるほど速く、安く終わる
> src/utils/date.test.ts が落ちている。原因を調べて直し、テストが通るのを確認して

/init tarafından oluşturulan AGENTS.md, testlerin nasıl çalıştırılacağı, hangi kütüphanelerin kullanılacağı ve dokunulmaması gereken yollar gibi “kodu okuyarak anlaşılamayan kuralları” içeren bir dosyadır ve sonraki oturumlarda otomatik olarak yüklenir. Oluşturulan içerik bir taslaktır; elle düzeltin.

İsteme biçiminin püf noktaları Claude Code ile aynıdır: dosya adını ve yolu ekleyin ve büyük bir isteği tek seferde göndermeyin. Keşif için kullanılan token sayısı azaldığından sonuç daha hızlı ve doğru olur, fatura da düşer. Onay iletişim kutularının sıklığını /permissions ile ayarlayabilirsiniz. Claude Code kullanımına ilişkin bilgiler Claude Code'u kullanma bölümünde toplandı.

Göreve göre model seçme — 1 görevin gerçek maliyeti

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

# config.toml の既定（gpt-5-6-sol）はそのまま、この起動だけモデルを変える
codex -m gpt-6-astra     # 原因の見えないバグ、設計をまたぐ変更
codex -m gpt-5-6-terra   # 定型の修正、一括置換、ログの要約などの軽い作業

“1 görev”, başarısız bir testi düzeltme işinin 20 adımdan oluştuğu varsayımıyla hesaplanmıştır. 1 adım; 25.000 girdi tokenı (sistem istemi + konuşma geçmişi + okunan dosyalar) ve 1.200 çıktı tokenıdır (tek bir düzenleme veya açıklama); dolayısıyla 1 görevde 500.000 girdi ve 24.000 çıktı tokenı bulunur. GPT-5.6 Sol için bu, $1,29, aynı sayıda token için OpenAI'ye doğrudan ödeme yapıldığında mevcut promosyon fiyatıyla $2,48 (liste fiyatıyla ise $3,22) demektir. Ucuz modellerde geri dönüşler nedeniyle gidip gelmeler artabileceğinden, bir seferde tamamlanmazsa bir üst seviyeye çıkmak pratik bir yaklaşımdır.

Bu hesaplama önbelleği dikkate almaz. Codex her adımda konuşma geçmişini yeniden gönderdiğinden, önbellekten kullanılan girdi, girdi 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 kısım ise girdi birim fiyatının 1,25 katı üzerinden ücretlendirilir. Ayrıca GPT-5.6 serisi ve GPT-6 Astra'da tek bir isteğin istemi 272K tokenı aşarsa, isteğin tamamı girdi birim fiyatının 2 katı ve çıktı birim fiyatının 1,5 katı üzerinden ücretlendirilir. Tek bir oturuma çok fazla iş doldurmadan her görev için yeniden başlatmak daha güvenlidir. Akıl yürütme modellerinin düşünme tokenları çıktı olarak ücretlendirildiğinden, zor görevlerde çıktı da artar. Gerçek tutarı yanıtın usage alanından ve kullanım geçmişinden kontrol edin. Model özellikleri GPT-5.6 Sol model sayfasında, tüm modellerin birim fiyatları ise fiyatlandırma tablosunda bulunur.

Yaygın hatalar

Dürüst cevap — ChatGPT planı ne zaman daha avantajlıdır?

Her gün saatlerce Codex ile etkileşimli çalışıyorsanız, sabit ücretli plan çoğu zaman daha ucuz olur. Kullanım başına ücret token miktarıyla doğrudan orantılıdır; bu nedenle çok ve istikrarlı kullananlar sabit ücretin avantajını daha fazla görür. Eşik “aylık ücret ÷ 1 görev fiyatı” ile hesaplanır; planla başa baş noktası Codex fiyatlandırması bölümünde hesaplanmıştır.

Bilmeniz gereken iki nokta daha vardır. OpenAI belgelerine göre ChatGPT çalışma alanına veya buluta bağlı özellikler, API anahtarı kullanıldığında kısıtlanır ya da kullanılamaz. Ayrıca Kunavo'nun rotası paylaşılan kapasite kullanır; özel kota veya sözleşmeye bağlı SLA yoktur. Garantili kapasite ya da SLA gerekiyorsa OpenAI ile doğrudan sözleşme yapmak daha uygundur.

Buna karşılık API anahtarı; kullandığı ve kullanmadığı günler arasında büyük fark olan, her görev için model seçmek isteyen, ekip içinde limitleri ve kullanım geçmişini anahtar bazında ayırmak isteyen ve yalnızca plan limitinin tükendiği günlerde çalışmaya devam etmek isteyen kişiler için uygundur. İkisi birlikte kullanılabilir. config.toml içindeki model_provider satırını silerseniz ChatGPT ile oturum açmaya dönersiniz; her başlatmada değiştirmek istiyorsanız Codex'in --profile seçeneğini kullanabilirsiniz.

Ödeme kartla (JCB dahil), Apple Pay, Google Pay ve benzeri yöntemlerle yapılır; bakiyenin son kullanma tarihi yoktur. Market ödemeleri ve PayPay desteklenmez. Başarısız istekler ücretlendirilmez. Codex ile Claude Code arasında kararsızsanız Codex ve Claude Code karşılaştırması bölümüne bakın.

Sık sorulan sorular