Üçüncü taraf API ile Claude Desktop: Configure Third-Party Inference ve sorun giderme

Wokey Team · 2026-09-24

Kısa cevap: Claude masaüstü uygulamasında üçüncü taraf bir API kullanmanın tek bir yolu vardır: Developer → Configure Third-Party Inference. Uygulama ne ANTHROPIC_BASE_URL değerini ne de ~/.claude/settings.json dosyasını okur; bu yüzden terminalinizde çalışan bir kurulum masaüstü uygulamasında hiçbir şey yapmaz. Bu rehber sık karşılaşılan sorunları ele alır: eksik menü, etkili olmayan ayarlar, boş model listesi ve üçüncü taraf modunda zaten bulunmayan özellikler. İlk kurulumun tamamı için Claude Desktop kurulum rehberine bakın.

Doğru sıra

1. Masaüstü uygulamasını açın ve bir Anthropic hesabına giriş yapmayın.

2. Help → Troubleshooting → Enable Developer Mode yolunu açın.

3. Developer → Configure Third-Party Inference… yolunu açın.

4. Connection bölümünde Inference provider değerini Gateway yapın, ardından Gateway credentials alanlarını doldurun:

   Alan	Değer
   Gateway base URL	https://api.wokey.ai (/v1 olmadan)
   Gateway API key	Wokey API anahtarınız
   Credential kind	Static API key
   Gateway auth scheme	Bearer (Wokey x-api-key de kabul eder; varsayılanı bırakın)

5. Apply Changes, ardından Save & Restart düğmesine tıklayın.

Sistem gereksinimleri:

• macOS: 14 (Sonoma) veya sonrası, Apple silicon ya da Intel üzerinde.
• Windows: Windows 10 build 19041 veya sonrası, x64 ya da Arm64 üzerinde.

Developer menüsü yok

Developer menüsü yalnızca geliştirici modu açıldıktan sonra görünür: Help → Troubleshooting → Enable Developer Mode. Bu öğe Help menüsünde de yoksa uygulamayı en son sürüme güncelleyin; eski sürümlerde üçüncü taraf çıkarım ayarları bulunmaz.

Yapılandırma penceresi salt okunur

Bilgisayarda bir yöneticinin gönderdiği bir yapılandırma, örneğin şirketinizden gelen bir MDM profili zaten varsa pencere salt okunur açılır ve onu yerelde değiştiremezsiniz. Yöneticinize danışın veya yönetilmeyen bir bilgisayar kullanın.

Ortam değişkenlerinin etkisi yok

En yaygın hata budur. Masaüstü uygulaması gateway ayarlarını yalnızca üçüncü taraf çıkarım yapılandırmasından alır. Ne ANTHROPIC_BASE_URL değerini ne de settings.json dosyasını okur.

Masaüstü uygulamasının Code sekmesi de aynı şekilde davranır. CLI ile aynı Claude Code motorunu çalıştırır, ancak gateway adresi ve kimlik bilgisi doğrudan masaüstü yapılandırmasından gelir. ~/.claude/settings.json dosyasındaki kullanıcı düzeyi ayarlar bunları geçersiz kılamaz.

Tersi de geçerlidir: masaüstü yapılandırması terminalinizdeki claude komutunu etkilemez. Her birini ayrı ayrı kurun; terminal için Claude Code base URL rehberine bakın.

Model listesi boş veya modeller eksik

Kendi model listeniz yoksa uygulama gateway'in GET /v1/models uç noktasını çağırır ve yalnızca kimliğinden Claude olduğu anlaşılan modelleri tutar. Bu yüzden Wokey ile otomatik keşif claude-opus-5 ve claude-sonnet-5 gibi modelleri gösterir; GPT, Grok ve diğer modelleri ise eler. Bu beklenen davranıştır.

Listeyi sabitlemek veya varsayılan modeli seçmek için yapılandırma penceresindeki model listesine (Model list, inferenceModels anahtarı) tam model kimliklerini girin:

• İlk giriş varsayılandır ve Code sekmesindeki yeni oturumlar da onunla başlar.
• Her giriş tam bir kimlik olduğunda uygulama /v1/models isteğini atlar.
• /v1/models başarısız olur ve liste boşsa seçici de boş kalır.

Hatalar

Gateway was unreachable: uygulama gateway'e ulaşamıyor. Gateway base URL alanında yazım hatası olup olmadığına bakın, ardından terminalden curl ile test edin:

curl -X POST https://api.wokey.ai/v1/messages \
  -H "Authorization: Bearer your Wokey API key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

curl çalışıyor ama uygulama çalışmıyorsa neden genellikle bir proxy'dir: terminal proxy üzerinden gidiyor ve uygulama gitmiyordur ya da tam tersi.

code değeri invalid_api_key olan 401: istek Wokey'ye ulaştı, ancak anahtar eksik veya yanlış. Wokey iki kimlik doğrulama şemasını da kabul eder; o ayarı değiştirmeniz gerekmez. Anahtarı yeniden yapıştırın.

invalid x-api-key: istek Anthropic'e gitmiştir, yani üçüncü taraf yapılandırması geçerli değildir. Genellikle Save & Restart düğmesine tıklanmamıştır veya sonrasında giriş ekranında Anthropic girişi seçilmiştir. invalid x-api-key rehberine bakın.

Daha fazla ayrıntı için: Help → Troubleshooting → Generate Diagnostic Report ile bir rapor dışa aktarın. İçindeki üç dosya işe yarar:

• managed-config.txt: geçerli olan yapılandırma.
• provider-status.txt: gateway bağlantı durumu.
• deployment-mode.txt: geçerli mod.

Günlükler şurada bulunur:

• macOS: ~/Library/Logs/Claude-3p/main.log
• Windows: %LOCALAPPDATA%\Claude-3p\Logs\main.log

Üçüncü taraf modunda kullanılamayan özellikler

Bunlar bir Anthropic hesabına veya Anthropic'in bulut hizmetlerine bağlıdır; bu yüzden bir gateway ile kullanılamaz. Bu bir yapılandırma sorunu değildir:

• Mobil ve claude.ai web erişimi
• Ses modu
• Proje ve eklenti paylaşımı
• Claude Design, Claude Security ve Claude Tag
• Computer use
• Remote Control ve Anthropic'in barındırdığı bulut ortamları

İki özellik daha varsayılan olarak kapalıdır:

• Tool search ve deneysel beta özellikleri. Uygulama, katı gateway'lerle uyumluluk için bunları kapatır. Tool search özelliğini toolSearchEnabled ile yeniden açın.
• SSH uzak oturumları. Bunlar üçüncü taraf modunda beta aşamasındadır ve bir yöneticinin host izin listesi kurmasını gerektirir.

Anthropic hesabınıza geri dönmek

Standart Claude masaüstü uygulamasına dönmek için giriş ekranında Anthropic giriş seçeneğini seçin.