API Hop

Dokumentasi

Dokumentasi API Hop

Integrasi Claude Code

Gunakan endpoint kompatibel Claude Messages API Hop di Claude Code.

Claude Code memanggil model melalui protokol Anthropic Messages. Atur ANTHROPIC_BASE_URL ke URL Dasar kompatibel Anthropic yang ditampilkan di halaman ini.

Claude Sonnet 4.6 (claude-sonnet-4-6) didukung penyedia hulu tetapi saat ini tidak dipublikasikan di API Hop. Model ini bukan pilihan integrasi bawaan yang aktif. Sebelum memanggil model apa pun, pastikan akses melalui respons GET https://api.apihop.ai/v1/models Anda sendiri.

text
ANTHROPIC_BASE_URL=https://api.apihop.ai/anthropic

Prasyarat

Siapkan API Key API Hop yang valid terlebih dahulu. Kunci akan ditulis ke lingkungan shell lokal Anda. Jangan memasukkannya ke repositori, log, atau tangkapan layar.

Instal Claude Code

Di macOS / Linux, gunakan penginstal native Claude Code:

bash
curl -fsSL https://claude.ai/install.sh | bash

Jika penginstal melaporkan ~/.local/bin/claude tetapi claude tidak ditemukan, buka terminal baru atau tambahkan ~/.local/bin ke PATH.

Untuk alur kerja lama, paket npm masih tersedia:

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

Jangan gunakan sudo npm install -g @anthropic-ai/claude-code; ini dapat menimbulkan masalah izin untuk pembaruan berikutnya.

Verifikasi CLI setelah penginstalan:

bash
claude --version
claude doctor

Di Windows, Git Bash atau WSL direkomendasikan untuk Claude Code. PowerShell juga dapat mengatur variabel lingkungan, tetapi persistensinya berbeda menurut terminal.

Konfigurasikan Variabel Lingkungan

Pengaturan sementara hanya memengaruhi sesi terminal saat ini:

bash
export ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-5-5"

macOS menggunakan zsh secara bawaan. Untuk konfigurasi persisten, tulis variabel ke ~/.zshrc, lalu jalankan source ~/.zshrc agar terminal saat ini segera membacanya:

bash
printf '%s\n' \
  'export ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"' \
  'export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"' \
  'export ANTHROPIC_MODEL="claude-sonnet-5-5"' \
  >> ~/.zshrc

source ~/.zshrc

Di Linux dengan bash, tulis variabel yang sama ke ~/.bashrc dan jalankan source ~/.bashrc.

Pengaturan sementara Windows PowerShell:

powershell
$env:ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"

Persistensi tingkat pengguna PowerShell:

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_APIHOP_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apihop.ai/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5-5", "User")

Buka sesi PowerShell baru sebelum menjalankan claude.

File Pengaturan

Sebagai alternatif konfigurasi shell, buat atau sunting ~/.claude/settings.json. Jika file sudah ada, gabungkan env dan model ke JSON yang ada alih-alih mengganti pengaturan lain:

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_APIHOP_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.apihop.ai/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  },
  "model": "claude-sonnet-5-5"
}

Model yang tersedia:

  • claude-fable-5
  • claude-fable-5-1
  • claude-opus-4-6
  • claude-opus-4-7
  • claude-opus-4-8
  • claude-opus-5
  • claude-opus-5-5
  • claude-sonnet-5
  • claude-sonnet-5-5

Gunakan GET https://api.apihop.ai/v1/models untuk model yang saat ini tersedia bagi API Key Anda.

Jalankan dan Uji

Mulai ulang Claude Code setelah mengatur variabel lingkungan, lalu kirim prompt biasa:

bash
claude "Reply exactly OK."

Anda juga dapat memulai mode interaktif:

bash
claude

Saat pertama dijalankan, Claude Code mungkin meminta tema, konfirmasi keamanan, pengaturan terminal, atau keputusan untuk memercayai direktori saat ini. Ikuti petunjuk terminal.

Pilih Model

Atur model bawaan dengan variabel lingkungan, atau pilih model untuk satu perintah dengan --model:

bash
claude --model claude-sonnet-5-5 "Review this PR"

Perilaku Endpoint

Claude Code melakukan autentikasi dengan API Key API Hop yang dikonfigurasi. Layanan menerima salah satu bentuk autentikasi:

http
x-api-key: YOUR_APIHOP_API_KEY
anthropic-version: 2023-06-01
http
Authorization: Bearer YOUR_APIHOP_API_KEY
anthropic-version: 2023-06-01

Respons mempertahankan format JSON native Anthropic Messages atau peristiwa SSE. Respons tidak dikonversi ke format OpenAI.

Pemecahan Masalah

  • ANTHROPIC_BASE_URL harus berupa URL Dasar API publik yang ditampilkan di halaman ini ditambah /anthropic.
  • Jangan sertakan jalur endpoint dalam ANTHROPIC_BASE_URL; hanya URL dasar kompatibel Anthropic yang diperlukan.
  • Setelah menyunting ~/.zshrc di macOS, jalankan source ~/.zshrc atau buka terminal baru sebelum memulai Claude Code.
  • Jika claude mengembalikan perintah tidak ditemukan, pastikan lokasi instalasi ada di PATH; lokasi yang umum adalah ~/.local/bin/claude.
  • Jika claude doctor melaporkan variabel lingkungan tidak ada, jalankan echo $ANTHROPIC_BASE_URL dan echo $ANTHROPIC_MODEL di terminal yang sama untuk memastikan variabel sudah dimuat.
  • Jika menerima 401, pastikan API Key valid.
  • Jika model tidak tersedia, pastikan nama model berasal dari daftar model tersedia di atas.
  • Mulai ulang proses Claude Code setelah mengubah variabel lingkungan.
  • POST https://api.apihop.ai/anthropic/v1/messages: endpoint kompatibel Anthropic Messages.