Windows/Linux'ta Codex uygulamasını çalıştırma

OpenAI’nin Codex’i, ajan odaklı yazılım geliştirme için yeni bir “komuta merkezi”: geliştiricilerin çok ajanlı kodlama iş akışlarını çalıştırmasına, deneyler için izole worktree’ler oluşturmasına ve büyük, uzun süreli mühendislik görevlerini otomatikleştirmesine olanak tanıyan bir masaüstü uygulaması + CLI + IDE uzantıları. OpenAI’nin Codex uygulaması, yerel ve bulutta AI kodlama ajanlarını çalıştırmak ve orkestre etmek için bir masaüstü arayüzüdür. macOS’ta piyasaya sürüldü ve — 2026 Mart başı itibarıyla — Windows’a genişletildi; Linux desteği planlanıyor.

Codex uygulaması nedir — ve neden önemli

Codex, geliştiricilerin ajan iş akışları, uzun süreli görevler ve çok ajanlı koordinasyon aracılığıyla kod yazmasına, yeniden düzenlemesine, test etmesine ve orkestre etmesine yardımcı olan bir AI kodlama ajanları ve ilgili araçlar ailesidir. Codex uygulaması, bu ajanları proje yönetimi, paralel ajan iş parçacıkları ve kalıcı/bulut destekli iş parçacıkları için tek bir arayüzde bir araya getiren bir masaüstü ürünüdür. Uygulama, Codex CLI ve IDE entegrasyonlarını (ör. eklentiler) tamamlar ve ajan temelli kodlamanın “görev kontrolü” olarak tasarlanmıştır.

Neden şimdi önemli:

• Verimlilik çarpanı: Ajan temelli iş akışları, örneğin iskelet kod üretimi, test paketlerini çalıştırma ve hata raporlarını triyaj etme gibi birçok görevi paralel yürütmenizi sağlar — gerçek geliştirici zamanı kazandırır.
• Uzun süreli otomasyon: Codex, saatler veya günler boyunca görevleri sürdürebilir ve ilerletebilir (CI araştırmaları, bağımlılık yükseltmeleri veya büyük refaktörler için önemlidir).
• Platform entegrasyonu: OpenAI, Codex’i masaüstü ve IDE deneyimlerine genişletti ve uygulama artık Windows’u yerel olarak (ve zaten macOS’u) destekliyor; bu, daha fazla geliştiriciye erişimi artırıyor. Erken metrikler, macOS sürümünün ilk haftasında bir milyon indirmeyi aştığını bildirdi — güçlü talebin bir işareti.
• Rekabet ivmesi: Uygulama lansmanı, diğer satıcıların ajan temelli kodlama özellikleri eklediği daha geniş bir yarışın parçasıdır (sektör haberlerinden bağlam).

OpenAI hızlı iterasyon yapıyor — 2026 Şubat sonundaki sık changelog girdileri günlük düzeltmeler ve performans iyileştirmeleri gösteriyor; bu nedenle iş akışınıza entegre ederken uygulamanın evrilmesini bekleyin.

Mevcut kullanılabilirlik ve desteklenen iş akışları

• Codex CLI, macOS, Windows ve Linux’ta desteklenir ve paket yöneticileri (npm/Homebrew) aracılığıyla veya platform ikililerini indirerek kurulabilir. CLI yerelde çalışır, depoları inceleyebilir ve düzenleyebilir, ayrıca ChatGPT ile oturum açmanızı veya bir API anahtarı girmenizi ister.
• Codex masaüstü uygulaması (GUI) önce macOS’ta yayınlandı; ardından Windows kullanılabilirliği eklendi. Yazı yazıldığı sırada, Linux masaüstü kullanılabilirliği için bir kayıt formu mevcuttur (OpenAI dağıtım bilgisi toplar). Bugün bir Linux GUI’si istiyorsanız seçenekleriniz: CLI + IDE uzantılarını kullanmak, chatgpt.com/codex adresindeki bulut/web Codex’i çalıştırmak veya (macOS Electron uygulamasını Linux’a port eden) topluluk projelerini denemek (resmi değil).

