ai2saveai2save

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

  1. Buka https://ai2save.com/keys.
  2. Klik "Create Key", isi dalam nama, dan pilih sebuah grup yang termasuk model Claude.
  3. 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:

  1. Masukkan pertanyaan singkat, seperti "Halo, perkenalkan dirimu"
  2. Jika isi dikembalikan secara normal, mengindikasikan bahwa alamat, kunci, dan grup model tersambung.
  3. 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, atau ANTHROPIC_API_KEY tidak 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/v1 akan menyebabkan kesalahan; Claude Kode harus diisi sebagai https://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.