Cara menyiapkan Claude Code dengan apmix dalam dua menit

Claude Code adalah agen coding dari Anthropic untuk terminal: ia membaca repositori Anda, mengedit file, menjalankan perintah, dan menulis tes. Ia berbicara dengan API Anthropic, dan apmix menyediakan API yang sama. Jadi Anda bisa menjalankan Claude Code dengan kunci apmix, memakai model Claude di paket Anda dan satu kuota bulanan, tanpa tagihan Anthropic terpisah.

Panduan ini butuh sekitar dua menit. Anda memerlukan akun apmix dengan kunci API (buat di dasbor) dan Node.js 18 atau lebih baru.

1. Instal Claude Code#

Lewati langkah ini jika claude sudah berjalan di komputer Anda.

npm install -g @anthropic-ai/claude-code

2. Arahkan ke apmix#

Claude Code membaca tiga variabel lingkungan. Karena memakai protokol Anthropic, Base URL-nya adalah https://api.apmix.ai tanpa /v1; Claude Code menambahkan path-nya sendiri.

Di macOS atau Linux:

export ANTHROPIC_BASE_URL="https://api.apmix.ai"
export ANTHROPIC_AUTH_TOKEN="apx_live_YOUR_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

Di Windows, dengan PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.apmix.ai"
$env:ANTHROPIC_AUTH_TOKEN = "apx_live_YOUR_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"

Nilai ini hanya berlaku di terminal saat ini. Pas untuk percobaan pertama; langkah berikutnya membuatnya permanen.

3. Simpan secara permanen#

Claude Code juga membaca pengaturannya dari ~/.claude/settings.json. Masukkan nilai yang sama ke blok env, dan setiap terminal baru langsung siap:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apmix.ai",
    "ANTHROPIC_AUTH_TOKEN": "apx_live_YOUR_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

Dokumentasi menyediakan skrip satu baris untuk PowerShell dan bash yang menulis file ini untuk Anda dan mencadangkan file lama.

4. Jalankan#

Buka proyek Anda dan jalankan Claude Code:

cd your-project
claude

Selesai: kini setiap permintaan melewati apmix dan dihitung dari kuota paket Anda.

Ganti model dengan /model#

Di dalam Claude Code, ketik /model untuk mengganti model sesi itu, dengan ID Claude mana pun dari katalog:

Setiap model punya pengali token berbobot sendiri, tercantum di halaman harga. Dengan model yang lebih ringan untuk pekerjaan rutin, kuota yang sama bertahan jauh lebih lama; baca penjelasan token berbobot.

Periksa apakah kunci berfungsi#

Jika ada yang tidak beres, tampilkan daftar model yang bisa dijangkau kunci Anda. Jika muncul daftar JSON, kunci dan URL sudah benar:

curl https://api.apmix.ai/v1/models -H "Authorization: Bearer apx_live_YOUR_KEY"

Respons yang paling umum dan cara mengatasinya:

• 401 invalid_api_key: kunci salah atau sudah dihapus. Salin ulang dari Dashboard → Kunci API.
• 403 model_not_in_plan: model itu di atas paket Anda. GET /v1/models hanya menampilkan model yang bisa dipakai paket Anda; pilih salah satunya atau upgrade.
• 429 rate_limit_exceeded: lebih dari 60 permintaan per menit di satu kunci (120 di Max). Tunggu sesuai detik di retry-after.

Setiap error dijelaskan di referensi error, dan setiap respons membawa header x-apmix-request-id yang bisa Anda sertakan saat menghubungi dukungan.

Pantau pemakaian#

Agen itu rakus: satu sesi Claude Code yang panjang bisa mengirim jutaan token. Tiga hal ini membantu:

1. Pantau Dashboard → Log, yang menampilkan setiap permintaan secara langsung dengan model, token, dan biayanya.
2. Atur batas harian atau mingguan opsional di Pengaturan, supaya sesi yang lepas kendali tidak menghabiskan kuota sebulan.
3. Aktifkan email peringatan di 50, 70, 80, atau 90% kuota Anda.

Dengan itu, Claude Code di apmix terasa persis seperti Claude Code, dengan satu kunci dan satu tagihan untuk semua hal lain yang Anda jalankan.