Ana içeriğe atla
Claude Desktop Cowork on third-party inference’ı CometAPI’ye bağlamak için bu kılavuzu kullanın. Bu yapılandırma, Claude Desktop’ın Cowork, Projects ve desteklenen masaüstü iş akışlarından CometAPI’ye Claude Messages API istekleri göndermesini sağlar. Resmi başvurular:
Claude Desktop third-party inference, Anthropic-compatible bir gateway gerektirir. CometAPI, Claude modellerini Anthropic Messages API üzerinden destekler.
Claude Desktop’tan gönderdiğiniz içerik, CometAPI ve seçilen model sağlayıcısı tarafından işlenir. Kuruluşunuz bu iş akışına izin vermiyorsa gizli veriler göndermeyin.

​
Ön koşullar

  • claude.com/download üzerinden yüklenmiş Claude Desktop
  • Developer mode ve Configure third-party inference içeren bir Claude Desktop sürümü
  • Etkin bir API anahtarına sahip bir CometAPI hesabı
  • CometAPI içinde Claude modellerine erişim
  • https://api.cometapi.com adresine erişebilen bir ağ yolu
Claude Desktop oturum açma ekranından başlayın. Zaten bir Anthropic hesabıyla oturum açtıysanız, third-party inference yapılandırmadan önce oturumu kapatın.

​
Yapılandırma

1

Developer mode'u etkinleştirin

Claude Desktop’ı açın ve oturum açma ekranında kalın. Uygulama menüsünde Help → Troubleshooting bölümünü açın, ardından Enable Developer Mode seçeneğini seçin.Windows’ta oturum açmadan önce menüye ulaşmak zor olabilir. E-posta alanına odaklanın, menü odaklanana kadar Tab tuşuna basın, ardından Enter tuşuna basın.
2

Third-party inference ayarlarını açın

Developer mode etkinleştirildikten sonra Developer → Configure third-party inference bölümünü açın.Yapılandırma penceresi, sol kenar çubuğunda birkaç bölümle açılır. CometAPI ayarları için Connection bölümünü kullanın.
3

Gateway'i yapılandırın

Connection bölümünde aşağıdaki CometAPI değerlerini girin:
AlanDeğer
Inference providerGateway
GatewayAnthropic-compatible
Gateway base URLhttps://api.cometapi.com
Gateway API key<COMETAPI_KEY> gibi CometAPI API anahtarınız
Gateway auth schemeBearer
Gateway extra headersBoş bırakın
Base URL’yi tam olarak gösterildiği gibi koruyun. Claude Desktop bir HTTPS base URL gerektirir.Aşağıdaki ekran görüntüsü, Connection bölümünün CometAPI değerleriyle doldurulmuş halini gösterir.CometAPI gateway base URL, API key alanı ve bearer auth scheme doldurulmuş Claude Desktop Connection ayarları
4

Model ID'lerini ekleyin

Model list içinde bu model ID’lerini manuel olarak ekleyin:
Model IDÖnerilen kullanım
claude-opus-4-7Karmaşık planlama ve agent görevleri
claude-sonnet-4-6Genel masaüstü kullanımı
claude-haiku-4-5-20251001Hafif Prompt’lar ve hızlı taslaklar
Listedeki ilk model varsayılan model olur. Genel amaçlı bir varsayılan istiyorsanız claude-sonnet-4-6 modelini ilk sıraya koyun.
Model kullanılabilirliği değişebilir. Bir model yapılandırmadan sonra Claude Desktop’ta görünmüyorsa, erişimi CometAPI Models page üzerinden doğrulayın.
Aşağıdaki ekran görüntüsü, CometAPI için yapılandırılmış üç Claude model ID’siyle model listesini gösterir.CometAPI için claude-opus-4-7, claude-sonnet-4-6 ve claude-haiku-4-5-20251001 gösteren Claude Desktop model listesi
5

Yapılandırmayı yerel olarak uygulayın

Apply locally seçeneğine tıklayın. Claude Desktop seçilen yapılandırmayı yerel kullanıcı profiline yazar ve uygulamayı yeniden başlatır.Uygulama yeniden başlatılmazsa Claude Desktop’ı tamamen kapatın ve tekrar açın.
6

Bir Cowork oturumu başlatın

Oturum açma ekranında, third-party inference üzerinde Cowork seçeneğini seçin. Cowork veya Projects’i açın, yapılandırılmış Claude modellerinden birini seçin ve kısa bir test Prompt’u gönderin.Başarılı bir yanıt, Claude Desktop’ın model çağrıları için CometAPI’yi kullandığını doğrular.

​
Yapılandırmayı doğrulayın

Harici araçlar gerektirmeyen kısa bir Prompt kullanın: 
Reply with one sentence: Claude Desktop is connected through CometAPI.
Claude Desktop bir yanıt döndürürse, base URL, API key ve model list doğru şekilde yapılandırılmış demektir. Aşağıdaki ekran görüntüsü, CometAPI üzerinden başarılı bir Cowork yanıtını gösterir. Third-party inference kurulumu sonrasında CometAPI kullanan Claude Desktop Cowork yanıtı Algılanan ayarları incelemek için Help → Troubleshooting → Copy Managed Configuration Report bölümünü açın. Kopyalanan raporda gizli değerler sansürlenir.

​
Sorun giderme

Help → Troubleshooting → Enable Developer Mode seçeneğini seçtiğinizi doğrulayın. Ardından Claude Desktop’ı tamamen kapatın ve tekrar açın.Seçenek yoksa, third-party inference yapılandırmasını içeren bir Claude Desktop sürümü yükleyin.
Şunları kontrol edin:
  • Inference provider değeri Gateway olarak ayarlanmış olmalıdır.
  • Gateway base URL https://api.cometapi.com olmalıdır.
  • Gateway API key, fazladan boşluk içermeden CometAPI API anahtarınızı içermelidir.
  • Apply locally seçeneğine tıkladınız ve Claude Desktop’ı tamamen yeniden başlattınız.
Base URL’nin https:// ile başladığını doğrulayın. Claude Desktop düz HTTP gateway URL’lerini kabul etmez.Ayrıca CometAPI hesabınızın Claude modellerine erişimi olduğunu ve API anahtarının silinmediğini veya devre dışı bırakılmadığını da doğrulayın.
Developer → Configure third-party inference bölümünü yeniden açın ve Model list girişlerini kontrol edin. Model ID’leri, CometAPI’nin sunduğu ID’lerle eşleşmelidir.Her model ID’sini ayrı bir giriş olarak ekleyin. UI alanlarına tırnak işareti, virgül veya fazladan boşluk eklemeyin.
Claude Desktop third-party inference, bu akış için Anthropic-compatible bir gateway bekler. https://api.cometapi.com adresini ve yukarıda listelenen Claude model ID’lerini kullanın.
Code sekmesi, Claude Desktop içindeki Claude Code engine’ini kullanır. Bazı masaüstü ayarları, Cowork için uygulandığı şekilde Code oturumlarına aynı biçimde uygulanmayabilir.Bağımsız terminal kullanımı için Claude Code integration guide sayfasına bakın.