Tutorial Konfigurasi Kode Claude

📋 Langkah-Langkah Persiapan

Sebelum memulai, pastikan Anda telah:

Mendaftarkan akun Koze dan masuk
Membuat Kunci API di halaman Manajemen API
Menginstal Claude Code (npm install -g @anthropic-ai/claude-code)

🚀 Langkah 1: Mengatur Variabel Lingkungan

Jalankan perintah berikut di terminal untuk mengatur alamat dan kunci API sebagai variabel lingkungan:

# Atur alamat proxy Koze ke URL Dasar
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'

# Atur Kunci API yang Anda buat di backend Koze
export ANTHROPIC_AUTH_TOKEN="Kunci API Anda"

💡 Tips: Ganti https://api.kozeai.com dengan domain layanan Anda yang sebenarnya. Kunci API dapat dilihat atau dibuat di halaman "Manajemen API → Kunci yang Ada".

🔧 Langkah Kedua: Konfigurasi Plugin VSCode (Opsional)

Jika Anda menggunakan plugin Claude untuk VSCode, Anda perlu mengkonfigurasinya di `~/.claude/config.json`:

{

"primaryApiKey": "Kunci API Anda",

"apiBaseUrl": "https://api.kozeai.com/v1"

}

Jika file tersebut tidak ada, silakan buat secara manual.

macOS / Linux: ~/.claude/config.json
Windows: C:\Users\Your Username\.claude\config.json

🎯 Langkah 3: Jalankan Claude Code

Setelah mengkonfigurasi variabel lingkungan, jalankan langsung di terminal:

claude

Claude Code akan secara otomatis menggunakan alamat proxy Koze yang telah Anda konfigurasi untuk melakukan permintaan.

📌 Variabel Lingkungan Permanen

Untuk menghindari pengaturan ulang variabel setiap kali Anda membuka terminal, disarankan untuk menulis variabel ke file konfigurasi shell:

# Pengguna Bash

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc

echo 'export ANTHROPIC_AUTH_TOKEN='kunci API Anda' >>> ~/.bashrc

source ~/.bashrc

# Pengguna Zsh

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN='kunci API Anda' >> ~/.zshrc

source ~/.zshrc

✅ Verifikasi Koneksi

Setelah menjalankan Claude Code, jika Anda melihat antarmuka dialog normal, konfigurasi berhasil.

Anda dapat melihat catatan panggilan secara real-time di halaman "Statistik Penggunaan" Koze.

⚠️ Pertanyaan yang Sering Diajukan

Masalah	Solusi
Tips: Kunci API Tidak Valid	Periksa apakah Kunci API telah disalin dengan benar, pastikan tidak ada spasi tambahan
Waktu Habis Koneksi	Konfirmasi apakah URL Dasar sudah benar dan berisi akhiran `/v1`
Model Tidak Tersedia	Periksa daftar model yang tersedia untuk paket saat ini di Lobi Model Koze