DeepSeek V4 Flash dan Pro di Claude Code: Pengaturan dan Pemindahan Model
Siapkan DeepSeek di Claude Code menggunakan APIMaster. Konfigurasikan settings.json di Windows, macOS dan Linux, jalankan claude, pilih model dengan /model dan mulai mengobrol.
Konfigurasikan APIMaster di settings.json, jalankan claude, lalu masukkan /model MODEL_ID dalam percakapan untuk menggunakan DeepSeek. ID yang tersedia dan dibahas di sini adalah deepseek-v4-flash, deepseek-v4-pro. Claude Code adalah klien; DeepSeek adalah model yang menjawab.
Sebelum memulai
Selesaikan pemeriksaan lingkungan dan penyiapan Claude Code. Dapatkan kunci API APIMaster dengan saldo yang cukup dan akses ke model yang dipilih.
claude --version
Base URL gateway adalah https://apimaster.ai, tanpa /v1. Claude Code menambahkan /v1/messages sendiri.
1. Buka direktori konfigurasi
Windows
Tekan Win + R, masukkan jalur berikut lalu tekan Enter:
%USERPROFILE%\.claude
Buat foldernya jika diperlukan. Buka atau buat settings.json. Pastikan namanya bukan settings.json.txt.
macOS / Linux
Di macOS, di Finder tekan Command + Shift + G dan masukkan:
~/.claude
Di Linux, buka direktori yang sama dengan file manager atau editor Anda. Buat jika diperlukan:
mkdir -p ~/.claude
Buka atau buat settings.json di sana. Jika Anda menetapkan direktori konfigurasi Claude Code kustom, gunakan direktori tersebut.
2. Edit settings.json
Windows, macOS dan Linux menggunakan konfigurasi yang sama. Ganti YOUR_APIMASTER_API_KEY dengan kunci APIMaster Anda:
{
"model": "deepseek-v4-flash",
"env": {
"ANTHROPIC_BASE_URL": "https://apimaster.ai",
"ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
"ANTHROPIC_AUTH_TOKEN": "",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
}
}
Jika file sudah ada, buat cadangan dan gabungkan kolom-kolom ini ke objek JSON dan objek env yang ada. Pertahankan pengaturan lain yang Anda butuhkan. Jangan menambahkan objek JSON kedua atau menduplikasi kunci env. JSON tidak mengizinkan komentar atau koma di akhir.
Panduan umum Claude Code menunjukkan autentikasi token. Panduan ini menggunakan autentikasi kunci API yang diuji dalam tes integrasi kami. Biarkan ANTHROPIC_AUTH_TOKEN kosong saat menggunakan ANTHROPIC_API_KEY, dan hapus kredensial yang bertentangan dari pengaturan lain atau terminal Anda. Gunakan kunci APIMaster untuk gateway ini.
Kolom model menetapkan model awal. Anda dapat memilih yang lain setelah diluncurkan. Jaga kerahasiaan file pengaturan pengguna ini; jangan mengommit kunci asli ke repositori bersama. Simpan file dan mulai ulang Claude Code untuk memuat konfigurasi baru.
3. Mulai Claude Code
Di terminal yang dibuka di direktori proyek Anda, jalankan:
claude
Selesaikan semua prompt pertama kali menjalankan seperti biasa dan tinjau prompt kepercayaan proyek. Model awal seharusnya deepseek-v4-flash. Ini adalah sesi interaktif normal dengan alat dan pengaturan proyek standar.
4. Pilih model dan mulai mengobrol
Di dalam percakapan Claude Code, masukkan salah satu perintah berikut dan tekan Enter:
/model deepseek-v4-flash
/model deepseek-v4-pro
Jalankan satu baris pada satu waktu, memilih model yang Anda inginkan. Setelah Claude Code mengonfirmasi perpindahan, kirim pesan singkat:
Reply with exactly OK.
Balasan teks normal mengonfirmasi koneksi dasar. Anda kemudian dapat melanjutkan mengobrol atau memintanya mengerjakan proyek Anda. Untuk berpindah lagi dalam percakapan yang sama, masukkan perintah /model MODEL_ID lainnya.
Memasukkan /model saja akan membuka pemilih model. ID gateway kustom mungkin tidak muncul dalam daftar bawaannya. Ketik ID lengkap seperti yang ditunjukkan di atas sebagai gantinya. Perintah slash berada di dalam Claude Code, bukan di PowerShell atau Bash. Nama-nama model tersebut menjelaskan model DeepSeek, bukan Claude Sonnet atau Opus.
Anda juga dapat memilih model saat meluncurkan dari terminal. Jalankan satu perintah pada satu waktu:
claude --model deepseek-v4-flash
claude --model deepseek-v4-pro
Untuk menetapkan default secara eksplisit untuk sesi mendatang, edit model di settings.json. Flag peluncuran, variabel lingkungan ANTHROPIC_MODEL, atau pengaturan proyek/terkelola dapat memengaruhi model yang dipilih; periksa hal-hal ini jika model awal berbeda dari nilai yang Anda simpan.
Pemecahan masalah
| Gejala | Yang diperiksa |
|---|---|
| 401 / prompt login yang tidak diharapkan | Periksa kunci APIMaster, base URL dan variabel autentikasi yang bertentangan; mulai ulang CLI setelah mengedit pengaturan. |
| 404 | Gunakan https://apimaster.ai, tanpa /v1 atau /v1/messages. |
| Pengaturan tidak berlaku | Periksa lokasi file, JSON yang valid dan penimpaan dari terminal, proyek atau pengaturan terkelola. |
| Model tidak ada di pemilih | Masukkan /model MODEL_ID dengan ID yang tepat, atau luncurkan dengan claude --model MODEL_ID. |
| Model tidak tersedia / 403 | Periksa ejaan, model yang diizinkan untuk kunci tersebut, saldo akun dan ketersediaan rute saat ini. |
unrecognized_model |
Teramati dengan ID kustom dalam pengujian kami. Periksa jawaban sebenarnya dan hasil alat; default kemampuan bawaan Claude tidak diverifikasi untuk DeepSeek. |
| Izin file atau perintah ditolak | Tinjau dan setujui operasi yang dimaksud melalui prompt izin seperti biasa. |
| 429 / 5xx / balasan terputus | Simpan pesan kesalahan, ID model, versi CLI, waktu UTC dan ID permintaan jika tersedia untuk dukungan. |
Validasi dan diagnostik opsional
Tes integrasi yang dicatat: 2026-09-07 UTC, Claude Code 2.1.239, Linux. Semua model yang tercantum di sini mengembalikan teks yang diharapkan dan membaca file lokal melalui alat. Tugas pengkodean kompleks berada di luar cakupan tes tersebut. Windows dan macOS bukan bagian dari pengujian tercatat tersebut.
Pemeriksaan otomatis sebelumnya menggunakan mode bare untuk mengisolasi konfigurasi. Penggunaan harian normal mengikuti settings.json dan langkah interaktif di atas. Mode bare dan --setting-sources "" melewati integrasi normal atau pengaturan tersimpan, sehingga keduanya tidak boleh ditambahkan ke perintah startup sehari-hari dari panduan ini.
Untuk pemeriksaan cepat non-interaktif menggunakan konfigurasi tersimpan Anda:
claude --model deepseek-v4-flash -p "Reply with exactly OK."
Untuk pemeriksaan alat, buat probe.txt yang berisi FILE_PROBE_739182, mulai Claude Code di direktori tersebut dan minta ia membaca file menggunakan alat dan mengembalikan isinya secara persis. Pastikan alat benar-benar berjalan.
Ini adalah pemeriksaan integrasi terbatas, bukan jaminan untuk setiap fitur Claude Code, perilaku sesi panjang atau konteks maksimum. Dokumentasi gateway Anthropic tidak secara resmi mendukung perutean Claude Code ke model non-Claude; panduan ini menjelaskan integrasi APIMaster.
FAQ
Apakah langganan Claude saya membayarkan permintaan-permintaan ini?
Tidak. Dengan konfigurasi APIMaster ini, permintaan menggunakan kunci dan saldo APIMaster Anda.
Bisakah saya melanjutkan mengobrol setelah berpindah model?
Ya, gunakan perintah perpindahan model dalam percakapan yang terbuka dan tunggu konfirmasi sebelum mengirim pesan berikutnya. Untuk perbandingan yang bersih antar model, mulai sesi terpisah dengan claude --model MODEL_ID.