Makinenizde Codex’i çalıştırmanın 3 yolu

Windows ve Linux kullanıcıları için üç pratik mod:

1. Yerel masaüstü uygulaması (Windows): Resmi Windows derlemesi (yerel korumalı alan, PowerShell entegrasyonu). Çoğu Windows masaüstü için önerilir.
2. WSL (Windows Subsystem for Linux) + Codex uygulaması: Linux ortamını tercih ediyorsanız veya geliştirici araç zinciriniz Linux’a özgüyse faydalıdır. Windows uygulaması, ajan çalışma zamanı için WSL’i kullanacak şekilde yapılandırılabilir.
3. Linux (CLI / geliştirici modu): Masaüstü Linux derlemesi başlangıçta “yakında” iken, Codex CLI’yi, IDE eklentilerini veya masaüstü deneyimini Linux’ta çalıştırmaya yönelik topluluk girişimlerini kullanabilirsiniz (veya OpenAI’nin bildirim kaydını takip edin). Codex CLI deposu (OpenAI), yerel ajan iş akışları için mevcuttur.

Sistem gereksinimleri ve güvenlik hususları (özet)

• Windows: Windows 10/11 (64-bit). Windows uygulamasında güvenilmeyen kod yürütmeyi sınırlamak için yerel PowerShell ve Windows korumalı alanı mevcuttur. WSL kullanıyorsanız WSL2 önerilir.
• Linux: Dağıtıma göre değişir. Masaüstü uygulaması henüz genel kullanıma açık değildir; şimdilik CLI veya IDE eklentilerini kullanın. Linux derlemeleri için bilgilendirme kaydı mevcuttur.
• RAM/CPU: Ajan iş yükleri, test veya derleme çalıştırmalarını isterseniz ağır olabilir — gündelik kullanım için çok çekirdek ve 8–16 GB RAM planlayın, yoğun eşzamanlılık için daha fazlası.
• Güvenlik en iyi uygulaması: Uygulamanın korumalı alan özelliklerini kullanın, ajanları en az ayrıcalıkla çalıştırın, proje dizinlerini izole edin ve depolara anahtar gömmek yerine kısa ömürlü API anahtarları veya kullanıcı oturum açma yöntemlerini kullanın.

Windows’ta Codex uygulamasını çalıştırma — adım adım

Windows’ta iki normal senaryo:1) Yerel Codex masaüstü uygulamasını kullanın (Microsoft Store / yerel yükleyici).
2) Codex CLI’yi PowerShell veya WSL’de kullanın, isteğe bağlı olarak VS Code uzantısıyla eşleştirin.

Aşağıda pratik, test edilmiş tarzda bir sıra vardır: kurulum, yapılandırma, WSL’ye bağlanma (opsiyonel) ve sorun giderme.

1) Resmi Windows Codex uygulamasını indirin ve yükleyin

1. Codex uygulama sayfasını ziyaret edin ve resmi dokümanlar/indirme sayfasından Windows yükleyicisini (MSI/EXE) indirin. (OpenAI’nin Codex uygulama sayfası Windows indirmesini ve Windows desteği notlarını gösterir.)
2. Yükleyiciyi Yönetici olarak çalıştırın. Windows SmartScreen uyarırsa yayıncıyı doğrulayın ve kuruluma izin verin.

PowerShell örneği (yönetici komut isteminden sessiz kurulum):

# From an elevated PowerShell prompt (Admin)$installer = "C:\path\to\Codex-Setup.exe"Start-Process -FilePath $installer -ArgumentList "/S" -Wait

2) İlk çalıştırma, oturum açma ve API vs. hesap modu

Codex’i Başlat menüsünden başlatın. İlk çalıştırmada ChatGPT/OpenAI hesabınızla oturum açmanız veya bir OpenAI API anahtarı sağlamanız istenir. Hesabınızla oturum açma (bulut dizileri, kalıcı durum) en sorunsuz deneyimi sunar. API anahtarı kullanmak da çalışır ancak bazı bulut özelliklerini sınırlayabilir. Tam farklar için geliştirici dokümanlarını inceleyin.

