Codex nasıl kullanılır — kurulumdan abonelik olmadan API anahtarıyla kullanıma ve tek bir görevin gerçek maliyetine kadar

Codex, OpenAI'nin kodlama ajanıdır. Temel kullanım şekli, terminalde çalışan Codex CLI'yi yüklemek (npm install -g @openai/codex), çalışacağınız depoda codex komutunu çalıştırmak ve ardından Korece bir istekte bulunmaktır. Başlamak için iki yöntem vardır: ChatGPT planınızla (Plus · Pro · Business vb.) oturum açıp kullanım sınırları içinde kullanmak veya API anahtarıyla çalıştırıp yalnızca kullanılan token miktarı kadar ödeme yapmak. Güney Kore'deki kullanım rehberlerinin neredeyse tamamı ilk yöntemi ele aldığı için bu yazı ikinci yöntemi — abonelik olmadan Codex CLI'yi çalıştırma ayarlarını, her görev için model seçimini ve tek bir görevin gerçek maliyetini — sırasıyla açıklar. Planlara göre sınırlar ve kullanım sınırına ulaşıldığında sunulan seçenekler, Codex kullanım sınırları sayfasında ayrıca açıklanmıştır.

Codex, sohbet penceresine kod yapıştırmaya yarayan bir araç değil; depodaki dosyaları okuyan ve düzenleyen, testleri ve komutları çalıştıran bir ajandır. Hangi işleri onay istemeden yapabileceğini, başlattıktan sonra /permissions ile belirleyebilirsiniz.

Codex kullanmanın iki yolu

API anahtarıyla çalıştırdığınızda ücretler, ChatGPT planının kullanımından ayrı hesaplanır. OpenAI API anahtarını doğrudan da kullanabilirsiniz, ancak bu yazı Responses API ile uyumlu bir uç noktaya bağlanmayı anlatır. Aynı anahtarla GPT-6 Astra'dan GPT-5.6 Terra'ya kadar modeller arasında geçiş yapabilirsiniz. Örneğin GPT-5.6 Sol için 1 milyon token başına ücret $2,00 / $12,00 iken, OpenAI liste fiyatı $5,00 / $30,00 şeklindedir. (OpenAI şu anda $4,00 / $20,00 promosyon fiyatıyla sunuyor; fiyatlandırma sayfasına göre bu fiyat en az 21 Kasım 2026 tarihine kadar geçerli) (Ücretler doğrudan katalogdan okunur.)

Codex kurulumu — npm veya Homebrew

# npm (Node.js만 있으면 macOS / Linux / Windows 공통)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

Her iki yöntem de OpenAI'ın resmi README dosyasında yer alan kurulum yöntemleridir. Windows'ta da npm komutuyla kurulum yapılabilir. Kurulum tamamlandığında, çalışacağınız deponun dizininde codex yazarak başlatabilirsiniz. ChatGPT ile giriş yaparak kullanacaksanız işlem burada biter; aşağıdaki ayarlara gerek yoktur.

Codex API anahtarı oluşturma ve yapılandırma — tek bir config.toml bloğu

Önce kaydolun, en az $10 bakiye yükleyin ve ardından API anahtarı ekranında bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir; hemen kaydedin. Sonra Codex yapılandırma dosyasına bir sağlayıcı bloğu 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 sık hata yapılan yer env_key alanıdır. Buraya yazılması gereken, anahtarın kendisi değil, anahtarı tutacak ortam değişkeninin adıdır. Anahtar yapılandırma dosyasında bulunmadığı için config.toml dosyasını commit etmek veya bir soru gönderisine eklemek güvenlidir.

# env_key에 적은 이름의 변수에 키를 넣습니다 (키는 sk-kn-으로 시작)
export KUNAVO_API_KEY="sk-kn-..."

# 매번 export하지 않도록, 쓰는 셸의 설정 파일에 추가해 둡니다
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Windows PowerShell kullanıyorsanız 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 şeklindedir. Codex'i başlatmadan önce tek bir istekle anahtarı ve uç noktayı doğrulamak, sorunları birbirinden ayırmayı kolaylaştırır.

# 코덱스를 의심하기 전에, 키와 엔드포인트만 요청 한 번으로 확인합니다
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 config.toml tarafındadır. Yapılandırma seçenekleri Codex CLI entegrasyon belgelerinde (İngilizce), Codex'ten Claude modellerini çağırmayı da anlatan açıklamalar ise Codex CLI API anahtarı rehberinde (İngilizce) yer alır.

İlk görev

# 1. 작업할 저장소로 들어가 실행합니다
cd ~/work/my-app
codex

# 2. AGENTS.md 초안을 만들게 합니다 (테스트 실행법이나 규칙을 적는 파일)
> /init

# 3. 이후엔 한국어로 요청합니다. 파일 경로를 붙일수록 빠르고 싸게 끝납니다
> src/utils/date.test.ts가 실패해. 원인을 찾아서 고치고 테스트가 통과하는지 확인해줘

/init komutunun oluşturduğu AGENTS.md, testlerin nasıl çalıştırılacağı, kullanılan kütüphaneler ve değiştirilmemesi gereken yollar gibi “kodu okuyarak öğrenilemeyen kuralların” yazıldığı bir dosyadır ve sonraki oturumlarda otomatik olarak okunur. Oluşturulan içerik bir taslaktır; elle düzenleyin.

İstek hazırlama yöntemi Claude Code ile aynıdır. Dosya yollarını ekleyin ve büyük işleri tek seferde vermeyin. Böylece inceleme için kullanılan token sayısı azalır, sonuçlar daha hızlı ve doğru olur, ücret de düşer. Claude Code'un kullanımına ilişkin yöntemler Claude Code kullanım rehberinde açıklanmıştır.

Her iş için model seçimi — tek bir işin gerçek maliyeti

API anahtarıyla çalıştırmanın en büyük avantajı, işin zorluğuna uygun modeli seçebilmenizdir. model yalnızca uç noktadaki model adıdır; değiştirmek için yeni bir anahtar veya ek yapılandırma gerekmez.

# config.toml의 기본값(gpt-5-6-sol)은 그대로 두고, 이번 실행만 모델을 바꿉니다
codex -m gpt-6-astra     # 원인을 모르는 버그, 여러 모듈에 걸친 변경
codex -m gpt-5-6-terra   # 정형화된 수정, 일괄 치환, 로그 요약 같은 가벼운 작업

“Bir görev”, başarısız olan bir testi düzeltmenin 20 adım sürdüğü varsayımıyla hesaplanmıştır. Bir adım 25.000 girdi tokenı (sistem istemi + konuşma geçmişi + okunan dosyalar) ve 1.200 çıktı tokenı (tek bir düzeltme veya açıklama) içerdiğinden, bir görev toplam 500.000 girdi ve 24.000 çıktı tokenı gerektirir. GPT-5.6 Sol ile maliyet $1,29, aynı tokenlar için doğrudan OpenAI'a ödeme yaparsanız mevcut promosyon fiyatıyla $2,48 (liste fiyatıyla $3,22) olur. Daha ucuz modellerde tekrar tekrar düzeltme yapmak gerektiğinden etkileşim sayısı artabilir; bu yüzden iş tek seferde bitmezse bir üst modele geçmek daha gerçekçidir. Kendi token sayılarınızı girerek hesaplamak için maliyet hesaplayıcısını kullanın.

Bu hesaplama önbelleği hesaba katmaz. Codex her adımda konuşma geçmişini yeniden gönderdiği için önbellekteki girdi, girdi birim fiyatının 0,10 katı üzerinden ücretlendirilir (GPT-5.6 Sol için 1 milyon token başına $0,20); önbelleğe yeni yazılan miktar ise girdi birim fiyatının 1,25 katıdır. Ayrıca GPT-5.6 ailesinde ve GPT-6 Astra'da, tek bir isteğin istemi 272 bin tokenı aşarsa o isteğin tamamı girdi için 2 kat, çıktı için 1,5 kat ücretlendirilir. Tek bir oturuma çok fazla iş yüklemek yerine her iş için yeniden başlatmak daha güvenlidir. Akıl yürütme modellerinin düşünme tokenları çıktı olarak ücretlendirildiğinden, iş zorlaştıkça çıktı miktarı da artar. Gerçek tutarı yanıtın usage alanında ve kullanım geçmişinde kontrol edin. Model özellikleri GPT-5.6 Sol model sayfasında, tüm ücretler fiyat tablosunda yer alır. Codex'in kullandığı GPT modellerinin token ücretlerini yan yana karşılaştıran tablo ise GPT API fiyatları sayfasındadır.

Sık karşılaşılan hatalar

Açıkça söyleyelim — ChatGPT planının daha iyi olduğu durumlar

Her gün birkaç saat Codex ile konuşarak çalışıyorsanız sabit ücretli bir plan genellikle daha ucuzdur. Kullanıma göre ücretlendirme doğrudan token miktarıyla orantılı olduğundan, kullanım arttıkça ve düzenli hale geldikçe sabit ücretin avantajı büyür. Hesaplama ölçütü “aylık sabit ücret ÷ tek bir işin birim maliyeti” şeklindedir; planla karşılaştırıldığında başa baş noktası Codex ücretleri sayfasında hesaplanmıştır.

Bilmeniz gereken iki nokta daha var. OpenAI belgelerine göre, ChatGPT çalışma alanına veya buluta dayanan özellikler API anahtarıyla kullanımda sınırlıdır ya da kullanılamaz. Ayrıca Kunavo üzerinden erişim paylaşılan kapasiteye dayanır; özel kota veya sözleşmeye dayalı SLA yoktur. Garantili limitlere veya SLA'ya ihtiyacınız varsa 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 olanlara, her iş için model seçmek isteyenlere, ekipte her anahtarın limitini ve kullanım geçmişini ayrı tutmak isteyenlere ve yalnızca plan limitinin tükendiği günlerde çalışmaya devam etmek isteyenlere uygundur. İkisi birlikte kullanılabilir. config.toml dosyasındaki model_provider satırını silerseniz ChatGPT ile girişe dönersiniz; her başlatmada değiştirmek istiyorsanız Codex'in --profile seçeneğini kullanabilirsiniz.

Kunavo yüklemesi kart, Apple Pay, Google Pay ve benzeri yöntemlerle yapılır; ödeme ekranı won cinsinden görüntülenirse KakaoPay, Naver Pay, PAYCO, Samsung Pay ve yerel kartlar (yurt dışı ödemeleri açık olmayan kartlar dahil) da görünür. Toss desteklenmez. Bakiyenin geçerlilik süresi yoktur ve 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