> ## 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.

# Gunakan Claude Desktop dengan CometAPI

> Gunakan panduan ini untuk mengonfigurasi Claude Desktop dengan CometAPI dengan menetapkan base URL, API key, serta opsi model atau provider.

Gunakan panduan ini untuk menghubungkan Claude Desktop Cowork pada third-party inference ke CometAPI. Konfigurasi ini memungkinkan Claude Desktop mengirim permintaan Claude Messages API ke CometAPI dari Cowork, Projects, dan alur kerja desktop yang didukung.

Referensi resmi:

* [Instalasi dan penyiapan Claude Desktop](https://claude.com/docs/cowork/3p/installation)
* [Konfigurasi gateway Claude Desktop](https://claude.com/docs/cowork/3p/gateway)
* [Referensi konfigurasi Claude Desktop](https://claude.com/docs/cowork/3p/configuration)

<Note>
  Third-party inference Claude Desktop memerlukan gateway yang kompatibel dengan Anthropic. CometAPI mendukung model Claude melalui [Anthropic Messages API](/api/text/anthropic-messages).
</Note>

<Warning>
  Konten yang Anda kirim dari Claude Desktop diproses oleh CometAPI dan provider model yang dipilih. Jangan kirim data rahasia kecuali organisasi Anda mengizinkan alur kerja tersebut.
</Warning>

## Prasyarat

* Claude Desktop terpasang dari [claude.com/download](https://claude.com/download)
* Build Claude Desktop yang mencakup **Developer mode** dan **Configure third-party inference**
* Akun CometAPI dengan API key yang aktif
* Akses ke model Claude di CometAPI
* Jalur jaringan yang dapat menjangkau `https://api.cometapi.com`

Mulailah dari layar masuk Claude Desktop. Jika Anda sudah masuk dengan akun Anthropic, keluar terlebih dahulu sebelum mengonfigurasi third-party inference.

## Konfigurasi

<Steps>
  <Step title="Aktifkan mode developer">
    Buka Claude Desktop dan tetap berada di layar masuk. Di menu aplikasi, buka **Help** → **Troubleshooting**, lalu pilih **Enable Developer Mode**.

    Di Windows, menu bisa sulit dijangkau sebelum masuk. Fokuskan field email, tekan `Tab` hingga menu terfokus, lalu tekan `Enter`.
  </Step>

  <Step title="Buka pengaturan inference pihak ketiga">
    Setelah mode developer diaktifkan, buka **Developer** → **Configure third-party inference**.

    Jendela konfigurasi akan terbuka dengan beberapa bagian di sidebar kiri. Gunakan bagian **Connection** untuk pengaturan CometAPI.
  </Step>

  <Step title="Konfigurasikan gateway">
    Di bagian **Connection**, masukkan nilai CometAPI di bawah ini:

    | Field                   | Value                                          |
    | ----------------------- | ---------------------------------------------- |
    | Penyedia Inference      | Gateway                                        |
    | Gateway                 | Anthropic-compatible                           |
    | URL dasar Gateway       | `https://api.cometapi.com`                     |
    | API key Gateway         | API key CometAPI Anda, seperti `$COMETAPI_KEY` |
    | Skema auth Gateway      | Bearer                                         |
    | Header tambahan Gateway | Biarkan kosong                                 |

    Pertahankan URL dasar persis seperti yang ditampilkan. Claude Desktop memerlukan URL dasar HTTPS.

    Tangkapan layar berikut menunjukkan bagian Connection yang telah diisi dengan nilai CometAPI.

    <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="Pengaturan Connection Claude Desktop dengan URL dasar gateway CometAPI, field API key, dan skema auth bearer yang telah diisi" width="1800" height="1440" data-path="images/integrations/claude-desktop-cometapi-connection.png" />
  </Step>

  <Step title="Tambahkan model ID">
    Di **Model list**, tambahkan model ID ini secara manual:

    | Model ID                    | Penggunaan yang direkomendasikan     |
    | --------------------------- | ------------------------------------ |
    | `claude-opus-4-7`           | Perencanaan kompleks dan tugas agent |
    | `claude-sonnet-4-6`         | Penggunaan desktop umum              |
    | `claude-haiku-4-5-20251001` | Prompt ringan dan draf cepat         |

    Model pertama dalam daftar akan menjadi model default. Letakkan `claude-sonnet-4-6` di urutan pertama jika Anda menginginkan default serbaguna.

    <Tip>
      Ketersediaan model dapat berubah. Jika model tidak muncul di Claude Desktop setelah konfigurasi, verifikasi akses di [halaman Models CometAPI](/id/overview/models).
    </Tip>

    Tangkapan layar berikut menunjukkan daftar model dengan tiga model ID Claude yang dikonfigurasi untuk CometAPI.

    <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="Daftar model Claude Desktop yang menampilkan claude-opus-4-7, claude-sonnet-4-6, dan claude-haiku-4-5-20251001 untuk CometAPI" width="1764" height="1278" data-path="images/integrations/claude-desktop-cometapi-model-list.png" />
  </Step>

  <Step title="Terapkan konfigurasi secara lokal">
    Klik **Apply locally**. Claude Desktop menulis konfigurasi yang dipilih ke profil pengguna lokal dan meluncurkan ulang aplikasi.

    Jika aplikasi tidak diluncurkan ulang, tutup Claude Desktop sepenuhnya lalu buka lagi.
  </Step>

  <Step title="Mulai sesi Cowork">
    Di layar masuk, pilih opsi untuk Cowork pada inference pihak ketiga. Buka Cowork atau Projects, pilih salah satu model Claude yang telah dikonfigurasi, lalu kirim Prompt uji singkat.

    Respons yang berhasil mengonfirmasi bahwa Claude Desktop menggunakan CometAPI untuk panggilan model.
  </Step>
</Steps>

## Verifikasi konfigurasi

Gunakan Prompt singkat yang tidak memerlukan alat eksternal:

```text theme={null}
Reply with one sentence: Claude Desktop is connected through CometAPI.
```

Jika Claude Desktop mengembalikan respons, berarti URL dasar, API key, dan daftar model telah dikonfigurasi dengan benar.

Tangkapan layar berikut menunjukkan balasan Cowork yang berhasil melalui CometAPI.

<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="Balasan Cowork Claude Desktop yang menggunakan CometAPI setelah pengaturan inference pihak ketiga" width="2880" height="1600" data-path="images/integrations/claude-desktop-cometapi-chat.png" />

Untuk memeriksa pengaturan yang terdeteksi, buka **Help** → **Troubleshooting** → **Copy Managed Configuration Report**. Nilai rahasia disamarkan dalam laporan yang disalin.

## Pemecahan masalah

<AccordionGroup>
  <Accordion title="Menu pengembang tidak muncul">
    Pastikan Anda memilih **Help** → **Troubleshooting** → **Enable Developer Mode**. Lalu keluar sepenuhnya dari Claude Desktop dan buka kembali.

    Jika opsi tersebut tidak ada, instal build Claude Desktop yang menyertakan konfigurasi inference pihak ketiga.
  </Accordion>

  <Accordion title="Claude Desktop membuka alur masuk standar">
    Periksa hal-hal berikut:

    * **Inference provider** diatur ke **Gateway**.
    * **Gateway base URL** adalah `https://api.cometapi.com`.
    * **Gateway API key** berisi API key CometAPI Anda tanpa spasi tambahan.
    * Anda mengklik **Apply locally** dan sepenuhnya memulai ulang Claude Desktop.
  </Accordion>

  <Accordion title="Validasi koneksi gagal">
    Pastikan base URL dimulai dengan `https://`. Claude Desktop tidak menerima URL gateway HTTP biasa.

    Pastikan juga akun CometAPI Anda memiliki akses ke model Claude dan API key tersebut belum dihapus atau dinonaktifkan.
  </Accordion>

  <Accordion title="Model yang dikonfigurasi tidak muncul">
    Buka kembali **Developer** → **Configure third-party inference** dan periksa entri **Model list**. Model ID harus cocok dengan ID yang diekspos oleh CometAPI.

    Tambahkan setiap model ID sebagai entri terpisah. Jangan sertakan tanda kutip, koma, atau spasi tambahan di kolom UI.
  </Accordion>

  <Accordion title="Base URL yang kompatibel dengan OpenAI tidak berfungsi">
    Inference pihak ketiga Claude Desktop mengharapkan gateway yang kompatibel dengan Anthropic untuk alur ini. Gunakan `https://api.cometapi.com` dan model ID Claude yang tercantum di atas.
  </Accordion>

  <Accordion title="Tab Code berperilaku berbeda">
    Tab Code menggunakan mesin Claude Code di dalam Claude Desktop. Beberapa pengaturan desktop mungkin tidak berlaku untuk sesi Code dengan cara yang sama seperti saat berlaku untuk Cowork.

    Untuk penggunaan terminal mandiri, lihat [panduan integrasi Claude Code](/id/integrations/claude-code).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#howto",
        "name": "Gunakan Claude Desktop dengan CometAPI",
        "description": "Gunakan panduan ini untuk mengonfigurasi Claude Desktop dengan CometAPI dengan menetapkan base URL, API key, serta opsi model atau provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-1",
            "position": 1,
            "name": "Aktifkan mode pengembang",
            "text": "Selesaikan langkah Aktifkan mode pengembang dalam panduan Gunakan Claude Desktop dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-2",
            "position": 2,
            "name": "Buka pengaturan inference pihak ketiga",
            "text": "Selesaikan langkah Buka pengaturan inference pihak ketiga dalam panduan Gunakan Claude Desktop dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-3",
            "position": 3,
            "name": "Konfigurasikan gateway",
            "text": "Selesaikan langkah Konfigurasikan gateway dalam panduan Gunakan Claude Desktop dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-4",
            "position": 4,
            "name": "Tambahkan model ID",
            "text": "Selesaikan langkah Tambahkan model ID dalam panduan Gunakan Claude Desktop dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-5",
            "position": 5,
            "name": "Terapkan konfigurasi secara lokal",
            "text": "Selesaikan langkah Terapkan konfigurasi secara lokal dalam panduan Gunakan Claude Desktop dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-6",
            "position": 6,
            "name": "Mulai sesi Cowork",
            "text": "Selesaikan langkah Mulai sesi Cowork dalam panduan Gunakan Claude Desktop dengan CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Dokumentasi CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrasi",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Gunakan Claude Desktop dengan CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-desktop"
          }
        ]
      }
    ]
    }
    `}
</script>