API anahtarını ortam değişkeni olarak ayarlayın (PowerShell):

# Temporary for session$env:OPENAI_API_KEY = "sk-..."# Permanent (example - user environment)setx OPENAI_API_KEY "sk-..." /M

Güvenlik ipucu: Etkileşimli oturum açmayı veya kısa ömürlü anahtarları tercih edin; anahtarları kaynak kontrolüne eklemekten kaçının.

3) Korumalı alan ve PowerShell entegrasyonunu yapılandırın

Windows uygulaması, rastgele ana makine değişikliğini azaltmak için ajan görevlerini yerel bir korumalı alanda çalıştırır. Uygulamanın Güvenlik veya Ayarlar sayfasından korumalı alanın sıkılığını değiştirin ve ajanlarla paylaşılan dizinleri gözden geçirin.

Ajan kancaları için PowerShell’i tercih ediyorsanız, uygulamanın PowerShell profillerini çalıştırmasına izin verildiğinden ve yürütme ilkenizin gereken komut dosyalarına izin verdiğinden emin olun. Yürütme ilkesi ayarlama örneği (yönetici):

Set-ExecutionPolicy RemoteSigned -Scope LocalMachine

4) İsteğe bağlı: Codex’i WSL2 kullanacak şekilde yapılandırın (Linux araç zincirleriniz varsa önerilir)

Linux araç zincirlerinde (apt, pip, make, systemd servisleri) geliştiriyorsanız, Codex’i yerel Windows yerine ajan görevlerini WSL2’de çalıştıracak şekilde yapılandırın:

WSL2’yi yükleyin (henüz yoksa):

# Run in an elevated PowerShellwsl --install# Reboot if requested

Dağıtımı seçin (Ubuntu önerilir):

wsl --install -d Ubuntu

Codex uygulaması Ayarlar → Çalışma Zamanı bölümünde yürütme arka ucunu WSL olarak seçin ve Codex’i varsayılan WSL dağıtımına yönlendirin (ör. Ubuntu). Uygulama, Linux araç zincirleri ve dosya yolları yerel davranacak şekilde ajan süreçlerini WSL ortamınız içinde başlatacaktır.

5) Kurulumu doğrulayın ve bir smoke testi çalıştırın

Uygulama arayüzünden, küçük bir program iskeleti oluşturan ve birim testlerini çalıştıran basit bir ajan görevi oluşturun. Alternatif olarak CLI’yı kullanın:

CLI testi (PowerShell):

# Check codex version (if installed)codex --version# Run a quick agent job (pseudo-command; follow CLI docs)codex agent run --task "create python app skeleton with pytest" --project "demo"

CLI PATH’te değilse, kurulum klasörünü PATH’e ekleyin veya yükleyicinin sağladığı başlatıcıyı kullanın.

6) Yaygın Windows sorunları için sorun giderme

• Uygulama başlamıyor: Windows Olay Görüntüleyicisi’ni ve %LOCALAPPDATA%\Codex\logs konumunu kontrol edin.
• Korumalı alan, ajanların dosya yazmasını engelliyor: Klasör paylaşımı için uygulama ayarlarını düzenleyin veya bir proje klasörünü uygulamanın izin verilen listesine ekleyin.
• PowerShell komut dosyaları engellendi: Yürütme ilkesini gözden geçirin ve komut dosyalarını kaldırın (Unblock-File path\script.ps1).
• Ajan WSL’i kullanamıyor: WSL2’nin kurulu ve dağıtımın başlatılmış olduğundan (ilk çalıştırma tamamlandı) emin olun. Durumu kontrol etmek için wsl -l -v kullanın.

H2 — Linux’ta Codex uygulamasını/CLI’yı çalıştırma (adım adım)

