Google Gemini 2.5 Pro'yu Open Codex CLI (Open Codex CLI) ile Nasıl Kullanılır

Open Codex CLI, büyük dil modellerinin (LLM'ler) gücünü doğrudan terminal iş akışınıza getiren açık kaynaklı bir araçtır. Bu kılavuz, özellikle günümüzde mevcut en gelişmiş modellerden biri olan Google'ın Gemini 2.5 Pro'sunun Open Codex CLI ortamında kullanılmasını ele almaktadır.

Open Codex CLI, orijinal OpenAI Codex CLI'nin bir çatalıdır ve temel işlevselliğini korurken, Google Gemini dahil olmak üzere birden fazla yapay zeka sağlayıcısı için destek ekleyerek yeteneklerini önemli ölçüde genişletir. Bu, geliştiricilerin, aşina oldukları terminal arayüzünden ayrılmadan, görevleri için en iyi modeli seçmelerini sağlar. Karmaşık kodlama soruları sormayı, hazır kod oluşturmayı, mevcut işlevleri yeniden düzenlemeyi, karmaşık komut dosyalarını açıklamayı ve hatta derleme komutlarını düzenlemeyi hayal edin; bunların tümü, komut satırınızdan ayrılmadan Gemini'nin zekası tarafından yönlendirilir.

Bu makale, Open Codex CLI'nin özellikle Google Gemini 2.5 Pro ile (Open Codex CLI yapılandırmasında belirtildiği gibi, yazıldığı sırada mevcut olan gemini-2.5-pro-preview-03-25 model sürümüne atıfta bulunarak) ve gemini-2.0-flash gibi kardeş modelleriyle kurulumu, yapılandırılması ve kullanılması için kapsamlı, adım adım bir kılavuz sunmaktadır. İster iş akışınızı optimize etmek isteyen deneyimli bir geliştirici olun, ister yapay zeka kodlama asistanları konusunda yeni olun, bu güçlü kombinasyonu nasıl kullanacağınızı öğreneceksiniz.

💡

Harika bir API Dokümantasyonu oluşturan harika bir API Test aracı mı istiyorsunuz? Güzel API Dokümantasyonu?

Geliştirici Ekibinizin maksimum verimlilikle birlikte çalışması için entegre, Hepsi Bir Arada bir platform mu istiyorsunuz?

Apidog tüm taleplerinizi karşılıyor ve Postman'in yerini çok daha uygun bir fiyata alıyor!

button

Neden Gemini ile Open Codex CLI?

This is wild. In just a few hours my friend forked Open AI Codex to work with Gemini 2.5 Pro 🤯 pic.twitter.com/gENT01q82P
— Sawyer Hood (@sawyerhood) April 17, 2025

Open Codex CLI'yi Gemini 2.5 Pro ile birleştirmek, cazip bir dizi avantaj sunar:

Terminal-Yerel İş Akışı: Komut satırını tercih eden geliştiriciler için Open Codex CLI, kesintisiz bir entegrasyon sağlar. Yapay zeka yardımı için düzenleyiciniz, terminaliniz ve ayrı bir tarayıcı penceresi arasında bağlam değiştirmenize gerek yoktur. Bu, daha hızlı yinelemeye ve daha az kesintiye yol açar.
Açık Kaynak ve Esnek: Açık kaynaklı (npm'de open-codex) olmak, şeffaflık ve topluluk katkıları potansiyeli sunar. Çok sağlayıcılı desteği (Gemini, OpenAI, OpenRouter, Ollama), temel araçlarınızı değiştirmeden, gerektiğinde model veya sağlayıcıları değiştirme esnekliği sağlar.
Güçlü Yapay Zeka Yetenekleri: Gemini 2.5 Pro, son teknoloji ürünü muhakeme, kod oluşturma ve anlama yetenekleri getirir. Bu, daha karmaşık görevlere, daha iyi kod kalitesi önerilerine ve doğrudan CLI içinde daha derin analizlere olanak tanır.
Eylem Odaklı: Basit sohbet robotlarının aksine, Open Codex CLI eylem için tasarlanmıştır. Bağlam için yerel dosyalarınızı okuyabilir, dosya değişiklikleri (yamalar) önerebilir ve güvenli bir korumalı alanda kabuk komutları yürütebilir, gerçek sohbet odaklı geliştirme sağlayabilir.
Güvenlik Odaklı: CLI, özellikle otomatik onay modlarını kullanırken, kabuk komutları gibi potansiyel olarak riskli işlemleri güvenli bir şekilde yürütmek için korumalı alan mekanizmaları (macOS'ta Apple Seatbelt, Linux'ta Docker önerilir) içerir. Daha yüksek özerklik modlarında, komutları ağ bağlantısı devre dışı bırakılmış ve varsayılan olarak dizin korumalı alanında çalıştırır.
Sürüm Kontrol Entegrasyonu: Araç, Git ile birlikte çalışacak şekilde tasarlanmıştır. Varsayılan olarak, dosyaları değiştirmeden önce onay gerektirir ve değişikliklerin çalışma dizininizi etkilemesinden önce incelemenize olanak tanır ve her zaman bir güvenlik ağına sahip olmanızı sağlar.

Önkoşullar

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

İşletim Sistemi: macOS 12 veya üzeri, modern bir Linux dağıtımı (Ubuntu 20.04+, Debian 10+ gibi) veya Windows Alt Sistemi for Linux (WSL2) kullanan Windows 10/11. Doğrudan Windows desteği mevcut değildir.
Node.js: Sürüm 22 veya üzeri gereklidir. LTS (Uzun Süreli Destek) sürümleri genellikle önerilir. Terminalinizde node -v komutunu çalıştırarak sürümünüzü kontrol edebilirsiniz. Node.js'yi nodejs.org adresinden indirin.
Google Cloud Hesabı ve Gemini API Anahtarı: Gemini modellerine istekleri doğrulamak için bir API anahtarına ihtiyacınız olacak. Bunu Google AI Studio veya Google Cloud Console aracılığıyla edinebilirsiniz. Bu anahtarı hesabınızla bağlantılı olduğu için güvenli bir şekilde saklayın.
Terminal Aşinalığı: Sisteminizin komut satırı arayüzünü (Terminal, iTerm, Bash, Zsh, vb.) kullanma konusunda temel bilgi varsayılır.

Adım 1: Open Codex CLI'yi Yükleme

Open Codex CLI'yi yüklemenin önerilen yolu, Node.js ile birlikte gelen npm (Node Package Manager) aracılığıyla genel olarak yapmaktır. Terminalinizi açın ve şunu çalıştırın:

npm install -g open-codex

Alternatif olarak, paket yöneticiniz olarak Yarn kullanıyorsanız, şunu çalıştırabilirsiniz:

yarn global add open-codex

Bu komut, open-codex paketini indirir ve open-codex komutunun terminalinizdeki her yerden erişilebilir olmasını sağlar. Genel npm yüklemeleri için sudo kullanmaktan kaçının; izin sorunlarıyla karşılaşırsanız, npm izinlerini düzeltmek daha iyidir.

Yüklemeyi open-codex --version veya open-codex --help komutunu çalıştırarak doğrulayabilirsiniz.

Adım 2: Gemini Erişimini Yapılandırma

Gemini modellerini kullanmak için Open Codex CLI'nin API anahtarınıza ihtiyacı vardır ve gemini sağlayıcısını kullanmak istediğinizi bilmesi gerekir. Bunu yapılandırmanın iki ana yolu vardır:

Yöntem 1: Ortam Değişkeni (Hızlı Başlangıç/Test için Önerilir)

API anahtarınızı sağlamanın en basit yolu, bir ortam değişkeni aracılığıyladır. Open Codex CLI, gemini sağlayıcısı seçildiğinde özellikle GOOGLE_GENERATIVE_AI_API_KEY'yi arar.

Terminalinizde, "YOUR_API_KEY_HERE" ifadesini gerçek Gemini API anahtarınızla değiştirerek aşağıdaki komutu çalıştırın:

export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY_HERE"

Önemli: Bu komut, ortam değişkenini yalnızca geçerli terminal oturumu için ayarlar. Terminali kapatır veya yeni bir terminal açarsanız, komutu tekrar çalıştırmanız gerekir.

API anahtarını kalıcı olarak kullanılabilir hale getirmek için, export satırını kabuk yapılandırma dosyanıza eklemeniz gerekir. Yaygın dosyalar şunlardır:

~/.zshrc (Zsh için, son macOS'lerde varsayılan)
~/.bashrc veya ~/.bash_profile (Bash için)

Uygun dosyaya export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY_HERE" satırını ekleyin, kaydedin ve ardından değişiklikleri uygulamak için terminalinizi yeniden başlatın veya source ~/.zshrc (veya ilgili dosya yolu) komutunu çalıştırın.

Daha sonra, --provider bayrağını kullanarak her çağrıda Gemini'yi sağlayıcı olarak belirtebilirsiniz:

open-codex --provider gemini "Fransa'nın başkenti neresidir?"

Yöntem 2: Yapılandırma Dosyası (Kalıcı Kurulum için Önerilir)

Özellikle Gemini'yi sürekli kullanmayı planlıyorsanız, daha kalıcı bir kurulum için Open Codex CLI yapılandırma dosyasını kullanabilirsiniz. CLI, ~/.codex/config.json adresinde bir yapılandırma dosyası arar.

Dizin yoksa oluşturun: mkdir -p ~/.codex

Yapılandırma dosyasını oluşturun ve açın: nano ~/.codex/config.json (veya tercih ettiğiniz metin düzenleyiciyi kullanın).

Gemini'yi varsayılan sağlayıcı olarak belirtmek için aşağıdaki JSON içeriğini ekleyin:

{
  "provider": "gemini"
}

İsteğe bağlı olarak, varsayılan bir Gemini modeli de ayarlayabilirsiniz. Open Codex CLI, Gemini için gemini-2.5-pro-preview-03-25'i varsayılan "aracı" modeli ve gemini-2.0-flash'i varsayılan "tam bağlam" modeli olarak tanımlar. Güçlü 2.5 Pro modelini çoğu etkileşim için varsayılan olarak açıkça ayarlamak için şunu kullanın:

{
  "provider": "gemini",
  "model": "gemini-2.5-pro-preview-03-25"
}

Dosyayı kaydedin ve düzenleyiciden çıkın.

Önemli olarak, sağlayıcıyı ve modeli ayarlamak için yapılandırma dosyasını kullanırken bile, Yöntem 1'de açıklandığı gibi yine de GOOGLE_GENERATIVE_AI_API_KEY ortam değişkenini ayarlamanız gerekir. Yapılandırma dosyası, CLI'ye hangi sağlayıcıyı kullanacağını söylerken, ortam değişkeni o sağlayıcı için kimlik bilgilerini sağlar.

Yapılandırma dosyası ayarlandıktan sonra, artık open-codex komutunu çalıştırabilirsiniz ve varsayılan olarak belirtilen Gemini sağlayıcısını kullanacaktır:

open-codex "Fransa'nın başkenti neresidir?"

Adım 3: Gemini ile Temel Kullanım

Open Codex CLI, Gemini için yüklendiğine ve yapılandırıldığına göre, onunla nasıl etkileşim kuracağımızı inceleyelim.

Etkileşimli Mod (REPL)

Sohbet benzeri bir deneyim için, CLI'yi belirli bir istem olmadan çalıştırın:

open-codex
# Veya config.json dosyasında varsayılan sağlayıcıyı ayarlamadıysanız:
# open-codex --provider gemini

Bu, istemleri yazabileceğiniz, yanıtlar alabileceğiniz ve Gemini ile sürekli bir konuşma yapabileceğiniz bir Okuma-Değerlendirme-Yazdır Döngüsü (REPL) başlatır.

❯ open-codex --provider gemini
Open Codex CLI'ye hoş geldiniz! İstediğinizi yazın, ardından göndermek için Enter'a iki kez basın.
> Bana Gemini 2.5 Pro modeli hakkında bilgi verin.

İstemi göndermek için Enter'a iki kez basın. Gemini terminal içinde yanıt verecektir. Takip soruları yazarak sohbete devam edebilirsiniz.

Doğrudan İsteme

Tek seferlik istekler için, istemi doğrudan bir argüman olarak geçirebilirsiniz. config.json dosyasında varsayılanları ayarlamadıysanız, sağlayıcı bayrağına ihtiyacınız olacaktır. Ayrıca, --model veya -m bayrağını kullanarak tam modeli belirtebilirsiniz:

Varsayılan Gemini modelini kullanma (config'de ayarlanmışsa):

open-codex "Python'daki kapanış kavramını açıklayın."

Sağlayıcıyı ve modeli açıkça belirtme:

open-codex --provider gemini --model gemini-2.5-pro-preview-03-25 "Geçerli dizinde ve alt dizinlerinde 10 MB'tan büyük tüm dosyaları bulmak için bir bash betiği yazın."

Farklı bir Gemini modeli kullanma (örneğin, potansiyel olarak daha hızlı/daha ucuz görevler için Flash):

open-codex --provider gemini --model gemini-2.0-flash "Kancalarla ilgili React dokümantasyonunun ana noktalarını özetleyin."

CLI, isteği Gemini ile işleyecek ve yanıtı doğrudan standart çıktıya yazdıracaktır.

Adım 4: Gemini ile Open Codex Özelliklerinden Yararlanma

Open Codex CLI'nin gerçek gücü, Gemini tarafından yönlendirilen yerel geliştirme ortamınızla etkileşim kurma yeteneğinde yatar.

Dosya Sistemi Etkileşimi

Gemini, Open Codex CLI aracılığıyla, istekleriniz için bağlam elde etmek üzere geçerli projenizdeki dosyaları okuyabilir. Ayrıca dosyalarınızda değişiklikler (yazma veya yamalar) önerebilir.

Dosyaları Okuma: İsteminize dosya adlarını belirttiğinizde, CLI genellikle Gemini'ye bağlam sağlamak için bunları otomatik olarak okur.

# 'calculate.js' adlı bir dosyanız olduğunu varsayalım
open-codex --provider gemini "'calculate.js' dosyasını okuyun ve okunabilirlik için iyileştirmeler önerin."

Dosyaları Yazma/Yamalama: Gemini'den bir dosyayı değiştirmesini isterseniz, CLI bir fark (önerilen değişikliklerin özeti) oluşturacak ve herhangi bir şeyi uygulamadan önce onayınızı isteyecektir.

open-codex --provider gemini "'calculate.js' dosyasına iki argüman alan ve farklarını döndüren 'çıkar' adlı yeni bir işlev ekleyin."

CLI, önerilen değişiklikleri çıkaracak ve şu istemi verecektir: Yamayı uygula? [e/H]. Kabul etmek için e veya reddetmek için h tuşuna basın.

Komut Yürütme

Open Codex CLI, Gemini tarafından önerilen kabuk komutlarını da yürütebilir. Bu güçlüdür ancak dikkat gerektirir.

Onay Modları: --approval-mode (veya -a) bayrağı, özerklik düzeyini kontrol eder:
öner (varsayılan): Tüm dosya değişiklikleri ve tüm kabuk komutları için açık onay gerektirir. Başlangıç için önerilir.
otomatik-düzenle: Dosya değişikliklerini otomatik olarak uygular, ancak yine de kabuk komutları için onay ister.
tam-otomatik: Dosya değişikliklerini OTOMATİK olarak uygular VE kabuk komutlarını yürütür (korumalı alan içinde). Özellikle güvenilmeyen depolarda, son derece dikkatli kullanın.
Korumalı Alan: otomatik-düzenle ve tam-otomatik modlarında, komutlar ağ bağlantısı devre dışı bırakılmış olarak ve güvenlik için geçerli çalışma dizini ve geçici dosyalarla sınırlı olarak çalıştırılır.
Örnek (varsayılan 'öner' modu ile):

open-codex --provider gemini "pip kullanarak 'requests' kütüphanesini yükleyin."

Gemini, pip install requests komutunu önerebilir. CLI komutu gösterecek ve şunu soracaktır: Komutu çalıştır? [e/H].

Proje Bağlamı (codex.md)

codex.md dosyaları oluşturarak projeniz hakkında Gemini'ye kalıcı talimatlar veya bağlam sağlayabilirsiniz. CLI bu dosyaları şu sırayla okur:

~/.codex/instructions.md (Genel, kişisel talimatlar)
Depo kökünüzdeki codex.md (Proje genelinde notlar)
Geçerli çalışma dizinindeki codex.md (Alt dizine özgü notlar)

Bu, Gemini'nin davranışına rehberlik etmenize veya proje standartları, kullanılan kütüphaneler vb. hakkında bilgileri her istemde tekrarlamadan sağlamanıza olanak tanır.

Sorun Giderme ve İpuçları

API Anahtarı Hataları: GOOGLE_GENERATIVE_AI_API_KEY'nin doğru ayarlandığından, dışa aktarıldığından ve geçerli terminal oturumunuzda erişilebilir olduğundan emin olun. Yazım hatalarını iki kez kontrol edin.
Model Bulunamadı: Model adının (gemini-2.5-pro-preview-03-25, gemini-2.0-flash, vb.) desteklenen veya yapılandırılanlarla eşleştiğini doğrulayın. ~/.codex/config.json dosyasını kontrol edin veya --model bayrağını doğru kullanın.
Sağlayıcı Hataları: Sağlayıcının config.json veya --provider gemini bayrağı aracılığıyla gemini olarak ayarlandığından emin olun.
Ayrıntılı Günlük Kaydı: Hata ayıklama için, komutları DEBUG=true ortam değişkeni önekiyle çalıştırın: DEBUG=true open-codex --provider gemini "İstemim". Bu, ayrıntılı istek/yanıt bilgilerini yazdıracaktır.
Basit Başlayın: Basit istemlerle başlayın ve Gemini ile CLI'nin nasıl etkileşim kurduğuna alışırken kademeli olarak karmaşıklığı artırın.
Onayları Dikkatlice İnceleyin: Özellikle dosya değişiklikleri veya komut yürütme ile uğraşırken, önerilen değişiklikleri veya komutları onaylamadan önce her zaman inceleyin (e yanıtını verin).

Sonuç

Google'ın Gemini 2.5 Pro'su tarafından güçlendirilen Open Codex CLI, terminalinizi akıllı bir kodlama asistanına dönüştürür. Bu kılavuzda özetlenen adımları izleyerek, gelişmiş yapay zeka yeteneklerini doğrudan komut satırından günlük geliştirme iş akışınıza sorunsuz bir şekilde entegre edebilirsiniz.

Hızlı kod parçacıklarından ve açıklamalardan karmaşık yeniden düzenlemeye ve komut dosyası yürütmeye kadar, bu kombinasyon, üretkenliği artırmak ve görevleri kolaylaştırmak için önemli bir potansiyel sunar. Aracın, korumalı alan ve kullanıcı onayları aracılığıyla güvenliğe odaklanması, çok sağlayıcılı desteğin esnekliği ve açık kaynaklı doğasıyla birleştiğinde, Open Codex CLI'yi terminalinde yapay zekadan yararlanmak isteyen geliştiriciler için cazip bir seçim haline getiriyor.

Farklı istemleri deneyin, çeşitli onay modlarını (dikkatli bir şekilde!) keşfedin ve Gemini ve Open Codex CLI'nin kodlama deneyiminizi nasıl geliştirebileceğini keşfedin.

💡

button