oh-my-claude-sisyphus 소개
oh-my-claude-sisyphus는 Anthropic의 차세대 개발 도구인 Claude Code SDK를 기반으로 설계된 고도화된 멀티 에이전트 오케스트레이션(Multi-Agent Orchestration) 프레임워크입니다. 이 도구의 등장 배경에는 최근 Anthropic의 정책 변화와 AI 개발 도구 생태계의 지각 변동이 밀접하게 연관되어 있습니다. 최근 Anthropic은 타사의 3rd Party 애플리케이션이나 비공식 래퍼(Wrapper)들이 Claude의 웹 구독 플랜(Subscription Plan)을 무단으로 연동하여 사용하는 것을 기술적, 정책적으로 엄격하게 차단하기 시작했습니다. 이로 인해 OpenCode를 비롯하여 Claude의 웹 구독 플랜을 활용하던 코딩 에이전트 도구들을 비롯하여, 많은 개발자들이 사랑하던 OpenCode의 유망한 oh-my-opencode 플러그인의 사용도 힘들어지게 되었습니다.
oh-my-claude-sisyphus 프로젝트는 이러한 oh-my-opencode 플러그인을 Claude Code에서 재현하려는 것을 목표로 하고 있습니다. 즉, 단순히 코드를 대신 작성해주는 보조 도구를 넘어, 개발자가 의도한 목표를 달성할 때까지 멈추지 않고 스스로 작업을 수행하는 자율적 시스템을 지향합니다. 프로젝트의 이름인 oh-my-opencode 플러그인이 제공하는 메인 에이전트인 '시시포스(Sisyphus)'에서 영감을 받았으며, 이는 개발 과정에서 발생하는 수많은 난관과 반복적인 수정 작업을 AI가 끈기 있게 수행하여 끝내 완수해내겠다는 강력한 의지를 담고 있습니다.
기존의 AI 코딩 어시스턴트들이 단발성 질문에 답변하거나 짧은 코드 스니펫을 생성하는 데 그쳤다면, oh-my-claude-sisyphus는 복잡한 개발 워크플로우 전체를 관장합니다. 사용자가 단 한 번의 프롬프트로 기능을 요청하면, 시스템 내부에 존재하는 11개의 전문화된 에이전트들이 유기적으로 협력하여 요구사항 분석부터 구현, 테스트, 그리고 리팩토링까지 수행합니다. 특히 개발자 Yeachan-Heo가 주도한 이 프로젝트는 기존의 oh-my-opencode가 가진 강력한 에이전트 개념을 Claude Code 환경에 최적화하여 이식함으로써, Claude 모델의 뛰어난 문맥 이해 능력과 추론 능력을 극대화한 것이 특징입니다.
이 도구의 가장 큰 차별점은 '완결성'에 있습니다. 대다수의 AI 도구는 중간에 맥락을 놓치거나 사용자의 추가 입력을 기다리며 멈추는 경우가 많지만, 이 시스템은 "작업 완료"라는 명확한 상태에 도달할 때까지 스스로 하위 작업을 생성하고 실행하는 루프(Loop) 구조를 갖추고 있습니다. 이는 개발자가 AI를 지켜보며 일일이 지시를 내리는 마이크로 매니지먼트의 피로감을 획기적으로 줄여주며, 진정한 의미의 '위임(Delegation)'을 가능하게 합니다.
oh-my-opencode와의 연관성
oh-my-claude-sisyphus는 오픈소스 커뮤니티에서 큰 호응을 얻었던 oh-my-opencode의 철학을 계승하고 있지만, 기술적인 기반과 실행 환경 면에서 진일보한 형태를 띠고 있습니다. oh-my-opencode가 OpenAI나 Google 등 다양한 LLM(Large Language Model)을 연결하여 사용할 수 있는 범용적인 에이전트 하네스(Harness) 역할을 수행했다면, oh-my-claude-sisyphus는 Anthropic의 Claude Code라는 특정 플랫폼에 완전히 네이티브(Native)하게 통합된 확장 프로그램입니다.
oh-my-opencode (Original) oh-my-claude-sisyphus (Port)
───────────────────────── ────────────────────────────
┌─────────────────────┐ ┌─────────────────────┐
│ OpenCode Plugin │ │ Claude Code │
│ (Bun runtime) │ │ (Native CLI) │
└─────────┬───────────┘ └─────────┬───────────┘
│ │
┌─────────▼───────────┐ ┌─────────▼───────────┐
│ Multi-Provider │ │ Claude Agent SDK │
│ Orchestration │ │ (Claude only) │
│ ┌───┐ ┌───┐ ┌───┐ │ └─────────┬───────────┘
│ │GPT│ │Gem│ │Grok│ │ │
│ └───┘ └───┘ └───┘ │ ┌─────────▼───────────┐
└─────────┬───────────┘ │ ~/.claude/agents/ │
│ │ (Markdown configs) │
┌─────────▼───────────┐ └─────────────────────┘
│ Custom Tool Layer │
│ (LSP, AST, etc.) │
└─────────────────────┘
이러한 네이티브 통합은 성능과 사용자 경험 측면에서 중요한 이점을 제공합니다. 별도의 복잡한 API 설정이나 외부 런타임 환경을 구성할 필요 없이, Claude Code가 설치된 환경이라면 어디서든 즉시 기능을 확장할 수 있습니다. 또한, Claude 모델이 가진 긴 컨텍스트 윈도우(Context Window)와 우수한 Tool Use 기능을 십분 활용하도록 설계되어, oh-my-opencode 대비 더욱 깊이 있는 코드 분석과 안정적인 긴 호흡의 작업 처리가 가능해졌습니다. 결과적으로 사용자는 기존 도구의 유연함에 더해, 특정 플랫폼에 최적화된 강력한 성능과 편의성을 동시에 누릴 수 있게 되었습니다.
oh-my-claude-sisyphus의 주요 기능
┌─────────────────────────────────────────────────────────────────┐
│ SISYPHUS ORCHESTRATOR │
│ (The Boulder Never Stops) │
└─────────────────────────────────────────────────────────────────┘
│
┌───────────────────┼───────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ PLANNING │ │ EXECUTION │ │ SUPPORT │
├─────────────────┤ ├─────────────────┤ ├─────────────────┤
│ 🔥 Prometheus │ │ 🔮 Oracle │ │ 📚 Librarian │
│ 🎭 Momus │ │ 🎨 Frontend Eng │ │ 🔍 Explore │
│ 🦉 Metis │ │ 🪨 Orchestrator │ │ 📝 Doc Writer │
│ │ │ ✨ Sisyphus Jr │ │ 👁️ Multimodal │
└─────────────────┘ └─────────────────┘ └─────────────────┘
11인의 전문가: 분업화된 에이전트 시스템
이 시스템의 백본은 단일 모델이 모든 것을 처리하는 것이 아니라, 각기 다른 전문성을 가진 11개의 에이전트가 협업하는 구조입니다. 예를 들어, 전체적인 프로젝트의 방향성과 아키텍처를 설계하는 역할은 Oracle 에이전트가 담당하며, 필요한 공식 문서나 라이브러리 사용법을 찾아오는 역할은 Librarian 에이전트가 수행합니다. 실제 코드를 작성하는 단계에서는 Frontend 에이전트나 구현 담당 에이전트가 투입되며, 작성된 코드의 품질을 검증하고 오류를 찾아내는 역할은 Reviewer가 맡습니다.
| 그룹 | 아이콘 | 에이전트 이름 | 모델 | 주요 역할 및 전문 분야 |
|---|---|---|---|---|
| 실행 |  |
Oracle | Opus | 복잡한 디버깅, 아키텍처 설계, 근본 원인 분석 |
 |
