Cara Memakai Claude Code dengan Hostlinku: Base URL, Auth Token, dan Pemetaan Model

Claude Code berbicara protokol Anthropic Messages. Hostlinku menyediakan endpoint yang kompatibel di POST /v1/messages (termasuk /v1/messages/count_tokens), sehingga Claude Code bisa diarahkan ke Hostlinku hanya dengan environment variable — tidak perlu proxy atau plugin.

1. Instal dan bersihkan login lama

npm install -g @anthropic-ai/claude-code
# atau: curl -fsSL https://claude.ai/install.sh | bash

Kalau sebelumnya kamu pernah login dengan akun Anthropic, jalankan claude lalu ketik /logout. Kredensial OAuth yang tersimpan bisa mendahului konfigurasi gateway.

2. Arahkan ke Hostlinku

Perhatikan bahwa base URL untuk protokol Anthropic adalah https://api.hostlinku.com — tanpa /v1, karena Claude Code menambahkan path-nya sendiri.

export ANTHROPIC_BASE_URL=https://api.hostlinku.com
export ANTHROPIC_AUTH_TOKEN=sk-isi-api-key-kamu

# Pin model untuk alias yang dipakai Claude Code
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Untuk konfigurasi yang persisten, taruh nilai yang sama di blok env pada ~/.claude/settings.json. Nilai di settings.json mengalahkan export shell.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hostlinku.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-isi-api-key-kamu",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6"
  }
}

3. Verifikasi

Di dalam sesi Claude Code, ketik /status. Bagian API harus menampilkan base URL https://api.hostlinku.com. Kirim satu prompt sederhana, lalu cek request-nya muncul di console → Log Permintaan lengkap dengan token, biaya, dan latensi.

4. Pakai model selain Claude

Karena gateway menerjemahkan protokol, alias Claude Code bisa dipetakan ke model lain di katalog. Untuk sekali jalan:

claude --model deepseek-v4-flash
# atau pin default lewat env:
export ANTHROPIC_MODEL=gpt-5-5

Claude Code sudah memasang cache_control sendiri pada system prompt dan definisi tools, sehingga sesi panjang otomatis menikmati tarif cache read. Panduan lengkap — termasuk troubleshooting — ada di docs integrasi Claude Code.