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

# Claude Desktop

> Hubungkan Claude Desktop ke gateway Hostlinku melalui Configure Third-Party Inference, tanpa proxy lokal tambahan.

[Claude Desktop](https://claude.com/download) dapat memakai gateway Hostlinku melalui **Configure Third-Party Inference** pada versi aplikasi yang menyediakan menu ini. Isi base URL dan API key di aplikasi, lalu pilih model yang tersedia untuk Service Mode key kamu.

Panduan ini untuk aplikasi Desktop. Untuk terminal atau ekstensi VS Code/JetBrains, lihat [Claude Code](https://docs.hostlinku.com/integrations/claude-code.md). Tidak perlu memasang proxy lokal atau mengubah konfigurasi MCP untuk jalur inference ini.

## Sebelum mulai

* Instal Claude Desktop dari [halaman unduhan resmi](https://claude.com/download).
* Buat API key Hostlinku di [Console → API Keys](https://console.hostlinku.com/api-keys/), dengan Service Mode yang menyediakan model Claude tujuan.
* Pastikan saldo USD dan limit pengeluaran key mencukupi. Penggunaan ditagihkan ke Hostlinku; lihat [Billing & Saldo](https://docs.hostlinku.com/billing.md).

Cakupan pengujian

Screenshot Windows berikut menunjukkan model discovery dan uji inference berhasil. Percakapan sederhana pada mode **Code** di Claude Desktop juga berhasil menggunakan **Fable 5.2**. Hasil ini belum membuktikan seluruh fitur Chat, Cowork, artifacts, connector, atau semua model sudah teruji. Nama dan letak menu dapat berbeda menurut versi aplikasi.

### Aktifkan Developer Mode

Pada Windows, buka menu aplikasi **☰ → Help → Troubleshooting → Enable Developer Mode**. Jika menu Developer belum muncul setelah diaktifkan, tutup aplikasi sepenuhnya lalu buka kembali.

![Claude Desktop Windows: Enable Developer Mode pada menu Help → Troubleshooting](https://mintcdn.com/hostlinku/D_n6COs9jkVA6WFt/images/integrations/claude-desktop-developer-mode.webp?fit=max\&auto=format\&n=D_n6COs9jkVA6WFt\&q=85\&s=8d52f77f1d224acf4278f03098e0a0ee)

### Buka pengaturan third-party inference

Buka **☰ → Developer → Configure Third-Party Inference…**.

![Claude Desktop Windows: Configure Third-Party Inference pada menu Developer](https://mintcdn.com/hostlinku/D_n6COs9jkVA6WFt/images/integrations/claude-desktop-third-party-menu.webp?fit=max\&auto=format\&n=D_n6COs9jkVA6WFt\&q=85\&s=2b29c13ba052454fe69fabbb47bc78ac)

### Isi koneksi Hostlinku

Di bagian **Connection**, gunakan pengaturan berikut:

| Field | Nilai |
| - | - |
| Provider | `Gateway` |
| Credential kind | `Static API key` |
| Gateway base URL | `https://api.hostlinku.com` |
| Gateway API key | API key Hostlinku kamu, mis. `sk-your-api-key` |
| Gateway auth scheme | `x-api-key` |

Masukkan key mentah tanpa awalan `Bearer `. Base URL tidak perlu ditambah `/v1` atau `/messages`. Hostlinku sudah menyediakan `GET /v1/models` untuk discovery dan `POST /v1/messages` untuk inference Anthropic Messages.

Pengujian pada gambar memakai `x-api-key`. Gateway Hostlinku juga menerima `Authorization: Bearer`, tetapi hasil pada gambar tidak menguji pilihan tersebut. Custom inference headers tidak diperlukan untuk konfigurasi dasar ini.

![Konfigurasi gateway Claude Desktop: base URL Hostlinku, static API key tersamar, x-api-key, dan hasil Test connection berhasil](https://mintcdn.com/hostlinku/D_n6COs9jkVA6WFt/images/integrations/claude-desktop-gateway-settings.webp?fit=max\&auto=format\&n=D_n6COs9jkVA6WFt\&q=85\&s=13d5e81a7e0ccf512c2f8141d09dd096)

### Uji koneksi dan temukan model

Klik **Test connection**. Hasil sukses menampilkan **Model discovery** dan **Inference**. Untuk memeriksa daftar saja, gunakan **Test model discovery** pada bagian **Models** bila tersedia.

Jumlah **12 models** pada screenshot adalah hasil key saat pengujian, bukan jumlah tetap untuk semua akun. Daftar mengikuti Service Mode dan ketersediaan model pada key. Jika mengisi **Model list** secara manual, gunakan slug dari `GET /v1/models` yang mendukung Anthropic Messages; jangan menyalin daftar model milik provider lain.

### Simpan dan coba percakapan

Klik **Save Changes**, lalu **Apply Changes** bila tersedia. Ikuti permintaan restart aplikasi. Buka sesi **Code** di Desktop, pilih model yang tersedia, lalu kirim pesan sederhana seperti `halo`.

Screenshot berikut menunjukkan balasan dengan **Fable 5.2**. Periksa juga **Console → Request Logs** untuk menghubungkan request dengan API key, model, status, dan biaya. Test connection sendiri dapat memakai token dan menimbulkan biaya kecil.

![Claude Desktop mode Code: percakapan halo berhasil dengan model Fable 5.2 melalui environment HostlinkuGateway](https://mintcdn.com/hostlinku/D_n6COs9jkVA6WFt/images/integrations/claude-desktop-code-conversation.webp?fit=max\&auto=format\&n=D_n6COs9jkVA6WFt\&q=85\&s=4dca2b60c563d61ae63c22850eb8eddb)

## Batas fitur

* **Inference berbeda dari MCP.** Pengaturan ini mengarahkan request model ke Hostlinku; pengaturan connector atau MCP tidak otomatis mengganti provider inference.
* **Gateway-managed Claude Code** dan **Server-side Auto mode checks** bukan syarat konfigurasi static key yang diperlihatkan. Integrasi ini belum menguji fitur tersebut.
* Dukungan tool calling, vision, reasoning, konteks, dan caching mengikuti model serta jalur protokol. Lihat [Anthropic Messages](https://docs.hostlinku.com/anthropic-messages.md) dan [katalog model](https://docs.hostlinku.com/models.md).
* Penemuan model berhasil tidak menjamin semua model pada daftar bekerja dengan seluruh fitur agent Desktop. Mulai dengan model Claude dan tugas sederhana.

## Troubleshooting

| Gejala | Pemeriksaan |
| - | - |
| Menu Developer atau third-party inference tidak ada | Pastikan versi Desktop menyediakan fitur tersebut, aktifkan Developer Mode, lalu restart aplikasi sepenuhnya. |
| `401` | Periksa key, status pencabutan/kedaluwarsa, serta kecocokan auth scheme. Jangan tambahkan `Bearer ` pada field key. |
| Discovery kosong atau model tidak ditemukan | Jalankan Test model discovery; cek `GET /v1/models` memakai key yang sama dan slug yang sesuai Service Mode. |
| `400 MODEL_NOT_IN_SERVICE_MODE` | Gunakan API key dengan Service Mode yang menyediakan model tersebut. |
| `402` | Periksa saldo USD tersedia dan limit pengeluaran key. |
| `429` | Ikuti `Retry-After` bila tersedia, kurangi konkurensi, dan lihat [Pemakaian & Limit](https://docs.hostlinku.com/usage-and-limits.md). |
| Test connection berhasil tetapi sesi Code gagal | Periksa model terpilih dan detail request di Console; uji koneksi singkat belum membuktikan dukungan tool/agent penuh. |

Jangan membagikan API key atau hasil export konfigurasi yang memuat kredensial. Untuk bantuan, sertakan versi Desktop, model, Service Mode, dan request ID tanpa key.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.