Panduan konfigurasi Claude Code
Claude Code menggunakan protokol Pesan Anthropic. Ketika menghubungkan ke ai2save, masukkan alamat root situs https://ai2save.com, jangan tambahkan secara manual /v1; gunakan sk-... dibuat dalam konsol ai2save sebagai kunci.
1. Siapkan kunci API
- Buka https://ai2save.com/keys.
- Klik "Create Key", isi dalam nama, dan pilih sebuah grup yang termasuk model Claude.
- Salin kunci lengkap segera setelah pembuatan. Kunci komplit hanya ditampilkan sekali.
2. Instal Claude Code
Pertama selesaikan pengaturan lingkungan Node.js, kemudian jalankan:
npm install -g @anthropic-ai/claude-code
claude --version
Jika versi lebih rendah dari persyaratan gateway, upgrade seperti yang diminta:
npm update -g @anthropic-ai/claude-code
3. Aktifkan sementara di terminal saat ini
MacOS / Linux / WSL:
export ANTHROPIC_BASE_URL="https://ai2save.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
claude
Windows PowerShell:
$env:ANTHROPIC_BASE_URL="https://ai2save.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
claude
ANTHROPIC_AUTH_TOKEN adalah variabel khusus untuk kunci stasiun transit. Jangan diset ANTHROPIC_API_KEY ke kunci resmi lainnya pada saat yang sama, untuk menghindari pembacaan kredensial Claude Code yang salah.
4. Tulis ke file konfigurasi Claude Code (disarankan)
Edit ~/.claude/settings.json (Pada Windows, biasanya di %USERPROFILE%\.claude\settings.json):
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_BASE_URL": "https://ai2save.com",
"ANTHROPIC_AUTH_TOKEN": "sk-your-api-key"
}
}
Setelah menyimpan, membuka kembali terminal dan mulai claude. Jika Anda hanya ingin mengambil efek untuk proyek tertentu, tulis isi yang sama ke .claude/settings.local.json dalam projek, dan jangan kirim Kunci sebenarnya ke Git.
5. Pilih model dan verifikasi
claude --model claude-sonnet-4-6
Setelah memasuki antarmuka interaktif:
- Masukkan pertanyaan singkat, seperti "Halo, perkenalkan dirimu"
- Jika isi dikembalikan secara normal, mengindikasikan bahwa alamat, kunci, dan grup model tersambung.
- Untuk menukar model, gunakan
/model, dan ID model harus cocok dengan ID yang dibuka dalam konsol.
Anda juga dapat menggunakan built-in diagnostik Claude Code untuk memeriksa status konfigurasi:
/status
/doctor
6. Beberapa konfigurasi dan pembersihan konfigurasi lama
Jika Anda sebelumnya masuk ke stasiun relay resmi Claude atau terminal relay lainnya:
- Prioritas memakai CC Switch untuk mengelola beberapa vendor untuk menghindari konfigurasi salah manual.
- Ketika menata secara manual, pastikan bahwa lama
ANTHROPIC_BASE_URL,ANTHROPIC_AUTH_TOKEN, atauANTHROPIC_API_KEYtidak memaksa nilai saat ini. - WSL dan Windows adalah dua lingkungan yang terpisah; setelah menata di terminal Windows, WSl juga perlu dikonfigurasi secara terpisah.
pembersihan sementara makOS / Linux:
unset ANTHROPIC_API_KEY
Kesalahan umum
- 401 / invalid _ api _ key: Kunci tidak sepenuhnya disalin, telah dicabut, atau grup tidak termasuk model saat ini.
- 404 / model tidak ditemukan: ID model salah, atau grup kunci belum mengaktifkan model ini.
- Koneksi gagal: Menulis URL Dasar sebagai
https://ai2save.com/v1akan menyebabkan kesalahan; Claude Kode harus diisi sebagaihttps://ai2save.com. - Masih mencoba untuk meminta alamat resmi: Periksa apakah alamat lama tetap dalam
~/.claude/settings.json, projek.claude/settings.local.json, atau variabel lingkungan terminal. - Jendela tidak berlaku setelah dibuka: Keluar dari terminal, VS Code, atau Claude Desktop, lalu buka kembali.