Claude Code

Claude Code memakai format API Anthropic, yang dilayani kenari di /v1/messages. Untuk menghubungkannya, atur tiga variabel environment. Claude Code butuh model chat yang mendukung tool calling. Pastikan tool_call bernilai true untuk model itu di katalog terbaru:

curl -s https://kenari.id/v1/models \
  | jq -r '.data[] | select(.tool_call == true) | .id'

Request dengan tools ke model tanpa tool calling mengembalikan 400, begitu juga id gambar, suara, transkripsi, dan video.

Atur variabel

Kamu butuh API key di KENARI_API_KEY. Lihat Mulai cepat untuk membuatnya dan mengekspornya.

export ANTHROPIC_BASE_URL=https://kenari.id
export ANTHROPIC_AUTH_TOKEN=$KENARI_API_KEY
export ANTHROPIC_MODEL=step-3-7-flash:free

Variabel	Nilai
`ANTHROPIC_BASE_URL`	`https://kenari.id`, tanpa `/v1`. Claude Code menambahkan `/v1/messages` sendiri.
`ANTHROPIC_AUTH_TOKEN`	API key kenari kamu, diawali `kn-`. Lihat Autentikasi & API key.
`ANTHROPIC_MODEL`	Id model dari Model & harga. `step-3-7-flash:free` bisa dipakai dengan saldo nol.

ANTHROPIC_API_KEY juga bisa dipakai sebagai pengganti ANTHROPIC_AUTH_TOKEN. kenari menerima key dari header Authorization maupun x-api-key.

Simpan variabel untuk sesi berikutnya

Tambahkan baris export ke profil shell, misalnya ~/.zshrc atau ~/.bashrc, beserta export KENARI_API_KEY=kn-... agar variabel sumbernya ada di setiap terminal baru. Lalu buka terminal baru. Atau taruh di blok env pada settings.json Claude Code:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://kenari.id",
    "ANTHROPIC_AUTH_TOKEN": "kn-...",
    "ANTHROPIC_MODEL": "step-3-7-flash:free"
  }
}

File settings.json menyimpan key sebagai teks biasa, jadi jangan masukkan ke version control.

Cek koneksi

Jika kamu memakai variabel environment, pastikan key sudah terpasang tanpa menampilkannya. Pakai ANTHROPIC_API_KEY sebagai pengganti ANTHROPIC_AUTH_TOKEN jika itu yang kamu pilih. Jika kamu memakai settings.json, lewati pemeriksaan ini.

test -n "$ANTHROPIC_AUTH_TOKEN" && echo set

Lalu jalankan Claude Code dan kirim pesan apa saja:

claude

Kalau ada balasan, koneksi sudah berjalan.

Penghitungan token

Claude Code memanggil POST /v1/messages/count_tokens sebelum setiap giliran untuk mengukur context window. kenari menjawab dengan perkiraan dan tidak menagih panggilan ini. Panggilan tetap butuh key kamu.

Pilih antara ini dan CLI kenari

Variabel di atas mengarahkan semua sesi Claude Code ke satu model. CLI kenari hanya mengarahkan sesi yang kamu mulai dengan kenari claude, dan memungkinkan model berbeda di tiap role, seperti opus atau subagents. Pilih salah satu. Kalau variabel tetap terpasang, kenari claude menimpanya untuk sesinya sendiri.

Troubleshooting

Gejala	Penyebab	Solusi
`401` dengan `invalid key` atau `missing authorization`	Variabel belum termuat, atau key tidak diawali `kn-`.	Pakai key yang sudah kamu simpan, lalu buka terminal baru. Key yang hilang tidak bisa ditampilkan lagi, jadi buat key baru. Lihat Autentikasi & API key.
`400` dengan `model_not_found`	Id model salah ketik atau tidak ada di katalog.	Salin id dari Model & harga.
`402` dengan `insufficient_balance`	Model berbayar dan saldomu kosong.	Pakai model `:free`, atau top up. Lihat Cara penagihan.
`405`	Base URL berakhir dengan `/v1`, sehingga request menuju `/v1/v1/messages`.	Atur `ANTHROPIC_BASE_URL` ke `https://kenari.id`.
`model_not_found` untuk model yang tidak kamu pilih	Claude Code juga mengirim request latar belakang ke model kecil bawaan yang mungkin tidak ada di kenari.	Atur `ANTHROPIC_DEFAULT_HAIKU_MODEL` ke id model katalog.