설치

OpenCode는 단일 바이너리로 배포되며 macOS, Linux, Windows에서 다양한 설치 방법을 지원합니다.

빠른 설치 (권장)

OpenCode를 설치하는 가장 빠른 방법은 공식 스크립트를 사용하는 것입니다:

curl -fsSL https://opencode.ai/install | bash

이 스크립트는 OS와 아키텍처를 감지하고, 올바른 바이너리를 다운로드하여 PATH에 추가합니다.

패키지 관리자

npm / bun / pnpm / yarn

npm i -g opencode-ai@latest
# 또는
bun i -g opencode-ai@latest
# 또는
pnpm i -g opencode-ai@latest
# 또는
yarn global add opencode-ai@latest

Homebrew (macOS & Linux)

권장 방법 (항상 최신):

brew install anomalyco/tap/opencode

공식 Homebrew 공식 (업데이트 빈도 낮음):

brew install opencode

Scoop (Windows)

scoop install opencode

Chocolatey (Windows)

choco install opencode

Arch Linux

# 안정 버전
sudo pacman -S opencode

# AUR에서 최신 버전
paru -S opencode-bin

mise (모든 OS)

mise use -g opencode

Nix

# nixpkgs에서
nix run nixpkgs#opencode

# GitHub에서 최신 버전
nix run github:anomalyco/opencode

데스크톱 앱 (베타)

OpenCode는 그래픽 인터페이스를 갖춘 데스크톱 애플리케이션으로도 사용할 수 있습니다.

다운로드

플랫폼	다운로드
macOS (Apple Silicon)	opencode-desktop-darwin-aarch64.dmg
macOS (Intel)	opencode-desktop-darwin-x64.dmg
Windows	opencode-desktop-windows-x64.exe
Linux	.deb, .rpm, 또는 AppImage

패키지 관리자 설치

macOS (Homebrew):

brew install --cask opencode-desktop

Windows (Scoop):

scoop bucket add extras
scoop install extras/opencode-desktop

Windows 설치

WSL2 (권장)

Windows에서 최상의 경험을 위해 WSL2 사용을 권장합니다:

# WSL2 설치
wsl --install

# 컴퓨터를 재시작한 후 실행:
curl -fsSL https://opencode.ai/install | bash

네이티브 Windows (실험적)

네이티브 Windows 설치의 경우 GitHub Releases 페이지에서 Windows 바이너리를 다운로드하여 PATH에 추가하세요.

수동 설치

GitHub Releases 페이지에서 직접 바이너리를 다운로드하세요.

macOS (Apple Silicon)

wget https://github.com/anomalyco/opencode/releases/latest/download/opencode-darwin-arm64
chmod +x opencode-darwin-arm64
mv opencode-darwin-arm64 /usr/local/bin/opencode

macOS (Intel)

wget https://github.com/anomalyco/opencode/releases/latest/download/opencode-darwin-amd64
chmod +x opencode-darwin-amd64
mv opencode-darwin-amd64 /usr/local/bin/opencode

Linux (x86_64)

wget https://github.com/anomalyco/opencode/releases/latest/download/opencode-linux-amd64
chmod +x opencode-linux-amd64
mv opencode-linux-amd64 /usr/local/bin/opencode

Linux (ARM64)

wget https://github.com/anomalyco/opencode/releases/latest/download/opencode-linux-arm64
chmod +x opencode-linux-arm64
mv opencode-linux-arm64 /usr/local/bin/opencode

설치 디렉토리

설치 스크립트는 다음 우선 순위에 따라 설치 경로를 결정합니다:

$OPENCODE_INSTALL_DIR - 사용자 지정 설치 디렉토리
$XDG_BIN_DIR - XDG 기본 디렉토리 사양을 준수하는 경로
$HOME/bin - 표준 사용자 바이너리 디렉토리 (존재하거나 생성 가능한 경우)
$HOME/.opencode/bin - 기본 대체 경로

예시:

# 사용자 지정 설치 디렉토리
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash

# XDG 준수 경로
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash

Docker

샌드박스 환경의 경우 Docker 컨테이너에서 OpenCode를 실행할 수 있습니다. 자세한 Docker 사용 지침은 Docker 지원 페이지를 참조하세요.

docker run -it -v $(pwd):/app anomalyco/opencode:latest

확인

설치 후 OpenCode가 제대로 작동하는지 확인하세요:

# 버전 확인
opencode --version

# TUI 시작
opencode tui

설치