빠른 시작

이 가이드는 몇 분 만에 Oh My OpenCode를 설치하고 구성하여 다중 에이전트 협업의 강력한 성능을 경험할 수 있도록 도와줍니다.

사전 요구 사항

시작하기 전에 다음 사항을 확인하세요:

✅ OpenCode 설치됨
✅ 다음 구독 중 하나를 보유:
- Claude Max20 (권장) - 가장 강력한 다중 에이전트 환경
- ChatGPT Plus/Pro - 좋은 성능과 비용 균형
- Gemini Advanced - 높은 가성비
✅ 기본 OpenCode 설정(API 키 등)이 구성됨

설치 단계

방법 1: 사용자 직접 설치

사용자라면 다음 단계에 따라 설치하세요:

# 1. Oh My OpenCode 저장소 복제
git clone https://github.com/code-yeongyu/oh-my-opencode.git ~/.oh-my-opencode

# 2. 종속성 설치
cd ~/.oh-my-opencode
npm install  # 또는 yarn install / pnpm install

# 3. 설치 스크립트 실행
npm run install

설치 스크립트는 자동으로 다음을 수행합니다:

OpenCode 설정 파일 위치 감지
기존 설정 백업
OpenCode 설정에 Oh My OpenCode 설정 병합

방법 2: AI 에이전트를 통한 설치

AI 에이전트를 사용하여 설치하는 경우 에이전트는 직접 다음을 사용할 수 있습니다:

# AI 에이전트는 설치 스크립트를 직접 실행할 수 있습니다
opencode "ultrawork 모드를 사용하여 oh-my-opencode 설치"

AI 에이전트는 작업을 자동으로 처리합니다:

다운로드 및 구성
종속성 설치
설정 파일 병합

구독 플랜 구성

구독 서비스에 따라 구성을 선택하세요:

Claude Max20 (권장)

{
  "subscription": "claude-max20",
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 3
  },
  "agents": {
    "oracle": { "enabled": true },
    "librarian": { "enabled": true },
    "frontend-engineer": { "enabled": true },
    "backend-engineer": { "enabled": true },
    "explore": { "enabled": true }
  }
}

특징:

가장 높은 동시 작업 수 (3개의 백그라운드 작업)
모든 에이전트 활성화
최상의 다중 에이전트 협업 경험

ChatGPT Plus/Pro

{
  "subscription": "chatgpt-plus",
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2
  },
  "agents": {
    "oracle": { "enabled": true },
    "librarian": { "enabled": true },
    "frontend-engineer": { "enabled": true }
  }
}

특징:

중간 수준의 동시 작업 수 (2개의 백그라운드 작업)
핵심 에이전트 활성화
좋은 성능과 비용 균형

Gemini Advanced

{
  "subscription": "gemini-advanced",
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2
  },
  "agents": {
    "oracle": { "enabled": false },
    "librarian": { "enabled": true },
    "explore": { "enabled": true }
  }
}

특징:

중간 수준의 동시 작업 수 (2개의 백그라운드 작업)
선택된 에이전트 활성화
높은 가성비

설치 확인

설치 후 Oh My OpenCode가 올바르게 작동하는지 확인하세요:

1. 설정 파일 확인

# Oh My OpenCode 설정 파일 보기
cat .opencode/oh-my-opencode.json  # 프로젝트 수준 설정
# 또는
cat ~/.config/opencode/oh-my-opencode.json  # 사용자 수준 설정 (macOS/Linux)
# 또는
type %APPDATA%\opencode\oh-my-opencode.json  # 사용자 수준 설정 (Windows)

설정 파일에 Oh My OpenCode 관련 설정이 포함되어 있는지 확인합니다.

2. 기본 기능 테스트

# Sisyphus 에이전트 테스트
opencode "@oracle을 사용하여 현재 프로젝트 아키텍처 분석해줘"

# ultrawork 모드 테스트
opencode "ulw: 프로젝트의 모든 설정 파일 목록 보여줘"

3. 에이전트 목록 확인

# 사용 가능한 모든 에이전트 보기
opencode "사용 가능한 모든 전문 에이전트 목록 보여줘"

다음과 유사한 출력이 나타나야 합니다:

