Pemecahan Masalah Claude Code
Fokus utama pemecahan masalah Claude Code adalah memastikan apakah konfigurasi Claude / Anthropic sudah diterapkan dengan benar. Jangan mencampuradukkan alamat yang kompatibel dengan OpenAI, nama model Codex, atau Gemini Key ke dalam Claude Code.
Apa yang harus dipastikan terlebih dahulu?
| Item pemeriksaan | Cara memeriksa | Alasan |
|---|---|---|
| Alat Target | Pastikan Anda memecahkan masalah Claude Code, bukan Codex atau Gemini CLI | File konfigurasi, protokol, dan nama model pada setiap alat berbeda-beda. |
| Protokol Provider | Claude, Anthropic, dan Claude Code disebutkan secara eksplisit di dashboard atau panduan | Provider yang hanya menyediakan antarmuka kompatibel OpenAI belum tentu mendukung Claude Code |
| Jenis Key | Gunakan Key yang sesuai untuk Claude / Anthropic | Jika jenis key salah, ini akan langsung menyebabkan error 401 atau kegagalan autentikasi |
| Status terminal | Setelah beralih konfigurasi, buka kembali terminal dan uji lagi | Terminal lama mungkin masih menggunakan variabel lingkungan atau konfigurasi sebelum peralihan |
Error umum
| Gejala | Pemeriksaan prioritas | Solusi |
|---|---|---|
| Perintah dapat dijalankan, tetapi permintaan gagal | Apakah Claude Code telah memuat konfigurasi baru | Tutup jendela terminal saat ini dan buka kembali, lalu kirim pertanyaan uji coba tersingkat. Setelah beralih melalui CC-Switch, jangan mengubah konfigurasi yang sama secara manual pada saat bersamaan. |
| 401 / Unauthorized | Jenis dan kelengkapan Key | Pastikan Anda menggunakan Key yang sesuai untuk Claude / Anthropic, jangan masukkan Key yang kompatibel dengan OpenAI di Claude Code; periksa spasi di awal dan akhir saat menyalin ulang. |
| 404 / model not found | Nama model Claude | Isi persis seperti yang tercantum di dashboard provider untuk model Claude, jangan ubah huruf besar-kecil, tanda hubung, atau nomor versi. |
| Koneksi timeout atau tidak ada respons | Base URL Claude | Periksa alamat API Claude / Anthropic di dashboard; provider yang hanya menyediakan alamat kompatibel OpenAI mungkin tidak mendukung Claude Code. |
| Masih menggunakan provider lama setelah beralih | Sesi terminal dan sumber konfigurasi | Buka kembali terminal dan uji lagi; jika masih belum berpengaruh, pastikan Provider saat ini di CC-Switch telah diterapkan ke Claude Code. |
Pengujian minimal
Saat menguji, pertama-tama kirim pertanyaan singkat yang pasti, pastikan ada respons, lalu lanjutkan ke proyek yang sebenarnya.
Pengujian Minimal Claude Code
claude "Please reply only: Claude Code configuration test successful"Templat umpan balik
Saat memberikan umpan balik kepada provider, tulis seperti ini
Tool: Claude Code System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened