OpenAI Codex Nasıl Kullanılır? Adım Adım Başlangıç Rehberi

Bilgisayarınıza bir komut yazıyorsunuz, yapay zeka sizin yerinize kodu okuyor, yazıyor, çalıştırıyor ve hatayı düzeltip karşınıza getiriyor. Kulağa bilim kurgu gibi gelse de bu, OpenAI Codex ile bugün mümkün. Peki OpenAI Codex nasıl kullanılır ve hiç deneyimi olmayan biri nereden başlamalı? Bu yazımızda Codex’i sıfırdan kurmaktan ilk görevinizi vermeye kadar tüm adımları, sizin için sade bir başlangıç rehberi olarak derledik.

Codex’i ister terminalden ister ChatGPT üzerinden bulutta kullanın, mantık aynı: ona ne istediğinizi anlatırsınız, o da bir yazılım mühendisi gibi adım adım çalışır. Gelin önce bu aracın tam olarak ne olduğuna bakalım.

OpenAI Codex Nedir?

OpenAI Codex, OpenAI’nin geliştirdiği bir yapay zeka kodlama ajanıdır (AI coding agent). Sıradan bir kod tamamlama aracının ötesine geçer: verdiğiniz görevi anlar, projenizdeki dosyaları inceler, gerekli değişiklikleri yapar, testleri çalıştırır ve sonucu size raporlar. Yani size yalnızca öneri sunmaz, işi baştan sona kendisi üstlenebilir.

Burada bir noktayı netleştirelim: “Codex” adı ilk kez 2021’de, GitHub Copilot’a güç veren eski bir kod modeli için kullanılmıştı. Bu yazıda anlattığımız Codex ise OpenAI’nin 2025’te tanıttığı çok daha yetenekli ajan sürümüdür. Mayıs 2025’te araştırma önizlemesi olarak duyuruldu, ardından genel kullanıma açıldı ve kısa sürede milyonlarca geliştiricinin haftalık kullandığı bir araca dönüştü.

Codex’i çalıştıran modeller OpenAI’nin GPT-5 ailesinin kodlamaya özel sürümleridir (örneğin GPT-5-Codex). Bu modeller, yazılım mühendisliği görevlerinde akıl yürütme yapacak şekilde optimize edilmiştir. Yapay zekanın yazılım dünyasını nasıl dönüştürdüğünü daha geniş bağlamda merak ediyorsanız, sitemizdeki GPT-4 ve dil modelleri rehberi de iyi bir başlangıç noktasıdır.

OpenAI Codex’i Hangi Yollarla Kullanabilirsiniz?

Codex tek bir uygulamadan ibaret değildir; aynı zekayı üç farklı ortamda karşınıza çıkarır. Hangisini seçeceğiniz çalışma tarzınıza bağlıdır:

• Codex CLI (terminal): Bilgisayarınızın komut satırında çalışır. Kod makinenizde kalır, Codex yerel olarak dosyalarınızla çalışır.
• Codex Cloud (ChatGPT içinde): Tarayıcıdan ChatGPT arayüzü üzerinden kullanılır. Görevler OpenAI’nin bulut sunucularında, izole bir kum havuzunda (sandbox) çalışır.
• IDE eklentisi: Visual Studio Code, Cursor gibi editörlere kurulan eklenti sayesinde Codex’i doğrudan yazılım geliştirme ortamınızda kullanırsınız.

Yeni başlıyorsanız tavsiyemiz Codex CLI veya ChatGPT içindeki bulut sürümüdür. Şimdi ikisinin de kurulumunu adım adım görelim.

Adım 1: Codex CLI Kurulumu

Codex CLI, terminal üzerinden çalışan hafif bir kodlama aracıdır. Kurulumu birkaç dakikanızı alır. En pratik yöntem, sisteminizde Node.js kuruluysa npm paket yöneticisini kullanmaktır:

• npm ile: npm install -g @openai/codex
• macOS için Homebrew ile: brew install --cask codex
• Doğrudan kurulum betiği: OpenAI’nin resmi kurulum komutuyla (macOS, Linux ve Windows için ayrı betikler) tek satırda indirebilirsiniz.

