📋 Hazırlık Adımları
Başlamadan önce lütfen şunlara sahip olduğunuzdan emin olun:
- Koze hesabı kaydı yaptırdınız ve giriş yaptınız
- API Yönetimi sayfasında bir API Anahtarı oluşturdunuz
- Codex CLI'yı yüklediniz (
npm install -g @openai/codex)
🚀 Adım 1: Codex Yapılandırma Dosyasını Yapılandırın
Aşağıdaki yapılandırmayı ~/.codex/config.toml dosyasının başına ekleyin:
model_provider = "koze"
model = "gpt-4.1"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.koze]
name = "koze"
base_url = "https://api.kozeai.com/v1"
wire_api = "responses"
requires_openai_auth = true
💡 İpucu: `
https://api.kozeai.com/v1` adresini gerçek Koze proxy adresinizle değiştirin. `model` alanı, planınıza göre farklı modeller seçmenize olanak tanır.
🔑 İkinci Adım: API Anahtarını Yapılandırın
API anahtarınızı ~/.codex/auth.json dosyasında yapılandırın:
{
'OPENAI_API_KEY': 'Koze API Anahtarınız'
}
🎯 Üçüncü Adım: Codex'i Başlatın
Yapılandırmadan sonra, doğrudan terminalde başlatın:
codex
Codex CLI, API istekleri için otomatik olarak Koze proxy'sini kullanacaktır.
📌 Kullanılabilir Modeller
Aşağıdaki modelleri kullanabilirsiniz: Yapılandırma dosyasının `model` alanı (Koze planınıza bağlı olarak):
| Model Adı | Açıklama |
|---|---|
gpt-5.3-codex |
gpt-5.3-codex, günlük programlama görevleri için uygundur |
gpt-5.4-mini |
GPT-4.1 Mini, daha iyi fiyat-performans oranı |
gpt-5.4 |
GPT-5.4 Multimodal Model |
⚠️ Sıkça Sorulan Sorular
| Sorun | Çözüm |
|---|---|
| İpucu: "Kimlik doğrulama başarısız" | auth.json dosyasındaki API Anahtarının doğru olup olmadığını kontrol edin |
config.toml çalışmıyor |
Yapılandırmanın dosyanın başına yazıldığından ve model_provider adının [model_providers.xxx] | ile eşleştiğinden emin olun
| Kullanım Nginx Anti-prototype başarısız oldu. | Nginx `http` bloğuna `underscores_in_headers on;` ekleyin; aksi takdirde Nginx, varsayılan olarak alt çizgi içeren istek başlıklarını yok sayacaktır. |
