Panduan pengaturan

Panduan pengaturan penyedia

Lihat langkah penyiapan dan pemecahan masalah berdasarkan alat.

Panduan pengaturan penyedia/CC-Switch Claude Code

CC-Switch Claude Code

Halaman ini hanya menjelaskan satu hal: menambahkan atau memilih Provider di CC Switch, lalu menerapkannya ke Claude Code. Ini bukan panduan konfigurasi Claude Code secara langsung; jika Anda ingin langsung memodifikasi file konfigurasi Claude Code, silakan lihat konfigurasi Claude Code CLI.

Yang dijelaskan di halaman ini

Tujuan CC Switch adalah membantu Anda mengelola Provider secara terpusat dan menyinkronkan konfigurasi ke alat target. Untuk Claude Code, fokuslah memeriksa protokol Claude / Anthropic, Key, dan nama model. Jangan langsung menggunakan alamat kompatibel OpenAI sebagai alamat Claude kecuali jika provider secara eksplisit menyatakan mendukung Claude Code.

Konfirmasi sebelum memulai

Hal yang perlu dikonfirmasiCara memeriksaAlasan
Claude Code sudah dapat dimulaiPastikan di terminal atau klien bahwa Claude Code dapat terbuka secara normalCC Switch hanya menangani peralihan konfigurasi, bukan instalasi Claude Code
Provider mendukung Claude CodeAnda dapat melihat instruksi terkait Claude / Anthropic / Claude Code di backend atau dokumentasiProvider yang hanya menyediakan antarmuka kompatibel OpenAI mungkin tidak dapat digunakan dengan Claude Code
Key dan nama model dapat digunakanAnda dapat melihat token, Key, daftar model, atau petunjuk model yang tersedia di backendPenulisan nama model yang salah akan langsung menyebabkan model tidak ditemukan
Ubah satu alat target terlebih dahuluAwalnya, pilih Claude Code sajaLebih mudah untuk menentukan item mana yang bermasalah saat pemecahan masalah (troubleshooting)

Cara mengisi kolom

PengaturanCara PengisianPerhatian untuk Pemula
Nama ProviderTulis nama yang mudah dikenaliMisalnya, 'Provider utama Claude', jangan hanya menulis angka
Alat Target / PresetPilih Claude Code atau preset terkait ClaudeJangan pilih Codex, OpenAI, atau Gemini
Base URLSalin tautan API yang disediakan backend provider untuk Claude / AnthropicTidak semua provider menggunakan Base URL yang sama dengan OpenAI
API KeySalin Key lengkap yang dibuat di backendSering juga disebut token, Key, secret key
Nama ModelSalin persis nama model Claude yang didukung oleh backendJangan menyingkat sendiri, dan jangan mengubah nama tampilan menjadi nama model
Jika backend provider memisahkan protokol yang berbeda, Claude Code menggunakan grup Claude / Anthropic. Hanya jika backend secara eksplisit menyatakan 'Claude Code menggunakan alamat kompatibel OpenAI', barulah diisi sesuai dengan instruksi tersebut.

Terapkan ke Claude Code

  1. Buka CC Switch dan buka area manajemen Provider.
  2. Tambahkan Provider baru, atau pilih konfigurasi provider yang telah Anda buat.
  3. Pilih preset yang terkait dengan alat target Claude Code.
  4. Isi nama Provider, Base URL, API Key, dan nama model secara berurutan.
  5. Setelah menyimpan, jalankan Apply / Switch untuk menerapkan Provider saat ini ke Claude Code.
  6. Jika halaman meminta Anda untuk me-restart terminal atau alat target, tutup sesi Claude Code saat ini lalu buka kembali.

Uji apakah berfungsi

Saat pengujian, kirimkan pertanyaan yang sangat singkat terlebih dahulu, dan jangan langsung membuka proyek yang sebenarnya. Selama respons dapat dikembalikan secara normal, ini menunjukkan bahwa Key, Base URL, nama model, dan sinkronisasi alat target pada dasarnya dapat digunakan.

Uji Minimal Claude Code
claude "Please reply only: CC-Switch Claude Code is active"
Jika pengujian gagal, periksa berdasarkan urutan prioritas ini: apakah alat target salah dipilih, apakah Base URL sesuai dengan Claude / Anthropic, apakah Key disalin secara lengkap, dan apakah nama model disalin persis dari backend.