Codex CLI: abonelik yerine kendi anahtarınız

Codex, editördeki bir yardımcı değil, bağımsız bir uygulayıcıdır. Görevi kelimelerle siz ifade edersiniz; hangi dosyaları okuyacağına, hangi komutları çalıştıracağına ve neyi değiştireceğine kendisi karar verir. Emrinde yaklaşık on kadar araç var: komut çalıştırma, dosya okuma, iş planı tutma, kullanıcıdan açıklama isteme, alt görevler için alt ajanlar oluşturma.

İki çalışma modu. Etkileşimli — argümansız codex, her adımı gösteren terminal diyaloğu. Etkileşimsiz — codex exec "task", sonuca kadar tek seferlik çalıştırma: script'lerde ve CI'da kullanışlı.

Güvenlik yerleşik: ajan varsayılan olarak sandbox'ta çalışır ve değişikliklerden önce onay ister. Kontrol seviyesi yapılandırmada belirlenir — "her şeyi sor"dan çalışma dizinine yazma hakkı olan tamamen otonom bir çalıştırmaya kadar.

Bir diğer özellik de diyalog durumu. Codex sunucudan hiçbir şeyi hatırlamasını istemez: tüm geçmişi kendi tarafında tutar ve her turda tamamını gönderir. Bu sizin için şu anlama gelir: yazışma model sağlayıcısının tarafında birikmez ve endpoint değişikliği başlatılmış oturumu bozmaz.

Claude Code ve diğer terminal ajanlarından farkı tam da protokolüdür. Codex, modelle Responses API üzerinden konuşur; burada yazışma düz bir mesaj listesiyle değil, bir öğeler akışıyla tanımlanır: metin, araç çağrısı, çağrı sonucu, akıl yürütme bloğu. Bu, araca daha katı bir diyalog modeli sunarken, sizin için bu protokolü anlayan bir endpoint'e sahip olma gerekliliğini doğurur.

Hızlı yol — kurulum aracı. npx @joingonka/setup --tool codex komutu ~/.codex/config.toml dosyasına wire_api = "responses" içeren sağlayıcı bloğunu, modeli ve gerçek bağlam penceresini kendisi ekler; yorumlarınızı ve diğer ayarlarınızı korur, ardından canlı bir istekle anahtarı ve modeli doğrular. Yapılandırmada zaten başka bir sağlayıcı seçiliyse kurulum aracı ona dokunmaz ve tek seferlik çalıştırma komutunu gösterir. Anahtarı doğrudan dosyaya yazar (izinler 600), experimental_bearer_token alanına — Codex'in anahtarı düz metin olarak saklayabildiği tek alan; Codex'in kendisi bunu deneysel sayar. Aşağıdaki manuel yöntem bir ortam değişkeniyle idare eder.

Codex ayarlarını ~/.codex/config.toml içinde saklar. Kendi sağlayıcınız [model_providers.*] bloğuyla tanımlanır ve buradaki kilit alan wire_api'dir: o olmadan Codex Chat Completions üzerinden konuşmayı dener ve ajan döngüsünü kuramaz.

# ~/.codex/config.toml
model_provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"

[model_providers.joingonka]
name = "JoinGonka Gateway"
base_url = "https://gate.joingonka.ai/v1"
env_key = "JOINGONKA_API_KEY"
wire_api = "responses"

Anahtar dosyaya yazılmaz: env_key, Codex'in anahtarı alacağı ortam değişkenini adlandırır. Değişken adı kendine ait, OPENAI_API_KEY değil — böylece bu yapılandırma OpenAI ile çalışan diğer araçlarınızı ele geçirmez.

export JOINGONKA_API_KEY=jg-your-key

model alanı varsayılan modeli belirler, model_provider ise tanımlı bloklardan hangisinin kullanılacağını söyler. Her ikisi de başlatma anında geçersiz kılınabilir, böylece tek bir yapılandırma birkaç sağlayıcıyı rahatça idare eder: üretim, deneysel ve yedek.

Anahtar, kayıttan sonra kişisel panelde verilir; bakiye ve harcama da orada görünür. Genel yapılandırmaya dokunmak istemiyorsanız aynı bloğu -c ile tek seferlik geçirebilirsiniz: codex -c model_provider=joingonka …. Birden fazla bağımsız yapılandırma tutmak içinse ayar dizinini CODEX_HOME değişkeniyle belirtin.

Bağlantının çalıştığından emin olmanın en hızlı yolu tek seferlik bir denemedir:

codex exec "Answer in one line: what is 17*3?"

Yanıtın başlığında Codex kiminle çalıştığını yazar: model, provider: joingonka, sandbox modu ve oturum kimliği. Orada sizin sağlayıcınız varsa ve aşağıda bir yanıt geldiyse bağlantı canlı demektir.

