Endpoint API Custom Claude Code: Pengaturan Gateway Ketiga-Partai dengan Model Open-Source Tiongkok

Claude Code dapat dikonfigurasi untuk berkomunikasi dengan sebuah endpoint kompatibel dengan Anthropic daripada menggunakan endpoint dari penyedia langsung. Hal ini memungkinkan Anda untuk menguji workflow yang diurus oleh gateway dengan ID model yang disediakan oleh gateway, termasuk model open-source Tiongkok yang tersedia dalam katalog model saat ini ECAIX.

Artikel ini membahas workflow kompatibilitas khusus untuk penyedia, bukan dokumentasi gateway resmi Anthropic. Dokumentasi resmi Anthropic menyatakan bahwa Anthropic tidak mendukung routing Claude Code ke model non-Claude melalui gateway. ECAIX tidak mengklaim bahwa workflow ini secara resmi didukung oleh Anthropic, dan model non-Claude mungkin tidak menyediakan semua kemampuan Claude Code.

Langkah cepat

Jika Anda sudah memahami batas kompatibilitas, coba langkah ini yang singkat:

1. Buka katalog model saat ini ECAIX dan pilih ID model yang aktif.
2. Buat key API ECAIX dan simpan di luar kontrol versi.
3. Setel ANTHROPIC_BASE_URL ke https://ecaix.com/api/ai/v1/anthropic.
4. Jalankan permintaan diagnostik di bawah ini dan catat status HTTP.
5. Uji Claude Code dalam proyek uji baca saja dengan claude -p.
6. Uji alat, streaming, batas konteks, dan izin secara terpisah.

Status validasi pada publikasi

Tabel ini sengaja dibuat: contoh konfigurasi bukanlah hasil kompatibilitas yang diukur.

Apa yang akan berubah dalam konfigurasi ini

Konfigurasi ini terdiri dari empat bagian yang terpisah:

1. Claude Code adalah klient yang menciptakan tugas pemrograman dan mengirim permintaan.
2. Gateway kompatibel dengan Anthropic menerima permintaan pada endpoint dengan gaya Anthropic.
3. ID model memilih model upstream yang disediakan oleh gateway.
4. Kunci API mengotentikasi permintaan dan menentukan akun, kuota, dan izin.

Mengubah endpoint tidak membuat model non-Claude menjadi Claude. Hanya yang berubah adalah permukaan API yang kompatibel yang menerima permintaan. Penggunaan alat, pengelolaan konteks, alias model, perilaku streaming, dan aliran izin dapat bervariasi berdasarkan versi klient dan implementasi gateway.

Sebelum memulai

Anda memerlukan:

• Instalasi Claude Code yang mendukung konfigurasi endpoint melalui lingkungan atau setting.
• Kunci API ECAIX.
• ID model yang saat ini ada dalam katalog model ECAIX.
• Terminal di mana Anda dapat menjalankan permintaan uji kecil tanpa memasukkan kunci API ke dalam kontrol versi.

Katalog berubah secara berkala. Sebelum menyalin ID model ke dalam file konfigurasi, buka direktorium model ECAIX dan konfirmasi bahwa model tersebut aktif dan tersedia untuk gaya API yang Anda rencanakan gunakan.

Konfigurasi Gateway Endpoint

Claude Code menyimpan pengaturan di ~/.claude/settings.json pada banyak instalasi. Schema pengaturan ini dapat berubah, jadi perhatikan pola ini sebagai awal dan bandingkan dengan dokumentasi versi yang Anda instal.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

Jangan komit file ini ke repositori publik jika file tersebut mengandung kunci API yang nyata. Prefer menggunakan lingkungan lokal, manajer rahasia, atau mekanisme otentikasi yang direkomendasikan oleh instalasi Claude Code Anda.

Anda juga dapat mengkonfigurasi endpoint dalam sesi shell saat uji:

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

Nama variabel dan pengaturan yang didukung oleh versi Claude Code tertentu dapat berubah. Jika klient menolak ANTHROPIC_MODEL, gunakan field model atau mekanisme alias model yang dijelaskan dalam dokumentasi versi Anda. Gateway masih harus mengenali ID model akhir.

Verifikasi Endpoint Kompatibel dengan Anthropic

Sebelum memulai sesi pemrograman interaktif, kirim permintaan kecil. Ini memisahkan masalah endpoint, otentikasi, dan ID model dari perilaku khas Claude Code.

Perintah di bawah ini menyimpan header respons dan isi respons secara terpisah, kemudian mencetak status HTTP. Gunakan kunci yang nyata dan terotentikasi hanya di shell lokal Anda; jangan pastekan ke dalam artikel, issue, atau log yang dibagikan.

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

Interpretasi yang diharapkan:

• 200: Inspeksi bentuk respons dan konfirmasi model atau field penggunaan yang dikembalikan.
• 401 atau 403: Periksa kunci, header, akun, dan jangkauan izin sebelum mengubah prompt.
• 404: Periksa URL dasar, tambahan /messages, dan deploymen endpoint.
• 400: Reduksi permintaan ke bentuk terkecil yang valid dan periksa field-model yang spesifik.
• 5xx atau timeout: Catat waktu permintaan dan isi respons, kemudian pemisahan perilaku timeout gateway, upstream, dan klient.

