Catatan Penulis: Solusi lengkap saat Claude Code memunculkan error "model tidak ditemukan" setelah terhubung ke API pihak ketiga: Cara penulisan Base URL yang benar, metode konfigurasi settings.json, dan tabel referensi nama model terbaru.
Saat menggunakan Claude Code, pesan error yang paling sering muncul adalah ini:
There's an issue with the selected model (claude-sonnet-4-6). It may not exist or you may not have access to it. Run /model to pick a different model.
Kesalahan ini biasanya terjadi dalam dua skenario:
- Menggunakan kunci API resmi, tetapi salah mengeja nama model (cukup jalankan
/modeluntuk memilih ulang). - Terhubung ke layanan proksi API pihak ketiga, di mana konfigurasi Base URL tidak tepat, sehingga menyebabkan kegagalan perutean model.
Artikel ini akan fokus membahas solusi lengkap untuk skenario kedua, dengan menggunakan APIYI (apiyi.com) sebagai contoh, mencakup konfigurasi variabel lingkungan, settings.json, serta tabel referensi nama model Claude terbaru.
Nilai Utama: Setelah membaca artikel ini, Anda akan dapat mengonfigurasi Claude Code dengan benar untuk terhubung ke layanan proksi API pihak ketiga, menghilangkan error model tidak ditemukan, dan menggunakan seluruh fitur Claude Code secara stabil.
I. Identifikasi Masalah dengan Cepat: Apakah Salah Nama Model atau Masalah Base URL?
Sebelum mulai mengonfigurasi, luangkan waktu 30 detik untuk menentukan jenis masalah yang Anda hadapi:
| Gejala | Kemungkinan Penyebab | Langkah Solusi |
|---|---|---|
Pesan error Run /model to pick a different model |
Nama model tidak ada atau tidak punya akses | Jalankan /model untuk memilih ulang |
| Nama model sudah benar, tapi tetap error | Masalah konfigurasi Base URL | Periksa ANTHROPIC_BASE_URL |
| Verifikasi kunci API gagal | Kunci tidak valid atau belum diatur | Atur ulang ANTHROPIC_API_KEY |
| Waktu habis (timeout) / Koneksi ditolak | Alamat layanan proksi salah | Periksa format Base URL |
| Semua model memunculkan error | Layanan proksi tidak kompatibel dengan format Anthropic | Pastikan layanan proksi mendukung protokol asli Anthropic |
Jika Anda menggunakan kunci API Anthropic resmi dan dapat mengakses anthropic.com secara normal, cukup jalankan perintah /model di dalam Claude Code untuk mengganti model tanpa perlu konfigurasi tambahan.
Jika Anda terhubung melalui layanan proksi API pihak ketiga (seperti apiyi.com), silakan lanjutkan membaca panduan konfigurasi di bawah ini.
🎯 Saran: Direkomendasikan untuk menggunakan platform APIYI (apiyi.com) untuk terhubung ke Claude Code. Platform ini kompatibel dengan format asli Anthropic dan mendukung seluruh seri model terbaru seperti claude-opus-4-6, claude-sonnet-4-6, dan lainnya secara stabil.
2. Konfigurasi Inti untuk Menghubungkan API Proksi Pihak Ketiga ke Claude Code
2.1 Format Base URL yang Benar: Hapus /v1
Ini adalah langkah yang paling krusial dan paling sering salah dilakukan.
Claude Code memiliki logika pemrosesan khusus untuk Base URL: Alat ini akan secara otomatis menambahkan /v1/messages di belakang Base URL yang kamu atur. Oleh karena itu:
-
❌ Cara Penulisan yang Salah:
ANTHROPIC_BASE_URL=https://api.apiyi.com/v1- Jalur permintaan yang sebenarnya menjadi:
https://api.apiyi.com/v1/v1/messages(terjadi pengulangan /v1) - Hasilnya: Rute tidak menemukan endpoint, model akan error.
- Jalur permintaan yang sebenarnya menjadi:
-
✅ Cara Penulisan yang Benar:
ANTHROPIC_BASE_URL=https://api.apiyi.com- Jalur permintaan yang sebenarnya menjadi:
https://api.apiyi.com/v1/messages - Hasilnya: Berhasil mengakses antarmuka asli Anthropic dengan benar.
- Jalur permintaan yang sebenarnya menjadi:
📌 Kesimpulan: Saat mengatur
ANTHROPIC_BASE_URL, cukup masukkan domain utamanya saja, jangan tambahkan akhiran/v1. Claude Code akan melengkapi jalur lengkapnya secara otomatis.
2.2 Mendapatkan Kunci API
Masuk ke dasbor APIYI untuk mendapatkan token: Halaman manajemen token APIYI api.apiyi.com/token
Saran Pemilihan Token:
| Tipe Token | Skenario Penggunaan | Diskon |
|---|---|---|
| Token Default | Skenario umum, bisa langsung digunakan | Harga Standar |
| Token Grup ClaudeCode | Khusus digunakan untuk Claude Code | Diskon 12% (Harga 88%) |
Saat membuat token baru, pilih grup ClaudeCode untuk menikmati diskon 12%, sehingga biaya penggunaan jangka panjang jadi lebih hemat.
三、Penjelasan Detail Dua Cara Konfigurasi
Metode 1: Konfigurasi Variabel Lingkungan (Direkomendasikan untuk pengujian sementara)
Jalankan perintah berikut di terminal. Konfigurasi ini akan langsung aktif (hanya berlaku untuk sesi terminal saat ini):
# Atur Base URL layanan proksi API pihak ketiga (Catatan: jangan tambahkan /v1)
export ANTHROPIC_BASE_URL="https://api.apiyi.com"
# Atur kunci API (ganti dengan Key asli Anda)
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
# Jalankan Claude Code
claude
Verifikasi apakah konfigurasi sudah aktif:
# Lihat variabel lingkungan saat ini
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
# Seharusnya muncul output:
# https://api.apiyi.com
# sk-xxxxxx...
Kelebihan & Kekurangan:
- ✅ Cepat dan mudah, tidak perlu mengubah file.
- ✅ Tidak memengaruhi konfigurasi di sesi terminal lain.
- ❌ Harus diatur ulang setiap kali membuka terminal baru (kecuali dimasukkan ke
.zshrc/.bashrc).
Solusi agar berlaku permanen (tulis ke file konfigurasi Shell):
# Untuk pengguna zsh (default di macOS)
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-KeyAnda"' >> ~/.zshrc
source ~/.zshrc
# Untuk pengguna bash
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-KeyAnda"' >> ~/.bashrc
source ~/.bashrc
Metode 2: Konfigurasi settings.json (Direkomendasikan untuk jangka panjang)
Edit file ~/.claude/settings.json (konfigurasi global, berlaku untuk semua proyek):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-KeyAPIAnda"
}
}
🎯 Saran: Gunakan
~/.claude/settings.jsonuntuk konfigurasi global agar sekali atur berlaku selamanya tanpa perlu repot mengatur variabel lingkungan setiap saat. Kunjungi APIYI apiyi.com untuk mendapatkan Key, pilih token grup ClaudeCode untuk menikmati diskon 12%.
Jika file belum ada, buat secara manual:
# Buat direktori .claude (jika belum ada)
mkdir -p ~/.claude
# Buat file settings.json
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-ganti-dengan-Key-Anda"
}
}
EOF
Prioritas Konfigurasi (dari tinggi ke rendah):
| Prioritas | Sumber Konfigurasi | Keterangan |
|---|---|---|
| 1 (Tertinggi) | Variabel Lingkungan | export langsung di terminal |
| 2 | .claude/settings.local.json |
Konfigurasi lokal proyek (tidak di-commit ke git) |
| 3 | .claude/settings.json |
Konfigurasi bersama proyek |
| 4 (Terendah) | ~/.claude/settings.json |
Konfigurasi pengguna global |
Untuk item konfigurasi yang sama, prioritas yang lebih tinggi akan menimpa yang lebih rendah. Jika Anda memiliki settings.json di direktori proyek, ingatlah urutan prioritas ini.
IV. Nama Model Terbaru yang Didukung Claude Code
Ini adalah nama model Claude terbaru tahun 2026. Anda harus mengisinya dengan tepat; besar kecil huruf dan angka tidak boleh salah sedikit pun:
Model Penalaran Standar
| Nama Model | Seri | Posisi Kemampuan | Skenario Penggunaan |
|---|---|---|---|
claude-opus-4-6 |
Claude 4.6 | Kemampuan Terkuat | Kode kompleks, analisis mendalam, pemrosesan dokumen panjang |
claude-sonnet-4-6 |
Claude 4.6 | Keseimbangan Kemampuan & Kecepatan | Pemrograman harian, tinjauan kode, penulisan dokumen |
claude-haiku-4-5-20251001 |
Claude 4.5 | Respons Sangat Cepat | Tanya jawab sederhana, pelengkapan kode, tugas cepat |
Model Penalaran yang Ditingkatkan (Mode Berpikir)
Dengan menambahkan akhiran -thinking pada nama model, Anda dapat mengaktifkan mode berpikir tingkat lanjut. Model akan melakukan penalaran mendalam sebelum memberikan jawaban:
| Nama Model | Model Dasar | Fitur |
|---|---|---|
claude-opus-4-6-thinking |
claude-opus-4-6 | Penalaran terkuat, cocok untuk matematika/logika/keputusan kompleks |
claude-sonnet-4-6-thinking |
claude-sonnet-4-6 | Keseimbangan penalaran & kecepatan, pilihan utama penggunaan harian |
claude-haiku-4-5-20251001-thinking |
claude-haiku-4-5-20251001 | Penalaran ringan |
💡 Saran Pemilihan: Untuk penggunaan Claude Code sehari-hari, direkomendasikan menggunakan
claude-sonnet-4-6karena memiliki keseimbangan terbaik antara kualitas coding dan kecepatan respons. Saat menghadapi desain arsitektur yang rumit atau debugging bug yang sulit diselesaikan, Anda bisa beralih keclaude-opus-4-6atauclaude-sonnet-4-6-thinking.
5. Mengganti Model di Claude Code
Setelah mengonfigurasi Base URL dan kunci API, ada dua cara untuk mengganti model:
5.1 Menggunakan perintah /model (Cara Termudah)
Cukup ketik perintah berikut langsung di percakapan Claude Code:
/model
Claude Code akan menampilkan daftar pilihan model. Jika kamu menggunakan layanan proksi API pihak ketiga, mungkin tidak semua model muncul otomatis di daftar. Dalam kondisi ini, kamu perlu memasukkan nama model secara manual.
5.2 Menentukan Model Default di settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-KunciAPIAnda",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
}
}
Melalui variabel lingkungan ANTHROPIC_DEFAULT_*_MODEL, kamu bisa menentukan nama model yang spesifik untuk setiap tingkatan model. Ini mencegah Claude Code menggunakan nama default bawaan (yang mungkin tidak cocok dengan layanan proksi API).
🎯 Contoh Konfigurasi Lengkap: Konfigurasi di atas disarankan untuk disimpan di
~/.claude/settings.json. Gunakan token grup ClaudeCode dari APIYI (apiyi.com) sebagai ANTHROPIC_API_KEY.
6. FAQ: Masalah Umum dan Solusinya
Q1: Setelah mengonfigurasi ANTHROPIC_BASE_URL, Claude Code malah tidak bisa jalan sama sekali?
Coba cek apakah format JSON sudah benar. Kesalahan yang sering terjadi:
- Ada koma ekstra setelah pasangan kunci-nilai terakhir (JSON tidak mengizinkan koma di akhir).
- Menggunakan tanda kutip karakter Mandarin
""alih-alih tanda kutip standar"".
# Verifikasi format JSON
cat ~/.claude/settings.json | python3 -m json.tool
Jika output-nya normal, berarti format sudah benar. Jika muncul error, berarti ada masalah sintaksis.
Q2: Muncul error Invalid API key, padahal Key saya sudah benar?
Kemungkinan penyebabnya:
- Ada spasi di awal atau akhir Key → Cek apakah ada spasi yang ikut tersalin.
- Key sudah kedaluwarsa atau dinonaktifkan → Login ke
api.apiyi.com/tokenuntuk membuat ulang. - Masalah prioritas variabel lingkungan → Mungkin ada variabel
ANTHROPIC_API_KEYlama yang masih tersimpan di sistem.
# Cek apakah ada variabel lingkungan dari sumber lain
env | grep ANTHROPIC
Q3: Model bisa dipanggil, tapi hasilnya jelek atau formatnya aneh?
Kemungkinan penyebab: Layanan proksi API tidak mendukung format Anthropic secara penuh, terutama dalam penanganan system prompt.
Cara verifikasi: Gunakan curl untuk mengetes apakah layanan proksi API memberikan respons yang benar:
curl https://api.apiyi.com/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: sk-Key-Anda" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 100,
"messages": [{"role": "user", "content": "Say hello"}]
}'
Respons yang normal harus berisi field content dan output teks yang sebenarnya. Jika hasilnya error, berarti ada masalah pada layanan proksi API tersebut.
🎯 Tips Cepat: APIYI (apiyi.com) sepenuhnya kompatibel dengan format asli Anthropic, jadi tes curl di atas akan berjalan lancar di sana. Jika kamu menggunakan layanan proksi lain, gunakan perintah ini untuk memvalidasi kompatibilitasnya.
Q4: Bagaimana cara mengatur variabel lingkungan di Windows?
Untuk pengguna Windows, disarankan menggunakan metode settings.json karena lebih mudah dan stabil:
// C:\Users\NamaUserAnda\.claude\settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-KunciAPIAnda"
}
}
Jika ingin menggunakan PowerShell untuk mengatur variabel lingkungan sementara:
$env:ANTHROPIC_BASE_URL = "https://api.apiyi.com"
$env:ANTHROPIC_API_KEY = "sk-KunciAPIAnda"
claude
Q5: Bagaimana cara menggunakan konfigurasi API yang berbeda untuk setiap proyek?
Buat file .claude/settings.json di direktori utama (root) proyekmu (file ini memiliki prioritas lebih tinggi daripada konfigurasi global):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-Key-Khusus-Proyek"
}
}
Catatan: Jika file ini berisi Key, sangat disarankan untuk menambahkannya ke .gitignore agar tidak terunggah ke repositori kode. Menggunakan .claude/settings.local.json (konfigurasi khusus lokal) jauh lebih aman karena secara default tidak akan dilacak oleh git.
7. Daftar Periksa Verifikasi Konfigurasi
Setelah menyelesaikan konfigurasi, ikuti langkah-langkah berikut untuk melakukan verifikasi:
# Langkah 1: Pastikan variabel lingkungan sudah aktif
echo "Base URL: $ANTHROPIC_BASE_URL"
echo "API Key: ${ANTHROPIC_API_KEY:0:10}..."
# Langkah 2: Uji konektivitas API
curl -s https://api.apiyi.com/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" | head -c 200
# Langkah 3: Jalankan Claude Code dan uji
claude --version
claude
Ketik /status di jendela dialog Claude Code untuk melihat status koneksi saat ini, pastikan Base URL dan konfigurasi model sudah benar.
🎯 Setelah konfigurasi selesai: Disarankan untuk mencoba mengirim pesan sederhana guna memastikan Claude Code merespons dengan normal. Platform APIYI (apiyi.com) mendukung pengecekan saldo, sehingga Anda bisa memantau penggunaan Token Claude Code secara real-time di dashboard untuk mengontrol biaya.
Ringkasan
Kesalahan "model tidak ditemukan" saat menghubungkan Claude Code ke layanan proksi API pihak ketiga 90% disebabkan oleh format Base URL yang salah. Prinsip utamanya adalah:
- Base URL tidak perlu ditambah
/v1: Masukkanhttps://api.apiyi.com, Claude Code akan otomatis menambahkan/v1/messagesdi belakangnya. - Nama model harus sesuai: Gunakan nama lengkap seperti
claude-sonnet-4-6,claude-opus-4-6, atauclaude-haiku-4-5-20251001. - Rekomendasi konfigurasi settings.json: Tulis di
~/.claude/settings.jsonagar berlaku permanen, jadi Anda tidak perlu mengatur variabel lingkungan setiap saat. - Token khusus ClaudeCode: Pilih grup ClaudeCode di dashboard APIYI untuk menikmati diskon 12%.
Jika Anda hanya menggunakan kunci API resmi dari Anthropic dan jaringan Anda bisa terhubung langsung, cukup jalankan perintah /model di Claude Code untuk memilih model tanpa perlu konfigurasi tambahan.
🎯 Dapatkan kunci API: Kunjungi APIYI (apiyi.com) untuk mendaftar akun, lalu buat token grup ClaudeCode di halaman manajemen token
api.apiyi.com/token. Platform ini mendukung sistem pay-as-you-go tanpa pengeluaran minimum, ditagih berdasarkan penggunaan Token yang sebenarnya, sangat cocok untuk individu maupun tim.
Artikel ini disusun oleh tim teknis APIYI, berdasarkan pengujian nyata pada Claude Code v2.x. Jika ada masalah konfigurasi, silakan kunjungi Pusat Bantuan APIYI di help.apiyi.com untuk mendapatkan bantuan.