İki pratik Linux yaklaşımı:1) Resmi olarak desteklenen: Codex CLI + IDE uzantısı (tam destekli).
2) Resmi olmayan GUI: macOS Electron uygulamasını Linux’ta çalıştıran topluluk köprü projeleri (deneysel, desteklenmiyor).

Yazı yazıldığı sırada, OpenAI’nin masaüstü Linux uygulaması yakında çıkacak olarak duyurulmuştu ve kullanıcılar bildirimler için kaydolabiliyordu; ancak Codex CLI ve geliştirici entegrasyonları mevcut ve Linux kullanıcıları için pratik yoldur. Ayrıca, gelişmiş kullanıcılar için topluluklar arası platform yeniden derlemeleri mevcuttur.

Resmi yol: Codex CLI + VS Code (kararlı, önerilen)

Bugün Linux’taki en sağlam, destekli deneyim CLI ile Codex IDE uzantılarıdır (VS Code, Cursor, vb.). CLI Linux’ta açıkça desteklenir.

Adım 1 — Sisteminizin hazırlanması (Ubuntu örneği)

# update OSsudo apt update && sudo apt upgrade -y# install build essentials & gitsudo apt install -y build-essential git curl# install Node.js via nvm (recommended)curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.4/install.sh | bash# restart shell or source ~/.bashrc, then:nvm install --lts

Adım 2 — Codex CLI’yi kurun

# install globally without sudo (using npm + nvm)npm install -g @openai/codex# verifycodex --version

Adım 3 — Kimlik doğrulama

# run the interactive CLI to authenticatecd /path/to/your/repocodex# follow the sign-in prompt: sign in with ChatGPT (OAuth) or paste API key

Adım 4 — Codex kullanımı
Örnekler:

# interactive modecodex# single-shot non-interactivecodex "Write unit tests for utils/crypto.js"# run specific commands# create a sandboxed change and show diffcodex "Add a users table migration" --dry-run

Adım 5 — Git worktree’lerini kullanın (önerilir)

# from repository rootgit checkout -b maingit worktree add ../codex-sandbox codex-sandbox-branchcd ../codex-sandbox# run Codex here so it operates on an isolated worktreecodex

Güvenlik ve yapılandırma

• CLI, yapılandırmayı ~/.codex/config.toml içinde saklar (varsayılanlar/üst yazmalar) — izinlere dikkat edin. Mümkün olduğunda API anahtarları için düz metin dosyaları yerine işletim sistemi kimlik bilgisi depolarını (Secret Service / Gnome Keyring / pass) veya ortam değişkenlerini kullanın.

Resmi olmayan yol: masaüstü GUI’yi Linux’ta çalıştırma (deneysel)

OpenAI’nin masaüstü uygulaması macOS ve Windows’ta başladı; Linux kullanıcıları, resmi bir Linux sürümü için şu anda bildirimlere kaydolabilir. Bu arada topluluk projeleri, app.asar dosyasını çıkartıp yerel modülleri yeniden derleyerek ve UI’yi bağlamak için yerel bir codex app-server arka ucunu başlatarak macOS Electron paketini Linux’ta çalıştırmanın yollarını tersine mühendislikle buldu. Bu yaklaşım desteklenmez ve güncellemelerle bozulabilir — yalnızca denemeler için kullanın ve asla üretim kodunda veya hassas depolarda kullanmayın.

Yine de denemek isterseniz (yüksek seviye):

1. macOS .dmg dosyasını indirin (kontrolünüz altındaki resmi kaynaktan).
2. app.asarı (Electron paketi) çıkartın.
3. Yerel Node modüllerini Linux için yeniden derleyin (node-pty, better-sqlite3, vb.).
4. Codex CLI’yi kurun ve arka uç olarak çalışacak yerel bir codex app-server çalıştırın.
5. Ortam değişkenlerini ayarlayan ve yerel arka uca bağlı paketlenmemiş Electron UI’yi başlatan bir sarmalayıcı komut dosyası oluşturun.

