Kısa cevap: macOS ve Linux'ta curl -fsSL https://chatgpt.com/codex/install.sh | sh, Windows PowerShell'de irm https://chatgpt.com/codex/install.ps1 | iex komutunu çalıştırın. Alternatif: npm install -g @openai/codex veya brew install --cask codex. Proje klasöründe codex yazın, "Sign in with ChatGPT" ile giriş yapın ve /init ile AGENTS.md oluşturun.
Bu rehber OpenAI'nin Codex CLI belgesine ve GitHub deposundaki README dosyasına dayanır. Codex'in ne olduğunu bilmiyorsanız önce OpenAI Codex nedir? yazısını okuyun.
Gereksinimler
| Bileşen | Gereksinim |
|---|---|
| İşletim sistemi | macOS (Apple Silicon ve Intel), Linux (x86_64, arm64), Windows (yerel kurulum veya WSL) |
| Hesap | ChatGPT Plus, Pro, Business, Edu, Enterprise ya da OpenAI API anahtarı |
| Ek araçlar | Git önerilir (değişiklikleri geri almak için); npm yolu için Node.js |
| Ağ | İnternet bağlantısı; sandbox içinde komutların ağ erişimi varsayılan kapalıdır |
Kurulum komutları
macOS ve Linux (standalone, önerilen)
curl -fsSL https://chatgpt.com/codex/install.sh | shWindows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"npm (Node.js kuruluysa)
npm install -g @openai/codexHomebrew (macOS)
brew install --cask codexGitHub Releases sayfasından platformunuza uygun arşivi indirip codex adıyla PATH'e koymak da mümkündür. Kurulumdan sonra:
codex --versionİlk çalıştırma ve giriş
cd ~/Projeler/magaza
codexİlk açılışta giriş yöntemi sorulur. Sign in with ChatGPT seçin; tarayıcı açılır, hesabınızla oturum açarsınız ve terminale dönersiniz. API anahtarıyla çalışmak isteyenler OPENAI_API_KEY ortam değişkenini tanımlar; bu durumda kullanım hesabınızdan düşülür.
AGENTS.md ve yapılandırma
Oturumda /init yazın. Codex projeyi tarar ve AGENTS.md taslağını üretir. Dosya proje kökünde durur, alt klasörlerde de olabilir (en yakın olan kazanır) ve ~/.codex/AGENTS.md ile kişisel kurallarınızı tüm projelerde geçerli kılarsınız. İçeriğe neler yazılmalı, Claude Code ile ortak dosya nasıl tutulur: AGENTS.md ve CLAUDE.md.
Kalıcı ayarlar ~/.codex/config.toml dosyasındadır. Örnek:
model = "gpt-5-codex"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
[mcp_servers.laravel-boost]
command = "php"
args = ["artisan", "boost:mcp"]MCP sunucularını codex mcp add komutuyla da ekleyebilirsiniz; MCP nedir? yazısında ayrıntı var.
Onay modları ve sandbox
Codex iki katmanla korunur: sandbox komutun nereye yazabileceğini ve ağa çıkabileceğini sınırlar; onay politikası ne zaman size sorulacağını belirler. /permissions komutu ikisini birlikte ayarlar.
| Mod | Davranış | Ne zaman |
|---|---|---|
| Yalnızca okuma | Dosya okur, hiçbir şey yazmaz, komut çalıştırmaz | Kod incelemesi, projeyi tanıma |
| Çalışma alanına yazma | Proje klasörüne yazar, dışına çıkmak ve ağ için sorar | Günlük geliştirme (önerilen) |
| Tam erişim | Sandbox kapalı, sormaz | Yalnızca izole ortam (Docker, CI) |
Komut satırından da verilebilir: codex --full-auto çalışma alanına yazma modunda soruları azaltır; codex --sandbox read-only salt okur.
Temel komutlar
| Komut | Açıklama |
|---|---|
codex | Etkileşimli oturum |
codex "görev" | Oturumu bu görevle başlatır |
codex exec "görev" | Etkileşimsiz çalışır, çıktıyı verir (CI için) |
codex resume | Önceki oturumu geri getirir |
codex --image ekran.png | Görseli bağlama ekler (hata ekranı, tasarım) |
/init, /status, /model, /permissions, /review | Oturum içi komutlar: AGENTS.md üret, kota ve ayarları gör, model seç, izin ayarla, değişiklikleri incelet |
Güncelleme ve kaldırma
Standalone kurulumda kurulum komutunu yeniden çalıştırmak güncel sürümü getirir. npm için npm install -g @openai/codex@latest, Homebrew için brew upgrade --cask codex. Kaldırma: npm uninstall -g @openai/codex veya brew uninstall --cask codex; ayarlar ~/.codex klasöründe kalır.
Editör ve masaüstü tarafı için Codex IDE eklentisi ve uygulaması yazısına geçebilirsiniz.
Sık Sorulan Sorular
Codex CLI için Node.js gerekli mi?
Standalone kurucu (curl veya PowerShell) ve Homebrew için gerekmez; hazır ikili dosya iner. npm ile kurmayı seçerseniz Node.js gerekir.
Codex CLI Windows'ta çalışır mı?
Evet. PowerShell kurucusuyla doğrudan Windows'a kurulur; Windows için ayrı sandbox desteği vardır. Linux araç zinciri kullananlar WSL içinde Linux kurulumunu tercih edebilir.
Giriş için API anahtarı şart mı?
Hayır. İlk çalıştırmada "Sign in with ChatGPT" seçeneğiyle Plus, Pro, Business, Edu veya Enterprise hesabınızla giriş yaparsınız. API anahtarı, kullandıkça öde isteyenler için ek seçenektir.
AGENTS.md dosyası nedir?
Codex'in her oturumda okuduğu proje kural dosyasıdır. /init komutu projeyi tarayıp ilk taslağı üretir; komutlar, kod standartları ve yasaklar buraya yazılır.
Codex'i etkileşimsiz çalıştırabilir miyim?
Evet. "codex exec \"görev\"" komutu soru sormadan çalışır ve çıktıyı verir; CI ve betiklerde kullanılır.
