Codex CLI: abonelik yerine kendi anahtarınız

Codex, düzenleyicideki bir ipucu aracı değil, bağımsız bir uygulayıcıdır. Görevi kelimelerle formüle edersiniz, hangi dosyaları okuyacağına, hangi komutları çalıştıracağına ve neyi değiştireceğine kendisi karar verir. Yaklaşık on kadar araç emrindedir: komut çalıştırma, dosya okuma, çalışma planı tutma, kullanıcıdan açıklama isteme, alt görevler için çocuk ajanlar oluşturma.

İki çalışma modu. İnteraktif — argümansız codex, terminalde her adımın gösterildiği diyalog. İnteraktif olmayan — codex exec «görev», sonuca kadar tek seferlik çalışma: betiklerde ve CI'da kullanışlıdır.

Güvenlik yerleşiktir: varsayılan olarak ajan korumalı alanda çalışır ve değişiklik yapmadan önce onay ister. Kontrol düzeyi, "her şeyi sor" seçeneğinden çalışma dizinine yazma hakkına sahip tam otonom çalışmaya kadar yapılandırmada ayarlanır.

Bir diğer özellik ise diyalog durumudur. Codex, sunucunun hiçbir şeyi hatırlamasını istemez: tüm geçmişi kendisinde tutar ve her hamlede tamamen gönderir. Sizin için bu, yazışmaların model sağlayıcısının tarafında kalmadığı ve endpoint değişikliğinin başlatılan oturumu bozmadığı anlamına gelir.

Claude Code ve diğer terminal ajanlarından farkı tam olarak protokoldür. Codex, modelle Responses API üzerinden iletişim kurar; burada yazışma düz bir mesaj listesi olarak değil, bir öğe akışı olarak tanımlanır: metin, araç çağrısı, çağrı sonucu, akıl yürütme bloğu. Araca bu, daha katı bir diyalog modeli sağlar, size ise bu protokolü anlayan bir endpoint'e sahip olma gerekliliği sunar.

Codex, ayarları ~/.codex/config.toml içinde saklar. Kendi sağlayıcınız [model_providers.*] bloğu ile tanımlanır ve buradaki anahtar alan wire_api'dir: o olmadan Codex, Chat Completions ile konuşmaya çalışır ve ajan döngüsünü oluşturamaz.

# ~/.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 onu alacağı ortam değişkenini adlandırır. Değişken adı kendinize hastır, OPENAI_API_KEY değildir — böylece bu ayar OpenAI ile çalışan diğer araçlarınızı etkilemez.

export JOINGONKA_API_KEY=jg-sizin-anahtarınız

model alanı varsayılan modeli belirler, model_provider ise tanımlanan bloklardan hangisinin kullanılacağını seçer. Her ikisi de başlatma anında geçersiz kılınabilir, böylece tek bir yapılandırma dosyası birden fazla sağlayıcıya rahatlıkla hizmet edebilir: çalışma, deneme ve yedek.

Anahtar, kayıttan sonra kişisel hesapta verilir, orada bakiye ve harcama da görülebilir. Genel yapılandırmaya dokunmak istemiyorsanız, aynı blok -c ile tek seferlik geçirilebilir: codex -c model_provider=joingonka …. Birkaç bağımsız yapılandırma tutmak için CODEX_HOME değişkeni ile ayarlar dizinini belirtin.

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

codex exec "Tek satırda cevapla: 17*3 kaçtır?"

Codex cevabın başlığında kiminle çalıştığını yazdırır: model, provider: joingonka, sandbox modu ve oturum tanımlayıcısı. Eğer orada sağlayıcınız varsa ve aşağıda bir cevap gelmişse bağlantı canlıdır.

Daha sonra Codex'in kurulma amacı olan ana özelliği, yani dosya işlemlerini kontrol etmelisiniz. Dizin içine küçük ve bariz hata içeren bir dosya koyun ve bulunmasını isteyin:

codex exec "calc.py dosyasını oku ve tek cümleyle bir hata olup olmadığını söyle."

Ajanın kendi kendine okuma aracını çağırması, dosyayı açması ve satır numarasını belirterek cevap vermesi gerekir. Bu gerçekleşirse, tam ajan döngüsü (istek → araç çağrısı → sonuç → cevap) ağ geçidi üzerinden doğru şekilde kurulmuş demektir.

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

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

Ağın tüm modelleri tek fiyattan sunulduğu için, seçim bütçeyle değil davranışla ilgilidir. Aşağıda aynı görevin (dosya okuma ve hata bulma) Codex üzerinden her bir modelde çalıştırılmasının canlı sonuçları bulunmaktadır.

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ı verir. Aşırı kısa cevaplar istiyorsanız Kimi K2.6 tercih edin. Model, dosya düzenlemeden konfigürasyondaki model satırı veya -c model=… bayrağı ile değiştirilebilir.

Ağ modellerinin güncel listesi her zaman GET https://gate.joingonka.ai/v1/models adresinden 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.0047 ve çıkış için milyon başına $0.014 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.