Tutorial Integrasi Claude Code dengan Gateway: Konfigurasi Terminal dan Base URL

I. Apa itu Claude Code

Claude Code adalah agen pengodean terminal (CLI) resmi dari Anthropic yang memungkinkan Anda membaca dan menulis kode, menjalankan perintah, serta mengeksekusi tugas langsung dari terminal. Karena secara native membaca variabel lingkungan seperti ANTHROPIC_BASE_URL dan ANTHROPIC_API_KEY, alat ini dapat dengan mudah diarahkan ke gateway perantara menggunakan kunci API dan saldo Anda sendiri.

II. Instalasi Claude Code

Membutuhkan Node.js (disarankan versi 18 ke atas). Anda dapat menginstalnya secara global dengan:

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

Setelah terinstal, jalankan dengan mengetik claude di terminal; gunakan /model atau claude --model … untuk beralih model.

III. Konfigurasi Variabel Lingkungan

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL="https://www.relay-api.com"
$env:ANTHROPIC_API_KEY="sk-kunci-api-anda"
$env:ANTHROPIC_MODEL="claude-sonnet-5"
claude

macOS / Linux (bash / zsh)

export ANTHROPIC_BASE_URL="https://www.relay-api.com"
export ANTHROPIC_API_KEY="sk-kunci-api-anda"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude

Catatan: ANTHROPIC_API_KEY akan disertakan dalam header permintaan, dan ANTHROPIC_BASE_URL digunakan untuk menimpa endpoint API default guna mengarahkannya ke gateway Anthropic situs ini.

IV. Referensi Alamat API

Grup Model	Alamat Entry (Base URL)	Protokol
Claude / Anthropic	https://www.relay-api.com	Anthropic Messages
GPT / OpenAI	https://www.relay-api.com/v1	OpenAI Chat Completions
Gemini	https://www.relay-api.com/v1beta	Google generateContent

V. Pemecahan Masalah Umum

Masalah	Solusi
401 / 403	Kunci tidak valid, belum diaktifkan, atau saldo tidak cukup; pastikan sk- sudah benar dan lakukan pengisian ulang.
404 / Model tidak tersedia	Nama model tidak cocok dengan slug platform atau model belum diaktifkan; verifikasi ID model.
Unknown model	ID model harus tepat (perhatikan huruf besar/kecil); cek di daftar model.
Request timeout	Tingkatkan durasi timeout untuk tugas yang lebih panjang; coba lagi jika terjadi gangguan jaringan.

Saran Keamanan: Jangan membagikan kunci API di repositori publik, gunakan .env atau variabel lingkungan. Tugas pembuatan kode dapat mengonsumsi banyak token, pantau saldo Anda dan cek setiap panggilan di "Log Penggunaan".

Catatan Base URL: Situs ini menerima /v1beta/models/... maupun /v1beta/v1beta/models/... (serta /v1/... dan /v1/v1/...), jadi tidak masalah apakah klien Anda menambahkan /v1 atau /v1beta secara otomatis: Anda dapat mengisi Base URL dengan domain root atau alamat yang menyertakan /v1beta. Silakan cari dan salin ID model di bagian "ID Model" di pojok kanan atas halaman "Token" pada dasbor.