Documentation

Codex CLI

Codex CLI'ı GateBeyz ile `OPENAI_API_KEY` ve `OPENAI_BASE_URL` üzerinden, isteğe bağlı `.codex/config.toml` varsayılanlarıyla kullanın.

Gereksinimler

- GateBeyz API anahtarınız

- Sonu `/v1` ile biten GateBeyz OpenAI uyumlu base URL'niz

- Yerelde kurulu Codex CLI ve shell profilinize veya `.codex/config.toml` dosyasına erişim

Kurulum akışı

1. GateBeyz anahtarınızla `OPENAI_API_KEY` değişkenini dışa aktarın.

2. GateBeyz OpenAI uyumlu uç noktanızla `OPENAI_BASE_URL` değişkenini dışa aktarın.

3. Değişkenleri kaydettiğiniz shell dosyasını source edin veya yeni bir terminal açın.

4. `codex` komutunu çalıştırın; Codex model sorarsa kullanmanıza izin verilen modeli seçin.

5. Daha uzun bir oturuma geçmeden önce Codex CLI'ın GateBeyz üzerinden çalıştığını kısa bir prompt ile doğrulayın.

Ortam

Shell değişkenleri

Gerekli export'lar

shell

export OPENAI_API_KEY="sk-gb-replace-with-your-key"
export OPENAI_BASE_URL="https://api.gatebeyz.xyz/v1"

İsteğe bağlı config

Kalıcı model veya approval varsayılanları istiyorsanız bunları `~/.codex/config.toml` ya da proje düzeyindeki `.codex/config.toml` dosyasına ekleyin. Base URL override'ı yine ortam değişkenlerinde kalabilir.

İsteğe bağlı `.codex/config.toml`

Profil örneği

toml

model = "gpt-5.4"

[profiles.gatebeyz]
model = "gpt-5.4"
approval_policy = "on-request"

Sorun giderme

- Codex CLI hala varsayılan OpenAI uç noktasına gidiyorsa `codex` komutunu çalıştırdığınız aynı shell içinde `OPENAI_BASE_URL` değerini yazdırın.

- Kimlik doğrulama çalışıyor ama model hata veriyorsa seçtiğiniz model GateBeyz hesabınızda henüz açık olmayabilir.

- Bir config profili kullanıyorsanız model veya uç noktanın eski yerel değerlerle override edilmediğini kontrol edin.

- Hala bağlanamıyorsanız model adı ve tam Codex CLI hatasıyla birlikte hello@gatebeyz.xyz adresine e-posta gönderin.