README.ko.md

오픈 소스 AI 코딩 에이전트.

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt

---

설치

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

# 패키지 매니저
npm i -g @opencode/cli@latest      # bun/pnpm/yarn 도 가능
brew install anomalyco/tap/opencode-v2 # macOS 및 Linux (권장, 항상 최신)
brew install opencode              # macOS 및 Linux (공식 brew formula, 업데이트 빈도 낮음)
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-beta              # Arch Linux (Latest from AUR)
mise use -g opencode               # 어떤 OS든
nix run github:anomalyco/opencode  # Nix

Tip

설치 전에 0.1.x 보다 오래된 버전을 제거하세요.

데스크톱 앱 (BETA)

OpenCode 는 데스크톱 앱으로도 제공됩니다. opencode.ai/download 에서 다운로드하세요.

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

# macOS (Homebrew)
brew install --cask opencode-desktop

설치 디렉터리

설치 스크립트는 OpenCode를 $HOME/.opencode/bin에 설치합니다.

Agents

OpenCode 에는 내장 에이전트 2개가 있으며 Tab 키로 전환할 수 있습니다.

• build - 기본값, 개발 작업을 위한 전체 권한 에이전트
• plan - 분석 및 코드 탐색을 위한 읽기 전용 에이전트
  • 기본적으로 파일 편집을 거부
  • bash 명령 실행 전에 권한을 요청
  • 낯선 코드베이스를 탐색하거나 변경을 계획할 때 적합

또한 복잡한 검색과 여러 단계 작업을 위한 general 서브 에이전트가 포함되어 있습니다. 내부적으로 사용되며, 메시지에서 @general 로 호출할 수 있습니다.

agents 에 대해 더 알아보세요.

문서

OpenCode 설정에 대한 자세한 내용은 문서 를 참고하세요.

기여하기

OpenCode 에 기여하고 싶다면, Pull Request 를 제출하기 전에 contributing docs 를 읽어주세요.

OpenCode 기반으로 만들기

OpenCode 와 관련된 프로젝트를 진행하면서 이름에 "opencode"(예: "opencode-dashboard" 또는 "opencode-mobile") 를 포함한다면, README 에 해당 프로젝트가 OpenCode 팀이 만든 것이 아니며 어떤 방식으로도 우리와 제휴되어 있지 않다는 점을 명시해 주세요.

---

커뮤니티에 참여하기 Discord | X.com