사용 가능한 에이전트:
- @oracle - 시스템 아키텍처 설계
- @librarian - 문서 조사
- @frontend-engineer - 프론트엔드 개발
- @backend-engineer - 백엔드 개발
- @explore - 코드베이스 분석

기본 구성

ultrawork 모드 활성화

작업 설명에 ultrawork 또는 ulw 키워드를 추가하세요:

opencode "ultrawork: 사용자 인증 모듈 리팩토링"

그러면 다음이 자동으로 활성화됩니다:

✅ 모든 구성된 에이전트
✅ 백그라운드 작업 병렬화
✅ LSP 도구 통합
✅ 지능형 컨텍스트 관리

에이전트 동작 사용자 정의

OpenCode 설정 파일을 편집하여 에이전트별 설정을 추가하세요:

{
  "agents": {
    "oracle": {
      "enabled": true,
      "model": "claude-sonnet-4",
      "temperature": 0.7,
      "prompt_append": "자세한 기술적 결정 근거를 제공해주세요"
    }
  }
}

백그라운드 작업 동시성 구성

동시에 실행되는 백그라운드 작업 수를 제어합니다:

{
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2,
    "task_timeout": 300
  }
}

자주 묻는 질문

설치 실패

문제: 설치 스크립트 오류 또는 OpenCode 설정을 찾을 수 없음

해결:

OpenCode가 올바르게 설치되었는지 확인: opencode --version

설정 파일 경로를 수동으로 지정:

export OPENCODE_CONFIG_PATH=/path/to/your/config.json
npm run install

에이전트가 응답하지 않음

문제: @oracle 및 기타 에이전트 사용 시 응답이 없음

해결:

에이전트가 활성화되어 있는지 확인:
```
opencode "현재 구성 보여줘"
```
구독 플랜이 해당 에이전트를 지원하는지 확인
API 할당량이 소진되었는지 확인

구성 충돌

문제: Oh My OpenCode 구성이 기존 구성과 충돌함

해결:

백업 파일 확인:
- 프로젝트 수준: .opencode/oh-my-opencode.json.backup
- 사용자 수준 (macOS/Linux): ~/.config/opencode/oh-my-opencode.json.backup

수동으로 구성 병합:

# 백업 복원 (프로젝트 수준 예시)
cp .opencode/oh-my-opencode.json.backup .opencode/oh-my-opencode.json

# 또는 사용자 수준 백업 복원 (macOS/Linux)
cp ~/.config/opencode/oh-my-opencode.json.backup ~/.config/opencode/oh-my-opencode.json

# Oh My OpenCode 구성을 수동으로 추가
# 설정 파일을 편집하여 필요한 agents 및 sisyphus 섹션 추가

LSP 도구가 작동하지 않음

문제: 에이전트가 호버, 이동 등의 LSP 기능을 사용할 수 없음

해결:

프로젝트에 LSP 서버가 초기화되었는지 확인:

# TypeScript 프로젝트의 경우
npm install -D typescript

# Python 프로젝트의 경우
pip install python-lsp-server

LSP 구성 확인:

{
  "lsp": {
    "enabled": true,
    "languages": ["typescript", "python", "go"]
  }
}

너무 많은 동시 작업

문제: 너무 많은 백그라운드 작업으로 인해 성능 저하 또는 API 속도 제한 발생

해결: 동시 작업 수를 줄입니다:

{
  "sisyphus": {
    "max_concurrent_tasks": 1  // 1로 감소
  }
}

다음 단계

설치 후 다음 항목을 권장합니다:

📖 핵심 기능을 읽고 모든 기능에 대해 알아보기
🎯 베스트 프랙티스를 확인하여 효율적인 사용 팁 배우기
⚙️ 고급 설정에서 심층 사용자 정의 탐색
💡 사용 사례를 참고하여 영감 얻기

도움 받기

문제가 발생했나요?

📖 GitHub README 확인
🐛 이슈 제출
💬 커뮤니티 토론 참여

다중 에이전트 협업의 강력한 성능을 경험할 준비가 되셨나요? 이 명령을 시도해보세요:

opencode "ultrawork: 현재 프로젝트를 분석하고 개선 제안을 해줘"