부록 D. OpenCode & Oh My OpenCode

이 부록에서 다루는 것

• OpenCode란 무엇인지
• OpenCode 설치 및 설정
• Oh My OpenCode로 에이전트 오케스트레이션
• Claude Code와의 비교

---

OpenCode란?

Go 기반 터미널 AI 코딩 어시스턴트입니다.

Claude Code와 유사하지만, 다중 AI 프로바이더(OpenAI, Claude, Gemini, Groq 등)를 지원하고 Go로 작성되어 빠릅니다.

참고: opencode-ai/opencode

Claude Code vs OpenCode

항목	Claude Code	OpenCode
제작사	Anthropic (공식)	커뮤니티
언어	Node.js	Go
AI 모델	Claude만	멀티 프로바이더
설정 파일	CLAUDE.md	.opencode.json
스킬 시스템	SKILL.md	Oh My OpenCode
설치 방식	npm	brew, go, npm

---

OpenCode 설치

방법 1: Homebrew (Mac)

brew install opencode-ai/tap/opencode

방법 2: Go

go install github.com/opencode-ai/opencode@latest

방법 3: npm

npm i -g opencode-ai@latest

방법 4: 설치 스크립트

curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/refs/heads/main/install | bash

설치 확인

opencode --version

---

OpenCode 설정

설정 파일 위치

위치	용도
~/.opencode.json	전역 설정
$XDG_CONFIG_HOME/opencode/.opencode.json	XDG 표준 위치
./.opencode.json	프로젝트별 설정

기본 설정 예시

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  "apiKey": "sk-ant-...",
  "theme": "dark"
}

첫 실행

opencode

---

Oh My OpenCode란?

OpenCode를 위한 에이전트 오케스트레이션 레이어입니다.

단일 AI 대화를 넘어서 병렬 작업, 에이전트 조합, 자동화 워크플로우를 가능하게 합니다.

참고: code-yeongyu/oh-my-opencode

주요 기능

기능	설명
Sisyphus Agent	자동 반복 에이전트
병렬 백그라운드	여러 작업 동시 실행
LSP 리팩토링	코드 자동 리팩토링
내장 MCP	웹 검색, 문서 조회, GitHub 검색
25+ Hooks	세밀한 동작 커스터마이징

---

Oh My OpenCode 설치

설치 가이드

공식 설치 가이드를 참조하세요:

# 설치 문서 확인
curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md

또는 GitHub에서 직접 확인:

• 설치 가이드

LLM 에이전트로 설치 (권장)

Oh My OpenCode는 LLM 에이전트를 통한 설치를 권장합니다:

> oh-my-opencode 설치해줘

---

Oh My OpenCode 설정

설정 파일 위치

위치	용도
.opencode/oh-my-opencode.json	프로젝트별 설정
~/.config/opencode/oh-my-opencode.json	전역 설정

참고: JSONC 형식 지원 (주석, trailing comma 허용)

설정 파일 구조

{
  // 에이전트 오버라이드
  "agentOverrides": {
    "coder": {
      "model": "claude-sonnet-4-20250514",
      "temperature": 0.3,
    },
  },

  // 내장 스킬
  "builtinSkills": {
    "playwright": true,
    "git-master": true,
  },

  // Sisyphus 에이전트
  "sisyphus": {
    "enabled": true,
    "maxIterations": 10,
  },

  // 백그라운드 작업
  "background": {
    "maxConcurrency": 3,
  },

  // MCP 설정
  "mcps": {
    "webSearch": true,
    "github": true,
  },
}

---

Sisyphus Agent

자동으로 반복 작업을 수행하는 에이전트입니다.

사용 예시

> sisyphus: 모든 TypeScript 파일에서 console.log 제거해줘

Sisyphus는:

1. 대상 파일 목록 수집
2. 각 파일 순회하며 작업
3. 결과 보고

설정

{
  "sisyphus": {
    "enabled": true,
    "maxIterations": 10,
    "stopOnError": false,
  },
}

---

병렬 백그라운드 작업

여러 작업을 동시에 실행합니다.

사용 예시

> 백그라운드로 다음 작업 병렬 실행해줘:
> 1. 테스트 실행
> 2. 린트 체크
> 3. 타입 체크

설정

{
  "background": {
    "maxConcurrency": 5,
    "timeout": 300000,
  },
}

---

내장 MCP 서버

Oh My OpenCode는 유용한 MCP 서버를 내장하고 있습니다.

웹 검색

> 최신 React 19 변경사항 검색해줘

GitHub 검색

> anthropics 조직의 skills 레포 이슈 검색해줘

문서 조회

> Next.js 15 공식 문서에서 서버 컴포넌트 설명 찾아줘

---

빠른 활성화: ultrawork

모든 기능을 한 번에 활성화하는 키워드입니다.

> ultrawork: 이 프로젝트 전체 리팩토링해줘

ultrawork 키워드 사용 시:

• Sisyphus 에이전트 활성화
• 병렬 처리 활성화
• 모든 내장 MCP 활성화
• 최대 성능 모드

---

Claude Code와 함께 사용하기

두 도구는 상호 보완적으로 사용할 수 있습니다.

사용 시나리오

상황	추천 도구
Anthropic API만 사용	Claude Code
다중 AI 프로바이더 필요	OpenCode
공식 지원 필요	Claude Code
고급 자동화 필요	Oh My OpenCode
스킬 시스템 활용	Claude Code
병렬 에이전트 작업	Oh My OpenCode

프로젝트별 선택

# Claude Code 프로젝트
my-project/
├── CLAUDE.md
└── .claude/skills/

# OpenCode 프로젝트
my-project/
├── .opencode.json
└── .opencode/oh-my-opencode.json

---

참고 자료

리소스	설명
opencode-ai/opencode	OpenCode 공식 레포
code-yeongyu/oh-my-opencode	Oh My OpenCode 레포
Oh My OpenCode 설치 가이드	공식 설치 문서
Oh My OpenCode 설정 가이드	설정 상세 문서