> ## 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.

# OpenCode

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

Prima dell'installazione, assicurati che il tuo sistema soddisfi i seguenti requisiti:

* **Node.js ≥ 18.0.0**
* Un gestore di pacchetti per la tua piattaforma (facoltativo):
  * macOS / Linux: `brew`
  * Arch Linux: `paru`
  * Windows: `choco`, `winget` o `scoop`

## 1. Installare OpenCode

Scegli il metodo di installazione più adatto al tuo sistema e ai tuoi strumenti.

### 1. Installazione tramite Node.js

```text theme={null}
# Installazione rapida tramite script curl
curl -fsSL https://opencode.ai/install | bash

# Con NPM
npm install -g opencode-ai

# Con Bun
bun install -g opencode-ai

# Con PNPM
pnpm install -g opencode-ai

# Con Yarn
yarn global add opencode-ai
```

***

### 2. Con Homebrew (macOS / Linux)

```text theme={null}
brew install sst/tap/opencode
```

***

### 3. Con Paru (Arch Linux)

```text theme={null}
paru -S opencode-bin
```

***

### 4. Installazione su Windows

Su Windows puoi installare OpenCode in uno dei seguenti modi:

```text theme={null}
# Chocolatey
choco install opencode

# WinGet
winget install opencode

# Scoop
scoop bucket add extras
scoop install extras/opencode

# Oppure tramite NPM (richiede Node.js) — nota: richiede privilegi di amministratore
npm install -g opencode-ai
```

***

## 2. Configurare OpenCode tramite CC Switch

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

![I Shot 2026 08 07 18 06 55](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_18.06.55.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=880954efc6e217eab4b1904f5498fabb)

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

![I Shot 2026 08 07 18 07 24](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_18.07.24.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=5501bd2b23e7ec701c72265786e0e8d5)

3. Inserisci la chiave del provider, il nome, la chiave API, l'endpoint (`https://api.harogo.ai/v1`) e così via.

![Compilazione del modulo di configurazione del provider](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_18.16.46.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=77331925513541de6e85b767c5648124)

4. Inserisci le informazioni del modello, poi salva.

![Compilazione della configurazione del modello](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_18.18.44.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=11e799c6d82a3b52ec8ff82b20574c71)

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

![11](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/11.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=3803b5b5382d04730ab8aedb549c2fbf)

***

## 3. Usare il modello

### 1. Verificare l'installazione

Puoi verificare che OpenCode sia installato e configurato correttamente con il seguente comando:

```text theme={null}
opencode
```

![Opencode 3](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_18.21.30.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=b4aeb0326bda3970e3fe16f3cfc807f3)

### 2. Selezionare un modello

Digita `/models`, cerca `harogo` e scegli il modello che preferisci.

![Opencode 4](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_18.22.23.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=72ede75376d54c65f9756960cb0ef0c1)


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