Codex CLI

CometAPI ile OpenAI Codex CLI kurulumunu yapın: config.toml içinde openai_base_url veya özel bir provider yapılandırın, API anahtarınızı auth.json içinde saklayın ve güncel bir model ile kodlamaya başlayın.

CometAPI’yi model provider olarak kullanarak Codex CLI çalıştırmak için bu kılavuzu kullanın.

Resmi başvuru kaynakları:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

Model kullanılabilirliği sık sık değişir. Aşağıdaki örneklerde your-model-id kullanılır — bunu CometAPI Models sayfasındaki güncel, kodlama dostu bir model kimliğiyle değiştirin.

​

Önkoşullar

Requirement	Details
OS	macOS 12+, Linux (Ubuntu 20.04+ / Debian 10+) veya WSL2 üzerinden Windows 11
Node.js	22+ (LTS önerilir)
Git	2.23+ önerilir
CometAPI key	Bir tane CometAPI Dashboard üzerinden alın (sk- ile başlar)

​

Codex CLI’yi yükleyin

npm i -g @openai/codex

Veya Homebrew ile:

brew install --cask codex

Kurulumu doğrulayın:

codex --version

​

CometAPI’yi yapılandırın

Codex’i CometAPI’ye yönlendirmenin iki yolu vardır. İş akışınıza en uygun olanı seçin.

Simple: openai_base_url

En kolay seçenek — yerleşik OpenAI provider’ı tek satırla CometAPI’ye yönlendirin. Özel bir provider tanımlamanız gerekmez.

~/.codex/config.toml oluşturun:

model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Named provider

Adlandırılmış bir cometapi provider’ı tanımlayın. --profile veya model_provider kullanarak birden fazla provider arasında geçiş yapmak istediğinizde faydalıdır.

~/.codex/config.toml oluşturun:

model = "your-model-id"
model_provider = "cometapi"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
env_key = "OPENAI_API_KEY"

env_key, API anahtarınızı hangi ortam değişkeninin tuttuğunu Codex’e söyler. Codex çalışma zamanında OPENAI_API_KEY değerini okur — bu gerçek anahtarınız değildir.

​

API anahtarınızı saklayın

~/.codex/auth.json oluşturun:

{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}

sk-your-cometapi-key değerini gerçek CometAPI anahtarınızla değiştirin.

Bu dosya zorunludur. auth.json içinde geçerli bir OPENAI_API_KEY girdisi olmadan, Codex API key auth is missing a key hatasıyla kapanır.

​

Codex’i başlatın

cd your-project
codex

İlk çalıştırmada Codex sizden bir tema seçmenizi ve güvenlik ayarlarını onaylamanızı ister.

​

Her oturum için model override etme

config.toml dosyasını düzenlemeden, tek bir çalıştırma için farklı bir modele geçin:

codex --model your-model-id

​

Alternatif: ortam değişkeni

auth.json yerine anahtarı doğrudan export edin:

export OPENAI_API_KEY="sk-your-cometapi-key"
codex

Bu, anahtarı yalnızca mevcut terminal oturumu için ayarlar. Kalıcı olması için export satırını ~/.zshrc veya ~/.bashrc dosyanıza ekleyin.

​

Sorun giderme

Symptom	Fix
API key auth is missing a key	~/.codex/auth.json dosyasının "OPENAI_API_KEY": "sk-..." içerdiğinden emin olun
Login prompt appears unexpectedly	Eski ~/.codex/auth.json dosyasını silin ve CometAPI anahtarınızla yeniden oluşturun
Model not found	Şu anda kullanılabilir modeller için Models sayfasını kontrol edin
Connection timeout	config.toml içinde openai_base_url veya base_url değerinin https://api.cometapi.com/v1 olduğunu doğrulayın
Windows issues	Codex, Windows’ta WSL2 gerektirir — yerel CMD/PowerShell desteklenmez