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

> Este guia ajuda você a começar a usar o OpenCode com a Harogo em poucos minutos.

Antes de instalar, verifique se o seu sistema atende aos seguintes requisitos:

* **Node.js ≥ 18.0.0**
* Um gerenciador de pacotes para a sua plataforma (opcional):
  * macOS / Linux: `brew`
  * Arch Linux: `paru`
  * Windows: `choco`, `winget` ou `scoop`

## 1. Instalar o OpenCode

Escolha o método de instalação mais adequado ao seu sistema e às suas ferramentas.

### 1. Instalar via Node.js

```text theme={null}
# Instalação rápida via script curl
curl -fsSL https://opencode.ai/install | bash

# Usando NPM
npm install -g opencode-ai

# Usando Bun
bun install -g opencode-ai

# Usando PNPM
pnpm install -g opencode-ai

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

***

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

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

***

### 3. Usando Paru (Arch Linux)

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

***

### 4. Instalação no Windows

No Windows, você pode instalar o OpenCode com qualquer uma das opções a seguir:

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

# WinGet
winget install opencode

# Scoop
scoop bucket add extras
scoop install extras/opencode

# Ou via NPM (requer Node.js); observação: requer privilégios de administrador
npm install -g opencode-ai
```

***

## 2. Configurar o OpenCode pelo CC Switch

1. Abra o CC Switch, selecione OpenCode à esquerda e clique em "Adicionar provedor" (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. Na lista de predefinições, escolha "Configuração personalizada" (Custom Configuration) como provedor.

![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. Preencha a chave do provedor, o nome, a chave de API, o endpoint (`https://api.harogo.ai/v1`) etc.

![Preenchimento do formulário de configuração do provedor](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. Preencha as informações do modelo e salve.

![Preenchimento da configuração do modelo](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. De volta à tela inicial, selecione "harogo" na lista de provedores e clique em "Usar" (Use).

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

***

## 3. Usar o modelo

### 1. Verificar a instalação

Você pode verificar se o OpenCode foi instalado e configurado corretamente com o seguinte 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. Selecionar um modelo

Digite `/models`, pesquise `harogo` e escolha o modelo desejado.

![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.