Codex CLI'yi yükleyin, çalıştırılabilir dosyayı doğrulayın, oturum açın ve proje dizininizde küçük bir görevle başlayın. Resmî yükleyiciler artık macOS, Linux ve Windows'u kapsıyor; npm ve Homebrew alternatif olmaya devam ediyor. Aşağıdaki yollardan birini seçin. Çalışan bir yükleme ilk adımdır; hesap erişimi ve API faturalandırması ayrı seçimlerdir.
1. Bir yükleme yöntemi seçin
Bu komutlar resmî Codex CLI yükleme kılavuzundan alınmıştır. Aracıyı çalıştıracağınız ortam için olan yükleyiciyi kullanın. Windows çalıştırılabilir dosyasını yüklemek, WSL içine ayrı bir Linux kopyası yüklemez; dizüstü bilgisayarınıza yüklemek de daha sonra bağlanacağınız uzak sunucuya yükleme yapmaz.
curl -fsSL https://chatgpt.com/codex/install.sh | shpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Geliştirme araçlarını zaten bir paket yöneticisiyle yönetiyorsanız, her iki yükleyiciyi birden çalıştırmak yerine onun alternatifini kullanın:
| Yöntem | Yükleme | Güncelleme |
|---|---|---|
| npm | npm install -g @openai/codex | npm install -g @openai/codex |
| Homebrew | brew install --cask codex | brew upgrade --cask codex |
| Bağımsız | İşletim sisteminiz için yükleyiciyi çalıştırın | Aynı yükleyiciyi yeniden çalıştırın |
npm yolu çalışan bir npm yüklemesi gerektirir; önce npm --version komutunu kontrol edin. Node araçlarına başka türlü ihtiyacınız yoksa bağımsız yol kullanışlıdır. Yönetilen bir makinede, sonraki güncellemelerin öngörülebilir kalması için yöneticinizin desteklediği yükleme yöntemini kullanın.
2. Hangi çalıştırılabilir dosyanın çalıştığını doğrulayın
Yükleme sonrasında komut bulunamıyorsa yeni bir terminal başlatın. macOS veya Linux'ta command -v codex, kabuğunuz tarafından seçilen çalıştırılabilir dosyayı gösterir. PowerShell'de Get-Command codex kullanın. Yeniden yüklemeden önce bu yolu seçtiğiniz yükleme yöntemiyle karşılaştırın. Yüklü iki kopya, birini güncellerken diğerini başlatmaya devam etmenize neden olabilir.
codex --version
codex --help
# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."Örnek proje yolunu kendi yolunuzla değiştirin. Son komut, ilk açıklama için salt okunur bir sandbox kullanır. Bu, doğru depoyu ve model erişimini doğrulayabileceğiniz için yararlı bir ilk kontroldür. Kullanılabilir bayrakları incelemek isterseniz yüklü CLI'nin yardımını veya komut referansını kullanın.
3. Doğru hesap yolunu seçin
codex login, hesap oturum açma akışını başlatır. Tamamlamadan önce tarayıcı hesabını ve çalışma alanını kontrol edin. Doğrudan OpenAI API faturalandırması için belgelenen alternatif, Platform anahtarını standart girdiden kabul eder:
# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-keyBu API komutu bir OpenAI Platform anahtarı içindir. Üçüncü taraf bir gateway için eksiksiz kurulum değildir. Özel bir sağlayıcının kendi yapılandırması, uç noktası, kimlik bilgisi kaynağı ve desteklenen modeli gerekir. Kimlik doğrulama belgeleri yolları açıklar; Codex API anahtarı kılavuzumuz ise daha kapsamlı sağlayıcı kurulumunu ele alır.
4. İlk yanıtı yararlı bir ilk göreve dönüştürün
- İlgili kaynak kodunun ve testlerin nerede olduğunu sorun, ardından yanıtı depoya göre kontrol edin.
- Küçük bir değişiklik seçin ve beklenen davranışını belirtin.
- Temiz bir dal veya kontrol noktası kullanın ve bu değişikliğe uygun izinleri seçin.
- Codex'in ilgili kontrolleri çalıştırmasını sağlayın, ardından farkını ve açıklamasını inceleyin.
Örneğin tek bir başarısız testle veya küçük bir belge düzeltmesiyle başlayın. İlk görevi uygulamanın tamamını yeniden yazmak hâline getirmeyin: yükleme, kimlik bilgileri, yerel bağımlılıklar ve görev kalitesi aynı anda değerlendirilmesi daha zor konular olur. Kısa döngü çalıştıktan sonra proje talimatlarınızı ekleyin ve kapsamı genişletin.
Kurulum durursa ilgili katmanı düzeltin
“Command not found” yükleme veya PATH sorununa işaret eder. 401 kimlik doğrulamaya işaret eder. Model hatası seçilen sağlayıcıya ve modele işaret eder. Limit uyarısı kullanım veya faturalandırmaya işaret eder. Çalışan katmanları koruyun ve uygun şekilde 401 kontrol listesini veya kullanım limiti kılavuzunu izleyin; çalıştırılabilir dosyayı yeniden yüklemek hesap bakiyesi eklemez.
Kunavo'yu yerel Codex çalışmaları için değerlendirmek üzere hesap oluşturun ve Codex entegrasyonunu izleyin. Responses uyumlu bir sağlayıcı yapılandırması kullanır. Daha büyük bir projede yeni faturalandırma yoluna güvenmeden önce küçük bir görevi doğrulayın.
Sık sorulan sorular
Codex CLI'yi nasıl yüklerim?
İşletim sisteminiz için resmî bağımsız yükleyiciyi veya npm ya da Homebrew alternatifini kullanın. Gerekirse yeni bir terminal açın, codex --version komutunu kontrol edin, ardından proje dizininizden Codex'i başlatın ve kimlik doğrulama yönteminizi seçin.
npm install -g @openai/codex hâlâ destekleniyor mu?
Evet. 17 Eylül 2026'da kontrol edilen resmî yükleme belgelerinde npm, bağımsız yükleyiciler ve Homebrew ile birlikte listeleniyor. Bir yükleme yöntemi seçin ve çakışan kopyaları önlemek için onun güncelleme yolunu kullanın.
Codex'i yüklemek için ChatGPT aboneliğine ihtiyacım var mı?
Yükleme ve model erişimi birbirinden ayrıdır. Desteklenen yerel çalışmalar için mevcut bir ChatGPT oturum açma yolunu veya ayrı faturalandırılan API erişimini seçin. Ödeme yöntemini seçmeden önce güncel hesap seçeneklerini kontrol edin; CLI'yi yüklemek model kredisi eklemez.
Codex'i Windows'a yükleyebilir miyim?
Evet. OpenAI, Windows için bağımsız bir yükleyici sunar. Bunun yerine WSL içinde çalışmayı seçerseniz Linux sürümünü bu ortamın içine yükleyip çalıştırın ve ayrı proje yollarını ve ortam değişkenlerini takip edin.
Resmî yükleme belgeleri ve yerel CLI yardımı 17 Eylül 2026'da kontrol edilmiştir.