Langsung ke konten utama
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:
Third-party inference Claude Desktop memerlukan gateway yang kompatibel dengan Anthropic. CometAPI mendukung model Claude melalui Anthropic Messages API.
Konten yang Anda kirim dari Claude Desktop diproses oleh CometAPI dan penyedia model yang dipilih. Jangan kirim data rahasia kecuali organisasi Anda mengizinkan alur kerja tersebut.

​
Prasyarat

  • Claude Desktop terinstal dari claude.com/download
  • Build Claude Desktop yang menyertakan 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
Mulai dari layar masuk Claude Desktop. Jika Anda sudah masuk dengan akun Anthropic, keluar terlebih dahulu sebelum mengonfigurasi third-party inference.

​
Konfigurasi

1

Aktifkan developer mode

Buka Claude Desktop dan tetap berada di layar masuk. Di menu aplikasi, buka Help → Troubleshooting, lalu pilih Enable Developer Mode.Di Windows, menu mungkin sulit dijangkau sebelum masuk. Fokus pada kolom email, tekan Tab hingga menu terfokus, lalu tekan Enter.
2

Buka pengaturan third-party inference

Setelah developer mode diaktifkan, buka Developer → Configure third-party inference.Jendela konfigurasi terbuka dengan beberapa bagian di bilah sisi kiri. Gunakan bagian Connection untuk pengaturan CometAPI.
3

Konfigurasikan gateway

Di bagian Connection, masukkan nilai CometAPI di bawah ini:
FieldValue
Inference providerGateway
GatewayKompatibel dengan Anthropic
Gateway base URLhttps://api.cometapi.com
Gateway API keyAPI key CometAPI Anda, seperti <COMETAPI_KEY>
Gateway auth schemeBearer
Gateway extra headersBiarkan kosong
Biarkan base URL persis seperti yang ditampilkan. Claude Desktop memerlukan base URL HTTPS.Tangkapan layar berikut menunjukkan bagian Connection yang diisi dengan nilai CometAPI.Pengaturan Connection Claude Desktop dengan gateway base URL CometAPI, kolom API key, dan bearer auth scheme yang telah diisi
4

Tambahkan model ID

Di Model list, tambahkan model ID ini secara manual:
Model IDPenggunaan yang direkomendasikan
claude-opus-4-7Perencanaan kompleks dan tugas agen
claude-sonnet-4-6Penggunaan desktop umum
claude-haiku-4-5-20251001Prompt ringan dan draf cepat
Model pertama dalam daftar menjadi model default. Letakkan claude-sonnet-4-6 di urutan pertama jika Anda menginginkan default serbaguna.
Ketersediaan model dapat berubah. Jika model tidak muncul di Claude Desktop setelah konfigurasi, verifikasi akses di halaman Models CometAPI.
Tangkapan layar berikut menunjukkan daftar model dengan tiga model ID Claude yang dikonfigurasi untuk CometAPI.Daftar model Claude Desktop yang menampilkan claude-opus-4-7, claude-sonnet-4-6, dan claude-haiku-4-5-20251001 untuk CometAPI
5

Terapkan konfigurasi secara lokal

Klik Apply locally. Claude Desktop menulis konfigurasi yang dipilih ke profil pengguna lokal lalu meluncurkan ulang aplikasi.Jika aplikasi tidak meluncur ulang, tutup Claude Desktop sepenuhnya dan buka lagi.
6

Mulai sesi Cowork

Di layar masuk, pilih opsi untuk Cowork pada third-party inference. Buka Cowork atau Projects, pilih salah satu model Claude yang dikonfigurasi, lalu kirim prompt uji singkat.Respons yang berhasil mengonfirmasi bahwa Claude Desktop menggunakan CometAPI untuk pemanggilan model.

​
Verifikasi konfigurasi

Gunakan prompt singkat yang tidak memerlukan alat eksternal: 
Reply with one sentence: Claude Desktop is connected through CometAPI.
Jika Claude Desktop mengembalikan respons, berarti base URL, API key, dan daftar model telah dikonfigurasi dengan benar. Tangkapan layar berikut menunjukkan balasan Cowork yang berhasil melalui CometAPI. Balasan Cowork Claude Desktop yang menggunakan CometAPI setelah penyiapan third-party inference Untuk memeriksa pengaturan yang terdeteksi, buka Help → Troubleshooting → Copy Managed Configuration Report. Nilai rahasia disamarkan dalam laporan yang disalin.

​
Pemecahan masalah

Periksa item 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 memulai ulang Claude Desktop sepenuhnya.
Pastikan base URL diawali 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.
Buka kembali Developer → Configure third-party inference lalu periksa entri Model list. Model ID harus sama persis dengan ID yang diekspos CometAPI.Tambahkan setiap model ID sebagai entri terpisah. Jangan sertakan tanda kutip, koma, atau spasi tambahan di kolom UI.
Third-party inference Claude Desktop mengharapkan gateway yang kompatibel dengan Anthropic untuk alur ini. Gunakan https://api.cometapi.com dan model ID Claude yang tercantum di atas.
Tab Code menggunakan engine Claude Code di dalam Claude Desktop. Beberapa pengaturan desktop mungkin tidak berlaku untuk sesi Code dengan cara yang sama seperti pada Cowork.Untuk penggunaan terminal mandiri, lihat panduan integrasi Claude Code.