[TIP]Oh My OpenCode(Antigravity연동)

---

🎯 Oh My OpenCode란 무엇인가?

Oh My OpenCode는 OpenCode라는 터미널 기반 AI 코딩 어시스턴트를 위한 고급 에이전트 향상 레이어입니다. 단일 에이전트 경험을 고도로 오케스트레이션된 멀티 에이전트 개발 환경으로 변형합니다.

핵심 가치

단일 AI 에이전트 → 전문화된 멀티 에이전트 시스템

각 에이전트는 특정 역할에 최적화되어 있어, 복잡한 개발 작업을 더 효율적으로 처리할 수 있습니다.

---

🔄 주요 특징

1. 전문화된 멀티 에이전트 시스템

에이전트	역할	모델
Sisyphus	메인 오케스트레이터 (계획 및 위임)	Claude Opus 4.5
Oracle	아키텍처, 전략, 고난이도 디버깅	GPT-5.2
Librarian	문서 및 오픈소스 분석	Claude/Gemini
Explore	빠른 코드베이스 검색	Grok/Gemini
Frontend UI/UX Engineer	미적 UI 구축	Gemini 3 Pro
Document-Writer	기술 문서 작성	Gemini 3 Flash
Multimodal-Looker	시각 자료 분석	Gemini 3 Flash

2. 고급 도구 통합

• LSP & AST-Grep: 전문 IDE 도구 제공 (정의로 이동, 리팩토링, 구조적 검색)
• MCP 통합: Model Context Protocol 지원 (예: Playwright 브라우저 자동화)
• 백그라운드 실행: 병렬 작업을 차단 없이 실행

3. 생산성 모드

모드	설명	활성화 방법
Ultrawork	고정밀 병렬 오케스트레이션 모드	프롬프트에 ulw 추가
Ralph Loop	작업이 100% 완료될 때까지 반복	/ralph-loop "작업 설명"

---

📖 설치 가이드

MacOS

Step 1: OpenCode 설치

brew install opencode

Step 2: 계정 인증

opencode auth login

Step 3: OpenCode 실행

opencode

Step 4: Oh My OpenCode 설치

Bun이 설치되어 있지 않다면 먼저 설치:

curl -fsSL https://bun.sh/install | bash

터미널 재시작 후:

npx oh-my-opencode install

Windows

Step 1: OpenCode 설치

npm i -g opencode-ai@latest

Step 2: OpenCode 실행

Warp 터미널에서 실행

Step 3: 계정 인증

OpenCode 내에서 계정 연동 진행

Step 4: Bun 설치

powershell -c "irm bun.sh/install.ps1|iex"
export BUN_INSTALL="$HOME/.bun" 
export PATH="$BUN_INSTALL/bin:$PATH" 

Warp 터미널 재시작 후 Oh My OpenCode 설치:

bunx oh-my-opencode install

or 

npx oh-my-opencode install

Step 5: Antigravity 연결

설치 중 Google > OAuth with Google (Antigravity) 선택

---

⚙️ 설정

설정 파일 위치

OS	경로
MacOS	~/.claude/opencode/opencode.json ~/.claude/opencode/oh-my-opencode.json
Windows	C:\Users\[USER_ID]\.config\opencode\opencode.json C:\Users\[USER_ID]\.config\opencode\oh-my-opencode.json

opencode.json에 추가할 모델 정의

"antigravity-claude-sonnet-4-5-thinking-high": {
  "name": "Claude Sonnet 4.5 (thinking high)",
  "thinking": true,
  "attachment": true,
  "limit": {
    "context": 1048576,
    "output": 65535
  },
  "modalities": {
    "input": ["text", "image", "pdf"],
    "output": ["text"]
  }
},
"antigravity-claude-opus-4-5-thinking-high": {
  "name": "Claude Opus 4.5 (thinking high)",
  "thinking": true,
  "attachment": true,
  "limit": {
    "context": 1048576,
    "output": 65535
  },
  "modalities": {
    "input": ["text", "image", "pdf"],
    "output": ["text"]
  }
}

