Jika Anda mencari CC Switch Claude Code, kemungkinan besar Anda sudah memasang asisten coding tersebut. Masalah setup-nya lebih sempit: Anda perlu membuat CC Switch menulis konfigurasi provider Claude Code yang सही, menggunakan kunci Flatkey yang tepat, mengarah ke base URL yang benar, memilih model yang benar-benar dapat diakses oleh kunci Anda, dan memverifikasi permintaan di usage logs.
Panduan ini membahas jalur praktis untuk routing CC Switch Claude Code dengan Flatkey dan alur kerja satu klik ala NewAPI. Dokumentasi CC Switch NewAPI saat ini menjelaskan impor deep link ccswitch:// dari halaman token New API. Pengguna Flatkey dapat memakai permukaan konfigurasi CC Switch yang sama secara manual: tambahkan provider Claude Code, tempelkan API key Flatkey, atur Claude Code gateway base URL, ambil model, simpan profil, dan verifikasi rutenya.
Panduan ini berbasis teks. Panduan ini tidak menggunakan screenshot aplikasi karena alur UI CC Switch dan Flatkey saat ini sebaiknya ditinjau ulang dengan screenshot sebelum menerbitkan gambar langkah.
Jawaban Cepat: Setelan CC Switch Claude Code Untuk Flatkey
Untuk setup CC Switch Claude Code berbasis Flatkey, buat provider Claude Code di CC Switch dan gunakan router Flatkey sebagai gateway. Untuk request ala Anthropic Messages pada Claude Code, gunakan root gateway URL, bukan path OpenAI chat-completions.
| Field Atau Config CC Switch | Nilai Flatkey | Yang Perlu Diverifikasi |
|---|---|---|
| Aplikasi | Claude atau Claude Code |
Jangan mengonfigurasi aplikasi Codex atau Gemini saat targetnya Claude Code. |
| Tab provider | App-specific Provider untuk Claude Code, atau Universal Provider jika Anda juga menyinkronkan Codex/Gemini |
Universal provider perlu pengecekan pasca sinkronisasi karena tiap aplikasi dapat mengharapkan bentuk URL yang berbeda. |
| Nama | Flatkey Claude Code |
Gunakan nama yang akan jelas saat switching di tray CC Switch nanti. |
| API Key | API key Flatkey Anda | Buat atau salin dari dashboard Flatkey. Jangan pernah menempelkan kunci asli ke dokumen bersama. |
| Claude Code base URL | https://router.flatkey.ai |
Gunakan ini untuk ANTHROPIC_BASE_URL. Claude Code kemudian mengakses path seperti /v1/messages. |
| OpenAI-compatible base URL | https://router.flatkey.ai/v1 |
Gunakan ini untuk klien yang kompatibel dengan OpenAI dan pengecekan fetch model yang memanggil /v1/models. |
| Main/Sonnet/Opus/Haiku models | Model ID dari hasil fetch CC Switch, konsol Flatkey, atau katalog harga | Gunakan model ID yang persis. Jangan gunakan nama pemasaran atau label keluarga model. |
| Verifikasi | Jalankan prompt kecil Claude Code dan tinjau usage logs Flatkey | Setup belum selesai sampai request muncul di dashboard Flatkey. |
Jika form CC Switch Anda menampilkan advanced JSON editor, profil Claude Code seharusnya menghasilkan bentuk seperti ini. Gunakan placeholder dalam dokumentasi; jangan pernah menyimpan kunci aktif di repo.
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-fk-your-flatkey-key",
"ANTHROPIC_BASE_URL": "https://router.flatkey.ai",
"ANTHROPIC_MODEL": "your-claude-model-id"
}
}Claude Code juga mendukung ANTHROPIC_API_KEY. Gunakan satu variabel autentikasi, bukan keduanya, kecuali Anda memang memahami prioritasnya. Untuk routing gateway bergaya bearer, ANTHROPIC_AUTH_TOKEN membuat pemetaan lebih eksplisit karena Claude Code mengirimkannya sebagai nilai header Authorization.
Di Mana NewAPI Berperan Dalam Alur Kerja CC Switch
Dokumentasi CC Switch NewAPI saat ini mengatakan bahwa konsol New API dapat menambahkan shortcut Chat Settings dengan JSON ini:
{ "CC Switch": "ccswitch" }Setelah itu, halaman pengelolaan token New API dapat menampilkan opsi CC Switch yang meluncurkan CC Switch melalui deep link ccswitch:// dan membuka dialog impor provider. Dokumentasi NewAPI menjelaskan field dialog tersebut sebagai tipe aplikasi, nama, main model, serta pilihan model Haiku/Sonnet/Opus.
Untuk Flatkey, gunakan konsep yang sama tanpa mengklaim impor dari halaman token NewAPI. Jika kunci Anda adalah kunci Flatkey, tambahkan provider langsung di CC Switch. Jika kunci Anda berada di deployment NewAPI, gunakan impor satu klik NewAPI. Perbedaan pentingnya sederhana: CC Switch mengelola konfigurasi lokal Claude Code, sedangkan Flatkey atau NewAPI menangani lapisan routing upstream.
Sebelum Anda Memulai
Sebelum mengubah provider CC Switch Claude Code, pastikan prasyarat berikut:
- CC Switch terpasang di mesin tempat Claude Code berjalan.
- Claude Code sudah terpasang dan dapat dibuka secara normal.
- Anda dapat masuk ke Flatkey dan membuka dashboard.
- Anda memiliki API key Flatkey untuk workstation atau developer ini.
- Anda mengetahui setidaknya satu model ID Claude yang tersedia untuk akun Flatkey Anda.
- Anda dapat meninjau usage logs Flatkey setelah request pengujian pertama.
Jangan gunakan kunci produksi bersama untuk pengujian pertama. Buat kunci terbatas yang dinamai sesuai alat dan pemiliknya, seperti cc-switch-lee atau claude-code-devbox. Itu akan membuat smoke test CC Switch Claude Code pertama lebih mudah diaudit dan lebih mudah dicabut.
Langkah 1: Buat Atau Salin API Key Flatkey
Buka dasbor Flatkey dan buat key untuk penggunaan Claude Code melalui CC Switch. Salin sekali saja lalu simpan di password manager atau team secret manager Anda.
Kolom API Key CC Switch harus berisi key Flatkey. Jangan tempelkan key Anthropic, OpenAI, Google, atau key spesifik penyedia ke profil ini kecuali Anda memang sengaja mengonfigurasi provider langsung tersebut, bukan Flatkey.
Untuk tim, buat key terpisah berdasarkan pengguna, perangkat, atau environment. Satu key bersama mungkin berfungsi secara teknis, tetapi akan membuat peninjauan penggunaan dan pencabutan lebih sulit nantinya.
Langkah 2: Tambahkan Provider Claude Code Di CC Switch
Buka CC Switch dan masuk ke area provider Claude Code. Manual pengguna CC Switch menjelaskan dua jalur penambahan: provider khusus aplikasi untuk aplikasi yang dipilih, dan Universal Provider untuk konfigurasi bersama di Claude Code, Codex, dan Gemini.
Untuk setup Flatkey CC Switch Claude Code pertama, mulai dengan provider Claude Code khusus aplikasi:
- Buka CC Switch.
- Pilih Claude atau Claude Code di application switcher.
- Klik tombol + untuk menambahkan provider.
- Pilih jalur custom provider jika tidak ada preset Flatkey.
- Set nama provider menjadi
Flatkey Claude Code. - Tempelkan API key Flatkey Anda.
- Set base URL gateway Claude Code ke
https://router.flatkey.ai. - Pilih ID model untuk Main, Sonnet, Opus, dan Haiku hanya setelah memastikan model tersebut tersedia untuk akun Anda.
Jika Anda menggunakan Universal Provider, isi Name, API Key, dan Endpoint URL, lalu centang aplikasi yang ingin Anda sinkronkan. Setelah sinkronisasi, periksa config Claude Code yang dihasilkan. Untuk Claude Code, base aktif seharusnya https://router.flatkey.ai. Untuk config aplikasi yang kompatibel dengan OpenAI, https://router.flatkey.ai/v1 biasanya merupakan base URL yang diharapkan.
Langkah 3: Ambil Model Sebelum Memilih Main, Sonnet, Opus, Dan Haiku
CC Switch mendokumentasikan aksi Fetch Models di samping input model. Aksi ini menggunakan API key yang dikonfigurasi untuk memanggil endpoint /v1/models yang kompatibel dengan OpenAI, lalu memungkinkan Anda memilih ID model yang dikembalikan dari dropdown.
Untuk artikel ini, pengecekan Flatkey bertanggal 11 Juni 2026 mengembalikan HTTP 200 dari https://router.flatkey.ai/v1/models dengan respons daftar model untuk test key yang dikonfigurasi. Contoh yang dikembalikan mencakup ID model keluarga Claude seperti claude-sonnet-4-6, claude-sonnet-4-5, claude-opus-4-7, dan claude-haiku-4-5. Perlakukan contoh tersebut sebagai snapshot saat ini, bukan rekomendasi model permanen.
Gunakan aturan pemilihan model berikut:
- Main Model: pilih model Claude yang ingin digunakan Claude Code secara default.
- Sonnet Model: pilih model seimbang yang diharapkan tim Anda untuk coding harian.
- Opus Model: pilih model dengan kemampuan lebih tinggi hanya jika anggaran dan akses Anda memungkinkan.
- Haiku Model: pilih model ringan untuk tugas yang lebih cepat atau tugas latar belakang jika tersedia.
Jika Fetch Models gagal, jangan menebak. Buka konsol Flatkey atau katalog harga, salin satu ID model yang persis kompatibel dengan Claude, dan uji hanya dengan model itu terlebih dahulu.
Langkah 4: Simpan, Sinkronkan, Dan Periksa Config Claude Code Yang Dihasilkan
Setelah Anda menyimpan provider, CC Switch menulis konfigurasi provider aktif untuk Claude Code. Path file yang tepat dapat berbeda tergantung pada versi CC Switch dan scope aplikasi, tetapi dokumentasi settings resmi Claude Code mengonfirmasi bahwa environment variables dapat dikonfigurasi melalui settings.json di bawah key env.
Periksa bahwa config yang dihasilkan tidak berisi nilai autentikasi yang saling bertentangan. Profil Flatkey yang bersih seharusnya memiliki salah satu pola berikut:
# Gaya gateway bearer token
ANTHROPIC_AUTH_TOKEN=sk-fk-your-flatkey-key
ANTHROPIC_BASE_URL=https://router.flatkey.aiatau:
# Gaya API key
ANTHROPIC_API_KEY=sk-fk-your-flatkey-key
ANTHROPIC_BASE_URL=https://router.flatkey.aiJangan biarkan key Anthropic langsung lama tetap aktif di shell Anda saat menguji profil CC Switch Claude Code yang baru. Jika shell masih mengekspor ANTHROPIC_API_KEY yang berbeda, troubleshooting bisa menjadi lebih sulit karena proses aktif mungkin tidak menggunakan profil CC Switch yang Anda kira sedang digunakan.
Langkah 5: Verifikasi Di Claude Code Dan Log Penggunaan Flatkey
Buka terminal baru setelah mengaktifkan provider Flatkey di CC Switch. Claude Code dapat mendukung hot-switching pada beberapa jalur CC Switch, tetapi terminal baru menghilangkan kebingungan state shell selama pengujian pertama.
- Jalankan Claude Code.
- Periksa model atau status aktif di Claude Code.
- Kirim prompt kecil, misalnya meminta agar ia membalas dengan satu kalimat pendek.
- Buka dasbor Flatkey.
- Tinjau log penggunaan untuk waktu permintaan, ID model, dan nama key.
Setup CC Switch Claude Code selesai hanya ketika ketiga lapisan selaras: CC Switch menampilkan provider Flatkey sebagai aktif, Claude Code menggunakan model/base URL yang diharapkan, dan log Flatkey menunjukkan permintaan tersebut.
Troubleshooting CC Switch Claude Code Dengan Flatkey
| Masalah | Kemungkinan Penyebab | Perbaikan |
|---|---|---|
| Kesalahan autentikasi | Key salah, dinonaktifkan, disalin dengan spasi, atau bukan key Flatkey. | Buat key baru di Flatkey, tempelkan lagi, dan verifikasi bahwa Anda menggunakan ANTHROPIC_AUTH_TOKEN atau ANTHROPIC_API_KEY, bukan nilai yang saling bertentangan. |
| 404 atau path endpoint salah | URL menyertakan bentuk path yang salah untuk Claude Code. | Untuk Claude Code, gunakan https://router.flatkey.ai. Untuk pengambilan model yang kompatibel dengan OpenAI atau klien lain, gunakan https://router.flatkey.ai/v1. |
| Fetch Models gagal | Key tidak dapat memanggil /v1/models, base URL salah, atau endpoint sementara tidak tersedia. |
Gunakan https://router.flatkey.ai/v1 untuk jalur pengambilan model, lalu gunakan ID model yang tepat dari konsol Flatkey jika perlu. |
| Claude Code masih menggunakan penyedia lama | Proses terminal lama atau export shell menimpa profil CC Switch. | Buka terminal baru, periksa variabel lingkungan shell, dan pastikan provider Flatkey diaktifkan di CC Switch. |
| Pemilihan model berhasil tetapi request gagal | Model yang dipilih tercantum tetapi tidak tersedia untuk key, grup, saldo, atau kebijakan akun Anda saat ini. | Uji dulu satu model yang sudah pasti bisa diakses. Tinjau akses akun Flatkey, saldo, kuota, dan log penggunaan. |
| Pencarian tool MCP mengubah perilaku | Claude Code memperlakukan base URL non-first-party sebagai routing gateway. | Ikuti panduan gateway Claude Code sebelum mengaktifkan perilaku pencarian tool tingkat lanjut melalui proxy. Jangan aktifkan flag khusus gateway kecuali gateway Anda meneruskan blok yang diperlukan. |
Sebagian besar kegagalan CC Switch Claude Code berujung pada empat bidang: key, base URL, model ID, dan profil aktif. Periksa itu sebelum membangun ulang seluruh basis data CC Switch.
CC Switch Vs A Claude Code Router
CC Switch dan router Claude Code menyelesaikan bagian alur kerja yang berbeda. CC Switch adalah pengelola konfigurasi lokal. Flatkey adalah lapisan routing dan akses.
| Lapisan | Fungsinya | Yang Tidak Dilakukannya |
|---|---|---|
| CC Switch | Menyimpan profil provider, men-switch konfigurasi Claude Code/Codex/Gemini, mengelola field model, dan dapat mengimpor provider melalui deep link. | Bukan akun model upstream, sistem billing, atau router. |
| Claude Code | Menjalankan coding assistant dan membaca nilai environment/config yang aktif. | Tidak mengelola key multi-provider atau billing tim Anda secara mandiri. |
| Flatkey | Menyediakan satu key, endpoint gateway, akses model, visibilitas penggunaan, routing, dan kontrol billing untuk model yang didukung. | Tidak menggantikan UI switch profil lokal milik CC Switch. |
Jika Anda hanya membutuhkan satu pengaturan gateway permanen, Anda bisa mengonfigurasi Claude Code secara langsung. Jika Anda berpindah di antara beberapa provider, workstation, atau tier model, alur kerja CC Switch Claude Code memberi Anda permukaan kontrol yang lebih rapi. Jika Anda juga sedang memigrasikan kode aplikasi ke gateway, baca panduan migrasi API yang kompatibel dengan OpenAI. Jika Anda sedang memutuskan antara proxy khusus Claude dan gateway yang lebih luas, baca proxy API Claude vs router.
Rollout Tim yang Direkomendasikan
Untuk satu developer, satu key Flatkey dan satu provider CC Switch sudah cukup. Untuk tim, perlakukan pengaturan CC Switch Claude Code sebagai rollout kontrol akses berskala kecil.
- Buat key Flatkey bernama untuk tiap developer, workstation, atau environment.
- Dokumentasikan ID model Claude yang disetujui dan tier mana yang dipetakan oleh masing-masing di CC Switch.
- Gunakan kuota sebelum mengundang lebih banyak pengguna ke setup routing yang sama.
- Tinjau log penggunaan setelah hari pertama, bukan hanya setelah kejutan tagihan.
- Simpan screenshot di luar dokumen publik sampai UI saat ini dikonfirmasi oleh reviewer.
- Gunakan import satu klik NewAPI hanya untuk key yang dikelola di NewAPI; gunakan setup provider Flatkey manual untuk key Flatkey.
FAQ
Apa itu setup CC Switch Claude Code?
Setup CC Switch Claude Code adalah profil provider di CC Switch yang menulis endpoint, key, dan pengaturan model yang harus digunakan Claude Code. Dengan Flatkey, profil itu mengarahkan Claude Code ke router Flatkey dan menggunakan key Flatkey.
Apakah base URL Claude Code Flatkey harus menyertakan /v1?
Untuk ANTHROPIC_BASE_URL milik Claude Code, gunakan https://router.flatkey.ai. Untuk klien aplikasi yang kompatibel dengan OpenAI dan pemeriksaan fetch model yang secara eksplisit memanggil /v1/models, gunakan https://router.flatkey.ai/v1.
Apakah import satu klik NewAPI mengonfigurasi Flatkey secara otomatis?
Tidak. Jalur satu klik CC Switch milik NewAPI didokumentasikan untuk halaman manajemen token API baru. Untuk Flatkey, tambahkan provider secara manual di CC Switch kecuali Flatkey nanti menerbitkan tautan import khusus ccswitch://.
Bisakah CC Switch mengambil model Flatkey?
Ya, ketika key yang dikonfigurasi dapat mengakses daftar model Flatkey yang kompatibel dengan OpenAI. Pemeriksaan 11 Juni 2026 untuk artikel ini mengembalikan HTTP 200 dari https://router.flatkey.ai/v1/models dan respons daftar model untuk test key yang dikonfigurasi.
Haruskah saya menggunakan ANTHROPIC_API_KEY atau ANTHROPIC_AUTH_TOKEN?
Claude Code mendokumentasikan keduanya. ANTHROPIC_API_KEY dikirim sebagai header API key, sedangkan ANTHROPIC_AUTH_TOKEN dikirim melalui jalur otorisasi. Gunakan satu metode yang jelas untuk profil Flatkey, dan hindari membiarkan keduanya terisi dengan nilai yang berbeda.
Bagaimana saya tahu pengaturannya berhasil?
Pengaturan berhasil ketika CC Switch menampilkan provider Flatkey sebagai aktif, Claude Code menggunakan model yang diharapkan, prompt uji kecil berhasil, dan permintaan muncul di log penggunaan Flatkey.
Final Check
CC Switch Claude Code Anda siap dengan setup Flatkey ketika daftar periksa ini lolos:
- CC Switch memiliki provider Flatkey dengan nama yang jelas di bawah Claude Code.
- API key adalah key Flatkey dari dashboard.
ANTHROPIC_BASE_URLmengarah kehttps://router.flatkey.ai.- ID model yang dipilih adalah ID persis yang tersedia untuk key Anda.
- Fetch Models atau entri model manual berhasil.
- Claude Code menjalankan prompt uji kecil.
- Log penggunaan Flatkey menampilkan permintaan tersebut.
Dapatkan key untuk merutekan Claude Code melalui Flatkey, lalu gunakan CC Switch untuk menjaga profil provider lokal tetap mudah diganti, diperiksa, dan di-rollback.
