Claude Desktop dengan API pihak ketiga: Configure Third-Party Inference dan pemecahan masalah

Wokey Team · 2026-09-24

Jawaban singkat: aplikasi desktop Claude hanya punya satu cara untuk memakai API pihak ketiga: Developer → Configure Third-Party Inference. Aplikasi ini tidak membaca ANTHROPIC_BASE_URL maupun ~/.claude/settings.json, jadi penyiapan yang berjalan di terminal Anda tidak berpengaruh apa pun di aplikasi desktop. Panduan ini membahas masalah yang sering ditemui: menu yang tidak ada, pengaturan yang tidak berlaku, daftar model kosong, dan fitur yang memang tidak tersedia di mode pihak ketiga. Untuk penyiapan pertama selengkapnya, lihat panduan penyiapan Claude Desktop.

Urutan yang benar

1. Buka aplikasi desktop dan jangan masuk ke akun Anthropic.

2. Buka Help → Troubleshooting → Enable Developer Mode.

3. Buka Developer → Configure Third-Party Inference….

4. Di Connection, atur Inference provider ke Gateway, lalu isi Gateway credentials:

   Kolom	Nilai
   Gateway base URL	https://api.wokey.ai (tanpa /v1)
   Gateway API key	API key Wokey Anda
   Credential kind	Static API key
   Gateway auth scheme	Bearer (Wokey juga menerima x-api-key; biarkan nilai bawaan)

5. Klik Apply Changes, lalu Save & Restart.

Persyaratan sistem:

• macOS: 14 (Sonoma) atau lebih baru, di Apple silicon atau Intel.
• Windows: Windows 10 build 19041 atau lebih baru, di x64 atau Arm64.

Menu Developer tidak ada

Menu Developer hanya muncul setelah mode developer aktif: Help → Troubleshooting → Enable Developer Mode. Jika item itu juga tidak ada di menu Help, perbarui aplikasi ke versi terbaru; versi lama tidak memiliki pengaturan inferensi pihak ketiga.

Jendela konfigurasi hanya bisa dibaca

Jika komputer sudah memiliki konfigurasi yang dikirim administrator, misalnya profil MDM dari perusahaan Anda, jendela terbuka dalam mode hanya-baca dan Anda tidak bisa mengubahnya secara lokal. Hubungi administrator Anda, atau gunakan komputer yang tidak dikelola.

Variabel lingkungan tidak berpengaruh

Ini kesalahan yang paling umum. Aplikasi desktop mengambil pengaturan gateway hanya dari konfigurasi inferensi pihak ketiga. Aplikasi ini tidak membaca ANTHROPIC_BASE_URL maupun settings.json.

Tab Code di aplikasi desktop berperilaku sama. Tab ini menjalankan mesin Claude Code yang sama dengan CLI, tetapi alamat gateway dan kredensialnya langsung berasal dari konfigurasi desktop. Pengaturan tingkat pengguna di ~/.claude/settings.json tidak bisa menimpanya.

Hal sebaliknya juga berlaku: konfigurasi desktop tidak memengaruhi claude di terminal Anda. Atur masing-masing secara terpisah; untuk terminal, lihat panduan base URL Claude Code.

Daftar model kosong atau ada model yang hilang

Tanpa daftar model dari Anda sendiri, aplikasi memanggil GET /v1/models milik gateway dan hanya menyimpan model yang ID-nya jelas dikenali sebagai Claude. Karena itu, dengan Wokey, penemuan otomatis menampilkan model seperti claude-opus-5 dan claude-sonnet-5, serta menyaring GPT, Grok, dan model lain. Itu memang perilaku yang diharapkan.

Untuk menetapkan daftar atau memilih model bawaan, masukkan ID model lengkap di daftar model pada jendela konfigurasi (Model list, key inferenceModels):

• Entri pertama menjadi model bawaan, dan sesi baru di tab Code juga dimulai dengan model itu.
• Jika setiap entri berupa ID lengkap, aplikasi melewati permintaan /v1/models.
• Jika /v1/models gagal dan daftarnya kosong, pemilih model kosong.

Error

Gateway was unreachable: aplikasi tidak bisa menjangkau gateway. Periksa Gateway base URL dari salah ketik, lalu uji dari terminal dengan curl:

curl -X POST https://api.wokey.ai/v1/messages \
  -H "Authorization: Bearer your Wokey API key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

Jika curl berhasil dan aplikasi tidak, penyebabnya biasanya proxy: terminal melewati proxy sedangkan aplikasi tidak, atau sebaliknya.

401 dengan code invalid_api_key: permintaan sampai ke Wokey, tetapi key tidak ada atau salah. Wokey menerima kedua skema autentikasi, jadi pengaturan itu tidak perlu diubah. Tempelkan key sekali lagi.

invalid x-api-key: permintaan menuju Anthropic, jadi konfigurasi pihak ketiga tidak berlaku. Biasanya Save & Restart belum diklik, atau setelahnya opsi masuk Anthropic yang dipilih di layar masuk. Lihat panduan invalid x-api-key.

Untuk detail lebih lanjut: ekspor laporan dengan Help → Troubleshooting → Generate Diagnostic Report. Tiga berkas di dalamnya berguna:

• managed-config.txt: konfigurasi yang sedang berlaku.
• provider-status.txt: status koneksi gateway.
• deployment-mode.txt: mode saat ini.

Log berada di:

• macOS: ~/Library/Logs/Claude-3p/main.log
• Windows: %LOCALAPPDATA%\Claude-3p\Logs\main.log

Fitur yang tidak tersedia di mode pihak ketiga

Fitur-fitur ini bergantung pada akun Anthropic atau layanan cloud Anthropic, sehingga tidak tersedia dengan gateway. Ini bukan masalah konfigurasi:

• Akses dari ponsel dan web claude.ai
• Mode suara
• Berbagi proyek dan plugin
• Claude Design, Claude Security, dan Claude Tag
• Computer use
• Remote Control dan lingkungan cloud yang di-hosting Anthropic

Dua lagi nonaktif secara bawaan:

• Tool search dan fitur beta eksperimental. Aplikasi menonaktifkannya demi kompatibilitas dengan gateway yang ketat. Aktifkan kembali tool search dengan toolSearchEnabled.
• Sesi remote SSH. Fitur ini masih beta di mode pihak ketiga dan membutuhkan administrator untuk menyiapkan allowlist host.

Kembali ke akun Anthropic Anda

Pilih opsi masuk Anthropic di layar masuk untuk kembali ke aplikasi desktop Claude standar.