Dokumentasi

Claude Code

Claude Code memperlakukan endpoint berformat Anthropic apa pun sebagai gateway. Dua variabel mengarahkannya ke Kunavo, tiga variabel lainnya menetapkan model yang disediakan Kunavo, instalasi tetap utuh, dan setiap sesi dikenai biaya per token dari saldo Anda, bukan melalui langganan.

Dua variabel lingkungan — ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN — mengalihkan Claude Code ke sistem bayar sesuai pemakaian tanpa mengubah instalasi.

# One terminal session
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Pin models Kunavo serves. Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models; the sonnet alias asks for Sonnet 5.5,
# which Kunavo does not serve — unpinned, /model sonnet 404s.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

claude

ANTHROPIC_BASE_URL adalah origin. Claude Code menambahkan /v1/messages sendiri—perintah verifikasi resmi Anthropic adalah curl "$ANTHROPIC_BASE_URL/v1/messages"—jadi nilai yang diakhiri dengan /v1 akan menghasilkan permintaan ke /v1/v1/messages dan respons 404. Inilah penyebab masalah penyiapan yang paling umum; halaman ANTHROPIC_BASE_URL membahas masalah lainnya.

Patok modelnya. Secara bawaan, Claude Code menggunakan Opus terbaru (Opus 5.5 per September 2026, menurut dokumentasi konfigurasi model Anthropic), dan model yang belum disediakan Kunavo akan menghasilkan 404 pada permintaan pertama. Alias sonnet meminta Sonnet 5.5 dan alias haiku meminta Haiku 5.5 (sejak v2.1.293); Kunavo tidak menyediakan keduanya, sehingga /model sonnet, /model haiku dan subagen yang menggunakan alias tersebut menghasilkan 404 kecuali modelnya juga dipatok. ANTHROPIC_MODEL menetapkan model sesi; ANTHROPIC_DEFAULT_OPUS_MODEL mencakup /model opus (Opus 5.5 memerlukan Claude Code v2.1.280 atau lebih baru), ANTHROPIC_DEFAULT_SONNET_MODEL mencakup /model sonnet, dan ANTHROPIC_DEFAULT_HAIKU_MODEL mencakup /model haiku serta panggilan latar belakang. ID apa pun dari GET /v1/models dapat digunakan.

Gunakan ANTHROPIC_AUTH_TOKEN, bukan ANTHROPIC_API_KEY. Kedua variabel tersebut memilih header: AUTH_TOKEN mengirim Authorization: Bearer, API_KEY mengirim x-api-key. Kunavo menerima keduanya, tetapi API_KEY memerlukan perintah persetujuan satu kali dalam sesi interaktif sebelum berlaku, sedangkan AUTH_TOKEN tidak.

Tidak ingin mengedit variabel lingkungan secara manual? CC Switch dapat menyimpan Kunavo sebagai penyedia Claude Code — dengan akar layanan dan kunci bearer yang sama seperti di atas; penyiapan setiap kolom dijelaskan di halaman CC Switch.

Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Claude Code.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Ekspor variabel di atas untuk sesi ini, atau simpan secara permanen di blok env dalam ~/.claude/settings.json: {"env":{"ANTHROPIC_BASE_URL":"https://api.kunavo.com","ANTHROPIC_AUTH_TOKEN":"sk-kn-...","ANTHROPIC_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_OPUS_MODEL":"claude-opus-5-5","ANTHROPIC_DEFAULT_SONNET_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_HAIKU_MODEL":"claude-haiku-4-5"}}. Dokumentasi Anthropic menegaskan bahwa kredensial tidak boleh dimasukkan ke dalam .claude/settings.json proyek—file itu akan di-commit.
Jalankan claude lalu buka tab Status. Baris yang menyebut Auth token mengonfirmasi bahwa kredensial gateway aktif; baris Login method yang menyebut akun claude.ai berarti variabel tersebut tidak terdeteksi.
Untuk ekstensi VS Code, variabel harus dimasukkan ke claudeCode.environmentVariables di pengaturan pengguna VS Code sendiri—ekstensi memeriksa kredensial sebelum diluncurkan, sehingga ~/.claude/settings.json diteruskan ke proses yang dijalankan, tetapi tidak ke pemeriksaan tersebut.

