Codex CLI'ı Codex4Less ile Kullanma

Codex CLI'ı Codex4Less ile Kullanma

Codex CLI, OpenAI'ın terminalde çalışan açık kaynak kodlama ajanıdır: deponuzu inceleyebilir, düzenleme yapabilir, komut çalıştırabilir ve tekrarlanabilir işleri otomatikleştirebilir. CLI, yapılandırılabilir bir model sağlayıcı katmanı üzerine kuruludur; yani onu varsayılan sağlayıcı dışında OpenAI uyumlu bir uç noktaya yönlendirebilirsiniz.

Bu rehber, resmî Codex CLI'ı özel bir model sağlayıcı tanımıyla Codex4Less'e istek gönderecek şekilde nasıl yapılandıracağınızı gösterir. Örnek yapılandırmadaki her değer, codex-cli 0.163.0 ile canlı Codex4Less API'si üzerinde uçtan uca doğrulanmıştır. Test sırasında çalıştırılmayan platforma özgü notlar açıkça işaretlenmiştir.

Not: Codex CLI hızlı gelişiyor. Sürümünüzde bir seçenek adı veya davranış farklıysa, CLI'nin kendisi için tek doğruluk kaynağı olan resmî yapılandırma referansına bakın (aşağıda bağlantılı).

Ön Koşullar

• Codex CLI kurulu olmalı (bkz. Adım 2). Kurulum yöntemleri işletim sistemine göre değişir; kendi platformunuz için resmî yönergeleri izleyin.
• Bir Codex4Less hesabı ve API anahtarı. İkisini de ücretsiz oluşturabilirsiniz — yalnızca gerçekten kullandığınız token için ödersiniz.
• Bir terminal. Windows'ta PowerShell (veya Windows Terminal) kullanın; PowerShell için ortam değişkeni söz dizimi aşağıda gösterilmiştir.
• Temel TOML bilgisi. Codex CLI yapılandırma dosyası TOML söz dizimi kullanır (key = "value" ve [bölüm] tabloları).

Adım 1 — Codex4Less API Anahtarınızı Oluşturun

1. Hesap oluşturun: codex4less.com/register
2. Giriş yapın, panele gidin ve API Anahtarları sayfasını açın: codex4less.com/dashboard/api-keys
3. Yeni API Anahtarı Oluştur'a tıklayın, anahtarı kopyalayın ve güvenli bir yerde saklayın.

Tam anahtar yalnızca oluşturma anında bir kez gösterilir. İstekler bakiyenizden token başına ücretlendirilir; CLI'yı çalıştırmadan önce hesapta bakiye olduğundan emin olun.

Güvenlik: Gerçek API anahtarını hiçbir zaman dokümana, ekran görüntüsüne, sohbet mesajına veya kaynak koda yapıştırmayın. Aşağıdaki adımlarda anahtar bir ortam değişkeninde tutulur; yapılandırma dosyası yalnızca değişkenin adını içerir.

Adım 2 — Codex CLI'ı Kurun

macOS ve Linux'ta önerilen yöntem OpenAI'ın bağımsız kurulum betiğidir:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

OpenAI ayrıca npm, Homebrew ve Windows kurulum yöntemlerini de belgeler — sisteminize uyan yöntemi seçmek için resmî Codex CLI sayfasına bakın.

Kurulumu doğrulayın:

codex --version

Sağlıklı bir kurulumda bu komut sürümü yazdırır, örneğin:

codex-cli 0.163.0

Linux notu: Codex'in makinanızda komut çalıştırdığı korumalı alan (sandbox) için resmî belgeler bubblewrap paketini önermektedir. Bu yalnızca yerel komut yürütmeyi etkiler — Codex4Less bağlantısını etkilemez. Ayrıntılar için sandbox ön koşullarına bakın.

Adım 3 — Özel Sağlayıcıyı Yapılandırın

Kurulumun özü burasıdır. Codex CLI, kullanıcı düzeyindeki yapılandırmasını şu dosyadan okur:

~/.codex/config.toml

Bu dosyayı oluşturun veya düzenleyin ve aşağıdakileri ekleyin:

model = "gpt-6.1-sol"
model_provider = "codex4less"

[model_providers.codex4less]
name = "Codex4Less"
base_url = "https://api.codex4less.com/v1"
env_key = "CODEX4LESS_API_KEY"
wire_api = "responses"
supports_websockets = false

Anahtarların anlamları:

API anahtarını ortam değişkeni olarak tanımlayın

