> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop'ı CometAPI ile kullanın

> base URL, API anahtarı ve model veya sağlayıcı seçeneklerini ayarlayarak Claude Desktop'ı CometAPI ile yapılandırmak için bu kılavuzu kullanın.

Claude Desktop'ta üçüncü taraf inference üzerinde Cowork'u 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 Claude Messages API isteklerini CometAPI'ye göndermesini sağlar.

Resmi başvurular:

* [Claude Desktop installation and setup](https://claude.com/docs/cowork/3p/installation)
* [Claude Desktop gateway configuration](https://claude.com/docs/cowork/3p/gateway)
* [Claude Desktop configuration reference](https://claude.com/docs/cowork/3p/configuration)

<Note>
  Claude Desktop üçüncü taraf inference, Anthropic uyumlu bir gateway gerektirir. CometAPI, [Anthropic Messages API](/api/text/anthropic-messages) üzerinden Claude modellerini destekler.
</Note>

<Warning>
  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 verileri göndermeyin.
</Warning>

## Ön koşullar

* [claude.com/download](https://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 ulaşabilen bir ağ yolu

Claude Desktop oturum açma ekranından başlayın. Zaten bir Anthropic hesabıyla oturum açtıysanız, üçüncü taraf inference yapılandırmasına geçmeden önce oturumu kapatın.

## Yapılandırma

<Steps>
  <Step title="Geliştirici modunu etkinleştirin">
    Claude Desktop'u 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.
  </Step>

  <Step title="Üçüncü taraf inference ayarlarını açın">
    Geliştirici modu 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.
  </Step>

  <Step title="Gateway'i yapılandırın">
    **Connection** bölümünde aşağıdaki CometAPI değerlerini girin:

    | Alan                  | Değer                                         |
    | --------------------- | --------------------------------------------- |
    | Inference provider    | Gateway                                       |
    | Gateway               | Anthropic-compatible                          |
    | Gateway base URL      | `https://api.cometapi.com`                    |
    | Gateway API key       | `$COMETAPI_KEY` gibi CometAPI API anahtarınız |
    | Gateway auth scheme   | Bearer                                        |
    | Gateway extra headers | Boş bırakın                                   |

    Base URL'yi tam olarak gösterildiği gibi tutun. Claude Desktop, HTTPS bir base URL gerektirir.

    Aşağıdaki ekran görüntüsü, Connection bölümünün CometAPI değerleriyle doldurulmuş halini gösterir.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-connection.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=879de5e2a4587861f220a7f6e0f7d2a5" alt="CometAPI gateway base URL, API key alanı ve bearer auth scheme doldurulmuş Claude Desktop Connection ayarları" width="1800" height="1440" data-path="images/integrations/claude-desktop-cometapi-connection.png" />
  </Step>

  <Step title="Model ID'lerini ekleyin">
    **Model list** bölümüne bu model ID'lerini manuel olarak ekleyin:

    | Model ID                    | Önerilen kullanım                   |
    | --------------------------- | ----------------------------------- |
    | `claude-opus-4-7`           | Karmaşık planlama ve ajan görevleri |
    | `claude-sonnet-4-6`         | Genel masaüstü kullanımı            |
    | `claude-haiku-4-5-20251001` | Hafif 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.

    <Tip>
      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](/tr/overview/models) üzerinden doğrulayın.
    </Tip>

    Aşağıdaki ekran görüntüsü, CometAPI için yapılandırılmış üç Claude model ID'siyle model listesini gösterir.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-model-list.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=63dcdfe05db59c09782e1514e09a734d" alt="CometAPI için claude-opus-4-7, claude-sonnet-4-6 ve claude-haiku-4-5-20251001 gösteren Claude Desktop model listesi" width="1764" height="1278" data-path="images/integrations/claude-desktop-cometapi-model-list.png" />
  </Step>

  <Step title="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'tan tamamen çıkın ve tekrar açın.
  </Step>

  <Step title="Bir Cowork oturumu başlatın">
    Oturum açma ekranında, üçüncü taraf inference için 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'un model çağrıları için CometAPI kullandığını doğrular.
  </Step>
</Steps>

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

Harici araçlar gerektirmeyen kısa bir Prompt kullanın:

```text theme={null}
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ıştır.

Aşağıdaki ekran görüntüsü, CometAPI üzerinden başarılı bir Cowork yanıtını gösterir.

<img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-chat.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=93bb3b1a60de0d7edbd25cb6ba3b58d8" alt="Üçüncü taraf inference kurulumundan sonra CometAPI kullanan Claude Desktop Cowork yanıtı" width="2880" height="1600" data-path="images/integrations/claude-desktop-cometapi-chat.png" />

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

<AccordionGroup>
  <Accordion title="Geliştirici menüsü görünmüyor">
    **Help** → **Troubleshooting** → **Enable Developer Mode** seçeneğini seçtiğinizi doğrulayın. Ardından Claude Desktop'u tamamen kapatın ve yeniden açın.

    Seçenek yoksa, üçüncü taraf inference yapılandırmasını içeren bir Claude Desktop build'i yükleyin.
  </Accordion>

  <Accordion title="Claude Desktop standart oturum açma akışını açıyor">
    Şu öğeleri kontrol edin:

    * **Inference provider** değeri **Gateway** olarak ayarlanmış.
    * **Gateway base URL** değeri `https://api.cometapi.com`.
    * **Gateway API key**, fazladan boşluk olmadan CometAPI API anahtarınızı içeriyor.
    * **Apply locally** seçeneğine tıkladınız ve Claude Desktop'u tamamen yeniden başlattınız.
  </Accordion>

  <Accordion title="Bağlantı doğrulaması başarısız oluyor">
    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.
  </Accordion>

  <Accordion title="Yapılandırılmış modeller görünmüyor">
    **Developer** → **Configure third-party inference** bölümünü yeniden açın ve **Model list** girdilerini kontrol edin. Model ID'ler CometAPI'nin sunduğu kimliklerle eşleşmelidir.

    Her model ID'yi ayrı bir girdi olarak ekleyin. UI alanlarına tırnak işareti, virgül veya fazladan boşluk eklemeyin.
  </Accordion>

  <Accordion title="OpenAI-compatible bir base URL çalışmıyor">
    Claude Desktop üçüncü taraf inference için bu akışta Anthropic-compatible bir gateway bekler. `https://api.cometapi.com` adresini ve yukarıda listelenen Claude model ID'lerini kullanın.
  </Accordion>

  <Accordion title="Code sekmesi farklı davranıyor">
    Code sekmesi, Claude Desktop içindeki Claude Code engine'ini kullanır. Bazı masaüstü ayarları, Cowork için geçerli oldukları şekilde Code oturumları için aynı biçimde geçerli olmayabilir.

    Bağımsız terminal kullanımı için [Claude Code integration guide](/tr/integrations/claude-code) sayfasına bakın.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#howto",
        "name": "Claude Desktop'u CometAPI ile kullanın",
        "description": "base URL, API key ve model veya provider seçeneklerini ayarlayarak Claude Desktop'u CometAPI ile yapılandırmak için bu kılavuzu kullanın.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-1",
            "position": 1,
            "name": "Geliştirici modunu etkinleştirin",
            "text": "Claude Desktop'u CometAPI ile kullanın kılavuzundaki Geliştirici modunu etkinleştirin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-2",
            "position": 2,
            "name": "Üçüncü taraf inference ayarlarını açın",
            "text": "Claude Desktop'u CometAPI ile kullanın kılavuzundaki Üçüncü taraf inference ayarlarını açın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-3",
            "position": 3,
            "name": "Gateway'i yapılandırın",
            "text": "Claude Desktop'u CometAPI ile kullanın kılavuzundaki Gateway'i yapılandırın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-4",
            "position": 4,
            "name": "Model ID'lerini ekleyin",
            "text": "Claude Desktop'u CometAPI ile kullanın kılavuzundaki Model ID'lerini ekleyin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-5",
            "position": 5,
            "name": "Yapılandırmayı yerel olarak uygulayın",
            "text": "Claude Desktop'u CometAPI ile kullanın kılavuzundaki Yapılandırmayı yerel olarak uygulayın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-6",
            "position": 6,
            "name": "Bir Cowork oturumu başlatın",
            "text": "Claude Desktop'u CometAPI ile kullanın kılavuzundaki Bir Cowork oturumu başlatın adımını tamamlayın."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI Dokümantasyonu",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Entegrasyonlar",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Claude Desktop'u CometAPI ile kullanın",
            "item": "https://apidoc.cometapi.com/integrations/claude-desktop"
          }
        ]
      }
    ]
    }
    `}
</script>