Diperiksa terhadap “Menghubungkan Claude Code ke gateway LLM” dari Anthropic pada 3 Oktober 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Ini versi singkatnya. Panduan lengkap — pilihan model, biaya sesi nyata, dan mode kegagalan — ada di panduan kunci API Claude Code.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Claude Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

ID model	Kunavo masuk / keluar	Kegunaannya di Claude Code
`claude-sonnet-5`	$1.40 / $7.00	model kerja bawaan—ditetapkan dengan /model atau ANTHROPIC_MODEL
`claude-opus-5-5`	$2.80 / $14.00	perencanaan dan penyuntingan tingkat arsitektur
`claude-haiku-4-5`	$0.70 / $3.50	alias haiku dan panggilan latar belakang Claude Code sendiri — patok dengan ANTHROPIC_DEFAULT_HAIKU_MODEL
`claude-fable-5`	$7.00 / $35.00	tingkat tercanggih, untuk rencana yang sepadan dengan biayanya

Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Pertanyaan umum

Bagaimana cara menggunakan Claude Code tanpa langganan Claude?

Tetapkan ANTHROPIC_BASE_URL ke endpoint berformat Anthropic dan ANTHROPIC_AUTH_TOKEN ke kunci endpoint tersebut, lalu tetapkan ANTHROPIC_MODEL ke model yang disediakan endpoint—nilai bawaan Claude Code mungkin tidak tersedia. Claude Code kemudian mengautentikasi ke endpoint, bukan claude.ai, dan penggunaan ditagih per token oleh pemilik kredensial tersebut, bukan melalui paket langganan. Anthropic menyebutnya mode gateway; login claude.ai yang tersimpan tetap berada di disk tanpa digunakan, dan kembali berlaku begitu variabel tersebut dihapus.

Apakah ANTHROPIC_BASE_URL harus menyertakan /v1?

Tidak. Claude Code menambahkan rute sendiri, jadi variabel tersebut berisi origin—https://api.kunavo.com, bukan https://api.kunavo.com/v1. Perintah verifikasi resmi Anthropic adalah curl "$ANTHROPIC_BASE_URL/v1/messages", yang menunjukkan penggabungan itu secara langsung. URL dasar yang sudah diakhiri /v1 akan mengirim permintaan ke /v1/v1/messages dan menghasilkan 404.

Apa perbedaan ANTHROPIC_AUTH_TOKEN dan ANTHROPIC_API_KEY?

Kredensial tersebut menempatkan nilainya di header HTTP yang berbeda: ANTHROPIC_AUTH_TOKEN mengirim Authorization: Bearer, sedangkan ANTHROPIC_API_KEY mengirim x-api-key. Jika kunci dimasukkan ke variabel yang salah, kunci itu akan sampai ke endpoint di header yang tidak dibaca, sehingga permintaan gagal dengan 401. Jika dokumentasi gateway menyebut "bearer token", gunakan ANTHROPIC_AUTH_TOKEN; jika menyebut "API key" atau "x-api-key", gunakan ANTHROPIC_API_KEY.

Fitur Claude Code apa yang berhenti berfungsi di balik URL dasar khusus?

Remote Control dan dikte suara memerlukan identitas claude.ai dan tidak tersedia selama kredensial gateway ditetapkan; Remote Control juga dinonaktifkan setiap kali ANTHROPIC_BASE_URL mengarah ke host non-Anthropic. Pemeriksaan ketersediaan mode cepat juga langsung mengakses api.anthropic.com, alih-alih mengikuti URL dasar. Semua yang ada di loop inti—agen, alat, subagen, server MCP—berjalan melalui Messages API dan tidak terpengaruh.