Home → Guides → Mengarahkan Claude Desktop dan Codex ke APICLAN

Mengarahkan Claude Desktop dan Codex ke APICLAN

Q: Alamat yang diisi dan aturan /v1

Setiap permintaan harus tiba di jalur yang diawali /v1. Perlu tidaknya Anda mengetik /v1 di klien tergantung kliennya: sebagian menambahkannya sendiri, sebagian tidak. Satu detail ini menjelaskan sebagian besar laporan «tidak bisa terhubung». Kalau terbalik, permintaan kena 404 di tepi jaringan, artinya tidak pernah sampai ke gateway dan tidak pernah muncul di log pemakaian Anda — jadi log yang kosong itu sendiri adalah gejalanya. Jangan pernah menyisakan garis miring di akhir alamat.

Aplikasi desktop tidak punya kolom base URL di pengaturannya sendiri. CC Switch yang menuliskan konfigurasi itu untuk Anda. Berikut apa yang persis harus diisi, dan dua hal yang menjelaskan hampir semua pemasangan yang gagal.

Sebelum mulai

Anda perlu akun dengan saldo dan sebuah kunci API. Buat kuncinya di konsol, di bagian «Kunci API»: pilih keluarga penyedia yang akan Anda panggil — Anthropic untuk Claude Desktop, OpenAI untuk Codex — lalu grup kunci yang saldonya dipakai. Grup menentukan tarif Anda; harga tiap model ada di halaman harga.

Satu kunci hanya milik satu grup. Kunci yang dibuat untuk model teks tidak bisa memanggil model gambar, begitu pula sebaliknya; itu kembali sebagai 404 pada model, bukan error izin. Jika butuh keduanya, buat dua kunci. Apa yang bisa dipanggil sebuah kunci selalu dijawab oleh GET /v1/models yang dikirim dengan kunci itu.

Alamat yang diisi dan aturan /v1

Setiap permintaan harus tiba di jalur yang diawali /v1. Perlu tidaknya Anda mengetik /v1 di klien tergantung kliennya: sebagian menambahkannya sendiri, sebagian tidak. Satu detail ini menjelaskan sebagian besar laporan «tidak bisa terhubung».

Klien	Alamat permintaan yang diisi
Claude Desktop (via CC Switch)	`https://apiclan.us/v1`
Codex / ChatGPT desktop app	`https://apiclan.us/v1`
OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studio	`https://apiclan.us/v1`
Cursor, Cline, Roo Code	`https://apiclan.us/v1`
Claude Code	`https://apiclan.us`
Anthropic SDK	`https://apiclan.us`

Kalau terbalik, permintaan kena 404 di tepi jaringan, artinya tidak pernah sampai ke gateway dan tidak pernah muncul di log pemakaian Anda — jadi log yang kosong itu sendiri adalah gejalanya. Jangan pernah menyisakan garis miring di akhir alamat.

Codex kini ada di dalam aplikasi desktop ChatGPT

Codex telah digabung ke aplikasi desktop ChatGPT. Di Windows, pasang ChatGPT dari Microsoft Store; di macOS, unduh dari situs OpenAI. Codex versi baris perintah memakai pengaturan yang sama.

Di CC Switch, tambahkan penyedia untuk Codex, tempel kunci Anda, dan isi https://apiclan.us/v1 sebagai alamat permintaan. Aktifkan penyedia itu, lalu tutup Codex sepenuhnya — menutup jendela saja tidak cukup — dan jalankan lagi. Konfigurasi hanya dibaca saat start, jadi instance yang masih berjalan tetap memakai pengaturan lama dan tampak seolah tidak terjadi apa-apa.

Kalau Anda lebih suka menyunting berkas konfigurasi sendiri daripada memakai CC Switch, base URL dan tempat kuncinya ada di panduan cepat kami.

Aplikasi Claude Desktop

Pasang Claude Desktop dari claude.com, lalu atur penyedianya di CC Switch:

Buka CC Switch, pilih target Claude Desktop, dan tambahkan penyedia baru.
Beri nama bebas, lalu tempel kunci APICLAN Anda ke kolom API Key.
Isi https://apiclan.us/v1 sebagai alamat permintaan — klien akan menambahkan /messages sendiri. Tanpa garis miring di akhir.
Simpan, jalankan Claude Desktop, lalu pilih model.

Jika CC Switch menawarkan pilihan antara koneksi langsung dan pemetaan model, baca bagian berikutnya sebelum memilih. Pengaturan itulah yang menentukan pemilih model bisa jalan atau tidak.

Saat pemilih model mengembalikan error gateway

Pesan yang bilang koneksi berhasil tapi penyedia menolak permintaan hampir selalu soal nama model, bukan kuncinya. Aplikasi desktop mengirim pengenal model bawaannya sendiri, sedangkan gateway hanya bisa melayani model yang memang disediakan akun hulunya.

Perbaikannya adalah pemetaan model, bukan koneksi langsung: petakan entri aplikasi ke nama yang dilayani gateway ini. Koneksi langsung hanya berhasil bila penyedia menerima persis pengenal yang dikirim aplikasi.

Kirim GET /v1/models dengan kunci Anda untuk mendapat daftar tujuan pemetaan. Daftar itu dibangun dari grup kunci Anda sendiri, jadi itu jawaban nyata untuk akun Anda, bukan katalog umum.

Kembali ke akun resmi

Tidak ada yang ditimpa permanen. Di CC Switch, aktifkan lagi penyedia resmi dan mulai ulang kliennya; aplikasi desktop kembali ke langganan Anda. Keduanya boleh tetap terpasang dan Anda bisa berpindah kapan saja — saldo di sini prabayar dan tidak kedaluwarsa, jadi konfigurasi yang menganggur tidak memakan biaya.

Kalau masih belum jalan

Dapat 404 dan log pemakaian kosong: alamatnya salah. Cek di tabel di atas apakah klien itu butuh /v1, dan hapus garis miring di akhir.
Dapat 401: kuncinya tidak ikut terkirim. Tempel ulang; kuncinya panjang, dan salinan yang terpotong gagal persis seperti kunci yang salah.
Satu model gagal sementara yang lain jalan dengan kunci yang sama: model itu ada di grup lain. Buat kunci kedua dengan grup yang benar; mengubah izin tidak akan menolong.

Masih mentok? Kirim email ke support@apiclan.us dengan nama model yang gagal dan kira-kira kapan Anda mencobanya. Ada orang yang membacanya.

Start using it

No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.

Read the 30-second quickstart

Prices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.