Codex, OpenCode ve diğer ajanlarda kurulum hataları: en sık yapılan 5 hata

Codex, OpenCode ve OpenAI uyumlu diğer ajanlarla ilgili destek taleplerini incelediğimizde, sorunların neredeyse tamamının aynı 5 kurulum hatasından kaynaklandığını görüyoruz. Kuruluma başlamadan önce bu listeye göz atın.

1. Yanlış veya eksik base_url

En sık hata: istemcinin varsayılan sağlayıcıya (örn. api.openai.com) gitmesi. Noxery adresi her zaman şudur:

https://api.noxery.net/v1

Dikkat: bazı araçlar adresin sonundaki /v1 ekini kendisi ekler, bazıları eklemez. Aracın dokümanında “base URL” alanı tam olarak ne bekliyorsa onu yazın. Yolda 401 veya 404 alıyorsanız ilk kontrol edilecek yer burasıdır.

2. Anahtarı env_key alanına yazmak

Codex config’inde env_key, anahtarın kendisi değil ortam değişkeninin adıdır:

env_key = "NOXERY_API_KEY"   # doğru
env_key = "nox-abc123..."    # yanlış

Anahtarı her zaman ortam değişkeni olarak saklayın:

export NOXERY_API_KEY="nox-ANAHTARINIZ"

3. Model adını tahmin etmek

Panelde görünen ad ile API’deki model değeri farklı olabilir. Model adını asla tahmin etmeyin; katalogdan alın:

curl https://api.noxery.net/v1/models \
  -H "Authorization: Bearer $NOXERY_API_KEY"

Yanıt içindeki id alanını kullanın. Güncel liste: noxery.net/tr/models. “404 model hatası” alıyorsanız neredeyse her zaman neden budur.

4. Windows’ta WSL ayrımını bilmemek

Windows’ta kurulum dosyasını çalıştırdıysanız ama ajanı WSL (Ubuntu) içinde kullanıyorsanız: .bat dosyası Windows tarafını, WSL ise kendi Linux ortamını kullanır. Kurulumu WSL terminalinde ayrıca yapmanız gerekir:

echo 'export NOXERY_API_KEY="nox-ANAHTARINIZ"' >> ~/.bashrc
source ~/.bashrc
rm -f ~/.codex/auth.json

Ayrıntılar: Missing environment variable rehberi.

5. Eski terminal / eski oturum

Ortam değişkenini tanımladınız ama hâlâ eski değer görünüyor ya da hiç görünmüyorsa:

Değişken tanımı yalnızca yeni terminal pencerelerinde geçerlidir. Tüm pencereleri kapatıp yeniden açın.
IDE içi terminaller ana kabuk ayarlarını almaz; IDE’yi tamamen yeniden başlatın.
Birden fazla anahtar kullanıyorsanız hangisinin aktif olduğunu panelden kontrol edin ve eski anahtarları iptal edin.

Araç bazında doğru örnekler

Codex CLI — ~/.codex/config.toml

model = "gpt-6-astra"
model_provider = "noxery"

[model_providers.noxery]
name = "Noxery"
base_url = "https://api.noxery.net/v1"
env_key = "NOXERY_API_KEY"
wire_api = "responses"
requires_openai_auth = false

OpenCode — ~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "noxery": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Noxery",
      "options": {
        "baseURL": "https://api.noxery.net/v1",
        "apiKey": "nox-YOUR_KEY"
      },
      "models": {"gpt-6-astra": {"name": "gpt-6-astra"}}
    }
  }
}

OpenAI uyumlu diğer araçlar

OPENAI_API_KEY=nox-YOUR_KEY
OPENAI_BASE_URL=https://api.noxery.net/v1
OPENAI_MODEL=gpt-6-astra

Daha fazlası: dokümantasyon ve ajan entegrasyon sayfaları. Kurulumda takılırsanız destek talebi açın veya Telegram grubuna yazın; genelde dakikalar içinde yanıt alırsınız.