Pintar Endpoint Claude Code dengan Gateway API Ketiga Berbasis Model Open-Source Tiongkok

Claude Code dapat dikonfigurasi untuk berkomunikasi dengan endpoint kompatibel dengan Anthropic daripada menggunakan endpoint provider langsung. Ini memungkinkan Anda untuk menguji workflow yang dikelola gateway dengan ID model yang ditampilkan oleh gateway, termasuk model open-source Tiongkok yang tersedia dalam katalog model saat ini ECAIX.

Buku panduan ini berkaitan dengan kerangka kerja kompatibilitas provider khusus, gateway ketiga. Dokumentasi resmi gateway Claude Code dari Anthropic menyatakan bahwa Anthropic tidak mendukung routing Claude Code ke model non-Claude melalui gateway. ECAIX tidak mengklaim bahwa kerangka kerja 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. Kirim permintaan diagnostik di bawah ini dan caturi 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 mengirimkan permintaan.
2. Gateway kompatibel dengan Anthropic menerima permintaan pada endpoint dengan gaya Anthropic.
3. ID model memilih model upstream yang ditampilkan oleh gateway.
4. Kunci API mengautentikasi 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 berubah berdasarkan versi klient dan implementasi gateway.

Sebelum memulai

Anda memerlukan:

• Instalasi Claude Code yang mendukung konfigurasi endpoint berdasarkan 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 dengan waktu. Sebelum menyalin ID model ke dalam file konfigurasi, buka direktorium model ECAIX dan pastikan model tersebut aktif dan tersedia untuk gaya API yang Anda rencanakan.

Konfigurasi Gateway Endpoint

Claude Code menyimpan pengaturan di ~/.claude/settings.json pada banyak instalasi. Schema pengaturan yang tepat dapat berubah, jadi perhatikan ini sebagai pola 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 kredensial yang direkomendasikan oleh instalasi Claude Code Anda.

Anda juga dapat mengkonfigurasi endpoint dalam sesi shell saat uji coba:

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 bidang model atau mekanisme alias model yang didokumentasikan oleh versi Anda. Gateway masih harus mengenali ID model akhir.

Verifikasi Endpoint Kompatibel dengan Anthropic

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

Perintah di bawah ini menyimpan header respons dan isi respons secara terpisah, kemudian mencetak status HTTP. Gunakan kunci yang nyata dan diotentikasi hanya dalam shell lokal Anda; jangan pastekan ke dalam artikel, isu, 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 bidang model atau penggunaan yang dikembalikan.
• 401 atau 403: Periksa kunci, header, akun, dan jangkauan izin sebelum mengubah prompt.
• 404: Periksa URL dasar, suffix /messages, dan deploymen endpoint.
• 400: Reduksi permintaan ke bentuk terkecil yang valid dan periksa bidang model khusus.
• 5xx atau timeout: Caturi waktu permintaan dan isi respons, kemudian pemisahan perilaku timeout gateway, upstream, dan klient.

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

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. Misalnya, katalog mungkin menampilkan ID seperti 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 dalam direktori model. Jika jendela 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 dengan OpenAI, sementara yang lain menyediakan nama bidang yang berbeda atau mendukung hanya sebagian kecil perilaku alat. Mulailah dengan uji coba 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 daripada hanya bergantung pada 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. Misalnya:

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

Uji dengan permintaan yang semakin memakan daya:

1. Respon teks biasa.
2. Penjelasan kode singkat.
3. Navigasi repository.
4. Edit kontrol dalam branch 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 berfungsi secara identik dengan sesi Claude.

Pilih Path API yang Tepat

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

Untuk ECAIX, gunakan Dokumentasi Messages Anthropic untuk path gaya Anthropic dan Dokumentasi 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 berikut adalah batas bukti pada publikasi, bukan klaim bahwa semua fitur didukung:

Perbedaan ini mencegah permintaan minimal yang berhasil ditampilkan 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 ini daripada mengubah beberapa variabel sekaligus:

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

Untuk "Model tidak ditemukan", ini membedakan kesalahan penulisan dengan masalah izin, masalah pemetaan gateway, dan kegagalan penyedia upstream. Untuk "