Oh My OpenCode 소개
Oh My OpenCode 는 터미널 기반 AI 코딩 에이전트인 OpenCode를 위한 강력한 플러그인입니다. 마치 Zsh 쉘을 사용할 때 Oh My Zsh를 설치하여 생산성을 극대화하는 것처럼, 이 프로젝트는 단일 AI 에이전트를 '전문가 팀'으로 확장시키는 플러그인입니다. 사용자는 Claude나 Gemini , ChatGPT Codex 등 다양한 대규모 코딩 에이전트들을 자신의 구독 정보에 맞춰 오케스트레이션하고, 비동기 서브 에이전트들을 통해 복잡한 개발 작업을 효율적으로 처리할 수 있습니다.
AI 코딩 에이전트 시대가 도래했지만, 단일 모델만으로는 복잡한 맥락 관리나 다양한 도구 활용에 한계가 있었습니다. Oh My OpenCode 는 이러한 문제를 해결하기 위해 여러 전문화된 에이전트(설계, 문서 탐색, 코드 탐색 등)를 동시에 운용하고, OpenCode 의 설정과 도구 통합을 자동화하여 개발자가 즉시 '팀' 단위의 AI 지원을 받을 수 있도록 돕습니다.
특히, Oh My OpenCode는 단순히 OpenCode의 설정을 돕는 것을 넘어, LSP (Language Server Protocol), AST-Grep 같은 고급 도구를 자동으로 통합하고, Claude Code와의 호환성 계층을 제공하여 기존 워크플로우를 그대로 유지하면서도 더 강력한 기능을 제공합니다.
OpenCode 및 Claude Code와의 시너지
기존 OpenCode는 훌륭한 인터페이스를 제공하지만, 기본 상태에서는 모델 간의 유기적인 전환이나 복잡한 도구 체인의 통합을 사용자가 직접 관리해야 하는 번거로움이 있었습니다. 여기에 Oh My OpenCode는 Claude Code 의 명령어 시스템, 스킬(Skill), 그리고 MCP(Model Context Protocol) 표준 등과 완벽하게 호환되는 호환성 계층을 제공합니다.
이를 통해 사용자는 기존에 익숙한 작업 흐름을 유지하면서도, 시스템 내부적으로는 수십 개의 최적화된 도구와 다중 모델 에이전트가 협업하는 강력한 백엔드를 활용할 수 있습니다. 특히 단순한 프롬프트 래퍼를 넘어, 에이전트의 반복적인 오류를 감지하고 스스로 수정하는 로직까지 포함된 점이 가장 큰 차별점입니다.
Oh My OpenCode의 주요 기능
Oh My OpenCode 프로젝트는 단순한 설정 파일이 아니라, 여러 AI 에이전트들을 개발 팀처럼 유기적으로 동작하도록 돕는 정교한 시스템입니다.
상황 인식 및 Ultrawork 모드 전환
이 시스템의 핵심은 사용자의 의도를 파악하는 지능형 키워드 감지 시스템입니다. 사용자가 입력하는 프롬프트에서 ultrawork, plan, act와 같은 특정 키워드가 감지되면, 에이전트는 즉시 해당 작업에 가장 적합한 모드로 태세를 전환합니다. 예를 들어, 대규모 리팩토링이나 복잡한 기능 구현을 의미하는 키워드가 입력되면, 메인 에이전트인 Sisyphus는 즉시 계획 수립 단계로 진입하여 하위 에이전트들에게 업무를 분장할 준비를 마칩니다. 이는 사용자가 매번 "지금은 기획 단계야"라고 명시하지 않아도 AI가 문맥을 파악하고 최적의 도구를 불러옵니다.
전문화된 에이전트 팀
Oh My OpenCode는 단일 에이전트가 모든 것을 처리하는 대신, 역할별로 특화된 에이전트들을 두고, 이 에이전트들 간의 협업을 통해 사용자의 요청을 처리합니다. (아래 소개된 에이전트들의 모델은 Oh My OpenCode가 제안하는 기본 설정 모델이며, 사용자가 사용하는 LLM으로 변경할 수 있습니다)
-
여러 에이전트를 지휘하는 Sisyphus: Claude Opus 4.5 기반의 메인 오케스트레이터입니다. 복잡한 작업을 계획하고, 하위 에이전트에게 위임하며, 전체 워크플로우를 관리합니다. 32k의 사고(Thinking) 버짓을 사용하여 추론 능력을 극대화했습니다.
-
추론/분석을 담당하는 Oracle: GPT 5.2 Medium 모델을 사용하여 아키텍처 설계, 코드 리뷰, 전략 수립을 담당합니다. 논리적 추론과 분석에 특화되어 있습니다.
-
레퍼런스를 담당하는 Librarian: Claude Sonnet 4.5 또는 Gemini 3 Flash를 사용합니다. 공식 문서 조회, 오픈소스 구현 탐색, 코드베이스 내부 분석을 담당하며 근거 기반의 답변을 제공합니다.
-
빠른 탐색을 수행하는 Explore: Grok Code 또는 Gemini 3 Flash를 사용하여 매우 빠른 속도로 코드베이스를 탐색하고 파일 패턴을 매칭합니다.
-
UI/UX에 전문화된 Frontend Engineer: Gemini 3 Pro 를 기반으로 하며, 창의적이고 아름다운 UI 코드를 생성하는 데 탁월한 에이전트입니다.
그 외 기술 문서를 작성하는 document-writer 및 시각적 콘텐츠나 PDF/이미지/다이어그램을 분석하여 정보를 추출하는 multimodal-looker 등도 함께 작업을 수행합니다.
각 에이전트들은 메인 에이전트인 Sisyphus가 알아서 호출하지만, @oracle 한테 이 부분 설계 고민하고서 아키텍쳐 제안을 부탁해줘와 같은 방식으로 명시적 요청도 가능합니다.
Ralph Loop: 무한 루프 방지 및 자기 수정
AI 에이전트를 장시간 운용할 때 가장 큰 문제 중 하나는 에이전트가 특정 작업에서 빠져나오지 못하고 무한 루프를 돌거나, 복잡한 지시를 회피하려고 하는, 일명 '게으름을 피우는 에이전트'입니다. Oh My OpenCode는 이를 방지하기 위해 Ralph Loop라는 감시 메커니즘을 도입했습니다.
이 기능은 일종의 슬래시 명령어(Slash Command)로 제공되며, /ralph-loop "REST API 구축"과 같이 /ralph-loop 를 프롬프트 앞에 추가하여 사용하면 됩니다. Ralph Loop 내에서는 에이전트의 활동을 실시간으로 모니터링하며, 에이전트의 진행이 정체되거나 반복적인 행동 패턴이 감지되면 강제로 개입하여 에이전트의 상태를 리셋하거나 새로운 접근 방식을 시도하도록 '발로 차는(Kick)' 역할을 수행합니다.
에이전트가 사용자의 요청을 완수하고 미리 약속된 <promise>DONE</promise>을 출력하면 완료로 감지하고 멈추게 됩니다. 또는, 사용자가 직접 /cancel-ralph 명령을 내리거나 최대 반복 횟수에 도달하면 멈추게 됩니다. 최대 반복은 기본 100회로 지정되어 있으며, oh-my-opencode.json에서 다음과 같이 설정할 수 있습니다:
{
"ralph_loop": {
"enabled": true,
"default_max_iterations": 100
}
}
이러한 Ralph Loop을 사용하여 사용자는 자리를 비울 때에도 작업이 중단되지 않고 완수될 확률을 비약적으로 높아지게 됩니다.
oh-my-opencode.json을 통한 정밀한 커스텀 설정
Oh My OpenCode는 강력한 기본값을 제공하지만, 사용자가 모든 것을 제어할 수 있도록 설계되었습니다. 설치 시 생성되는 oh-my-opencode.json 설정 파일을 통해 사용자는 각 역할(Sisyphus, Oracle, Librarian 등)을 수행할 모델을 구체적으로 지정할 수 있습니다. 예를 들어, 메인 에이전트인 Sisyphus에게 Claude 대신 OpenAI 모델을 사용하고 싶거나, 특정 작업에만 Gemini를 투입하고 싶다면 이 JSON 파일만 수정하면 됩니다.
{
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
// Antigravity OAuth를 통해 Google Gemini 활성화
"google_auth": false,
/* 에이전트 오버라이드 - 특정 작업에 대한 모델 커스터마이징 */
"agents": {
"oracle": {
"model": "openai/gpt-5.2" // 전략적 추론을 위한 GPT
},
"explore": {
"model": "opencode/grok-code" // 탐색을 위한 빠르고 무료인 모델
},
},
}
또한, 각 에이전트별 모델 설정 외에도 프롬프트나 권한(permission)을 비롯한 다양한 MCP(Model Context Protocol) 서버 설정이나 특정 도구의 활성화 여부도 이 파일에서 통합 관리할 수 있어, 팀 단위로 동일한 개발 환경을 배포하고 공유하는 데에도 매우 유용합니다.
도구 체인 및 MCP 통합
개발 생산성을 높이기 위해 필수적인 도구들이 사전에 완벽하게 통합되어 있습니다. 단순한 텍스트 검색을 넘어 코드의 구조적 의미를 파악하는 AST-Grep, 파일 변경 사항을 추적하고 관리하는 Git 통합 도구, 그리고 다양한 외부 데이터 소스와 연결할 수 있는 MCP 서버들이 기본적으로 설정됩니다. 특히 MCP 지원을 통해 사용자는 Google Drive, Slack, GitHub 등 외부 서비스의 데이터를 에이전트가 직접 조회하고 참조하여 코딩에 활용하도록 확장할 수 있습니다.
또한, Oh My OpenCode에 포함된 Todo Continuation Enforcer는 AI가 긴 작업을 수행하다가 중단하는 것을 방지합니다. 완료되지 않은 작업이 있으면 강제로 계속 진행하게 하여 끝까지 완수하도록 만듭니다.
그 외에도 Comment Checker는 AI가 불필요하게 과도한 주석을 다는 것을 방지하여, 사람이 작성한 코드와 구분되지 않도록 깔끔한 코드를 유지합니다.
Oh My OpenCode 설치 방법
Bun 또는 Node.js 환경에서 다음 명령어를 통해 설치할 수 있습니다. 설치 스크립트는 사용자의 모델 구독 여부를 확인하고 opencode.json 플러그인 설정을 자동으로 구성합니다.
# 기본 설치 (대화형 모드)
bunx oh-my-opencode install
# 또는 구독 정보를 플래그로 지정하여 설치 (비대화형)
bunx oh-my-opencode install --no-tui --claude=max20 --chatgpt=yes --gemini=yes
Bun을 Snap으로 설치한 Ubuntu 사용자는 npx를 사용하거나 Bun을 재설치해야 합니다.
라이선스
Oh My OpenCode 프로젝트는 MIT 라이선스하에 배포되고 있습니다. 누구나 자유롭게 사용, 수정 및 배포할 수 있습니다.
Oh My OpenCode 공식 저장소
https://github.com/code-yeongyu/oh-my-opencode
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 