API Hop

Documentazione

Documentazione API Hop

Integrazione Claude Code

Usa l’endpoint compatibile con Claude Messages di RequestBeam in Claude Code.

Claude Code chiama i modelli tramite il protocollo Anthropic Messages. Imposta ANTHROPIC_BASE_URL sull’URL di base compatibile con Anthropic mostrato in questa pagina.

Claude Sonnet 4.6 (claude-sonnet-4-6) è supportato dal fornitore a monte, ma non è attualmente pubblicato su RequestBeam. Non è il modello predefinito di un’integrazione attiva. Prima di chiamare qualsiasi modello, verifica l’accesso con la tua risposta di GET https://api.apihop.ai/v1/models.

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

Prerequisiti

Prepara prima una chiave API RequestBeam valida. Verrà scritta nell’ambiente della shell locale. Non inserirla in repository, registri o schermate.

Installare Claude Code

Su macOS / Linux usa il programma di installazione nativo di Claude Code:

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

Se il programma di installazione indica ~/.local/bin/claude ma claude non viene trovato, apri un nuovo terminale o aggiungi ~/.local/bin a PATH.

Per i flussi di lavoro precedenti, il pacchetto npm è ancora disponibile:

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

Non usare sudo npm install -g @anthropic-ai/claude-code; può causare problemi di permessi negli aggiornamenti successivi.

Verifica la CLI dopo l’installazione:

bash
claude --version
claude doctor

Su Windows si consiglia Git Bash o WSL per Claude Code. Anche PowerShell può impostare variabili d’ambiente, ma la persistenza varia in base al terminale.

Configurare le variabili d’ambiente

Le impostazioni temporanee influiscono solo sulla sessione corrente del terminale:

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

macOS usa zsh per impostazione predefinita. Per una configurazione persistente, scrivi le variabili in ~/.zshrc, poi esegui source ~/.zshrc affinché il terminale corrente le legga subito:

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

source ~/.zshrc

Su Linux con bash, scrivi le stesse variabili in ~/.bashrc ed esegui source ~/.bashrc.

Impostazioni temporanee di Windows PowerShell:

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

Persistenza a livello utente in PowerShell:

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_REQUESTBEAM_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")

Apri una nuova sessione PowerShell prima di eseguire claude.

File di impostazioni

In alternativa alla configurazione della shell, crea o modifica ~/.claude/settings.json. Se il file esiste già, unisci env e model al JSON esistente senza sostituire le altre impostazioni:

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

Modelli disponibili:

  • 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

Usa GET https://api.apihop.ai/v1/models per vedere i modelli attualmente disponibili per la tua chiave API.

Avvio e test

Riavvia Claude Code dopo aver impostato le variabili d’ambiente, quindi invia un normale prompt:

bash
claude "Reply exactly OK."

Puoi anche avviare la modalità interattiva:

bash
claude

Al primo avvio, Claude Code può chiedere un tema, una conferma di sicurezza, la configurazione del terminale o se considerare attendibile la directory corrente. Segui le indicazioni del terminale.

Selezionare un modello

Imposta un modello predefinito con la variabile d’ambiente, oppure scegline uno per un singolo comando con --model:

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

Comportamento dell’endpoint

Claude Code si autentica con la chiave API RequestBeam configurata. Il servizio accetta entrambe le forme di autenticazione:

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

Le risposte mantengono il formato nativo JSON o di eventi SSE di Anthropic Messages. Non vengono convertite nel formato OpenAI.

Risoluzione dei problemi

  • ANTHROPIC_BASE_URL deve essere l’URL di base dell’API pubblica mostrato in questa pagina più /anthropic.
  • Non includere percorsi di endpoint in ANTHROPIC_BASE_URL; serve solo l’URL di base compatibile con Anthropic.
  • Dopo aver modificato ~/.zshrc su macOS, esegui source ~/.zshrc o apri un nuovo terminale prima di avviare Claude Code.
  • Se claude restituisce comando non trovato, verifica che il percorso di installazione sia in PATH; un percorso comune è ~/.local/bin/claude.
  • Se claude doctor segnala variabili d’ambiente mancanti, esegui echo $ANTHROPIC_BASE_URL ed echo $ANTHROPIC_MODEL nello stesso terminale per confermare il caricamento.
  • Se ricevi 401, verifica che la chiave API sia valida.
  • Se il modello non è disponibile, verifica che il suo nome provenga dall’elenco dei modelli disponibili sopra.
  • Riavvia il processo Claude Code dopo aver modificato le variabili d’ambiente.
  • POST https://api.apihop.ai/anthropic/v1/messages: endpoint compatibile con Anthropic Messages.