Ana içeriğe atla
CometAPI’yi model provider olarak kullanarak Codex CLI çalıştırmak için bu kılavuzu kullanın. Resmi başvuru kaynakları:
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

RequirementDetails
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+) veya WSL2 üzerinden Windows 11
Node.js22+ (LTS önerilir)
Git2.23+ önerilir
CometAPI keyBir 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.
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"

​
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

SymptomFix
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 unexpectedlyEski ~/.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 timeoutconfig.toml içinde openai_base_url veya base_url değerinin https://api.cometapi.com/v1 olduğunu doğrulayın
Windows issuesCodex, Windows’ta WSL2 gerektirir — yerel CMD/PowerShell desteklenmez