Risorse per sviluppatori

Claude Code

Installa Claude Code, connettilo a RunAPI, scegli un modello e verifica la configurazione.

Panoramica

Claude Code è uno strumento di codifica agentivo per il terminale. Questa guida installa la CLI, indirizza le sue richieste compatibili con Anthropic verso RunAPI, seleziona un modello RunAPI e verifica la connessione.

Prima di iniziare

Usa una piattaforma supportata dalla guida ufficiale di configurazione di Claude Code.
Crea una Chiave API RunAPI standard seguendo la Guida introduttiva all’Autenticazione. Non eseguire il commit in un repository.
Copia un identificatore di modello che supporta Anthropic Messages dal Catalogo modelli.

Installa

Usa il programma di installazione nativo ufficiale su macOS, Linux o WSL, quindi verifica che il comando sia disponibile:

SHELL

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

Per Homebrew, WinGet e requisiti specifici della piattaforma, usa la guida di installazione ufficiale.

Configura RunAPI

Per un primo test, esporta il Base URL, la Chiave API e il modello nella shell corrente:

SHELL

export ANTHROPIC_BASE_URL=https://runapi.ai
export ANTHROPIC_API_KEY=YOUR_RUNAPI_API_KEY
export ANTHROPIC_MODEL=YOUR_RUNAPI_MODEL_ID

Per applicare i valori a ogni sessione di Claude Code per il tuo utente, inseriscili nell’oggetto env in ~/.claude/settings.json:

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

Mantieni la chiave reale fuori da .claude/settings.json, che è destinato alle impostazioni di progetto che potrebbero essere committate. Per gli ambiti di configurazione e la precedenza, utilizza il riferimento delle impostazioni di Claude Code.

Scegli un modello

Sostituisci YOUR_RUNAPI_MODEL_ID con l’identificatore esatto dal Catalogo modelli. ANTHROPIC_BASE_URL modifica il destinatario delle richieste; non sceglie un modello. Puoi anche avviare una sessione con claude --model YOUR_RUNAPI_MODEL_ID oppure eseguire /model durante una sessione.

Verifica

Esegui i controlli di installazione e configurazione, poi invia un breve prompt:

SHELL

claude --version
claude doctor
claude

All’interno di Claude Code, esegui /status per confermare le impostazioni caricate e il modello attivo. Una risposta normale a Describe this repository in one sentence. conferma che la connessione RunAPI funziona.

Risoluzione dei problemi

claude non viene trovato: riapri il terminale e segui la risoluzione ufficiale dei problemi di installazione.
Le impostazioni non si caricano: valida ~/.claude/settings.json con claude doctor, quindi usa /status per ispezionare le sorgenti caricate.
L’autenticazione non riesce: conferma che ANTHROPIC_API_KEY contenga una chiave RunAPI attiva. Crea o ruota le chiavi tramite la Authentication Guide.
Il modello non è disponibile: copia l’identificatore esatto dal Model Catalog, quindi avvia una nuova sessione. Le sessioni riprese potrebbero mantenere il modello precedente.
Le richieste usano un altro endpoint: avvia un nuovo terminale dopo aver modificato le variabili di ambiente e verifica la presenza di un’impostazione Claude Code con priorità più alta.

Passaggi successivi

Usa la guida introduttiva all’LLM API per il comportamento del protocollo e il Riferimento API Anthropic Messages per i campi di richiesta. Per aggiungere gli strumenti RunAPI a Claude Code, continua con la Panoramica MCP.