macOS / Linux:

export CODEX4LESS_API_KEY="sk-..."

Kalıcı hale getirmek için aynı satırı kabuk profilinize (~/.bashrc, ~/.zshrc, …) ekleyin ve yeni bir terminal açın. Ortak kullanılan makinelerde anahtarı doğrudan komut satırına yazmaktan kaçının — kabuk geçmişine düşebilir.

Windows (PowerShell):

$env:CODEX4LESS_API_KEY = "sk-..."

Oturumlar arasında kalıcı olması için:

setx CODEX4LESS_API_KEY "sk-..."

setx yalnızca yeni terminalleri etkiler — çalıştırdıktan sonra yeni bir terminal açın.

Not: Yukarıdaki Windows komutları standart PowerShell ortam değişkeni söz dizimini kullanır; bu rehberdeki uçtan uca kurulum Linux'ta codex-cli 0.163.0 ile test edilmiştir. PowerShell sürümünüz farklı bir şey bekliyorsa resmî kurulum sayfasını izleyin.

Hangi modelleri kullanabilirim? Codex4Less güncel model listesini OpenAI uyumlu GET /v1/models uç noktası ve panelde sunar. Bu rehberin yazıldığı sırada Responses API üzerinde gpt-6.1-sol ve gpt-5.6-sol doğrulanmıştır. Farklı bir model kimliği seçerseniz önce /v1/models listesinde göründüğünden emin olun.

İleri düzey: CODEX_HOME ortam değişkenini farklı bir dizine yönlendirerek bu yapılandırmayı varsayılan Codex kurulumunuzdan tamamen izole edebilirsiniz (ör. CODEX_HOME=~/.codex-codex4less codex). Bu test sırasında doğrulanmıştır.

Adım 4 — İlk İsteğinizi Gönderin

Bir proje dizininde terminal açın ve Codex'i başlatın:

codex

Ardından bir görev tanımlayın; ya da bağlantıyı test etmenin en hızlı yolu olan tek seferlik (etkileşimsiz) modu deneyin:

codex exec "Reply with exactly: CONNECTED"

Bunu bir Git deposunun dışında çalıştırırsanız Codex güvenilmeyen dizin için onay ister; betiklerde bunu --skip-git-repo-check ile geçebilirsiniz:

codex exec --skip-git-repo-check "Reply with exactly: CONNECTED"

Çalışan bir kurulum; sağlayıcı ile modeli gösteren oturum başlığını ve ardından modelin yanıtını yazdırır:

model: gpt-6.1-sol
provider: codex4less
...
codex
CONNECTED

Başlığın tam biçimi CLI sürümleri arasında değişebilir; önemli olan provider: satırında codex4less girdinizin görünmesi ve yanıtın kimlik doğrulama hatası olmadan dönmesidir.

Adım 5 — Bağlantıyı Doğrulayın

Modelden yanıt gelmesi isteğin başarılı olduğunu kanıtlar; ancak isteğin Codex4Less üzerinden geçtiğini tek başına kanıtlamaz. Üç bağımsız kontrol:

1. Oturum başlığı. CLI, oturum başında aktif sağlayıcıyı ve modeli yazdırır (provider: codex4less).
2. Panel kullanım kaydı. İsteğinizden sonra codex4less.com/dashboard/usage sayfasını açın — istek; model adı, token sayıları ve maliyetle birlikte görünür ve bakiyeniz düşer. En güçlü kanıt budur: isteğin Codex4Less altyapısında işlendiğini ve faturalandığını gösterir.
3. Doğrudan API kontrolü. Aynı anahtarla API'den model listesini isteyin:

curl https://api.codex4less.com/v1/models -H "Authorization: Bearer $CODEX4LESS_API_KEY"

OpenAI'ın {"object":"list", ...} biçiminde güncel model kataloğunu almalısınız.

Sorun Giderme

401 — geçersiz API anahtarı

• Anahtar, panelde verildiği haliyle sk- önekini eksiksiz içermelidir.
• Ortam değişkenleri terminale özeldir: bir terminalde tanımlanan anahtar diğerinde görünmez. echo $CODEX4LESS_API_KEY ile kontrol edin (ortak ekranlarda tam değeri yazdırmayın).
• Panelde silinen veya iptal edilen anahtar anında çalışmaz hale gelir — yeni bir anahtar oluşturun.

404 — yanlış base URL veya yol

