Menu docs

Docs / Integrasi

Pakai Cent AI di Claude Code

Arahkan Claude Code ke Cent AI dengan dua variabel environment, lalu pilih model berdasarkan namanya.

Terakhir diperbarui

Diuji dengan Claude Code v2.1.323 pada 2026-11-13


Setup Anda

Mengisi YOUR_API_KEY di kode halaman ini. Key hanya ada di tab ini: tidak dikirim dan tidak disimpan.

Claude Code memakai format Anthropic Messages, jadi ia tersambung ke Cent AI di https://api.cent-ai.dev dan menambahkan /v1/messages sendiri.

Prasyarat

  • Akun Cent AI yang punya saldo. Lihat Mulai cepat.
  • API key dari Key. Bentuknya cai_<secret> dan hanya tampil sekali.
  • Claude Code sudah terpasang. Versi yang kami uji ada di akhir halaman ini.

Atur Claude Code

Isi base URL, key, dan model. Ganti YOUR_API_KEY dengan key Anda.

export ANTHROPIC_BASE_URL="https://api.cent-ai.dev"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5.5"
VariabelFungsinya
ANTHROPIC_BASE_URLMengirim request Claude Code ke Cent AI. Jangan tambahkan /v1.
ANTHROPIC_AUTH_TOKENMengirim key sebagai Authorization: Bearer. ANTHROPIC_API_KEY juga bisa dan mengirimnya sebagai x-api-key; Cent AI menerima keduanya.
ANTHROPIC_MODELModel untuk sesi. Tulis nama persis seperti di daftar GET /v1/models.
ANTHROPIC_DEFAULT_HAIKU_MODELModel yang dipakai Claude Code untuk tugas latar, misalnya judul sesi. Isi juga dengan nama model Cent AI; bila tidak, request itu gagal dengan 404 model_not_found.

Variabel shell hanya berlaku di satu terminal. Agar tetap tersimpan, taruh nilai yang sama di blok env pada ~/.claude/settings.json (di Windows %USERPROFILE%\.claude\settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.cent-ai.dev",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5.5"
  }
}

Jangan taruh key di .claude/settings.json milik proyek: file itu biasanya ikut di-commit ke repositori.

Di ekstensi VS Code, isi variabel yang sama di claudeCode.environmentVariables pada pengaturan pengguna VS Code.

Coba

Cek key dan base URL sebelum membuka Claude Code:

curl https://api.cent-ai.dev/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5","max_tokens":16,"messages":[{"role":"user","content":"Halo"}]}'

Respons memuat usage.cost, jumlah yang ditagih untuk request ini dalam USD. Setelah itu jalankan claude dari terminal yang sama dan ketik /status: baris Anthropic base URL menampilkan https://api.cent-ai.dev. Kirim satu prompt. Setiap giliran tampil di halaman Requests di dashboard beserta token per tarif dan biayanya. Lihat Biaya per request.

Agar cache tetap kena

Claude Code mengirim header ID sesi, X-Claude-Code-Session-Id, dan field metadata.user_id yang nilainya sama selama satu percakapan. Cent AI memakai sinyal itu untuk mengirim setiap giliran ke rute yang melayani giliran sebelumnya, agar cache model bisa kena. Anda tidak perlu menambah apa pun di konfigurasi.

Cent AI tidak menjanjikan tingkat cache hit. Token cache hanya ditagih bila model melaporkannya. Lihat Prompt caching.

Troubleshooting

Untuk menelusuri request yang gagal, cari x-request-id dari respons di halaman Requests. Semua kode ada di Error 4xx dan Error 5xx.

401 invalid_api_key

Key salah, terpotong, sudah dicabut, atau berupa management key (cai_mgmt_…). Periksa nilai ANTHROPIC_AUTH_TOKEN, lalu jalankan /status untuk melihat kredensial yang dipakai Claude Code. Bila yang tampil login claude.ai, variabelnya belum sampai ke sesi.

402 insufficient_balance

Saldo yang bisa dipakai untuk model ini kosong, atau model itu tidak termasuk paket budget Anda. Top-up atau beli paket. Lihat Saldo.

403 ip_not_allowed atau model_not_allowed

Key punya allowlist IP tanpa alamat Anda, atau allowlist model tanpa model yang diminta Claude Code. Ingat model latar di ANTHROPIC_DEFAULT_HAIKU_MODEL: model itu juga harus ada di allowlist.

404 model_not_found

Nama model itu tidak dilayani Cent AI. Salin nama persisnya dari Model atau GET /v1/models; nama dari penyedia lain, misalnya gpt-4o-mini, bukan alias. Nama :free hanya berlaku untuk model event hari ini (lihat Token gratis harian); di model lain, termasuk model event hari sebelumnya, hasilnya 404.

429 rate_limited, key_limit_exceeded, atau project_budget_exceeded

  • rate_limited: lebih dari 600 request per menit di key ini. Claude Code dengan banyak subagent bisa mencapainya. Tunggu sesuai Retry-After, atau bagi pekerjaan ke beberapa key.
  • rate_limited pada nama :free: pool gratis hari ini sudah habis, atau event sedang mati. Retry-After berlaku sampai 00:00 UTC; nama asli model tetap bisa dipakai dengan harga normal.
  • key_limit_exceeded: limit harian atau bulanan yang Anda pasang di key sudah tercapai.
  • project_budget_exceeded: budget project pemilik key sudah tercapai.

501 not_available_yet

Endpoint itu belum dibuka. Claude Code hanya butuh /v1/messages, yang sudah tersedia, jadi error ini biasanya berarti base URL salah.

Stream timeout

Giliran yang panjang di-stream dengan : keepalive setiap 15 detik. Bila satu giliran berhenti dengan timeout_error atau api_error di stream, lihat Stream timeout.