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

发布时间2026年8月30日 09:08
语言id

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 Model	Entri Situs (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

Gejala	Penanganan
401 / 403	Kunci tidak valid, belum diaktifkan, atau saldo tidak cukup; pastikan `sk-` sudah benar dan lakukan isi ulang.
404 / Model tidak tersedia	Nama model tidak sesuai dengan slug platform, atau model belum diaktifkan; periksa ID model.
Unknown model	ID model harus akurat (termasuk huruf besar/kecil), periksa di marketplace model.
Permintaan timeout	Untuk 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".