Windows kullanıyorsanız, en kararlı deneyim için Windows için Linux Alt Sistemi’ni (WSL2) kurmanız önerilir. Kurulum bittiğinde terminale codex yazıp Enter’a basmanız yeterlidir. Güncel kurulum seçeneklerini her zaman resmi Codex GitHub deposundan doğrulayabilirsiniz.

Adım 2: Kimlik Doğrulama (ChatGPT ile Giriş veya API Anahtarı)

Codex’i ilk kez çalıştırdığınızda sizden giriş yapmanızı ister. İki yöntem vardır ve yeni başlayanlar için ilki çok daha kolaydır:

• ChatGPT hesabıyla giriş (önerilen): “Sign in with ChatGPT” seçeneğini tıklayın. Plus, Pro, Business veya Enterprise gibi bir ChatGPT aboneliğiniz varsa Codex doğrudan o planınız üzerinden çalışır; ayrıca ödeme yapmanıza gerek kalmaz.
• API anahtarı ile giriş: Geliştiriciler kullanımlarını ayrı faturalandırmak isterse OpenAI platformundan aldıkları bir API anahtarını tanımlayabilir.

ChatGPT ile giriş, abonelik kullanım hakkınızı doğrudan Codex’e taşıdığı için başlangıç için en mantıklı seçenektir. Hangi planların Codex’i kapsadığını OpenAI’nin resmi yardım belgesinden teyit edebilirsiniz.

OpenAI Codex Nasıl Kullanılır: İlk Görevinizi Vermek ve Onay Modları

Giriş yaptıktan sonra Codex’e ne yapmasını istediğinizi doğal dille yazarsınız. Örneğin “Bu projedeki giriş formuna e-posta doğrulaması ekle” ya da “Başarısız olan testi bul ve düzelt” gibi. Codex projeyi inceler, bir plan yapar ve değişiklikleri uygulamaya başlar.

Burada en önemli kavram onay modlarıdır (approval modes). Codex’in sisteminizde ne kadar serbest hareket edeceğini siz belirlersiniz:

• Öneri modu (suggest): Codex değişiklik farklarını (diff) gösterir, siz onaylamadan hiçbir şeye dokunmaz. Başlangıç için en güvenlisidir.
• Otomatik düzenleme (auto-edit): Dosya değişikliklerini kendisi uygular, ancak komut çalıştırmadan önce sizden izin ister.
• Tam otomatik (full-auto): Görevi baştan sona, müdahale olmadan tamamlar. Otomatik iş akışları için idealdir, ama dikkatli kullanılmalıdır.

Codex CLI, üretilen kodu varsayılan olarak izole bir kum havuzunda (sandbox) çalıştırır ve ağ erişimini kapalı tutar. Bu sayede yapay zeka, sizin izniniz olmadan sistem dışına çıkamaz; bu da güven açısından kritik bir tasarımdır.

Adım 4: Bulut Üzerinde Codex Kullanımı (ChatGPT)

Terminalle uğraşmak istemiyorsanız, Codex’i doğrudan ChatGPT içindeki Codex bölümünden bulutta kullanabilirsiniz. Bu yöntemde her görev, OpenAI’nin sunucularında size özel bir sanal makinede çalışır.

Bulut kullanımının tipik akışı şöyledir:

• ChatGPT içinde Codex’i açar ve bir GitHub deposu bağlarsınız.
• Ortam ayarlarından bağımlılıkları (dependencies) tanımlayarak sandbox’ı kendi geliştirme ortamınıza benzetirsiniz.
• Görevinizi yazarsınız; Codex aynı anda birden fazla görevi paralel çalıştırabilir.
• İş bitince Codex değişiklikleri ve test sonuçlarını gösterir; isterseniz tek tıkla bir pull request (değişiklik talebi) açabilirsiniz.

Yani bulut Codex, adeta bulutta çalışan bir asistan mühendis gibidir: siz başka işlerle ilgilenirken o arka planda kodunuzu yazar. Yapay zeka destekli benzer üretkenlik araçlarını merak ediyorsanız, en iyi yapay zeka yazma araçları listemiz de ilginizi çekebilir.

