Ch1. 설치/업데이트

OpenCode는 터미널(TUI), 데스크톱 앱, IDE 확장을 지원하는 오픈소스 AI 코딩 에이전트입니다. v1.3.2 기준 GitHub 113K+ 스타, 월 250만+ 활성 개발자가 사용 중입니다.

설치 옵션 요약

# 공식 설치 스크립트 (권장)
curl -fsSL https://opencode.ai/install | bash

# Homebrew
brew install anomalyco/tap/opencode

# npm / Bun / pnpm / Yarn
npm i -g opencode-ai@latest
bun i -g opencode-ai
pnpm i -g opencode-ai
yarn global add opencode-ai

# mise
mise use -g opencode

# Arch Linux
sudo pacman -S opencode
paru -S opencode-bin

# Chocolatey
choco install opencode

# Scoop
scoop install opencode

# npm (Node.js 설치 후)
npm i -g opencode-ai@latest

docker run -it --rm ghcr.io/anomalyco/opencode

설치 경로 우선순위

OpenCode는 아래 순서로 설치 경로를 결정합니다.

런타임 지원

v1.3.0부터 Bun 외에 Node.js에서도 실행할 수 있습니다. 기존에는 Bun이 필수 런타임이었으나, Node.js 환경에서도 동일한 기능을 사용할 수 있게 되었습니다.

데스크톱 앱 (Beta)

opencode.ai/download에서 데스크톱 앱을 받을 수 있습니다.

IDE 확장

VS Code, Cursor, Windsurf, VSCodium을 지원합니다. IDE 통합 터미널에서 opencode를 실행하면 확장이 자동 설치됩니다.

업데이트 관리

# 최신 버전으로 업그레이드
opencode upgrade

# 특정 버전 지정
opencode upgrade 1.2.15

자동 업데이트는 기본 활성화되어 있으며, 비활성화하려면:

{ "autoupdate": false }

또는 환경 변수 OPENCODE_DISABLE_AUTOUPDATE=true로 제어합니다.

Interactive Update Flow (v1.3.0+)

메이저 또는 마이너 업데이트 시 확인 대화상자가 표시됩니다. 브레이킹 체인지가 포함된 업데이트를 실수로 적용하는 것을 방지합니다.

• 메이저 업데이트: 브레이킹 체인지 목록과 마이그레이션 안내 표시
• 마이너 업데이트: 주요 변경사항 요약 표시
• 패치 업데이트: 기존처럼 자동 적용

멀티윈도우 Electron (v1.2.27+)

데스크톱 앱에서 여러 창을 동시에 열 수 있습니다. 프로젝트별로 독립적인 창에서 작업하면 컨텍스트 전환이 편해집니다.

고급 팁: 팀 표준 설치

참고 문서

• OpenCode 공식 사이트: https://opencode.ai
• 설치 가이드: https://opencode.ai/docs
• 다운로드: https://opencode.ai/download
• IDE 확장: https://opencode.ai/docs/ide/
• 체인지로그: https://opencode.ai/changelog