OpenAI’nin Codex CLI’si, yapay zekâyı doğrudan yerel iş akışlarına entegre etmek isteyen geliştiriciler için hızla vazgeçilmez bir araca dönüştü. 16 Nisan 2025’te duyurulmasının ardından ve 3 Haziran 2025’te internet erişimi gibi güncellemelerle, Codex CLI terminalinizden OpenAI’nin güçlü akıl yürütme modellerinden yararlanmanın güvenli, gizliliğe odaklı ve yüksek ölçüde özelleştirilebilir bir yolunu sunuyor. Bu makale, en son gelişmeleri sentezler ve makinenize Codex CLI’yi kurup yapılandırmak için adım adım bir kılavuz sağlar.
OpenAI’nin Codex CLI’si Nedir?
Kökenler ve Duyuru
OpenAI, en yeni modelleri o3 ve o4-mini ile birlikte Codex CLI’yi tanıttı; bu, yapay zekâ destekli kodlama yardımını doğrudan terminale getiren deneysel ve açık kaynaklı bir projedir. 16 Nisan 2025’te duyurulan bu araç, AI ajanlarının yerel ortamınızda kodu okumasına, değiştirmesine ve yürütmesine olanak tanır; böylece hassas kodun makinenizi terk etmemesini sağlar.
Codex CLI’nin Temel Özellikleri
- Hafif ve Açık Kaynak: Kolay kurulum ve topluluk katkıları için tasarlanan Codex CLI’nin kod tabanı GitHub’da yer alır; hata raporlarını ve çekme isteklerini teşvik eder.
- Doğal Dil Komutları: Geliştiriciler, şablon kod üretmek, mevcut modülleri yeniden düzenlemek veya test yazmak için Codex’e sade İngilizce komutlarla talepte bulunabilir.
- Yerel Yürütme: Tüm işlemler makinenizde gerçekleşir; tescilli kodu harici sunuculara yükleme endişesini ortadan kaldırır.
- Ajan İnternet Erişimi: 3 Haziran 2025 itibarıyla, Codex CLI isteğe bağlı olarak internet erişimi sağlayabilir; bağımlılıkları kurma veya harici kaynakları getirme gibi görevler için alan ve yöntem bazında ayrıntılı denetimler sunar.
En Son Mimari Güncellemeler Neler?
2025 Haziran ayı başında, OpenAI Codex CLI’nin özgün Node.js ve TypeScript yığınından Rust’a büyük bir yeniden yazımını duyurdu. Bu geçiş, Rust’ın bellek güvenli tasarımından yararlanarak “sıfır bağımlılıklı kurulum”, geliştirilmiş performans ve artırılmış güvenlik garantileri sağlamayı hedefliyor. Geliştiriciler daha hızlı başlangıç süreleri, küçültülmüş ikili dosya boyutları ve daha sağlam derleme denetimleri bekleyebilir; tümü daha akıcı bir geliştirici deneyimine katkıda bulunur.
Neden Codex CLI’yi Yerel Olarak Kurmalısınız?
Yerel Kurulum Hangi Güvenlik ve Gizlilik Faydalarını Sunar?
Yapay zekâ modellerini yerel olarak çalıştırmak, kaynak kodunuzun şirket içinde kalması anlamına gelir. Bulutla sınırlı çözümlerin aksine, Codex CLI dosyalarınızı siz açıkça talep etmedikçe paylaşmaz; bu da veri sızıntıları veya yetkisiz erişimle ilgili riskleri önemli ölçüde azaltır.
Yerel Kurulum Performansı ve Çevrimdışı Yeteneği Nasıl Artırır?
Komutları kendi donanımınızda işleyerek, Codex CLI gecikmeyi ve harici API çağrılarına olan bağımlılığı en aza indirir. Yeni internet erişimi özellikli ajanla birlikte, çoğu görev için çevrimdışı çalışabilir ve ajanın ne zaman çevrimiçi olacağını yapılandırarak özerklik ile bağlantı arasındaki doğru dengeyi kurabilirsiniz.
Kurulum İçin Ortamınızı Nasıl Hazırlarsınız?
Önkoşullar Nelerdir?
Codex CLI’yi kurmadan önce şunlara sahip olduğunuzdan emin olun:
PATH’inize eklenmiş, yüklü Node.js (v14 veya üzeri).- Paket yönetimi için npm (genellikle Node.js ile birlikte gelir).
- Geçerli bir OpenAI API anahtarı; OpenAI kontrol panelinizdeki API ayarları bölümünden edinebilirsiniz.
OpenAI API Anahtarınızı Nasıl Alır ve Güvenceye Alırsınız?
- OpenAI kontrol paneline giriş yapın.
- API Keys bölümüne gidin ve Create new secret key’e tıklayın.
- Oluşturulan anahtarı kopyalayın ve güvenli bir kimlik bilgisi yöneticisinde saklayın.
- Sürüm kontrolüne eklemekten kaçının; yerel geliştirme için ortam değişkenlerini kullanın.
Codex CLI’yi Farklı İşletim Sistemlerine Nasıl Kurabilirsiniz?
macOS ve Linux’ta npm ile Nasıl Kurulur?
Terminalinizi açın ve şunu çalıştırın:
npm install -g @openai/codex
Bu komut codex çalıştırılabilirini genel olarak kurar ve herhangi bir dizinden erişilebilir hale getirir.
Windows’ta (PowerShell veya Git Bash) Nasıl Kurulur?
- PowerShell’i (Yönetici olarak) veya Git Bash’i açın.
- Aynı npm komutunu çalıştırın:
npm install -g @openai/codex - İsteğe bağlı olarak, Git Bash’i varsayılan kabuğunuz olarak ayarlayın:
Set-Alias sh.exe "C:\Program Files\Git\bin\bash.exe" ``` :contentReference{index=10}.
Codex CLI Nasıl Yapılandırılır ve Kimlik Doğrulaması Yapılır?
Ortam Değişkenleri Nasıl Ayarlanır?
Kurulumdan sonra, kabuk profilinizde API anahtarınızı dışa aktararak yapılandırın:
export OPENAI_API_KEY="your-api-key-here"
Kalıcı olması için bu satırı ~/.bashrc, ~/.zshrc veya ~/.profile dosyanıza ekleyin.
ChatGPT Entegrasyonu ile Nasıl Oturum Açılır?
Codex CLI, ChatGPT Plus ve Pro aboneleri için basitleştirilmiş bir oturum açma akışını destekler:
codex --free
Bu komut, OpenAI hesabınızla kimlik doğrulama ve uygun kredileri kullanma sürecinde size rehberlik eder.
Kurulumu Nasıl Doğrulayabilirsiniz?
Sürüm Nasıl Kontrol Edilir?
Şunu çalıştırın:
codex --version
Başarılı bir kurulum, CLI’ye erişilebildiğini doğrulayan bir sürüm dizgesi (ör. 0.1.0) döndürür.
Test Komutu Nasıl Çalıştırılır?
Her şeyin çalıştığından emin olmak için basit bir istem deneyin:
codex "Create a Python function to reverse a string."
Codex CLI, temel işlevselliğini göstererek ilgili Python kodunu doğrudan terminalinizde çıktılar.
CLI’yi nasıl güncel tutarım?
npm ile:
npm update -g @openai/codex
Rust ikilisiyle:
- En son sürümü GitHub’dan indirin.
- Mevcut ikili dosyanızı yeni indirilen sürümle değiştirin.
Alternatif olarak, güncellemeleri destekleyen bir paket yöneticisiyle (ör. Homebrew) kurduysanız, onun güncelleme komutlarını kullanabilirsiniz.
Codex CLI’yi Nasıl Genişletir ve Özelleştirirsiniz?
codex.yml içinde yapılandırma seçenekleri
codex.yml dosyasını düzenleyerek:
- Dizinleri hariç tutun (örn.
node_modules,vendor) - Varsayılan istem şablonlarını ayarlayın
- Yedek modelleri veya yerel açık kaynak alternatifleri seçin (çevrimdışı kullanım için StarCoder gibi)
Betikleme ve otomasyon
Codex CLI’yi derleme betiklerine veya CI iş akışlarına dahil edin:
yaml# .github/workflows/codex.yml
jobs:
ai_lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Run Codex Auto-Edit
run: |
codex --mode auto-edit "Optimize bundle size and tree-shake unused imports"
- name: Run Tests
run: npm test
Bu, standart denetleyicilerin yanında kesintisiz, yapay zekâ destekli kod iyileştirmesine olanak tanır.
Codex CLI’yi Kullanmak İçin En İyi Uygulamalar ve İpuçları Nelerdir?
Ajanlar İçin İnternet Erişimini Nasıl Yönetmelisiniz?
Varsayılan olarak internet erişimi devre dışıdır. Belirli görevler için erişim vermek üzere şunu kullanın:
codex --allow-internet
Ardından güvendiğiniz alan adlarını veya HTTP yöntemlerini belirtin. Bu, Codex’in yalnızca açıkça izin verdiğinizde dışarıya erişmesini sağlayarak güvenliği ve izlenebilirliği korur.
Nasıl Katkıda Bulunur ve Sorun Bildirirsiniz?
Deneysel bir proje olarak topluluk geri bildirimi hayati önem taşır. Katkıda bulunmak için:
- GitHub deposunu çatallayın ve çekme istekleri gönderin.
- Hatalar veya özellik istekleri için sorunlar açın; yeniden üretim adımlarını net bir şekilde açıklayın.
- Gelecek yönleri şekillendirmeye yardımcı olmak için tartışmalarda bakımcılarla etkileşime geçin.
Yukarıda belirtilen adımları izleyerek, OpenAI’nin Codex CLI’sini yerel geliştirme iş akışınıza sorunsuzca entegre edebilir; en son yapay zekâ gelişmelerinden yararlanırken kodunuz ve ortamınız üzerinde tam denetimi koruyabilirsiniz. Proje evrildikçe, güncellemeler için resmi değişiklik günlüğünü ve topluluk forumlarını takip edin; deneyimlerinizi ve iyileştirmelerinizi daha geniş geliştirici topluluğuyla paylaşmaktan çekinmeyin.
Başlarken
CometAPI, yüzlerce yapay zekâ modelini tek bir uç nokta altında birleştiren birleşik bir REST arayüzü sunar; dahili API anahtarı yönetimi, kullanım kotaları ve faturalandırma panolarıyla birlikte. Birden çok sağlayıcının URL’leri ve kimlik bilgileriyle uğraşmak yerine.
Geliştiriciler, CometAPI aracılığıyla GPT-4.1 API gibi chatGPT API’lerine erişebilirler Makale yayımlama son tarihi. Başlamak için, modelin yeteneklerini Playground içinde keşfedin ve ayrıntılı talimatlar için [API guide] bölümüne başvurun. Erişmeden önce, lütfen CometAPI’ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. CometAPI entegrasyona yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat sunar.
Ayrıca bkz. Claude Code vs OpenAI Codex: Hangisi Daha İyi