getdeepseekapi.comPanduan
Cara Menggunakan API DeepSeek di Claude Code: Opsi Nyata
Jika Anda sedang mencari cara menggunakan API DeepSeek di Claude Code, hal pertama yang perlu diketahui adalah Claude Code berkomunikasi dengan endpoint gaya Anthropic, sementara layanan ini menggunakan format OpenAI. Proxy penerjemah kecil menutup celah tersebut, dan halaman ini menunjukkan cara mengonfigurasinya.
Diperbarui
Poin utama
- Claude Code mengharapkan API Messages Anthropic; layanan ini menawarkan /v1/chat/completions yang kompatibel dengan OpenAI.
- Proxy lokal seperti LiteLLM dapat menerjemahkan antara kedua format tersebut.
- Aider, Continue, dan Cline menerima base URL kompatibel OpenAI secara langsung, tanpa proxy.
- Ini bukan API resmi DeepSeek: ini adalah satu model open-weight independen dengan ID
uncensored.

Mulai dengan apa yang akan dan tidak akan berfungsi
Dua klarifikasi ini menghemat satu jam kebingungan. Pertama, layanan ini bukan API DeepSeek resmi, dan ini bukan router untuk DeepSeek atau vendor lain. Layanan ini menjalankan satu model bobot terbuka, oleh penyedia independen, di bawah ID model uncensored. Jika Anda membutuhkan model milik DeepSeek, kunjungi DeepSeek secara langsung. Kedua, Claude Code dibangun di atas Messages API milik Anthropic. Anda dapat mengubah tempat permintaan dikirim, tetapi format JSON yang dikirim tetap berbentuk seperti API Anthropic.
Layanan ini mengekspos POST /v1/chat/completions dan GET /v1/models dalam format OpenAI. Mengarahkan Claude Code langsung ke sana tidak akan berfungsi, karena jalur dan payload berbeda. Solusinya adalah lapisan terjemahan. Anda menjalankan proxy kecil di mesin Anda yang menerima panggilan format Anthropic dari Claude Code dan meneruskannya sebagai panggilan format OpenAI ke https://api.getdeepseekapi.com/v1. Ada alat yang dibuat khusus untuk ini, dan bagian berikutnya mengonfigurasinya.
Sebelum memulai, periksa satu ekspektasi. Claude Code sangat bergantung pada pemanggilan alat untuk membaca file, mengeditnya, dan menjalankan perintah. API ini mendukung pemanggilan alat, termasuk tool_calls streaming, tetapi seberapa baik model tertentu menggerakkan loop agen panjang adalah sesuatu yang perlu Anda uji di repositori Anda sendiri, bukan sesuatu yang bisa diasumsikan.
Dapatkan kunci dan konfirmasi endpoint
Buat akun dengan Google atau email dan kata sandi, lalu buka halaman kunci API. Pengguna baru dapat mengklaim $0,50 kredit uji coba dengan satu klik. Kredit ini berlaku selama 7 hari, tidak memerlukan detail pembayaran, dan cukup untuk menguji semua hal di bawah ini. Perhatikan bahwa kunci uji coba memungkinkan 2 permintaan paralel dan 60 per menit, yang penting untuk alat agen yang memicu beberapa panggilan sekaligus.
export UNCENSORED_API_KEY="paste-your-key-here"
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
Jika itu mengembalikan penyelesaian, sisi hulu sudah selesai. Sisanya hanya menghubungkan proxy ke sana.
Opsi 1: proxy LiteLLM di depan Claude Code
LiteLLM adalah proyek sumber terbuka yang server proxynya dapat menyajikan endpoint kompatibel Anthropic dan mengarahkan ke backend kompatibel OpenAI. Periksa dokumentasinya untuk set fitur saat ini, karena bagian ekosistem ini bergerak dengan cepat.
Instal dan konfigurasi
pip install 'litellm[proxy]'
cat > litellm-config.yaml <<'EOF'
model_list:
- model_name: uncensored
litellm_params:
model: openai/uncensored
api_base: https://api.getdeepseekapi.com/v1
api_key: os.environ/UNCENSORED_API_KEY
EOF
litellm --config litellm-config.yaml --port 4000
Awalan openai/ memberi tahu LiteLLM untuk menggunakan adapter kompatibel OpenAI; nama setelahnya dikirim ke hulu sebagai model. Biarkan terminal tetap berjalan.
Arahkan Claude Code ke proxy
Claude Code membaca endpoint dan kredensialnya dari variabel lingkungan. Di terminal kedua:
export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="any-local-string"
export ANTHROPIC_MODEL="uncensored"
export ANTHROPIC_SMALL_FAST_MODEL="uncensored"
claude
Token autentikasi di sini hanyalah apa yang diharapkan proxy lokal Anda; kunci asli tetap berada di lingkungan proxy. Mengatur model kecil dan cepat juga penting, karena Claude Code menggunakan model kedua untuk tugas latar belakang ringan. Jika Anda membiarkannya tidak diatur, ia mungkin mencoba memanggil nama model Anthropic yang tidak dikenal proxy. Versi yang lebih baru dapat menamai pengaturan ini dengan berbeda, jadi jalankan claude --help atau baca dokumentasi pengaturan Claude Code saat ini jika variabel tampaknya diabaikan.
Opsi 2: alat yang menerima base URL OpenAI secara langsung
Jika tujuan Anda adalah asisten pemrograman AI daripada Claude Code itu sendiri, beberapa alat melewati proxy karena mereka sudah berbicara format OpenAI. Setiap alat memungkinkan Anda mengatur base URL dan nama model kustom.
- Aider adalah asisten pair programming di terminal. Ini membaca
OPENAI_API_BASEdanOPENAI_API_KEY, dan Anda menambahkan awalanopenai/pada model. - Continue adalah ekstensi editor di mana entri model dapat membawa
apiBasedan penyedia gaya OpenAI. - Cline menawarkan penyedia Kompatibel OpenAI di pengaturannya dengan bidang untuk base URL, kunci, dan ID model.
Dengan Aider, seluruh konfigurasi adalah tiga baris:
export OPENAI_API_BASE="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="$UNCENSORED_API_KEY"
aider --model openai/uncensored
Alat-alat ini sering mengubah menu mereka, jadi perlakukan nama bidang di atas sebagai panduan dan ikuti dokumentasi terbaru setiap proyek. Nilai yang Anda butuhkan tidak pernah berubah: base URL https://api.getdeepseekapi.com/v1, kunci Anda, dan ID model uncensored.
Tulis loop agen tipis Anda sendiri
Ketika asisten coding lengkap terlalu berlebihan, skrip pendek dengan pemanggilan alat mencakup banyak fungsi. Skrip ini memungkinkan model meminta untuk membaca file, lalu mengirimkan kembali file tersebut sebagai pesan role: "tool".
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key=os.environ["UNCENSORED_API_KEY"],
)
tools = [{
"type": "function",
"function": {
"name": "read_file",
"description": "Read a text file from the project",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"],
},
},
}]
messages = [{"role": "user", "content": "What does main.py do? Read it first."}]
for _ in range(5):
r = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = r.choices[0].message
messages.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
with open(args["path"]) as f:
result = f.read()
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
Batas loop lima menjaga model yang bingung agar tidak berjalan selamanya. Dalam alat nyata, Anda juga akan memvalidasi jalur sehingga model tidak dapat membaca file di luar proyek.
Batas laju, biaya, dan perbaikan 429
Alat agen mengirim banyak permintaan. Satu tugas dapat memicu puluhan permintaan, masing-masing mengirim ulang konteks yang semakin besar. Dengan kunci penuh, Anda mendapatkan 8 permintaan paralel dan 300 per menit. Kode 429 dengan concurrency berarti terlalu banyak panggilan yang tumpang tindih, dan kode 429 dengan rate_limited berarti terlalu banyak per menit. Saat kelebihan beban singkat, Anda akan melihat kode 429 dengan Retry-After: 5. LiteLLM dapat mencoba ulang secara otomatis jika Anda menambahkan pengaturan coba ulang; lihat dokumentasinya.
Biaya ringan karena harga $0,15 per 1M token input dan $0,50 per 1M token output. Misalkan sesi agen membuat 40 panggilan yang masing-masing mengirim 30.000 token konteks dan mendapatkan kembali 600 token. Input adalah 1.200.000 token, yang biayanya 1,2 x $0,15 = $0,18. Output adalah 24.000 token, yang biayanya 0,024 x $0,50 = $0,012. Seluruh sesi berakhir pada $0,192. Jendela konteks adalah 100.000 token, jadi jaga file yang Anda muat agar fokus.
Saat kredit uji coba habis, isi saldo dengan jumlah bulat apa pun dari $20 hingga $500 menggunakan kripto (USDT di TRC20, USDC di Base). Bonus adalah +5% dari $50, +10% dari $100, dan +15% dari $200. Lihat halaman harga dan dokumentasi untuk detailnya.
Pemecahan masalah konfigurasi proxy
| Gejala | Penyebab | Apa yang harus dicoba |
|---|---|---|
| Claude Code melaporkan model tidak dikenal | Nama model latar belakang tidak dipetakan | Atur variabel model kecil dan cepat menjadi uncensored juga |
| Koneksi ditolak | Proxy tidak berjalan atau port berbeda | Mulai LiteLLM dan cocokkan port di ANTHROPIC_BASE_URL |
| 401 dari hulu | Kunci salah di lingkungan proxy | Ekspor ulang UNCENSORED_API_KEY dan mulai ulang proxy |
| Panggilan fungsi gagal atau loop | Model kesulitan dengan format agen | Turunkan suhu, perpendek prompt, atau gunakan Aider |
| 429 sering terjadi | Konkurensi kunci uji coba sebesar 2 | Isi saldo untuk mendapatkan kunci penuh dengan 8 slot konkuren |
Dua kebiasaan menjaga setup Anda aman. Jalankan proxy hanya di localhost, agar tidak ada orang lain di jaringan Anda yang dapat menghabiskan saldo Anda, dan simpan kunci asli di lingkungan proxy, bukan di file proyek yang akan masuk ke kontrol versi. Perhatikan juga header respons X-Balance-USD selama sesi panjang pertama Anda, karena loop agen dapat menggunakan lebih banyak token daripada yang Anda perkirakan. Jika saldo turun lebih cepat dari perkiraan di atas, perpendek file yang Anda masukkan atau batasi jumlah langkah.
Permintaan yang gagal tidak dibebankan biaya, sehingga bereksperimen menjadi murah. Prompt tidak digunakan untuk pelatihan. Untuk perbandingan dengan gateway lain, baca ringkasan kunci API kami.
Panduan lainnya
Tanya jawab
Dapatkah Claude Code terhubung langsung ke API ini?
Tidak. Claude Code menggunakan format Messages Anthropic, sedangkan API ini menggunakan format chat completions OpenAI. Pasang proxy penerjemah seperti LiteLLM di antaranya.
Apakah ini API resmi DeepSeek?
Tidak. Ini menghosting satu model bobot terbuka independen di bawah ID uncensored dan tidak berafiliasi dengan DeepSeek atau vendor lain.
Alat apa saja yang berfungsi tanpa proxy?
Alat dengan pengaturan penyedia kompatibel OpenAI, seperti Aider, Continue, dan Cline. Atur base URL, kunci, dan ID model uncensored.
Apakah pemanggilan fungsi berfungsi?
Ya, termasuk tool_calls yang di-streaming dan hasil yang dikirim kembali sebagai pesan peran tool. Uji alur kerja agen Anda sendiri untuk melihat bagaimana model menanganinya.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah base URL. Itu saja seluruh proses pengaturannya.