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

> Hướng dẫn này giúp bạn bắt đầu dùng OpenCode với Harogo chỉ trong vài phút.

Trước khi cài đặt, hãy đảm bảo hệ thống của bạn đáp ứng các yêu cầu sau:

* **Node.js ≥ 18.0.0**
* Trình quản lý gói cho nền tảng của bạn (tùy chọn):
  * macOS / Linux: `brew`
  * Arch Linux: `paru`
  * Windows: `choco`, `winget` hoặc `scoop`

## 1. Cài đặt OpenCode

Chọn cách cài đặt phù hợp với hệ thống và công cụ bạn đang dùng.

### 1. Cài đặt qua Node.js

```text theme={null}
# Cài đặt nhanh bằng script curl
curl -fsSL https://opencode.ai/install | bash

# Dùng NPM
npm install -g opencode-ai

# Dùng Bun
bun install -g opencode-ai

# Dùng PNPM
pnpm install -g opencode-ai

# Dùng Yarn
yarn global add opencode-ai
```

***

### 2. Dùng Homebrew (macOS / Linux)

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

***

### 3. Dùng Paru (Arch Linux)

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

***

### 4. Cài đặt trên Windows

Người dùng Windows có thể cài đặt OpenCode bằng một trong các cách sau:

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

# WinGet
winget install opencode

# Scoop
scoop bucket add extras
scoop install extras/opencode

# Hoặc qua NPM (cần Node.js) — lưu ý: cần quyền quản trị viên
npm install -g opencode-ai
```

***

## 2. Cấu hình OpenCode qua CC Switch

1. Mở CC Switch, chọn OpenCode ở bên trái, rồi nhấp "Thêm nhà cung cấp" (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. Trong danh sách cài đặt sẵn, chọn nhà cung cấp "Cấu hình tùy chỉnh" (Custom Configuration).

![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. Điền key nhà cung cấp, tên, API key, endpoint ("[https://api.harogo.ai/v1](https://api.harogo.ai/v1)") và các thông tin khác.

![Điền biểu mẫu cấu hình nhà cung cấp](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. Điền thông tin mô hình, rồi lưu lại.

![Điền cấu hình mô hình](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. Quay lại màn hình chính, chọn "harogo" trong danh sách nhà cung cấp và nhấp "Sử dụng" (Use).

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

***

## 3. Sử dụng mô hình

### 1. Kiểm tra cài đặt

Bạn có thể kiểm tra OpenCode đã được cài đặt và cấu hình đúng hay chưa bằng lệnh sau:

```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. Chọn mô hình

Gõ `/models`, tìm `harogo` và chọn mô hình bạn muốn dùng.

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