• base_url tam olarak https://api.codex4less.com/v1 olmalıdır.
• Sık yapılan hata, uç noktayı base URL'ye eklemektir (https://api.codex4less.com/v1/responses): /responses ekini Codex kendisi ekler; sonuçta istek /v1/responses/responses olur ve 404 döner.

Seçilen model kullanılamıyor

• Güncel liste için GET /v1/models'e bakın ve kimliği listeden kopyalayın.
• Model kullanılabilirliği zaman içinde değişebilir. Yapılandırdığınız kimlik listede yoksa veya diğer modeller çalışırken yanıt vermeyi bırakırsa, model değerini güncel listedeki bir kimlikle değiştirin ve Codex'i yeniden başlatın.

wire_api uyumsuzluğu

• Güncel Codex CLI yalnızca wire_api = "responses" destekler. "chat" denerseniz CLI, başlangıçta geçiş tartışmasına işaret eden bir hatayla durur.
• Bir sağlayıcı Responses desteği sunduğunu belirtiyor ama istekler başlangıçtan hemen sonra başarısız oluyorsa {base_url}/responses adresinin gerçekten yanıt verdiğini doğrulayın — Codex4Less için bu uç nokta hem akışlı hem de akışsız isteklerle doğrulanmıştır.

Yapılandırma dosyası okunmuyor / yanlış konum

• Sağlayıcı tanımları kullanıcı düzeyindeki ~/.codex/config.toml dosyasında yaşar. Proje içindeki .codex/config.toml dosyaları model_providers tanımlayamaz veya geçersiz kılamaz — Codex bu anahtarları tasarım gereği yok sayar (bkz. yapılandırma referansı).
• CODEX_HOME kullanıyorsanız, aynı değerin Codex'i çalıştırdığınız terminalde de tanımlı olduğundan emin olun.

Ortam değişkeni okunmuyor

• Değişkeni Codex'i başlattığınız aynı terminal oturumunda tanımlayın; kabuk profilinizi düzenledikten veya setx çalıştırdıktan sonra terminali yeniden başlatın.
• macOS/Linux'ta değişken adları büyük/küçük harfe duyarlıdır.

SSS

Codex CLI ile özel bir API sağlayıcı kullanabilir miyim? Evet. Codex CLI, kullanıcı düzeyindeki yapılandırma dosyasından model_providers listesini okur ve özel bir sağlayıcı girdisi, CLI'yı gerektirdiği wire API'sini uygulayan herhangi bir uç noktaya yönlendirebilir. Yukarıdaki kurulum tam olarak bunu yapar; resmî yapılandırma referansına bakın.

API anahtarımı nerede saklamalıyım? env_key ile başvurulan bir ortam değişkeninde. Böylece yapılandırma dosyası yalnızca değişkenin adını (CODEX4LESS_API_KEY) içerir; yedeklemek veya paylaşmak güvenlidir. Gerçek anahtarı asla bir depoya işlemeyin, ekran görüntüsüne almayın.

Uç nokta hangi API biçimini destekliyor? Codex4Less OpenAI uyumlu API'ler sunar. Codex CLI için kritik olan parça Responses API'dir — POST https://api.codex4less.com/v1/responses — akış dahil çalıştığı doğrulanmıştır. Klasik POST /v1/chat/completions uç noktası da diğer araçlar ve SDK'lar için kullanılabilir; bkz. API dokümantasyonu.

Seçtiğim model kullanılamıyorsa ne yapmalıyım? Modelleri GET /v1/models (veya panel) ile listeleyin ve yapılandırmanızdaki model değerini listede görünen bir kimlikle değiştirin. Model kullanılabilirliği değişebilir; Codex4Less zaman içinde model ekler ve kaldırır.

Bu Windows'ta çalışır mı? Evet — Codex CLI Windows için de sunulur (resmî kurulum sayfasına bakın). Ortam değişkeni için yukarıdaki PowerShell söz dizimini kullanın ve config.toml dosyasını C:\Users\<kullanıcı>\.codex\config.toml konumuna koyun.

Sonuç ve Çağrı

Resmî Codex CLI'ı özel bir sağlayıcı tanımıyla Codex4Less'e yönlendirdiniz, ilk isteğinizi gönderdiniz ve panelden doğruladınız. Bundan sonrası normal Codex kullanımıdır — tek fark, yapılandırmanızdaki sağlayıcı girdisidir.

Başlamaya hazır mısınız?

Codex4Less hesabınızı oluşturun, bir API anahtarı üretin ve desteklenen bir modeli denemek için kurulum adımlarını izleyin.

Hesabınızı oluşturun →