OpenCode와 Oh-my-opencode 설치 가이드

최근 개발자들이 많이 사용하고 있는 OpenCode는 오픈소스 AI 코딩 에이전트로, 터미널 기반의 인터페이스를 통해 개발 작업을 획기적으로 효율화할 수 있습니다. 여기에 Oh My OpenCode 플러그인을 추가하면 더욱 강력한 기능을 경험할 수 있습니다. 현재 저도 Vibe coding을 위해 Opencode와 Oh-my-opencode를 활용하고 있습니다.

OpenCode란?

OpenCode는 터미널에서 직접 작동하는 AI 코딩 어시스턴트입니다. Claude, GPT, Gemini 등 다양한 LLM 프로바이더를 지원하며, 코드 작성, 디버깅, 리팩토링 등의 작업을 자연어로 요청할 수 있습니다. GitHub에서 26,000개 이상의 스타를 받을 정도로 개발자들 사이에서 큰 인기를 얻고 있습니다.

 

홈페이지: https://opencode.ai/

OpenCode | The open source AI coding agent

 

OpenCode 설치하기

방법 1: 설치 스크립트 (가장 간단)

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

방법 2: 패키지 매니저 사용

npm/bun/pnpm:

npm i -g opencode-ai
# 또는
bun add -g opencode-ai

Homebrew (macOS/Linux):

brew install anomalyco/tap/opencode

Windows (Scoop/Chocolatey):

scoop install opencode
# 또는
choco install opencode

Arch Linux:

paru -S opencode-bin

설치 확인

opencode --version

API 키 설정

OpenCode를 사용하려면 LLM 프로바이더의 API 키가 필요합니다. 다음 명령어로 인증을 설정하세요:

opencode auth login

대화형 프롬프트에서 원하는 프로바이더(Anthropic, OpenAI, Google 등)를 선택하고 API 키를 입력하면 됩니다.

첫 실행

설치가 완료되면 프로젝트 디렉토리에서 OpenCode를 실행합니다:

cd your-project
opencode

처음 실행 시 /init 명령어로 프로젝트를 분석하고 AGENTS.md 파일을 생성할 수 있습니다. 이 파일을 Git에 커밋해두면 팀 전체가 일관된 설정을 공유할 수 있습니다.

Oh My OpenCode란?

Oh My OpenCode는 OpenCode의 공식 플러그인으로, 다음과 같은 기능을 제공합니다:

• Sisyphus: 메인 에이전트로, 복잡한 작업을 전문화된 서브에이전트에게 위임
• Oracle: 아키텍처 분석과 코드 리뷰 전문
• Librarian: 문서 검색과 코드베이스 분석
• Explore: 빠른 코드 검색
• Background Agents: 병렬 에이전트 실행으로 실제 개발팀처럼 작업

Oh My OpenCode 설치하기

Github 링크: https://github.com/code-yeongyu/oh-my-opencode

GitHub - code-yeongyu/oh-my-opencode: The Best Agent Harness. Meet Sisyphus: The Batteries-Included Agent that codes like you.

 

전제 조건

OpenCode가 먼저 설치되어 있어야 하며, 버전 1.0.150 이상이 필요합니다.

opencode --version  # 1.0.150 이상 확인

설치

Opencode에 입력:

Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md