Gunakan DeepSeek di Claude Code: Panduan Pengaturan V4 Flash / Pro
Jalankan DeepSeek V4 Flash dan Pro di Claude Code melalui APIMaster. Atur gateway dan kunci API, ganti model, verifikasi alat pembaca file, dan perbaiki kesalahan konfigurasi.
Bisakah Claude Code menggunakan DeepSeek? Pengujian kami dengan Claude Code 2.1.239 berhasil menggunakan deepseek-v4-flash dan deepseek-v4-pro melalui endpoint Messages APIMaster. Atur ANTHROPIC_BASE_URL ke https://apimaster.ai, berikan kunci APIMaster, dan pilih model secara eksplisit. Konfigurasi ini menjalankan DeepSeek, meskipun kliennya bernama Claude Code.
Terakhir diuji: 2026-09-07, Claude Code 2.1.239, Linux. Kedua model mengembalikan teks yang diharapkan dan menyelesaikan putaran alat pembaca file. Semua proses keluar dengan kode 0. CLI mencetak
unrecognized_model, tetapi permintaan yang diuji berhasil. Pemeriksaan ini tidak menetapkan dukungan untuk setiap fitur Claude Code, sesi panjang, atau rilis mendatang. Perintah pengaturan Windows / macOS disertakan; pengujian yang tercatat dijalankan di Linux.
1. Siapkan CLI dan kunci API
Ikuti panduan lingkungan dan panduan pengaturan Claude Code untuk instalasi. Periksa versi Anda:
claude --version
Dapatkan kunci API APIMaster dengan akses ke model DeepSeek yang dipilih dan kuota yang cukup. Gunakan pengaturan sesi di bawah ini untuk tutorial ini; tidak perlu menimpa settings.json normal Anda.
2. Atur gateway dan kunci
Buka terminal baru untuk menjaga pengaturan ini terpisah dari sesi CLI biasa Anda.
macOS / Linux:
export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN
Windows PowerShell:
$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
Gunakan origin situs di sini, tanpa /v1: Claude Code menambahkan /v1/messages. Kunci API harus berasal dari APIMaster. Perintah ini memengaruhi terminal ini dan proses anaknya, bukan file login yang disimpan. Jangan letakkan kunci asli di file pengaturan bersama atau repositori.
3. Kirim permintaan uji minimal
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"
Diharapkan: is_error adalah false, result adalah DEEPSEEK_TEST_OK, dan proses keluar dengan kode 0. Ubah --model menjadi deepseek-v4-pro dan jalankan lagi.
Mode --bare dari versi yang diuji menggunakan autentikasi kunci API eksplisit dan melewati integrasi latar belakang normal. --setting-sources "" mengecualikan sumber pengaturan yang disimpan, sementara --tools "" menonaktifkan alat untuk satu tes teks ini. Ini adalah pengaturan diagnostik yang disengaja, bukan persyaratan untuk menonaktifkan alat selama penggunaan normal. Versi CLI yang lebih lama mungkin tidak menerima semua flag ini.
4. Verifikasi alat pembaca file
Buat probe.txt di direktori saat ini dengan konten ini:
TOOL_PROBE_739182
Jalankan:
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."
Diharapkan: CLI membaca file dan mengembalikan TOOL_PROBE_739182. Ulangi dengan deepseek-v4-pro. Ini memeriksa bahwa model dapat meminta alat, menerima hasilnya, dan kemudian menjawab. Hanya alat Read yang diaktifkan untuk tes ini.
Untuk pekerjaan interaktif biasa dengan pengaturan terminal yang sama:
claude --bare --setting-sources "" --model deepseek-v4-flash
Untuk memulai dengan Pro:
claude --bare --setting-sources "" --model deepseek-v4-pro
Perintah interaktif menghilangkan --tools "", sehingga alat default tersedia. Tinjau prompt izin seperti biasa. --bare melewati kemudahan seperti hook dan instruksi proyek otomatis; aktifkan pengaturan normal Anda dengan sengaja setelah pengaturan minimal berfungsi, dan periksa bahwa mereka tidak menimpa gateway atau model. Tutup terminal ini setelah selesai untuk meninggalkan lingkungan sesi ini.
Pemecahan Masalah
| Gejala | Apa yang harus diperiksa |
|---|---|
unrecognized_model |
Diamati untuk kedua ID DeepSeek di 2.1.239. Itu tidak mencegah permintaan kami selesai. Periksa hasil akhir daripada memperlakukan peringatan saja sebagai kegagalan. |
| 401 atau prompt login yang tidak terduga | Konfirmasi ANTHROPIC_API_KEY diatur, hapus ANTHROPIC_AUTH_TOKEN yang bertentangan di terminal ini, dan coba lagi mode bare. |
| 404 | ANTHROPIC_BASE_URL harus https://apimaster.ai, bukan endpoint /v1/messages lengkap atau basis yang diakhiri dengan /v1. |
Opsi --bare tidak dikenal |
Periksa versi Anda terhadap 2.1.239 yang diuji. Gunakan panduan instalasi umum untuk memperbarui jika sesuai. |
Tidak dapat membaca probe.txt |
Jalankan dari direktori file. Untuk tes alat, aktifkan Read daripada menggunakan --tools "". |
| Model yang berbeda dipilih | Berikan ID model lengkap dengan --model dan periksa pengaturan tersimpan atau override alias model sebelum mengaktifkannya. |
| Batas kecepatan, kuota tidak mencukupi, atau kesalahan hulu | Baca isi kesalahan, periksa kuota dan izin model, dan catat stempel waktu untuk dukungan. |
Pertanyaan yang sering diajukan
Apakah ini sama dengan menggunakan model Claude?
Tidak. Claude Code adalah klien di sini; model yang dipilih adalah DeepSeek. Fitur yang bergantung pada model Claude tertentu tidak secara otomatis tercakup oleh pengaturan ini.
Mengapa URL dasar berbeda dari contoh Python SDK?
Python OpenAI SDK menggunakan https://apimaster.ai/v1 dan menambahkan /chat/completions. Claude Code menggunakan https://apimaster.ai dan menambahkan /v1/messages. Gunakan format dasar yang didokumentasikan untuk setiap klien.
Bisakah saya menggunakan kunci resmi DeepSeek dengan gateway ini?
Tutorial ini memerlukan kunci yang diterbitkan oleh APIMaster. Kunci spesifik untuk penyedia yang menerbitkannya; mengubah hanya endpoint tidak mentransfer kredensial atau kuota.
Apakah penggunaan alat yang sebenarnya diuji, atau hanya balasan teks?
Keduanya diuji untuk kedua model. Tes alat membaca file lokal dan mengembalikan isinya. Itu tidak menetapkan bahwa semua alat, agen latar belakang, atau tugas pengkodean panjang didukung.