> ## Documentation Index
> Fetch the complete documentation index at: https://docs.harogo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Questa guida ti permette di iniziare a usare Claude Code con Harogo in pochi minuti.

> [!NOTE]
>
> **Questa guida usa solo modelli Claude.** Claude Code può eseguire i modelli Claude (Claude Opus 5.5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Fable 5.1, Claude Haiku 5.5) e i modelli senza restrizioni di client (GLM, Qwen, Kimi, MiniMax, DeepSeek). I modelli GPT non sono disponibili in Claude Code — vedi [Codex](https://docs.harogo.ai/it/codex.md).

### 1. Installare Claude Code

#### Installazione locale

```shellscript macOS theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

```shellscript Windows theme={null}
irm https://claude.ai/install.ps1 | iex
```

#### Installazione tramite npm

Richiede [Node.js 18 o versioni successive](https://nodejs.org/en/download/)

```shellscript theme={null}
npm install -g @anthropic-ai/claude-code
```

### 2. Configurare l'API Harogo

Per collegarti al servizio di modelli di Harogo tramite l'API compatibile con Anthropic, imposta le seguenti variabili d'ambiente.

1. Imposta `ANTHROPIC_BASE_URL` su `https://api.harogo.ai/`
2. Imposta `ANTHROPIC_AUTH_TOKEN` sulla chiave API ottenuta dalla [piattaforma Harogo](https://console.harogo.ai/keys)
3. Imposta `ANTHROPIC_MODEL` su un modello Claude supportato da Harogo, ad esempio `claude-sonnet-5`.

> [tab] macOS
>
> 1. Esegui il seguente comando nel terminale per verificare la tua shell predefinita.
>
> ```shellscript theme={null}
> echo $SHELL
> ```
>
> 2. Imposta le variabili d'ambiente in base al tipo di shell:
>
> ```shellscript Zsh theme={null}
> # Sostituisci <HAROGO_API_KEY> con la chiave reale ottenuta dalla tua piattaforma Harogo
> echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc
> echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.zshrc
> echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc
> ```
>
> ```shellscript Bash theme={null}
> # Sostituisci <HAROGO_API_KEY> con la chiave reale ottenuta dalla tua piattaforma Harogo
> echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile
> echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.bash_profile
> echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile
> ```
>
> 3. Esegui il seguente comando nel terminale per applicare le variabili d'ambiente.
>
> ```shellscript Zsh theme={null}
> source ~/.zshrc
> ```
>
> ```shellscript Bash theme={null}
> source ~/.bash_profile
> ```
>
> 4. Apri un nuovo terminale ed esegui i seguenti comandi per verificare che le variabili d'ambiente siano attive.
>
> ```shellscript theme={null}
> echo $ANTHROPIC_BASE_URL
> test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
> echo $ANTHROPIC_MODEL
> ```

> [tab] Windows
>
> Su Windows puoi impostare il Base URL e la [chiave API](https://console.harogo.ai/keys) di Harogo come variabili d'ambiente tramite CMD o PowerShell.
>
> > [tab] CMD
> >
> > 1. Esegui il seguente comando in CMD per impostare le variabili d'ambiente.
> >
> > ```shellscript theme={null}
> > REM Sostituisci <HAROGO_API_KEY> con la chiave reale ottenuta dalla tua piattaforma Harogo
> > setx ANTHROPIC_AUTH_TOKEN "<HAROGO_API_KEY>"
> > setx ANTHROPIC_BASE_URL "https://api.harogo.ai"
> > setx ANTHROPIC_MODEL "claude-sonnet-5"
> > ```
> >
> > 2. Apri una nuova finestra di CMD ed esegui i seguenti comandi per verificare che le variabili d'ambiente siano attive.
> >
> > ```shellscript theme={null}
> > if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set
> > echo %ANTHROPIC_BASE_URL%
> > echo %ANTHROPIC_MODEL%
> > ```
>
> > [tab] PowerShell
> >
> > 1. Esegui il seguente comando in PowerShell per impostare le variabili d'ambiente.
> >
> > ```shellscript theme={null}
> > # Sostituisci <HAROGO_API_KEY> con la chiave reale ottenuta dalla tua piattaforma Harogo
> > [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<HAROGO_API_KEY>", [EnvironmentVariableTarget]::User)
> > [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User)
> > [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User)
> > ```
> >
> > 2. Apri una nuova finestra di PowerShell ed esegui i seguenti comandi per verificare che le variabili d'ambiente siano attive.
> >
> > ```shellscript theme={null}
> > if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" }
> > echo $env:ANTHROPIC_BASE_URL
> > echo $env:ANTHROPIC_MODEL
> > ```

> [!NOTE]
>
> Se intendi gestire Claude Code tramite CC Switch, ti consigliamo di non impostare anche valori globali per `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` o `ANTHROPIC_MODEL`. Le variabili d'ambiente di sistema o utente possono sovrascrivere la configurazione del provider scritta da CC Switch: l'interfaccia mostra selezionato il provider corretto, ma Claude Code in realtà continua a usare una vecchia chiave o un vecchio modello.

### 3. Verificare la configurazione

Dopo aver configurato le variabili d'ambiente o CC Switch, invia prima una richiesta minima per verificare che chiave, modello ed endpoint compatibile con Anthropic funzionino, prima di avviare una sessione più lunga.

```bash macOS/Linux theme={null}
curl https://api.harogo.ai/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, output only the answer"}]
  }'
```

```powershell Windows theme={null}
curl.exe https://api.harogo.ai/v1/messages `
  -H "content-type: application/json" `
  -H "anthropic-version: 2023-06-01" `
  -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" `
  -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}"
```

### 4. Iniziare a usare Claude Code

Una volta completata la configurazione, spostati nella tua directory di lavoro ed esegui il comando `claude` nel terminale per iniziare.

```bash theme={null}
$ cd /path/your-project
> claude
```

Se all'avvio compare `Not logged in · Please run /login`, oppure vieni portato nel flusso di accesso di Anthropic, di solito significa che Claude Code non ha trovato una configurazione Harogo funzionante o che l'onboarding iniziale non è stato completato. Verifica prima che la richiesta minima del passaggio precedente restituisca `2` e controlla che `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` o `ANTHROPIC_MODEL` non vengano sovrascritte da vecchie variabili d'ambiente globali. Se la chiave funziona e vieni comunque portato al flusso di accesso, puoi saltare l'onboarding iniziale con i passaggi seguenti:

![Terminale con la richiesta di accesso o di proseguimento al primo avvio di Claude Code](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/cc-7.avif?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=80bd9b41f8af28fa7679659117d6266c)

1. Individua il file `.claude.json` nella tua home directory:
   * macOS / Linux: `~/.claude.json`
   * Windows: `C:\Users\%USERNAME%\.claude.json`
2. Imposta il campo `hasCompletedOnboarding` su `true`

```json theme={null}
{
  "hasCompletedOnboarding": true
}
```

3. Salva il file, poi esegui di nuovo `claude` nel terminale.

#### (Facoltativo) Altri modi per configurare il modello

Claude Code supporta i seguenti modi per configurare il modello, **elencati dalla priorità più alta alla più bassa**: un'impostazione con priorità più alta sovrascrive quella con priorità più bassa.

1. **Durante una conversazione:** esegui il comando `/model <model-name>` per cambiare modello. Utile per un cambio occasionale.

```text theme={null}
/model claude-sonnet-5
```

2. **All'avvio di Claude Code:** esegui `claude --model <model-name>` per specificare un modello. Utile per una singola sessione.

```text theme={null}
claude --model claude-sonnet-5
```

3. **Impostare le variabili d'ambiente:** configura diversi livelli di modello in base alla complessità del task e Claude Code sceglierà automaticamente quello adatto. Si applica a livello globale.

```shellscript theme={null}
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
```

Dove:

* `ANTHROPIC_DEFAULT_OPUS_MODEL`: per ragionamento complesso, progettazione dell'architettura e altri task difficili.
* `ANTHROPIC_DEFAULT_SONNET_MODEL`: per scrivere codice, implementare funzionalità e altri task quotidiani.
* `ANTHROPIC_DEFAULT_HAIKU_MODEL`: per controlli di sintassi, ricerca di file e altri task semplici.

4. **Impostazione permanente in settings.json:** scrivi la configurazione del modello nel file di configurazione utente di Claude Code (ad es. `~/.claude/settings.json`, oppure `C:\Users\%USERNAME%\.claude\settings.json` su Windows) o in una configurazione a livello di progetto, per un'impostazione permanente a livello utente o di progetto.

## Configurazione tramite CC Switch

1. Avvia CC Switch, seleziona **Claude Code** a sinistra, poi fai clic su "Aggiungi provider" (Add Provider).

![Pulsante Aggiungi provider nella schermata principale di CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/1.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=3a0a45652c18bbabd158f7e3a17a8dce)

2. Dall'elenco dei preset, scegli "Configurazione personalizzata" (Custom Configuration) come provider.

![Selezione di Custom Configuration nell'elenco dei preset dei provider di CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.51.01.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=2d63af589968a3f94173587919cbf9a2)

3. Inserisci il nome del provider, la chiave API, l'endpoint ([https://api.harogo.ai](https://api.harogo.ai)) e così via. Una volta compilati tutti i campi, fai clic su "Aggiungi" (Add).

![Inserimento della chiave API nel modulo di configurazione del provider di CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.55.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=37caaae4e1ccd895dbe089f656e55751)

4. Tornato alla schermata principale, seleziona "harogo" dall'elenco dei provider e fai clic su "Usa" (Use).

![Selezione di harogo e clic su Use nella schermata principale di CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.00.16.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=78acb5f499057ae22c6e97c4d770f499)

> ![Verifica della configurazione del modello con i comandi status e models nel terminale di Claude Code](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.03.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=192f4da074881e069682f2c9da8b3cd9)
>
> ![I Shot 2026 08 07 17 04 52](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.04.52.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=a8f4c213e6115c8c874979a1d7b0c388)
>
> Suggerimento: una volta aperto Claude Code nel terminale, digita <kbd>/status</kbd> per verificare l'ID del modello, oppure <kbd>/models</kbd> per scegliere un altro modello configurato.

> [!WARNING]
>
> Se CC Switch mostra "Rilevato conflitto con variabili d'ambiente di sistema" (System environment variable conflict detected), occupati prima di `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_MODEL`. Queste variabili globali sovrascrivono la configurazione del provider attuale: un valore segnaposto come `ANTHROPIC_AUTH_TOKEN=<HAROGO_API_KEY>` farà fallire direttamente l'autenticazione. Quando sei sicuro di non aver più bisogno delle variabili globali, rimuovi le voci in conflitto in CC Switch, oppure elimina manualmente le variabili d'ambiente di sistema/utente e riavvia il terminale.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.