Tema
Bahasa

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.

Jalur paling sederhana, terutama jika Anda tidak memakai terminal. Satu aplikasi, beberapa langkah, dan kunci Anda. Jika ada yang tidak berhasil, lihat «Masalah umum» di bawah; varian terminal ada di halaman Claude Code CLI.
Jika muncul «App unavailable in region», Anda berada di aplikasi, bukan di situs web. Menu Help → Troubleshooting ada di dalam Claude Desktop — bilah menu macOS, atau tombol ☰ di kiri atas layar masuk Windows. Jangan masuk ke akun Anthropic: aktifkan Developer Mode dan konfigurasikan gateway seperti di bawah. Jika versi Anda tidak menampilkan menu itu, gunakan Claude Code CLI.

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

  1. Di menu Developer yang baru, pilih Configure Third-Party Inference….
  2. Di bawah Connection ubah tipenya menjadi Gateway.
  3. Base URL gateway: https://getvibeapi.com — tanpa /v1, aplikasi menambahkan /v1/messages sendiri.
  4. Jenis kredensial: Static API key; Skema autentikasi: x-api-key.
  5. Kunci API gateway: kunci sk-pv-… Anda dari Dashboard → API keys.
  6. 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/models secara 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 .msix dan 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

ParameterTipeDeskripsi
App unavailable in regionscreenIni layar masuk pertama aplikasi, bukan gateway kami. Menu Help/☰ ada di aplikasi, bukan di situs web. Konfigurasikan Gateway; jika menunya tidak ada, gunakan CLI.
401errorPeriksa key dan bahwa skema Auth adalah x-api-key, bukan Bearer.
404errorAlamat gateway tidak boleh berisi /v1 — gunakan alamat akar yang ditampilkan di atas.
Models did not appear / “The connection test needs at least one model”configTambahkan 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”networkThe 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 appliedconfigKeluar sepenuhnya dari aplikasi melalui Quit/Exit dan buka kembali — menutup jendela saja tidak cukup.
Claude Desktop + GetVibe API — Inferensi Pihak Ketiga (gateway) | GetVibe API