Claude Code - Hostlinku Docs

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 cukup dengan environment variable — tidak perlu proxy tambahan.

Autentikasi: `AUTH_TOKEN` atau `API_KEY`?

Variabel	Header yang dikirim	Didukung Hostlinku
`ANTHROPIC_AUTH_TOKEN`	`Authorization: Bearer sk-…`	Ya (disarankan)
`ANTHROPIC_API_KEY`	`x-api-key: sk-…`	Ya

Keduanya diterima gateway; pilih salah satu, jangan isi dua-duanya dengan nilai berbeda.

Ekstensi VS Code & JetBrains

Ekstensi Claude Code memeriksa login sendiri, jadi variabel yang sama harus diisi juga di setting ekstensi — VS Code: claudeCode.environmentVariables di settings.json:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.hostlinku.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-isi-api-key-kamu" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-4-6" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

Di JetBrains, isi variabel yang sama di Settings → Tools → Claude Code → Environment variables (atau pastikan IDE dijalankan dari shell yang sudah meng-export variabel tersebut).

Pakai model non-Claude

Karena gateway menerjemahkan protokol, alias sonnet/haiku bisa diisi slug apa pun dari katalog:

export ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash

Fitur yang bergantung pada kemampuan model (tool use, extended thinking, vision) mengikuti kapabilitas model tujuan — cek field capabilities di katalog.

Troubleshooting

401 authentication_error padahal key benar — kredensial OAuth lama masih dipakai. Jalankan /logout, tutup sesi, pastikan ANTHROPIC_BASE_URL terbaca (/status).
Model tidak ditemukan (404) — alias belum di-pin, sehingga Claude Code mengirim nama model bawaannya. Isi ANTHROPIC_DEFAULT_*_MODEL dengan slug dari katalog.
400 max_tokens melebihi batas — turunkan max_tokens lewat CLAUDE_CODE_MAX_OUTPUT_TOKENS (mis. 32000) bila model tujuan punya batas output lebih kecil.
Rate limit (429) — Claude Code dapat menjalankan beberapa sub-agent paralel. Lihat batas di Pemakaian & Limit.

​Autentikasi: AUTH_TOKEN atau API_KEY?

​Ekstensi VS Code & JetBrains

​Pakai model non-Claude

​Troubleshooting

Autentikasi: `AUTH_TOKEN` atau `API_KEY`?

Ekstensi VS Code & JetBrains

Pakai model non-Claude

Troubleshooting