Librarian | Sonnet | 문서 탐색, 코드 구조 파악 및 지식 제공 | |
 |
Explore | Haiku | 빠른 파일 검색, 패턴 매칭, 정찰 및 탐색 | |
 |
Frontend | Sonnet | UI 컴포넌트, 스타일링, 접근성 구현 | |
 |
Multimodal | Sonnet | 스크린샷, 다이어그램, 목업 이미지 분석 | |
 |
Doc Writer | Haiku | README, API 문서, 주석 작성 | |
| 기획 |  |
Prometheus | Opus | 전략 기획, 포괄적 작업 계획 수립, 요구사항 인터뷰 |
 |
Momus | Opus | 계획에 대한 비판적 검토, 타당성 평가, 리스크 식별 | |
 |
Metis | Opus | 사전 분석, 숨겨진 요구사항 탐지, 모호성 해결 | |
| 관리 |  |
Sisyphus | Sonnet | 작업 조율, 태스크 위임, 진행 상황 추적 (PM) |
 |
Junior | Sonnet | 구체적 계획 이행, 직접적인 작업 실행 |
이러한 역할 분담은 AI의 고질적인 문제인 '할루시네이션(환각)'을 줄이고 작업의 정확도를 높이는 데 크게 기여합니다. 한 에이전트가 모든 맥락을 유지하려 애쓰는 대신, Orchestrator 에이전트가 전체 작업의 흐름을 조율하고 각 단계에 가장 적합한 전문가 에이전트에게 작업을 할당함으로써, 각 에이전트는 자신에게 주어진 좁은 범위의 문제 해결에만 집중할 수 있기 때문입니다. 또한, 대규모 코드베이스를 탐색하고 문맥을 파악하는 Explore 에이전트는 개발자가 미처 파악하지 못한 프로젝트의 의존성 관계까지 고려하여 안전한 수정을 제안합니다.
시시포스 루프(Sisyphus Loop)와 울트라워크(Ultrawork)
oh-my-claude-sisyphus의 정체성은 /ultrawork (또는 /ulw) 명령어에 집약되어 있습니다. 이 명령어가 실행되면 시스템은 일반적인 챗봇 모드에서 벗어나 '시시포스 모드'로 전환됩니다. 이 모드에서는 AI가 사용자의 추가 개입 없이도 스스로 계획을 수립(Plan)하고, 코드를 수정(Act)하며, 결과를 검증(Verify)하는 과정을 무한히 반복합니다. 만약 테스트가 실패하거나 오류가 발생하면, 시스템은 즉시 원인을 분석하고 새로운 수정 방안을 도출하여 다시 시도합니다.
| 명령어 | 설명 |
|---|---|
| /sisyphus | Sisyphus 멀티 에이전트 오케스트레이션 모드를 활성화하여 작업을 수행합니다. |
| /sisyphus-default | Sisyphus를 영구적인 기본(Default) 모드로 설정합니다. |
| /ultrawork | 병렬 에이전트를 활용하여 최대 성능으로 작업을 수행하는 '울트라워크' 모드를 실행합니다. |
| /deepsearch | 다양한 전략을 복합적으로 사용하여 코드베이스를 심층 검색합니다. |
| /analyze | 특정 대상에 대해 깊이 있는 분석과 조사를 수행합니다. |
| /plan | Prometheus 에이전트와 함께 기획 세션을 시작하여 작업 계획을 수립합니다. |
| /review [plan-path] | 수립된 계획을 Momus 에이전트가 비판적으로 검토합니다. |
| /prometheus | 인터뷰 방식의 워크플로우를 통해 요구사항을 구체화하고 전략을 기획합니다. |
| /orchestrator | 복잡하고 단계가 많은 작업을 조율하고 관리합니다. |
| /ralph-loop | 작업이 완료될 때까지 멈추지 않고 스스로를 호출하며 반복 실행하는 자기 참조 루프를 시작합니다. |
| /cancel-ralph | 현재 실행 중인 Ralph Loop를 즉시 취소합니다. |
| /update | 도구의 최신 업데이트를 확인하고 설치합니다. |
이 과정에서 개발자는 /deepsearch 명령어를 통해 심층적인 정보 검색을 수행하게 하거나, /plan 명령어로 작업의 우선순위를 재조정하게 할 수 있습니다. 이러한 명령어 체계는 AI에게 단순한 지시를 내리는 것을 넘어, AI의 행동 양식(Behavior Mode) 자체를 제어할 수 있는 강력한 인터페이스를 제공합니다. 즉, 개발자는 AI라는 엔진의 출력을 조절하는 드라이버가 되어 프로젝트의 진행 속도와 방향을 결정하게 됩니다.
엔지니어링의 깊이: LSP와 ast-grep 통합
단순히 텍스트를 생성하는 LLM의 한계를 극복하기 위해, 이 프로젝트는 실제 IDE(통합 개발 환경)에서 사용되는 기술들을 적극적으로 도입했습니다. 가장 주목할 만한 점은 LSP(Language Server Protocol)와의 통합입니다. LSP를 통해 에이전트는 코드를 단순한 텍스트 덩어리가 아닌, 함수 정의(Go to Definition), 참조 관계(Find References), 타입 정보, 구문 오류(Diagnostics) 등을 포함한 구조적인 데이터로 이해합니다. 이를 통해 변수명 변경이나 함수 시그니처 수정과 같은 작업 시 발생할 수 있는 부수적인 오류를 사전에 차단합니다.
더불어, ast-grep의 도입은 코드 리팩토링의 정밀도를 획기적으로 높였습니다. ast-grep은 텍스트 매칭이 아닌 추상 구문 트리(AST, Abstract Syntax Tree) 기반의 검색 및 치환 도구입니다. 이를 활용하면 "이 패턴과 비슷한 코드를 모두 바꿔줘"와 같은 모호한 요청도 문법적 구조에 맞춰 정확하게 처리할 수 있습니다. 예를 들어, 들여쓰기나 줄 바꿈이 다르더라도 논리적 구조가 같다면 동일한 코드로 인식하여 수정합니다. 또한, AI가 생성한 코드에 불필요하게 포함되는 주석을 자동으로 감지하고 제거하는 Comment Checker 기능은 결과물의 품질을 사람이 작성한 코드 수준으로 유지해 줍니다.
oh-my-claude-sisyphus 설치 및 통합 워크플로우
oh-my-claude-sisyphus은 Claude Code 기반으로 동작하므로, 반드시 미리 Claude Code의 설치 및 유효한 구독 또는 API Key가 설정되어 있어야 합니다. oh-my-claude-sisyphus는 Node.js 환경에서 동작하며, NPM(Node Package Manager)을 통해 손쉽게 설치할 수 있습니다.
설치 과정은 매우 직관적이며, 설치가 완료되는 즉시 Claude Code의 설정 디렉토리(~/.claude/agents)에 필요한 에이전트 정의와 설정 파일들이 자동으로 배치됩니다.
# oh-my-claude-sisyphus 설치
npm install -g oh-my-claude-sisyphus
설치 후 Claude Code를 실행하면, 자동으로 확장된 에이전트 기능과 슬래시 커맨드들이 로드되어 별도의 재시작이나 복잡한 연동 과정 없이 즉시 사용할 수 있습니다. 이는 개발자가 도구 설정에 시간을 낭비하지 않고 본연의 개발 업무에 바로 집중할 수 있도록 돕는 세심한 배려가 돋보이는 부분입니다.
라이선스
oh-my-claude-sisyphus 프로젝트는 MIT 라이선스 하에 자유롭게 공개 및 배포되고 있습니다. 누구나 무료로 사용, 수정 및 재배포가 가능하며, 상업적 이용에도 큰 제약이 없습니다.
oh-my-claude-sisyphus 프로젝트 GitHub 저장소
더 읽어보기
-
Oh My OpenCode: 다수의 SubAgent 및 도구들을 활용하는, OpenCode를 위한 All-in-One 플러그인
-
Mysti: 멀티 에이전트 AI 코딩 팀을 구성해주는 VS Code 확장 (Claude + Codex + Gemini + Copilot)
-
DeepCode: Multi-Agent System(MAS) 기반의 오픈 에이전틱 코딩(Open Agentic Coding) 플랫폼
-
Claude Flow: 여러 개발 AI 에이전트들의 협력을 제어하고 자동화하는 AI 오케스트레이션 플랫폼(AI Orchestration Platform)
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 