oh-my-opencode.json 설정 예시

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  "google_auth": false,
  "agents": {
    "Sisyphus": {
      "model": "google/antigravity-claude-opus-4-5-thinking-high"
    },
    "librarian": {
      "model": "google/antigravity-claude-opus-4-5-thinking-high"
    },
    "explore": {
      "model": "google/antigravity-gemini-3-flash"
    },
    "oracle": {
      "model": "google/antigravity-claude-opus-4-5-thinking-high"
    },
    "frontend-ui-ux-engineer": {
      "model": "google/antigravity-gemini-3-pro-high"
    },
    "document-writer": {
      "model": "google/antigravity-gemini-3-flash"
    },
    "multimodal-looker": {
      "model": "google/antigravity-gemini-3-flash"
    }
  }
}

---

🚀 사용법

기본 사용

opencode

OpenCode가 시작되면 자연어로 작업을 요청하면 됩니다.

특정 에이전트 호출

@oracle에게 아키텍처를 리뷰해달라고 요청
@librarian에게 문서를 찾아달라고 요청
@explore에게 코드베이스를 검색해달라고 요청

Ultrawork 모드 활성화

프롬프트에 ulw 또는 ultrawork를 포함시켜 최대 성능 모드를 활성화:

ulw 새로운 API를 설계하고 구현해줘

Ralph Loop 사용

작업이 완료될 때까지 반복 작업:

/ralph-loop "프로젝트의 버그를 모두 수정해줘"

디렉토리별 컨텍스트 제공

프로젝트 디렉토리에 AGENTS.md 파일을 생성하면 해당 디렉토리에서 에이전트에게 추가 컨텍스트를 제공할 수 있습니다.

---

📊 비교표

특징	일반 IDE 도구	Oh My OpenCode
에이전트	단일 AI	전문화된 멀티 에이전트
IDE 통합	IDE 내장	터미널 기반
LSP 지원	기본	고급 LSP & AST-Grep
병렬 실행	제한적	완전 백그라운드 지원
확장성	플러그인	MCP 프로토콜
제어 수준	낮음	높음

---

🛠️ 트러블슈팅

문제	원인	해결책
Bun 설치 오류	Windows PATH 설정 문제	Warp 터미널 재시작 후 재시도
Antigravity 모델 미표시	Google 인증 실패	OpenCode에서 Google 재인증
에이전트 응답 없음	설정 파일 오류	JSON 문법 확인
MCP 스킬 작동 안함	스킬 설치 누락	해당 스킬 설치 확인

---

✨ 팁

1. Ultrawork 적극 활용: 복잡한 작업에서는 항상 ulw를 사용하여 최대 성능을 끌어내세요
2. 에이전트 전문화 활용: 프론트엔드 작업은 frontend-ui-ux-engineer, 아키텍처는 oracle에 요청
3. 백그라운드 활용: 긴 검색 작업을 백그라운드로 돌려서 코딩과 병렬 진행
4. AGENTS.md 활용: 각 프로젝트별로 에이전트에게 컨텍스트를 제공하여 품질 향상
5. 설정 최적화: 프로젝트에 따라 각 에이전트의 모델을 최적의 것으로 변경

---

📚 추가 리소스

• OpenCode 공식 사이트: OpenCode 기본 정보
• Oh My OpenCode GitHub: 프로젝트 리포지토리
• Antigravity Auth Migration Guide: 인증 마이그레이션 가이드

---

★ Insight ─────────────────────────────────────

1. 멀티 에이전트 설계: 각 에이전트는 특정 작업에 최적화되어 있어, 전문가 팀과 협업하는 것과 같은 효과를 얻을 수 있습니다.
2. 백그라운드 아키텍처: 병렬 실행을 통해 시간 절약이 가능하며, 사용자는 결과가 나올 때까지 기다리지 않고 계속 작업할 수 있습니다.
3. MCP 확장성: 새로운 도구와 스킬이 계속 추가되고 있어, Oh My OpenCode는 계속해서 더 강력해집니다.
   ─────────────────────────────────────────────────

---

⚠️ 면책 조항

본 가이드를 따르면서 발생하는 모든 결과에 대한 책임은 전적으로 사용자 본인에게 있습니다. 이 문서는 참고용으로 제공되며, 작성자는 어떠한 손해나 문제에 대해 책임지지 않습니다.

금지 사항:

• 본 내용을 악의적인 목적으로 사용하는 것을 엄격히 금지합니다.
• 타인의 권리를 침해하거나 불법적인 활동에 사용하는 것을 금지합니다.
• 상업적 목적의 무단 복제나 재배포를 금지합니다.

본 가이드의 내용은 학습 및 교육 목적으로만 사용해야 합니다.