Claude Code adalah coding agent resmi Anthropic yang jalan di terminal. Secara default ia bicara ke API Anthropic, tapi setelan koneksinya bisa diganti lewat file settings.json ke endpoint lain yang mendukung format Anthropic.
Gateway Appverse berjalan di atas LiteLLM yang menyediakan endpoint format Anthropic di /v1/messages. Bila format itu ternyata tidak aktif di deployment kamu, bagian troubleshooting di bawah menunjukkan jalur alternatif yang pasti jalan.
Sebelum mulai
- Paket AI Gateway aktif (Token Plan atau Pay As You Go). Belum punya? Pilih paket dulu di sini.
- API key aktif dari dashboard gateway.
- Claude Code sudah terinstal. Belum? Jalankan npm install -g @anthropic-ai/claude-code.
- Satu Model ID dari tabel harga model.
Langkah integrasi
- 1
Isi base URL dan API key di settings.json
Claude Code membaca setelan koneksi dari file ~/.claude/settings.json. Isi dua nilai di blok env: ANTHROPIC_BASE_URL untuk alamat gateway dan ANTHROPIC_AUTH_TOKEN untuk API key kamu.
Perhatikan base URL-nya tanpa /v1. Claude Code menambahkan path format Anthropic sendiri di belakang base URL, jadi jika kamu menulis /v1 secara manual, path akhirnya jadi dobel.
~/.claude/settings.json { "env": { "ANTHROPIC_BASE_URL": "https://ai.appverse.id", "ANTHROPIC_AUTH_TOKEN": "API_KEY_KAMU" } } - 2
Jalankan Claude Code
Buka terminal di folder project kamu, lalu jalankan claude. Setelan dari settings.json terbaca otomatis tanpa perlu perintah tambahan.
Kalau kamu sebelumnya memakai Claude Code dengan login Anthropic, jalankan /logout dulu supaya sesi ini memakai token gateway, bukan akun lama.
- 3
Pilih model dari gateway
Di dalam Claude Code, buka /model untuk berganti model. Isi dengan Model ID dari gateway, bukan nama tampilannya.
Kamu juga bisa menetapkan model default dengan menambahkan ANTHROPIC_MODEL di blok env settings.json.
Blok env di ~/.claude/settings.json "env": { "ANTHROPIC_BASE_URL": "https://ai.appverse.id", "ANTHROPIC_AUTH_TOKEN": "API_KEY_KAMU", "ANTHROPIC_MODEL": "MODEL_ID_DARI_DASHBOARD" } - 4
Uji koneksi dan bila gagal
Kirim satu prompt pendek. Respons keluar berarti koneksi lewat gateway sudah aktif dan pemakaian token tercatat di dashboard.
Bila muncul error 404 atau endpoint /v1/messages tidak ditemukan, format Anthropic belum tersedia di gateway kamu. Semua integrasi berbasis OpenAI-compatible tetap jalan normal, jadi pakai panduan OpenCode, Cline, atau Aider di halaman integrasi ini.
Tips pemakaian
- ANTHROPIC_BASE_URL ditulis tanpa /v1, sedangkan semua agent OpenAI-compatible memakai base URL dengan /v1. Beda satu potongan path ini adalah sumber error paling sering.
- settings.json di home berlaku untuk semua project. Bila kamu butuh model berbeda per project, tambahkan file .claude/settings.json di folder project itu dan isi blok env dengan nilai yang berbeda.
- Biaya mengikuti harga per 1 juta token di tabel gateway, bukan tarif langganan Anthropic. Cek tabel harga sebelum memakai model besar untuk task panjang.
Pertanyaan yang sering muncul
Kenapa base URL Claude Code tanpa /v1?
Claude Code menyusun path Anthropic sendiri (misalnya /v1/messages) di belakang base URL. Menambahkan /v1 manual membuat path akhir dobel dan request gagal.
Apakah saya masih butuh akun atau API key Anthropic?
Tidak untuk jalur ini. Autentikasi memakai API key gateway lewat ANTHROPIC_AUTH_TOKEN, dan tagihannya mengikuti paket saldo atau Token Plan Appverse.
Apakah prompt dan kode saya disimpan di gateway?
Tidak. Gateway menerapkan ZDR (Zero Data Retention): prompt dan response tidak disimpan, tidak dibaca, dan tidak dipakai untuk training.
Muncul error endpoint tidak ditemukan. Solusi cepatnya?
Format Anthropic Messages belum aktif di gateway kamu. Gunakan integrasi OpenAI-compatible seperti OpenCode, Cline, atau Aider yang jalurnya sudah pasti dilayani di /v1/chat/completions.