Risorse per sviluppatori

CC Switch

Installa CC Switch, aggiungi un Provider Claude Code RunAPI, scegli un modello e verifica la connessione.

Panoramica

CC Switch è un’applicazione desktop per la gestione dei Provider di strumenti di codifica. Questa guida connette il suo Claude Code Provider a RunAPI senza modificare manualmente il profilo shell o i file di progetto.

Prima di iniziare

Installa Claude Code e accedi al tuo account RunAPI.
Crea una Chiave API standard seguendo la Guida introduttiva all’Autenticazione. Conservala in CC Switch; non aggiungerla al controllo del codice sorgente.
Usa un identificatore di modello RunAPI disponibile tramite questa connessione. Puoi selezionarne uno da CC Switch o copiarlo dal Catalogo modelli.

Installa

Scarica CC Switch dalle sue versioni ufficiali per Windows, macOS o Linux. Su macOS con Homebrew, installalo con:

SHELL

brew install --cask cc-switch

Apri CC Switch dopo l’installazione e seleziona Claude Code nel selettore di app.

Configura RunAPI

Seleziona Add Provider, quindi scegli il preset Custom.
Assegna al provider il nome RunAPI e inserisci la chiave API e il Base URL nell’editor di configurazione:

JSON

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

La Chiave API sopra è un segnaposto. Crea e ruota la tua chiave effettiva tramite la Guida all’Autenticazione.

Scegli un modello

Usa Fetch Models solo per scoprire i candidati. Se il modello non è elencato, copia il suo identificatore dal Model Catalog. Il recupero non assegna modelli ai ruoli di richiesta Claude Code.
Imposta l’identificatore scelto come Default fallback model, quindi seleziona Quick Set. Questo applica l’identificatore a ogni riga Actual Request Model: Sonnet, Opus, Fable, Haiku e Subagent.
Prima di salvare, verifica che ogni riga mostri l’identificatore RunAPI previsto. CC Switch conserva questa mappatura come ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, e CLAUDE_CODE_SUBAGENT_MODEL.
Salva il provider, selezionalo nell’elenco dei provider e attivalo.

Verifica

Apri un nuovo terminale in una directory di progetto e avvia Claude Code:

SHELL

claude

Esegui /status per ispezionare il modello attivo, poi invia un breve prompt come Describe this repository in one sentence. Una risposta normale conferma che CC Switch sta utilizzando il RunAPI Provider attivo.

Risoluzione dei problemi

L’autenticazione non riesce: verifica la Chiave API nel Provider CC Switch attivo, quindi crea una nuova chiave dalla Authentication Guide se necessario.
Il modello previsto non è disponibile: aggiorna il selettore di modelli o copia un identificatore di modello supportato dal Model Catalog, quindi impostalo come Modello di fallback predefinito e seleziona di nuovo Quick Set.
Claude Code continua a usare un altro Provider: attiva il Provider RunAPI in CC Switch, quindi apri una nuova sessione di terminale. Consulta la documentazione del provider di CC Switch per i conflitti di ambiente.

Passaggi successivi

Per la selezione del protocollo e il comportamento delle richieste, utilizza la Guida introduttiva all’API LLM. Per i campi di richiesta e risposta, utilizza il Riferimento API Anthropic Messages. Per aggiungere gli strumenti RunAPI a Claude Code, prosegui con la Panoramica MCP.