AZZ API

Tutorial Integrasi Relay Claude Code: Proxy Terminal dan Konfigurasi Base URL

Tutorial integrasi Claude Code, agen coding terminal resmi dari Anthropic: instalasi, pengaturan ANTHROPIC_BASE_URL dan kunci, pergantian model, serta pemecahan masalah umum.

I. Apa itu Claude Code

Claude Code adalah agen coding terminal (CLI) resmi dari Anthropic yang memungkinkan Anda membaca dan menulis kode, menjalankan perintah, serta mengeksekusi tugas langsung di dalam terminal. Alat ini secara native membaca variabel lingkungan seperti ANTHROPIC_BASE_URL dan ANTHROPIC_API_KEY, sehingga memudahkan Anda untuk mengarahkannya ke gateway relay dan menjalankan tugas menggunakan kunci serta saldo Anda sendiri.

II. Instalasi Claude Code

Memerlukan Node.js (versi 18 ke atas disarankan oleh pihak resmi), lalu instal secara global:

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

Setelah instalasi, ketik claude di terminal untuk memulai; 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-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-anda"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude

Catatan: ANTHROPIC_API_KEY akan disertakan sebagai header permintaan, dan ANTHROPIC_BASE_URL digunakan untuk menimpa endpoint API default, cukup arahkan ke entri Anthropic situs ini.

IV. Referensi Alamat Interface

Grup ModelEntri Situs (Base URL)Protokol
Claude / Anthropichttps://www.relay-api.comAnthropic Messages
GPT / OpenAIhttps://www.relay-api.com/v1OpenAI Chat Completions
Geminihttps://www.relay-api.com/v1betaGoogle generateContent

V. Pemecahan Masalah Umum

GejalaPenanganan
401 / 403Kunci tidak valid, belum diaktifkan, atau saldo tidak cukup; pastikan sk- sudah benar dan lakukan isi ulang.
404 / Model tidak tersediaNama model tidak sesuai dengan slug platform, atau model belum diaktifkan; periksa ID model.
Unknown modelID model harus akurat (termasuk huruf besar/kecil), periksa di marketplace model.
Permintaan timeoutUntuk tugas yang lebih lama, Anda bisa meningkatkan batas timeout; coba lagi jika terjadi gangguan jaringan.

Saran Keamanan: Jangan tuliskan kunci di repositori publik, gunakan .env atau variabel lingkungan; tugas berbasis pembuatan kode memakan banyak token, perhatikan saldo Anda, dan periksa setiap panggilan di "Log Penggunaan".