여러분 이거 경험 있죠? OpenCode
Claude Code 쓰고 싶은데 월 $20가 부담스러운 거.
“무료로 비슷한 거 없나?” 하고 검색해본 거.
저도요.
근데 말이죠. 진짜로 있어요.
결론부터: oh-my-opencode는 $24,000 상당의 토큰 테스트를 거친 OpenCode 플러그인
2026년 1월 5일 기준, oh-my-opencode는 v2.12.3 버전으로, 개발자 code-yeongyu가 $24,000 상당의 토큰을 투자해 테스트한 OpenCode용 플러그인입니다. 비동기 서브에이전트(Claude Code처럼!), LSP/AST 도구, MCP 내장 등 Claude Code급 기능을 무료로 제공합니다.
핵심 스펙 (GitHub에서 확인):
| 항목 | 내용 |
|---|---|
| 버전 | v2.12.3 (2026-01-05) |
| 메인 에이전트 | Sisyphus (Claude Opus 4.5 기반) |
| 서브에이전트 | oracle (GPT 5.2), librarian, explore, frontend-ui-ux-engineer 등 7개 |
| 핵심 기능 | Async Subagents, LSP/AST, Todo Continuation Enforcer, MCP 내장 |
| 가격 | 무료 (API 비용만) |
| 테스트 규모 | $24,000 상당의 토큰 사용 |
🚨 경고: Anthropic Claude 계정을 OAuth로 연결하면 계정이 밴될 수 있습니다! Gemini나 OpenAI API 사용을 권장합니다. (상세 내용은 아래에서 설명)
🚨 먼저 알아야 할 것: Anthropic 계정 밴 사례
이거 왜 먼저 말하냐면요.
진짜 중요해서요.
최근 커뮤니티에서 OpenCode에 Claude 계정(OAuth)을 연결해서 사용하다가 계정이 정지되는 사례들이 보고되고 있습니다.
알려진 상황
| 항목 | 내용 |
|---|---|
| 문제 | OpenCode에 Claude OAuth 연결 시 밴 위험 |
| 원인 추정 | Anthropic 서비스 약관 위반 |
| VPN 사용 시 | 더 위험하다는 의견 다수 |
| 공식 입장 | Anthropic 공식 발표 없음 (2026년 1월 기준) |
| 우회 방법 | Gemini나 다른 계정으로 테스트 중 |
솔직히 저도 아직 헤비하게 사용 안 해봤어요. 근데 커뮤니티에서 밴 사례가 나오니까 조심해야 할 것 같아요.
Anthropic 정책이니 어쩔 수 없어요. Gemini 무료 티어나 OpenAI API 쓰는 게 안전합니다.
안전한 사용법
✅ 권장하는 방법: - Gemini API 사용 (무료 티어 있음!) - OpenAI API 사용 - Claude API 키 방식 사용 (OAuth X) ❌ 피해야 하는 방법: - Claude 계정 OAuth 직접 연결 - VPN + Claude OAuth 조합
oh-my-opencode가 뭔데?
oh-my-opencode… 이름부터 뭔 소린지 모르겠죠?
쉽게 말할게요.
“OpenCode를 Claude Code 수준으로 만들어주는 플러그인”
끝. 이게 전부예요.
oh-my-zsh 아시죠? 터미널을 화려하게 꾸며주는 그거. 비슷한 컨셉이에요.
OpenCode라는 오픈소스 AI 코딩 에이전트가 있는데, 기본 상태로는 좀 밋밋해요. 여기에 oh-my-opencode 플러그인을 얹으면 Claude Code급 기능들이 추가됩니다.
GitHub README에서 개발자가 직접 밝힌 내용:
“Claude Code is great. But if you’re a hacker, you’ll fall head over heels for OpenCode.”
“Certified, Verified, Tested, Actually Useful. Harness in Production, after $24,000 worth of tokens spent.”
$24,000어치 토큰으로 테스트했다는 거예요. 실화냐…
핵심 기능: Sisyphus와 7개의 서브에이전트
여러분 이거 왜 Sisyphus(시시포스)냐고요?
그리스 신화에서 시시포스는 영원히 바위를 굴려 올려야 하는 벌을 받은 인물이에요. LLM 에이전트도 똑같이 “돌(할 일)”을 계속 굴려야 하니까 이런 이름을 붙인 거예요.
재밌죠?
메인 에이전트: Sisyphus
| 항목 | 내용 |
|---|---|
| 모델 | Claude Opus 4.5 |
| 역할 | 전체 오케스트레이션, 태스크 위임, 병렬 실행 |
| 특징 | 작업이 완료될 때까지 멈추지 않음 |
서브에이전트 목록 (GitHub에서 확인)
| 에이전트 | 모델 | 역할 |
|---|---|---|
| oracle | GPT 5.2 | 아키텍처, 코드 리뷰, 전략 |
| librarian | Claude Sonnet 4.5 / Gemini 3 Flash | 문서 조회, 구현 예시 검색 |
| explore | Grok Code / Gemini 3 Flash / Claude Haiku | 빠른 코드베이스 탐색 |
| frontend-ui-ux-engineer | Gemini 3 Pro High | UI/UX 설계 및 프론트엔드 개발 |
| document-writer | Gemini 3 Flash | 기술 문서 작성 |
| multimodal-looker | Gemini 3 Flash | PDF, 이미지, 다이어그램 분석 |
Claude Code처럼 서브에이전트가 있다는 게 핵심이에요.
근데 oh-my-opencode는 **비동기(Async)**로 동작해요. 무슨 말이냐면:
“Gemini 3 Pro가 프론트엔드를 백그라운드에서 작성하는 동안, Claude Opus 4.5가 백엔드를 처리. 디버깅이 막히면 GPT 5.2 호출. 프론트엔드 완료 보고가 오면 검증하고 배포.”
이게 된다고?
실제로 GitHub 리뷰를 보면:
“Knocked out 8000 eslint warnings with Oh My Opencode, just in a day” — Jacob Ferrari
“I converted a 45k line tauri app into a SaaS web app overnight” — 커뮤니티 사용자
하루 만에 8,000개 eslint 워닝 해결, 4만5천 줄 앱을 하룻밤에 SaaS로 변환…
실화냐…
핵심 기능 상세: Claude Code와 비교
1. Todo Continuation Enforcer
이거 왜 중요한지 아세요?
AI 에이전트 쓰다 보면 중간에 멈추는 경우 많잖아요. “여기까지 했어요~” 하고 끝나버리는.
Todo Continuation Enforcer는 이걸 방지해요. 에이전트가 중간에 포기하면 강제로 계속하게 만들어요.
이게 바로 시시포스가 바위를 계속 굴리게 만드는 장치예요.
2. Comment Checker
AI가 코드 짜면 주석을 과하게 다는 경우 많죠?
// This function adds two numbers
// Parameters: a and b
// Returns: the sum of a and b
function add(a, b) {
// Add a and b together
return a + b; // Return the result
}
이런 거 보면 짜증나잖아요.
Comment Checker가 이걸 방지해요. 시시포스가 작성한 코드는 인간이 쓴 것처럼 보여야 한다는 철학이에요.
3. LSP/AST 도구
LSP… 뭔 소린지 모르겠죠?
쉽게 말하면 **”코드 구조를 이해하는 도구”**예요.
일반 AI는 코드를 텍스트로 봐요. 근데 LSP/AST 도구가 있으면 코드를 구조로 봐요.
- 이 함수가 어디서 호출되는지
- 이 변수가 어디서 사용되는지
- 리팩토링할 때 어디를 바꿔야 하는지
이걸 정확히 알 수 있어요. 리팩토링 정확도가 확 올라가요.
4. MCP 내장 (Model Context Protocol)
MCP가 뭐냐면요.
**”AI한테 외부 도구 쓸 수 있게 해주는 규격”**이에요.
oh-my-opencode는 3개의 MCP가 기본 탑재:
| MCP | 기능 |
|---|---|
| Context7 | 라이브러리 공식 문서 자동 참조 |
| Exa (Web Search) | 실시간 웹 검색 |
| Grep.app | GitHub 수백만 저장소 코드 검색 |
“React 18에서 useEffect 어떻게 쓰더라?” 물어보면 공식 문서에서 직접 가져와서 답해요.
환각? 거의 없음.
5. Claude Code 호환 레이어
Claude Code의 Command, Agent, Skill, MCP, Hook 시스템과 호환돼요.
기존에 Claude Code용으로 만든 설정이 있으면 그대로 쓸 수 있다는 뜻이에요.
설치 방법
자, 이제 설치해봅시다.
STEP 1: OpenCode 먼저 설치
oh-my-opencode는 OpenCode의 플러그인이에요. OpenCode가 먼저 있어야 해요.
OpenCode 설치 방법은 공식 문서를 참고하세요.
STEP 2: oh-my-opencode 설치
Bun으로 설치 (권장)
bunx oh-my-opencode
npm으로 설치
npx oh-my-opencode
설치 프로그램이 대화형으로 물어봐요:
- ChatGPT 구독 있어요? (Y/N)
- Claude 구독 있어요? (Y/N)
- Gemini 구독 있어요? (Y/N)
있는 거 체크하면 알아서 설정해줘요.
끝. 진짜 이게 끝이에요.
STEP 3: API 인증 설정
⚠️ 다시 한번 강조: Claude OAuth는 피하세요!
oh-my-opencode GitHub README에 보면 여러 인증 방법이 있어요:
Gemini (Antigravity Auth) – 권장
# opencode-antigravity-auth 플러그인 추가 # 최대 10개 Google 계정 로드밸런싱 지원!
OpenAI (Codex Auth)
# opencode-openai-codex-auth 플러그인 추가
자세한 설정은 GitHub README의 “Installation > For Humans” 섹션 참고하세요.
Magic Word: ultrawork
이거 진짜 신기해요.
설정이 복잡하다고요?
그냥 프롬프트에 ultrawork (또는 ulw) 한 단어만 넣으면 돼요.
ultrawork 이 프로젝트 리팩토링해줘
그러면:
- 병렬 에이전트 자동 활성화
- 백그라운드 태스크 자동 실행
- 완료될 때까지 멈추지 않음
에이전트가 알아서 다 해요.
설정 커스터마이징
기본 설정 그대로 써도 되지만, 바꾸고 싶으면 바꿀 수 있어요.
설정 파일 위치
~/.config/opencode/oh-my-opencode.json
또는 프로젝트별로:
.opencode/oh-my-opencode.json
에이전트 모델 변경
{
"agents": {
"oracle": {
"model": "openai/gpt-5.2"
},
"librarian": {
"model": "google/gemini-3-flash"
}
}
}
특정 기능 비활성화
{
"disabled_hooks": ["comment-checker"],
"disabled_mcps": ["websearch_exa"]
}
GitHub 사용자 리뷰
제가 직접 헤비하게 써본 건 아니에요. 솔직히 말할게요.
근데 GitHub에 올라온 리뷰들을 보면:
“Oh My Opencode is king of the hill and has no contenders” — RyanOnThePath
“use oh-my-opencode, you will never go back” — d0t3ch
“ok yeah holy shit this thing is legit” — z80.eth
“Hire @yeon_gyu_kim if you can convince him, this dude has revolutionized opencode.” — mysticaltech
사용자들 반응이 꽤 좋아 보여요.
Claude Code와 실제 차이점
Claude Code가 더 나은 점
| 장점 | 설명 |
|---|---|
| 안정성 | Anthropic 공식 지원, 버그 수정 빠름 |
| Claude 최적화 | Claude 모델에 완벽 튜닝 |
| 간편함 | 설치하고 바로 사용 |
oh-my-opencode가 더 나은 점
| 장점 | 설명 |
|---|---|
| 가격 | 무료 (API 비용만) |
| 모델 자유 | GPT, Gemini, Claude 등 선택 가능 |
| 비동기 서브에이전트 | 백그라운드에서 병렬 실행 |
| 커스터마이징 | 오픈소스라 자유롭게 수정 |
| $24,000 테스트 | 실전 검증됨 |
결론
| 상황 | 추천 |
|---|---|
| 돈 있고 편하게 쓰고 싶다 | Claude Code |
| 무료로 시작하고 싶다 | oh-my-opencode |
| 여러 모델 조합하고 싶다 | oh-my-opencode |
| 비동기 병렬 작업 필요 | oh-my-opencode |
자주 묻는 질문 (FAQ)
Q1. 진짜 무료예요?
oh-my-opencode 자체는 무료예요. 다만 AI 모델 API 사용료는 발생해요. Gemini 무료 티어 쓰면 거의 무료로 가능.
Q2. Claude 계정 밴되면 복구 되나요?
공식적인 복구 방법은 알려지지 않았어요. 처음부터 OAuth 연결을 피하는 게 좋아요. API 키 방식이나 Gemini/OpenAI 사용 권장.
Q3. OpenCode랑 oh-my-opencode 차이가 뭐예요?
- OpenCode: 기본 오픈소스 AI 코딩 에이전트
- oh-my-opencode: OpenCode용 플러그인 (기능 확장)
oh-my-zsh가 zsh를 강화하듯이, oh-my-opencode가 OpenCode를 강화해요.
Q4. ultrawork가 뭐예요?
프롬프트에 ultrawork 넣으면 모든 고급 기능이 자동 활성화돼요. 병렬 에이전트, 백그라운드 태스크, 완료까지 자동 실행.
Q5. 어떤 모델이 가장 좋아요?
상황마다 달라요:
- 빠른 응답: Gemini Flash
- 복잡한 코딩: Claude Sonnet, GPT 5.2
- 무료로 시작: Gemini 무료 티어
주의사항 정리
- 🚨 Anthropic OAuth 밴 위험: Claude 계정 OAuth 연결 피하세요
- ✅ API 키 방식 권장: Gemini, OpenAI API 사용
- 💰 API 비용 확인: 사용량 따라 비용 발생
- 🔧 초기 설정: Claude Code보다 세팅에 시간 좀 걸림
마무리: 무료로 Claude Code급 경험을 원한다면
솔직히 저도 아직 헤비하게 써본 건 아니에요.
근데 GitHub에서 확인한 정보들, 사용자 리뷰들 보면 꽤 괜찮아 보여요.
$24,000어치 토큰으로 테스트했다는 것도 신뢰가 가고요.
다만 Anthropic OAuth 밴 이슈는 진짜 주의해야 해요. Gemini나 OpenAI API 쓰세요.
한 줄 요약:
oh-my-opencode = OpenCode + Claude Code급 기능
(단, Claude OAuth 연결은 피하세요!)
궁금한 거 있으면 댓글 남겨주세요!
🔗 참고 링크
- oh-my-opencode GitHub: https://github.com/code-yeongyu/oh-my-opencode
- OpenCode 공식: https://opencode.dev
- Gemini API (무료 티어): https://ai.google.dev