Claude Desktop (Chat, Cowork, Code)
Menghubungkan aplikasi resmi Claude Desktop ke GetVibe API melalui Third-Party Inference: Developer Mode, base URL Gateway, dan key sk-pv- dengan skema x-api-key. Chat, Cowork, dan Code tanpa akun Anthropic.
Aplikasi resmi Claude Desktop (macOS dan Windows) dapat berjalan melalui gateway pihak ketiga — fitur Third-Party Inference. GetVibe API berbicara format asli Anthropic (/v1/messages dengan header x-api-key), sehingga aplikasi terhubung langsung, tanpa proxy penerjemah. Ketiga tab berfungsi: Chat, Cowork, dan Code. Akun Anthropic tidak diperlukan — jangan masuk. Dokumentasi Anthropic menyatakan aplikasi mendeteksi mode pihak ketiga (3P) saat diluncurkan dari penyedia yang dikonfigurasi; bila penyedia dan kredensial tersedia, layar masuk menawarkan mulai pihak ketiga tanpa akun Anthropic, dan dokumentasi tidak menjelaskan pemeriksaan wilayah dalam mode 3P. Lihat ringkasan 3P dan panduan instalasi.
Untuk siapa
- Windows 10/11 atau macOS. Tidak ada lagi yang perlu dipasang — tanpa Node.js, tanpa terminal.
- Anda hanya perlu kunci
sk-pv-…dari Dasbor → Kunci API.
1. Pasang aplikasi
Unduh Claude Desktop dari situs resmi, pasang lalu jalankan. Pada layar masuk, jangan masuk ke akun Anthropic.
Jika Windows menampilkan “Aplikasi ini tidak dapat berjalan di PC Anda”, penginstal tidak cocok dengan prosesor Anda atau unduhan terputus. Periksa Pengaturan → Sistem → Tentang → Jenis sistem (x64 atau ARM64), unduh kembali penginstal untuk arsitektur tersebut, lalu jalankan.
2. Aktifkan Developer Mode
Di menu aplikasi itu sendiri (bilah menu macOS; di Windows ☰ di kiri atas layar masuk) buka Help → Troubleshooting → Enable Developer Mode. Item Developer akan muncul di menu.
3. Konfigurasikan gateway GetVibe API
- Di menu Developer yang baru, pilih Configure Third-Party Inference….
- Di bawah Connection ubah tipenya menjadi Gateway.
- Base URL gateway:
https://getvibeapi.com— tanpa/v1, aplikasi menambahkan/v1/messagessendiri. - Jenis kredensial: Static API key; Skema autentikasi:
x-api-key. - Kunci API gateway: kunci
sk-pv-…Anda dari Dashboard → API keys. - Pada tab Model, tambahkan model secara manual sebelum menguji koneksi:
claude-sonnet-5.5,claude-opus-5.5,claude-haiku-5.5. Uji koneksi tidak akan berhasil tanpa setidaknya satu model, dan tidak semua versi aplikasi mengisi daftar dari/v1/modelssecara otomatis.
4. Mulai ulang aplikasi sepenuhnya
Klik Apply Changes, lalu tutup aplikasi sepenuhnya (Quit dari menu, bukan hanya menutup jendela) dan buka lagi. Di layar masuk, pilih mulai pihak ketiga yang muncul setelah konfigurasi disimpan; jangan masuk ke Anthropic. Jika konfigurasi menyetel deploymentMode: "3p" (Claude Desktop 4.16336.0+), opsi masuk claude.ai disembunyikan.
5. Periksa koneksi
Kirim pesan apa saja dan buka Dasbor → Penggunaan: catatan baru harus muncul dengan model dan biayanya. Jika tidak, lihat «Masalah umum» di bawah — terminal tidak diperlukan untuk memeriksa.
Batasan
- Cowork di Windows memerlukan installer
.msixdan virtualisasi perangkat keras yang diaktifkan (persyaratan di sisi aplikasi). - Anthropic menonaktifkan beberapa fitur beta (misalnya tool search) untuk gateway pihak ketiga — itu keterbatasan aplikasi, bukan masalah pada API key Anda.
Masalah umum
| Parameter | Tipe | Deskripsi |
|---|---|---|
App unavailable in region | screen | Ini layar masuk pertama aplikasi, bukan gateway kami. Menu Help/☰ ada di aplikasi, bukan di situs web. Konfigurasikan Gateway; jika menunya tidak ada, gunakan CLI. |
401 | error | Periksa key dan bahwa skema Auth adalah x-api-key, bukan Bearer. |
404 | error | Alamat gateway tidak boleh berisi /v1 — gunakan alamat akar yang ditampilkan di atas. |
Models did not appear / “The connection test needs at least one model” | config | Tambahkan id secara manual di tab Models: claude-sonnet-5.5, claude-opus-5.5, claude-haiku-5.5. |
“Couldn’t load your organization’s model list”, “Gateway /v1/models was unreachable”, “Can’t reach … provider didn’t respond” | network | The request never reached us — Usage shows no new record. On the same computer open https://getvibeapi.com/v1/models in a browser: it must return a JSON error (the browser sends no key, that is expected). If the page does not open, a VPN, proxy, antivirus or corporate network is cutting the connection. Add the models by hand on the Models tab as well. |
Changes not applied | config | Keluar sepenuhnya dari aplikasi melalui Quit/Exit dan buka kembali — menutup jendela saja tidak cukup. |