Üçüncü taraf API ile Claude Code VS Code uzantısı: environmentVariables kurulumu

Wokey Team · 2026-09-24

Kısa cevap: Claude Code VS Code uzantısını üçüncü taraf bir API'ye yönlendirmek için ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN değerlerini VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables içine yazın ve claudeCode.disableLoginPrompt ayarını açın. Değişkenleri bir terminalde export etmek çoğunlukla uzantıya ulaşmaz. ~/.claude/settings.json da yetmez: uzantının başlatma öncesi oturum kontrolü bu dosyayı okuyamaz, bu yüzden giriş ekranını görmeye devam edersiniz.

Kurulum

  1. Uzantıyı yükleyin. VS Code 1.94.0 veya sonrası gerekir. Extensions görünümünde (Cmd/Ctrl+Shift+X) "Claude Code" (yayıncı: Anthropic) araması yapın. Cursor aynı uzantıyı yükleyebilir; VSCodium gibi editörler de onu Open VSX'ten alabilir.
  2. Kullanıcı ayarlarınızı açın. Cmd/Ctrl+Shift+P tuşlarına basıp Preferences: Open User Settings (JSON) komutunu çalıştırın.
  3. Ayarları ekleyin. En dıştaki {} içine şunu ekleyin:
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" }
  ],
  "claudeCode.disableLoginPrompt": true
}
  1. Yeniden yükleyin. Komut paletinden Developer: Reload Window komutunu çalıştırın, ardından Claude Code panelini açın.

Dikkat edilecek üç nokta:

  • ANTHROPIC_BASE_URL yalnızca alan adıdır, /v1 olmadan; /v1/messages yolunu uzantı kendisi ekler.
  • Bunlar kullanıcı ayarlarınıza yazılır; çoğu zaman depoya commit edilen çalışma alanı .vscode/settings.json dosyasına değil.
  • disableLoginPrompt giriş istemini atlar. Resmi açıklama bunun "for third-party provider setups" olduğunu söyler.

export ve settings.json neden yetmez

Uzantı, Claude sürecini başlatmadan önce bir kimlik bilgisinin mevcut olup olmadığını kontrol eder. Bu kontrol yalnızca claudeCode.environmentVariables değerini okur:

  • Dock'tan, Başlat menüsünden veya bir masaüstü simgesinden açılan VS Code, ~/.zshrc içinde export ettiğiniz değişkenleri almaz.
  • ~/.claude/settings.json dosyasındaki env bloğu uzantının başlattığı Claude sürecine ulaşır, ama uzantının kendi oturum kontrolüne ulaşmaz.

Bu yüzden yalnızca settings.json varken ve disableLoginPrompt kapalıyken tipik belirti, sürekli giriş yapmanızı isteyen bir uzantıdır. Shell değişkenlerini tek seferlik kullanmak için code . komutunu değişkenlerin ayarlı olduğu bir terminalden çalıştırın. Günlük kullanımda yukarıdaki kullanıcı ayarları daha güvenilirdir.

İsteklerin Wokey üzerinden gittiğini doğrulayın

Uzantının prompt kutusunda /status komutunu çalıştırın (bunun için Claude Code v2.1.280 veya sonrası gerekir). Status sekmesindeki Anthropic base URL değerinde https://api.wokey.ai yazmalıdır.

Model seçimi

Komut menüsünden Switch model… öğesini seçin veya prompt kutusunun altındaki model adına tıklayın. Opus, Sonnet ve Haiku kademelerinin her birinin hangi modeli kullanacağını sabitlemek için değişkenleri aynı listeye ekleyin:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" }
  ]
}

Üçüncü taraf API ile kullanılamayanlar

Üçüncü taraf bir API ile uzantı, claude.ai hesabı gerektiren özellikleri sunmaz:

  • Plan kullanım çubukları, sesle dikte ve bulut oturumları için Web sekmesi.
  • Menüde Sign out öğesi bulunmaz.
  • /bug göndermek bir hata gösterir ve hiçbir şey göndermez.

Daha önce /login ile giriş yaptığınız bir claude.ai hesabı kayıtlı kalır ama kullanılmaz.

Terminaldeki CLI ile karşılaştırıldığında uzantı ayrıca komutların yalnızca bir alt kümesini destekler; ! Bash kısayolu ve sekme tamamlama da yoktur.

Sorun giderme

Giriş ekranı çıkmaya devam ediyor. claudeCode.environmentVariables eksiktir veya yanlış yerdedir (örneğin çalışma alanı ayarlarında) ya da değişiklikten sonra pencereyi yeniden yüklemediniz. disableLoginPrompt değerinin true olduğunu da kontrol edin.

invalid x-api-key. ANTHROPIC_BASE_URL uygulanmadığı için istek Anthropic'in kendi adresine gitmiştir. Wokey bu mesajı asla döndürmez; invalid x-api-key rehberine bakın.

/v1/v1/messages geçen bir 404. Base URL'de fazladan bir /v1 var. https://api.wokey.ai olarak değiştirin.

Yanıt da yok, hata da yok. Resmi öneri, daha ayrıntılı hatalar için claude komutunu bir terminalde çalıştırmaktır. Uzantı kendi CLI'ını içinde getirir ama claude komutunu PATH'inize eklemez; bu yüzden CLI'ı ayrıca kurun ve değişkenlerini Claude Code base URL rehberindeki gibi ayarlayın.

JetBrains kullanıcıları

JetBrains eklentisi kendi CLI'ını içermez. Kurulu claude komutunuzu IDE terminalinde çalıştırır; yolu Settings → Tools → Claude Code [Beta] → Claude command altında değiştirebilirsiniz. Yani JetBrains'i CLI ile aynı şekilde yapılandırırsınız: ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN değerlerini ~/.claude/settings.json dosyasındaki env bloğuna yazın. Claude Code base URL rehberine bakın.

Sık sorulan sorular

VS Code'da Claude Code için base URL nasıl ayarlanır?

VS Code kullanıcı ayarlarına (JSON) ANTHROPIC_BASE_URL (https://api.wokey.ai, /v1 olmadan) ve ANTHROPIC_AUTH_TOKEN içeren claudeCode.environmentVariables ekleyin, claudeCode.disableLoginPrompt değerini true yapın, ardından Reload Window komutunu çalıştırın.

Uzantı neden sürekli giriş yapmamı istiyor?

Uzantının başlatma öncesi oturum kontrolü yalnızca claudeCode.environmentVariables değerini okur; shell değişkenlerini veya ~/.claude/settings.json dosyasını okumaz. Değişkenleri kullanıcı ayarlarınıza yazın, disableLoginPrompt ayarını açın ve pencereyi yeniden yükleyin.

Bunu çalışma alanının .vscode/settings.json dosyasına yazabilir miyim?

Yazmamanız daha iyi. Çalışma alanı ayarları çoğu zaman depoya commit edilir ve bu, anahtarınızı sızdırır. Kullanıcı ayarları zaten her projede geçerlidir.

JetBrains eklentisi nasıl yapılandırılır?

JetBrains eklentisi kurulu claude komutunuzu çalıştırır; bu yüzden onu CLI gibi yapılandırın: ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN değerlerini ~/.claude/settings.json dosyasındaki env bloğuna yazın.