Bunu hassas makinelerde yapmayın. Bu adımları otomatikleştiren topluluk depoları ve komut dosyaları mevcuttur, ancak bunlar resmi destek kanalları değildir.

En iyi uygulamalar: güvenlik, performans ve ekip iş akışları

Güvenlik — ana makinenizi koruyun

• Korumalı alan kullanın: Mümkün olduğunda uygulamanın sıkı korumalı alanını etkinleştirin veya ajan iş yüklerini konteyner/VM’lerde çalıştırın. Windows derlemesi yerel korumalı alan desteği ekler; güvenilmeyen kod için bunu tercih edin.
• En az ayrıcalıkla bağlama: Uygulamayla yalnızca belirli proje klasörlerini paylaşın.
• Kısa ömürlü kimlik bilgileri: Kısa ömürlü API anahtarları, rol tabanlı belirteçler veya etkileşimli oturum açma kullanın. Anahtarları döndürün ve kullanımlarını denetleyin.
• Depo hijyeni: Sırları asla commit etmeyin — .gitignore ve gizli tarayıcıları kullanın. Ortam değişkenleri veya gizli depolar kullanın.

Performans — kaynak çakışmasını yönetin

• Ajan eşzamanlılığını kısın: Mütevazı bir dizüstünde onlarca tam derlemeyi paralel çalıştırmayın. Uygulamanın eşzamanlılık ayarlarını veya zamanlayıcısını kullanın.
• Ağır görevler için WSL veya konteynerler kullanın: Windows dosya sistemi performansı tuzaklarından kaçınmak için ağır derlemeleri ve testleri WSL’e veya konteynerize bir ortama taşıyın.
• Görevleri profilleyin: Ajanlar çalışırken darboğazları anlamak için CPU/RAM izlemeyi (Görev Yöneticisi, top, htop) kullanın.

Ekip iş akışı önerileri

• Paylaşılan yapılandırmalar: Ajan tariflerini (görev istemleri, araç zincirleri, başlatma komut dosyaları) ekip agent çalıştırmalarını yeniden üretmek için paylaşılan bir codex/ dizininde (sırsız) tutun.
• CI denetimi: Codex ajanlarını kod değişiklikleri önermek için kullanın, ancak birleştirmeyi CI kontrolleriyle koruyun — bir ajanı insan incelemesi olmadan otomatik birleştirme yapmayın.
• Günlükleme ve denetim: Ajan eylemleri için ayrıntılı günlüklemeyi etkinleştirin, böylece bir ajanın ne yaptığını izleyebilir ve geri alabilirsiniz.

Sorun giderme matrisi (hızlı başvuru)

Kapanış notları

Codex uygulaması, geliştiriciler için ajan temelli, uzun süreli otomasyona atılmış somut bir adımdır. Windows sürümü ve devam eden iterasyonla birlikte, geliştiricilerin Codex’i çapraz platform iş akışlarına çalıştırması, orkestre etmesi ve entegre etmesi için daha fazla yol vardır. İlk kez kuruyorsanız, resmi Windows yükleyicisini veya Linux’ta resmi CLI’yı tercih edin; uyumluluk için korumalı alanı ve WSL’i tercih edin; ve yukarıdaki güvenlik ve operasyonel en iyi uygulamaları takip edin.

CometAPI, büyük model API’lerinin tek noktadan toplanmasını sağlayan, API hizmetlerinin sorunsuz entegrasyonunu ve yönetimini sunan bir platformdur. Claude Sonnet/ Opus 4.6 ve GPT-5.3 Codex gibi çeşitli ana akım AI modellerinin çağrılmasını destekler. Erişimden önce lütfen CometAPI’ye giriş yaptığınızdan ve API anahtarını aldığınızdan emin olun. CometAPI, Codex entegrasyonunuza yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat sunar.

Hazır mısınız?→ Bugün kodlamaya kaydolun !

AI üzerine daha fazla ipucu, rehber ve haber için bizi VK, X ve Discord üzerinde takip edin!