Sırada Codex'in asıl kurulma sebebini, yani dosyalarla çalışmayı test etmek var. Dizine bariz bir hata içeren küçük bir dosya koyun ve bulmasını isteyin:

codex exec "Read calc.py and tell me in one sentence whether it has a bug."

Ajan okuma aracını kendisi çağırmalı, dosyayı açmalı ve satır belirterek işin özüne dair yanıt vermeli. Bu gerçekleştiyse tam ajan döngüsü (istek → araç çağrısı → sonuç → yanıt) ağ geçidi üzerinden doğru şekilde kuruluyor demektir.

Bir şeyler ters giderse teşhis genellikle doğrudan mesajdan okunur:

Bir oturumdaki ilk istek birkaç saniye sürebilir: Codex büyük bir sistem istemi ve tüm araçlarının tanımını gönderir, ağ düğümünün de görevi kabul etmesi gerekir. Sonraki yanıtlar daha hızlı gelir.

Ağın tüm modelleri aynı fiyata mevcuttur, bu nedenle seçim bütçe hakkında değil, davranış hakkındadır. Aşağıda aynı görevin (dosya okuma ve hata ayıklama) DeepSeek V4 Flash ve MiniMax M2.7 üzerinde Codex aracılığıyla canlı çalıştırma sonucu verilmiştir; GLM-5.3 Flash ağa çalıştırdıktan sonra katıldı — onun için model özellikleri verilmiştir.

Varsayılan öneri DeepSeek V4 Flash'tır: ajan çalışmaları hızla bağlam hacmine takılır ve 380K token, birçok dosyayı aynı anda akılda tutma imkanı sağlar. Eğer görev karmaşık bir mantık üzerine düşünmeyi gerektiriyorsa, GLM-5.3 Flash'ı alın, ancak max_tokens için yedek pay bırakın: yanıt bütçesinin bir kısmı düşünme sürecine gider. Model, dosyayı düzenlemeden config içindeki model satırı veya -c model=… bayrağı ile değiştirilir.

Ağın güncel model listesi her zaman GET https://gate.joingonka.ai/v1/models üzerinden alınır.

Ajan araçları tokenleri sohbetten farklı harcar: Codex her ifadenize bir sistem istemi ve tüm araçların açıklamasını ekler, ardından modelle çok aşamalı bir diyalog yürütür. Canlı çalışmada basit bir “dosyayı oku ve hatayı bul” görevi yaklaşık 18-20 bin tokene mal oldu. Bu, otonomluk için normal bir bedeldir ve tam olarak bu yüzden token fiyatı belirleyicidir.

JoinGonka Gateway üzerinden tokenler giriş için milyon başına $0.0069 ve çıkış için milyon başına $0.021 maliyetindedir — fiyat tüm ağ modelleri için aynıdır ve bu sayfaya canlı kaynaktan yansıtılır.

Karşılaştırma için — Codex'in kendi ücretli seçenekleri ve nişindeki komşuların yapıları şöyledir:

Ödeme aylık abonelik ve istek kotası olmadan gerçek tüketim üzerinden yapılır: 5 saatlik pencereler, “istemi” limiti veya yoğun saatlerde çarpanlar yoktur. Bakiye kripto para ile yüklenir, bakiye ve günlük harcama kişisel panelden görülebilir. Ekonomi hakkındaki detaylı analiz en ucuz API hakkında makalededir.

Diyalog geçmişini Codex'in kendisi tutar. Her istekte bunu bütünüyle gönderir ve sunucudan hiçbir şeyi hatırlamasını istemez — biz de yazışmaları saklamayız. Kodunuz ve komutlarınız cevap geldikten sonra ağ geçidinde kalmaz.

Web araması çalışıyor. Codex her istekte bir arama aracı duyurur ve ağ geçidi bunu kabul eder: Arama bizim tarafımızdan gerçekleştirilir, sonuçlar modelin yanıtına eklenir.

Araçlar bulut tabanlı değil, yereldir. Codex komutları yürütür ve dosyaları yerel olarak makinenizde okur, bu nedenle projeye erişim model sağlayıcısına bağlı değildir.

Sandbox. Linux üzerinde Codex, çalıştırılan komutları izole etmek için bubblewrap kullanır. Eğer sistemde yüklü değilse, Codex sizi uyarır ve yerleşik bir kopyasını kullanır — bu durum çalışmayı etkilemez, ancak paketi standart yönetici ile kurmak daha pratiktir.

Görsellerle çalışmanız gerekiyorsa — arayüz ekran görüntüsü, fotoğraftaki şema — bu tür görevler için vizyon yeteneğine sahip bir model aracı kullanın: Gonka ağındaki modeller metin tabanlıdır. Kod, komutlar ve dosyalar için bu bir kısıtlama değildir.

Eğer Codex uygun değilse diğer terminal ajanları: API hızlı başlangıç kılavuzu, herhangi bir uyumlu aracı birkaç dakika içinde nasıl bağlayacağınızı gösterir.