Respons yang berhasil mengkonfirmasi bahwa kunci, endpoint, format permintaan, dan ID model bekerja bersama untuk permintaan tersebut. Ini tidak membuktikan bahwa semua fitur Claude Code akan bekerja.

Memilih ID Model

Katalog ECAIX mengandung keluarga model dari penyedia Tiongkok. Model yang tepat untuk dimulai tergantung pada tugas, bukan hanya nama model.

Pemrograman dan pengembangan umum

Mulai dengan model DeepSeek, Qwen, GLM, atau Seed yang mampu pemrograman dan terlihat dalam katalog. Contoh ID yang mungkin ada dalam katalog adalah deepseek-v4.1-flash, qwen3.8-flash, glm-5.3, atau seed-2.0-code. Ketersediaan dan kemampuan dapat berubah, jadi selalu verifikasi halaman model saat ini sebelum menerbitkan konfigurasi.

Konteks panjang dan kerja repository

Untuk repository besar atau dokumen teknis panjang, bandingkan panjang konteks yang ditampilkan di halaman model. Jika konteks lebih besar tidak secara otomatis berarti hasil repository lebih baik: struktur prompt, dukungan alat, batas output, dan batas permintaan gateway juga penting.

Panggilan alat dan workflow agent

Jika workflow memerlukan panggilan fungsi atau alat, periksa dokumentasi model dan endpoint. Beberapa penyedia menyediakan panggilan alat melalui API kompatibel OpenAI, sementara yang lain menggunakan nama field yang berbeda atau mendukung hanya sebagian dari perilaku alat. Mulai dengan uji panggilan alat kecil sebelum memberikan model akses ke repository nyata atau sistem eksternal.

Pengembangan dalam bahasa Tiongkok

Model open-source Tiongkok dapat berguna ketika basis kode, dokumentasi, tracker issue, atau workflow tim mengandung materi dalam bahasa Tiongkok. Evaluasi model dengan prompt dan contoh repository Anda sendiri, bukan hanya berdasarkan peringkat umum.

Uji Claude Code setelah permintaan API berhasil

Setelah permintaan langsung berhasil, mulai dengan perintah baca saja atau rendah risiko:

claude -p "Explain what this repository does without editing files."

Lalu uji tugas yang sempit dan spesifik. Contohnya:

claude -p "List the likely entry points for the web application. Do not modify files."

Gunakan uji yang semakin meminta:

1. Respon teks biasa.
2. Penjelasan kode singkat.
3. Navigasi repository.
4. Edit kontrol dalam cabang disposable.
5. Penggunaan alat atau tugas multi-tahap.
6. Perilaku streaming dan konteks panjang.

Jangan asumsi bahwa respon teks yang berhasil membuktikan perilaku izin, panggilan alat, streaming, batas konteks, atau edit file berperilaku identik dengan sesi Claude yang sebenarnya.

Pilih Path API yang Tepat

Claude Code hanya satu workflow klient. Path API yang tepat tergantung pada klient dan set fitur yang Anda butuhkan:

Untuk ECAIX, gunakan Dokumentasi Messages Anthropic untuk path gaya Anthropic dan Chat Completions untuk klient kompatibel OpenAI. Gunakan direktorium model untuk konfirmasi model saat ini dan halaman harga untuk harga yang ditampilkan saat ini.

Matriks Kompatibilitas

Matriks ini adalah batas bukti pada saat publikasi, bukan klaim bahwa semua fitur didukung:

Perbedaan ini mencegah presentasi permintaan minimal yang berhasil sebagai sertifikasi kompatibilitas Claude Code yang lengkap.

Halaman Detail Model dan ID Saat Ini

Gunakan halaman detail model daripada menyalin nama model lama dari artikel blog:

• DeepSeek v4.1 Flash
• Qwen 3.8 Flash
• GLM 5.3
• Kimi K3

Link ini adalah pintu masuk untuk memeriksa ID model saat ini, informasi konteks, dan detail halaman tingkat.

Ketersediaan dapat berubah setelah publikasi.

Setelah terjadi kesalahan, gunakan urutan berikut daripada mengubah beberapa variabel sekaligus:

1. Simpan status HTTP dan isi respons.
2. Konfirmasi URL dasar dan tambahan endpoint.
3. Konfirmasi kunci API ada lokal dan memiliki jangkauan yang diharapkan.
4. Konfirmasi ID model yang tepat dalam katalog model hidup .
5. Uji kembali dengan permintaan terkecil yang valid.
6. Bandingkan hasil dengan permintaan klient yang dikirim oleh Claude Code.
7. Hanya kemudian investigasikan perbedaan routing upstream, timeout, atau skema alat.

Untuk "Model tidak ditemukan", ini membedakan kesalahan penulisan dengan masalah izin, masalah pemetaan gateway, dan kegagalan penyedia upstream. Untuk "401" dan "403", mengubah model biasanya bukan perbaikan pertama. Untuk kasus sukses teks/kegagalan alat