Örnek Bir Codex İş Akışı Nasıl İlerler?

Teoriyi somutlaştırmak için basit bir senaryo düşünelim. Diyelim ki bir web sitenizde “iletişim formu gönderilmiyor” şeklinde bir hata var. Codex CLI ile şu akışı izleyebilirsiniz:

• 1. Proje klasörünüzde codex komutunu çalıştırırsınız.
• 2. “İletişim formu gönderilmiyor, sorunu bul ve düzelt” yazarsınız.
• 3. Codex ilgili dosyaları tarar, hatalı kod satırını tespit eder ve bir çözüm önerir.
• 4. Öneri modundaysanız değişiklik farkını gözden geçirir, beğenirseniz onaylarsınız.
• 5. Codex düzeltmeyi uygular ve varsa testleri çalıştırarak sonucu doğrular.

İpucu olarak: projenizin köküne bir AGENTS.md dosyası ekleyebilirsiniz. Bu dosyada Codex’e projenizin kurallarını, kullandığınız komutları ve kod stilinizi anlatırsınız; böylece ajan sizin tarzınıza daha uygun çalışır.

Codex’i Verimli Kullanmak İçin İpuçları

Codex’ten en iyi sonucu almak, ona ne kadar net talimat verdiğinizle doğrudan ilgilidir. Şu önerileri aklınızda tutun:

• Görevi küçük ve net tutun: “Tüm projeyi yenile” yerine “şu fonksiyona hata yakalama ekle” gibi somut istekler daha iyi sonuç verir.
• Önce öneri modunda başlayın: Aracı tanıyana kadar değişiklikleri onaylayarak ilerlemek hataları azaltır.
• Bağlam sağlayın: AGENTS.md dosyası ve açıklayıcı istemler (prompt) Codex’in doğruluğunu artırır.
• Sürüm kontrolü kullanın: Git ile çalışmak, beğenmediğiniz değişiklikleri kolayca geri almanızı sağlar.

Programlamaya yeni başlıyor ve temel bilgilerinizi de güçlendirmek istiyorsanız, yazılım öğrenmek için ücretsiz sertifikalı kurslar içeriğimiz, Codex’i daha bilinçli kullanmanıza yardımcı olur.

OpenAI Codex Hakkında Sık Sorulan Sorular

OpenAI Codex ücretsiz mi?

Codex CLI aracının kendisi açık kaynaklıdır. Ancak çalışması için bir ChatGPT aboneliği (Plus, Pro, Business vb.) veya bir API anahtarı gerekir. Yani aracı indirmek ücretsizdir, kullanım hakkı aboneliğinize bağlıdır.

Kod yazmayı bilmeden Codex kullanabilir miyim?

Temel düzeyde evet, çünkü Codex’e doğal dille talimat verirsiniz. Yine de üretilen kodu anlamak, değişiklikleri onaylamak ve hataları fark etmek için yazılımın mantığına dair temel bir bilgi büyük avantaj sağlar.

Codex ile ChatGPT arasındaki fark nedir?

ChatGPT genel amaçlı bir sohbet asistanıdır; Codex ise özellikle yazılım geliştirmeye odaklanmış, projelerinizde dosya okuyup yazabilen ve komut çalıştırabilen uzmanlaşmış bir ajandır. Codex, ChatGPT’nin kodlama konusundaki uzman koludur diyebiliriz.

Sonuç

OpenAI Codex, yapay zekayı bir öneri aracı olmaktan çıkarıp gerçek bir yazılım ortağına dönüştürüyor. Kurulumun birkaç dakika sürmesi, ChatGPT hesabıyla kolayca giriş yapılabilmesi ve hem terminal hem bulut seçeneği sunması, onu yeni başlayanlar için bile erişilebilir kılıyor. İster küçük bir hatayı düzeltmek, ister yeni bir özellik eklemek isteyin, doğru talimatlarla Codex işinizi ciddi ölçüde hızlandırabilir.

Eğer bu tür yapay zeka ve teknoloji içerikleri ilginizi çekiyorsa, sitemizde yer alan “ChatGPT Alternatifi En İyi 10 Sohbet Botu Programları” adlı yazımıza da göz atabilirsiniz.