OpenCode 리뷰 (2) — oh-my-opencode 에이전트팀 구조 · 설치 · 설정
Key Insight
oh-my-opencode는 OpenCode에 단일 에이전트 대신 Sisyphus(Claude Opus 4.5, 32k Extended Thinking) + 6개 전문 에이전트로 구성된 팀을 얹는 하네스.
ultrawork키워드 하나로 병렬 에이전트 전체 활성화. 현재는 Oh-My-OpenAgent로 리브랜딩됨.
출처: https://goddaehee.tistory.com/485 타입: 블로그 (갓대희 tistory) 작성자: 갓대희 유효일: 2026-01-09 시리즈: OpenCode 시리즈 Part 2 (Part 1 | Part 3 | Part 4)
핵심 Takeaway
- 에이전트 팀 패러다임: 3세대(단일 에이전트) → 4세대(에이전트 팀)로 전환. Sisyphus가 Aggressive Delegation으로 전문 에이전트에게 위임해 병렬 처리
- Sisyphus 오케스트레이터: Claude Opus 4.5, Extended Thinking 32k 토큰 예산, 작업 완료까지 멈추지 않는 Todo Continuation Enforcer
- 7개 에이전트 팀(초기 라인업): Sisyphus/Claude Opus 4.5 + Oracle/GPT-5.2 + Librarian/GLM-4.7 Free + Explore/Grok Code + Frontend UI/UX/Gemini 3 Pro + Document-Writer/Gemini 3 Flash + Multimodal-Looker/Gemini 3 Flash
- ultrawork: 한 단어로 모든 기능 활성화 — 병렬 에이전트·백그라운드 실행·Todo Enforcer·전문 에이전트 자동 위임
- Gemini 멀티 계정 로드밸런싱: 최대 10개 Google 계정 등록, Rate Limit 초과 시 자동 순환
- Claude OAuth 차단 (2026-01-09): Anthropic이 써드파티 도구의 Claude Code OAuth 토큰 사용 공식 차단 → API 키 방식만 안전 (valid_as_of 2026-01-09)
상세 요약
OpenCode vs oh-my-opencode 비교
| 구분 | 순정 OpenCode | oh-my-opencode |
|---|---|---|
| 에이전트 | build/plan + @general (3개) | Sisyphus + 6개 전문 에이전트 (총 7개) |
| 모델 선택 | 단일 모델 | 역할별 최적 모델 자동 배정 |
| 작업 방식 | 순차 실행 | 병렬 백그라운드 실행 |
| 작업 완료 보장 | 수동 확인 필요 | Todo Enforcer 자동 지속 |
| 개발 도구 | 기본 8개 | LSP/AstGrep 추가 (총 11+2개) |
| MCP 서버 | 수동 설정 | Exa·Context7·Grep.app 포함 |
AI 코딩 도구 4세대 진화
| 세대 | 도구 예시 | 특징 |
|---|---|---|
| 1세대 코드 완성 | GitHub Copilot | 타이핑 중 다음 코드 제안 |
| 2세대 대화형 | ChatGPT, Claude | 질문→코드 생성 |
| 3세대 단일 에이전트 | Claude Code, Cursor, OpenCode | 하나의 AI가 파일 읽고 수정 |
| 4세대 에이전트 팀 | oh-my-opencode | 전문화된 여러 AI가 역할 분담 협업 |
Sisyphus 오케스트레이터
시지푸스 신화에서 이름을 따온 메인 오케스트레이터. Aggressive Delegation 전략으로 가능한 모든 것을 전문 에이전트에게 위임한다.
- 기본 모델: Claude Opus 4.5
- Extended Thinking: 32k 토큰 예산
- 실행 모드: Sync (결과를 기다림)
- 파일 권한: Read + Write (유일한 쓰기 권한 보유)
작업 흐름: 사용자 요청 분석 → 에이전트 선택 → 병렬 위임 → 결과 통합 → 완료 검증
전문 에이전트 팀 (2026-01 초기 라인업)
| 에이전트 | 역할 | 모델 | 실행 | 파일 권한 |
|---|---|---|---|---|
| Sisyphus | 메인 오케스트레이터 | Claude Opus 4.5 (32k) | Sync | R+W |
| Oracle | 아키텍처 설계·디버깅 어드바이저 | GPT-5.2 Medium | Sync | Read Only |
| Librarian | 공식 문서 탐색·코드 리서치 | GLM-4.7 Free | Async | Read Only |
| Explore | 초고속 코드베이스 탐색 | Grok Code | Async | Read Only |
| Frontend UI/UX | 프론트엔드 개발 | Gemini 3 Pro | Async | R+W |
| Document-Writer | README·API 문서 작성 | Gemini 3 Flash | Async | R+W |
| Multimodal-Looker | PDF·이미지·다이어그램 분석 | Gemini 3 Flash | Async | Read Only |
Dated Claim
에이전트 구성 및 모델 배정은 2026-01 기준. 현재 버전(Oh-My-OpenAgent)에서는 에이전트 라인업과 모델이 변경됨 (Sisyphus/kimi-k2.6, Hephaestus/gpt-5.5, Prometheus 등)
추가 도구 (순정 대비)
- LSP Integration: 11개 도구 (lsp_hover, lsp_goto_definition, lsp_find_references 등) — IDE 수준 코드 네비게이션
- AST-Grep: 2개 작업 × 25개 언어 — 정확한 구조적 리팩토링
- Session History: 4개 도구 — 이전 작업 내용 빠른 참조
- 큐레이팅 MCP: Exa(AI 웹 검색), Context7(공식 문서), Grep.app(GitHub 전체 코드 검색)
설치 방법
# bun 사용 (권장)
bunx oh-my-opencode install
# npm 사용 (Ubuntu/Debian Snap 환경)
npx oh-my-opencode install
# CLI 플래그 방식 (자동화 환경)
bunx oh-my-opencode install --no-tui --claude=max20 --chatgpt=yes --gemini=yes설치 확인: opencode --version (1.0.150 이상 필요)
설정 파일 구조
~/.config/opencode/
├── opencode.json # 플러그인 및 provider 설정
├── oh-my-opencode.json # 에이전트별 모델 매핑
└── antigravity-accounts.json
~/.local/share/opencode/
└── auth.json # API 키 및 인증 정보
oh-my-opencode.json 핵심 필드:
{
"$schema": "...",
"google_auth": true, // Google ADC 직접 인증 (속도↑ 비용↓)
"agents": {
"Sisyphus": { "model": "anthropic/claude-opus-4-5" },
"oracle": { "model": "openai/gpt-5.2" }
}
}Gemini 멀티 계정 로드밸런싱
최대 10개 Google 계정 등록 가능. Rate Limit 초과 시 다음 계정으로 자동 전환 (라운드 로빈).
antigravity auth # 첫 번째 계정
antigravity auth --add # 추가 계정 등록ultrawork 사용법
이 프로젝트를 분석하고 리팩토링 계획을 세워줘 ultrawork
로그인 기능을 구현해줘 ulw
ultrawork 하나로 병렬 에이전트 실행·백그라운드 작업·Todo Continuation Enforcer·전문 에이전트 위임 전체 활성화.
Claude 연동 주의사항
Anthropic OAuth 차단 (2026-01-09)
Anthropic이 써드파티 도구의 Claude Code OAuth 토큰 사용을 공식 차단. 계정 밴 사례 발생. OpenCode/oh-my-opencode에서 Claude 사용 시 API 키 방식만 안전.
- 차단: Claude Pro/Max 구독 OAuth (ToS 위반)
- 허용: Anthropic API 키 (
console.anthropic.com발급)- Google Gemini, OpenAI ChatGPT OAuth는 제한 없음 (2026-01 기준)
연결되는 노트
- OpenCode — oh-my-opencode의 베이스 플랫폼
- Oh-My-OpenAgent — 이 기사의 oh-my-opencode가 현재 리브랜딩된 도구
- OpenCode-입문-설치-설정-oh-my-opencode-사전학습 — OpenCode Part 1 (기초)
- oh-my-openagent-github-readme — OmO 공식 README (최신)