Claude Code base URL: ANTHROPIC_BASE_URL nasıl doğru ayarlanır

Wokey Team · 2026-09-24

Kısa cevap: Claude Code'un base URL'i ANTHROPIC_BASE_URL ortam değişkeniyle ayarlanır. Yalnızca gateway'in origin adresini yazın, /v1 olmadan. Wokey için bu https://api.wokey.ai adresidir; /v1/messages yolunu Claude Code kendisi ekler. Anahtarınızı ANTHROPIC_AUTH_TOKEN değişkenine koyun; bu değer Authorization: Bearer olarak gönderilir. Base URL'i ayarlayıp anahtar vermezseniz Claude Code kayıtlı claude.ai oturumunuzu kullanmaya devam eder.

En küçük kurulum

export ANTHROPIC_BASE_URL="https://api.wokey.ai"
export ANTHROPIC_AUTH_TOKEN="your Wokey API key"
claude

Claude Code içinde /status komutunu çalıştırın. Status sekmesinde şunlar görünüyorsa istekler Wokey üzerinden gidiyordur:

• Anthropic base URL değeri https://api.wokey.ai
• ANTHROPIC_AUTH_TOKEN adını gösteren bir Auth token satırı

Anthropic base URL satırı yoksa değişken oturuma hiç ulaşmamıştır.

/v1 neden bozar

Claude Code ANTHROPIC_BASE_URL değerini bir önek olarak görür ve $ANTHROPIC_BASE_URL/v1/messages adresine istek atar. Değeri https://api.wokey.ai/v1 yaparsanız istek /v1/v1/messages yoluna gider ve Wokey şu yanıtı verir:

{"message":"Route POST:/v1/v1/messages not found","error":"Not Found","statusCode":404}

Cursor veya Cherry Studio gibi OpenAI uyumlu istemciler genellikle .../v1 bekler. Claude Code ise Anthropic'in kuralını izler ve ikisi birbirine karıştırılamaz. /v1/messages ya da sondaki eğik çizgiyi de eklemeyin.

AUTH_TOKEN mı API_KEY mi

Wokey iki başlığı da kabul eder. Fark Claude Code tarafındadır:

• ANTHROPIC_AUTH_TOKEN hemen geçerli olur.
• ANTHROPIC_API_KEY devreye girmeden önce etkileşimli modda bir kerelik onay ister. Daha önce reddettiğiniz bir anahtar sessizce yok sayılır.

İkisini farklı değerlere ayarlamayın. İki başlık farklı anahtarlar taşıdığında Wokey isteği reddeder:

{"error":{"code":"conflicting_api_key_headers","message":"conflicting_api_key_headers","type":"invalid_request_error"}}

İki başlıkta da aynı anahtarın olması sorun değildir.

Yalnızca base URL ayarlıysa ne olur

Base URL bir kimlik bilgisi değildir. Yalnızca ANTHROPIC_BASE_URL ayarlıysa ve AUTH_TOKEN ya da API_KEY yoksa Claude Code istekleri yine kayıtlı claude.ai oturumunuzla gönderir. Wokey bunu bir Wokey anahtarı olarak tanımaz ve 401 döndürür.

Bir gateway kimlik bilgisi ayarlandığında claude.ai oturumunuz kayıtlı kalır ama kullanılmaz; ona dönmek için değişkeni kaldırın.

Başlangıçta auth may not work as expected ile biten bir uyarı görebilirsiniz. Eski sürümler bunun yerine Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set yazar. İkisi de hem bir gateway kimlik bilgisinin hem de kayıtlı bir oturumun bulunduğu anlamına gelir. Yalnızca gateway'i kullanmak için Claude Code içinde /logout komutuyla kayıtlı oturumu silin.

settings.json ile kalıcı hale getirin

Bir export yalnızca geçerli terminal boyunca yaşar ve Dock'tan ya da Başlat menüsünden açılan editörler onu görmez. Günlük kullanım için değerleri ~/.claude/settings.json dosyasındaki env bloğuna yazın:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.wokey.ai",
    "ANTHROPIC_AUTH_TOKEN": "your Wokey API key"
  }
}

• Shell ile bir ayar dosyası aynı değişkeni ayarladığında ayar dosyası kazanır. Değiştirdiğiniz bir shell değişkeni etkisiz görünüyorsa önce buraya bakın.
• Tek bir proje için o projenin .claude/settings.local.json dosyasını kullanın ve gitignore'da olduğundan emin olun.
• Anahtarı asla bir projenin .claude/settings.json dosyasına koymayın. Bu dosya depoya commit edilir.

Model seçimi

Wokey, Anthropic ile aynı Claude model kimliklerini kullanır; örneğin claude-opus-5, claude-sonnet-5 ve claude-haiku-4-5. Oturum sırasında /model ile değiştirin. Claude Code'un Opus, Sonnet ve Haiku kademelerinin her birinin hangi modeli kullanacağını sabitlemek için env bloğuna şunu ekleyin:

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

ANTHROPIC_DEFAULT_HAIKU_MODEL, oturum başlıkları gibi arka plan görevlerinin modelini de belirler.

VS Code uzantısı ve masaüstü uygulaması

VS Code uzantısı, oturum kontrolünde shell değişkenlerini kullanmaz. Bunları VS Code'un kendi kullanıcı ayarlarında tanımlayın: komut paletinden Preferences: Open User Settings (JSON) komutunu çalıştırıp şunu ekleyin:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" }
  ]
}

~/.claude/settings.json içindeki değerler uzantının başlattığı sürece ulaşır, ama uzantının kendi oturum kontrolüne ulaşmaz. Uzantı sürekli giriş yapmanızı istiyorsa yukarıdaki ayarı kullanın.

Claude masaüstü uygulaması ne ANTHROPIC_BASE_URL değerini ne de settings.json dosyasını okur. Bir gateway ayarlamak için:

1. Help → Troubleshooting → Enable Developer Mode yolunu açın.
2. Developer → Configure Third-Party Inference yolunu açıp gateway adresini girin.

Tüm adımlar için Claude Desktop kurulum rehberine bakın.

Önce curl ile kontrol edin

Aynı terminalden, Claude Code'u devreye sokmadan test edin:

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

Yanıt size şunu söyler:

• {"id":"msg_ ile başlıyorsa: URL ve anahtar doğrudur; sorun Claude Code yapılandırmanızdadır.
• code değeri invalid_api_key olan 401: anahtar eksik, yanlış yazılmış veya silinmiş.
• /v1/v1/messages geçen 404: base URL'de fazladan bir /v1 var.
• curl çalışıyor ama Claude Code hâlâ giriş yapmanızı istiyorsa: Claude Code'un kendi kimlik bilgisi yoktur. Değişkenlerin claude komutunu başlatan terminalde ayarlandığını kontrol edin veya onları ~/.claude/settings.json dosyasına taşıyın.