Codex’te ‘Missing environment variable’ hatası: adım adım çözüm (WSL dahil)

Codex CLI kurulumunda en çok karşılaştığımız hata: Missing environment variable: nox-.... Bu hata genellikle iki basit yanlıştan kaynaklanır: config dosyasına anahtarın kendisinin yazılması ve Windows’ta WSL kullanılırken ayarların yanlış tarafa yapılması. Bu rehberde ikisini de adım adım çözüyoruz.

Hata ne anlama geliyor?

Codex, config.toml içindeki env_key alanında yazan ada sahip bir ortam değişkeni arar. Sizin durumunuzda bu alanda anahtarın kendisi (örn. nox-99569a06...) yazdığı için Codex “nox-99569a06… adlı ortam değişkeni yok” diyor. Çözüm çok basit:

# YANLIŞ — env_key bir değişken adı olmalı, anahtar değil
env_key = "nox-99569a06..."

# DOĞRU
env_key = "NOXERY_API_KEY"

Doğru config.toml dosyası

~/.codex/config.toml dosyanız tam olarak şöyle olmalı:

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

Model adını tahmin etmeyin; güncel listeyi noxery.net/tr/models sayfasından veya GET /v1/models yanıtından alın.

Windows + WSL kullanıyorsanız: en kritik nokta

Windows’ta hazırladığımız otomatik kurulum dosyası (noxery-codex-setup.bat) Windows tarafını ayarlar: %USERPROFILE%\.codex\ ve Windows ortam değişkenlerini. Ancak Codex’i WSL (Ubuntu) içinde çalıştırıyorsanız, WSL kendi Linux ev dizinini (~/.codex) ve kendi ortam değişkenlerini kullanır. Bu yüzden .bat “başarılı” dese bile WSL içinde hata almaya devam edebilirsiniz.

WSL içinde adım adım kurulum

1. WSL terminalinde config dosyasını düzenleyin:

   nano ~/.codex/config.toml

   Yukarıdaki doğru içeriği yapıştırıp kaydedin.

2. Anahtarı ortam değişkeni olarak tanımlayın ve kalıcı yapın:

   echo 'export NOXERY_API_KEY="nox-ANAHTARINIZ"' >> ~/.bashrc
   source ~/.bashrc

3. Eski anahtar kalabilecek dosyayı silin:

   rm -f ~/.codex/auth.json

4. Tüm WSL terminallerini kapatıp yeni bir terminal açın ve doğrulayın:

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

5. Codex’i çalıştırın:

   codex

Sık sorulan ek sorunlar

• Komut bulunamadı (codex: command not found): Codex kurulumu WSL tarafında yapılmamış. Kurulumu WSL terminalinde tekrarlayın.
• Hâlâ 401 alıyorum: Eski anahtar bir dosyada kalmış olabilir. grep -r "nox-" ~/.codex ile kontrol edin. Ek olarak 401 rehberimize bakın.
• Windows PowerShell’de çalıştırıyorum: O zaman .bat dosyasını kullanabilirsiniz; ancak yine de terminali kapatıp yeniden açmanız gerekir.

Adımları uyguladıktan sonra sorun devam ederse destek talebi açın — anahtarın tamamını değil, ilk 12 karakterini ve hata mesajını ekleyin. Kurulumun tamamı için: Codex entegrasyon dokümanı.