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

> 이 가이드를 따라 하면 Harogo 기반의 OpenCode를 몇 분 만에 사용할 수 있습니다.

설치하기 전에 시스템이 다음 요구 사항을 충족하는지 확인하세요.

* **Node.js ≥ 18.0.0**
* 플랫폼에 맞는 패키지 관리자(선택 사항):
  * macOS / Linux: `brew`
  * Arch Linux: `paru`
  * Windows: `choco`, `winget` 또는 `scoop`

## 1. OpenCode 설치

시스템과 사용하는 도구에 맞는 설치 방법을 선택하세요.

### 1. Node.js로 설치

```text theme={null}
# curl 스크립트로 빠르게 설치
curl -fsSL https://opencode.ai/install | bash

# NPM 사용
npm install -g opencode-ai

# Bun 사용
bun install -g opencode-ai

# PNPM 사용
pnpm install -g opencode-ai

# Yarn 사용
yarn global add opencode-ai
```

***

### 2. Homebrew 사용(macOS / Linux)

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

***

### 3. Paru 사용(Arch Linux)

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

***

### 4. Windows에서 설치

Windows 사용자는 다음 방법 중 하나로 OpenCode를 설치할 수 있습니다.

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

# WinGet
winget install opencode

# Scoop
scoop bucket add extras
scoop install extras/opencode

# 또는 NPM으로 설치(Node.js 필요) — 참고: 관리자 권한이 필요합니다
npm install -g opencode-ai
```

***

## 2. CC Switch로 OpenCode 설정

1. CC Switch를 실행하고 왼쪽에서 OpenCode를 선택한 다음 "제공업체 추가"(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. 프리셋 목록에서 제공업체로 "사용자 지정 설정"(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. 제공업체 키, 이름, API 키, 엔드포인트("[https://api.harogo.ai/v1](https://api.harogo.ai/v1)") 등을 입력합니다.

![제공업체 설정 양식 입력 화면](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. 모델 정보를 입력한 뒤 저장합니다.

![모델 설정 입력 화면](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. 홈 화면으로 돌아가 제공업체 목록에서 "harogo"를 선택하고 "사용"(Use)을 클릭합니다.

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

***

## 3. 모델 사용하기

### 1. 설치 확인

다음 명령으로 OpenCode가 올바르게 설치 및 설정되었는지 확인할 수 있습니다.

```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. 모델 선택

`/models`를 입력하고 `harogo`를 검색한 뒤 원하는 모델을 선택합니다.

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