oh-my-claude-sisyphus (시지포스) 소개: Claude Code 기반 멀티 에이전트 AI 코딩 도구

오늘날 소프트웨어 개발 과제는 규모와 복잡성이 커지면서 단일 AI 챗봇만으로 해결하기 어렵습니다. oh-my-claude-sisyphus(시지포스)는 Claude Code 환경에서 여러 전문 에이전트를 협업시켜 복잡한 작업을 자동으로 완수하는 멀티-에이전트 오케스트레이션 도구입니다.

한 번의 /sisyphus <작업> 명령어로 Oracle, Librarian, Prometheus 등 11개 특화 에이전트가 분업하여 과제를 처리하므로 개발 생산성을 크게 향상시킵니다. 단 한 번의 명령으로 여러 AI가 협력해 작업을 끝까지 밀어붙인다는게 메인 아이디어입니다.

이 도구는 뭐예요?

oh-my-claude-sisyphus(오마이 클로드 시지포스)는 Anthropic의 ‘클로드코드’와 Claude Agent SDK를 기반으로 만든 멀티 에이전트 오케스트레이션 시스템입니다.

원래 OpenCode용으로 개발된 ‘oh-my-opencode’의 아이디어를 ‘클로드코드’에 맞춰 옮겨 온 것으로, 하나의 코딩 작업을 여러 전문 에이전트에게 분산시켜 끝까지 처리하는 것이 핵심입니다.

이를 위해 총 11개의 에이전트(예: 아키텍처 분석 전문가 Oracle, 문서 조사 전문가 Librarian, 기획 전문가 Prometheus 등)가 역할별로 나뉘어 작동합니다.

시스템 이름인 ‘시지포스(Sisyphus)’는 바위를 끈질기게 굴리는 그리스 신화 속 시지프스의 집요함을 본따, 작업이 중단되지 않고 끝까지 밀어붙인다는 의미를 담고 있습니다.

왜 지금 이게 뜨는가

최근 ‘클로드코드’ 플랫폼의 성장과 함께 AI 코딩 환경이 빠르게 변화하고 있습니다. 특히 Anthropic은 ‘클로드코드’ CLI 전용 구독자를 위한 보안 조치로 타사 클라이언트(OpenCode 등)의 우회 사용을 차단했는데, 이 사건은 개발자 커뮤니티에 큰 파장을 일으켰습니다.

이러한 변화로 인해 기존에 oh-my-opencode 같은 도구를 사용하던 개발자들은 ‘클로드코드’ 환경에서도 비슷한 편의성을 유지할 방법을 찾게 되었습니다. 따라서 oh-my-claude-sisyphus는 기존 아이디어를 ‘클로드코드’ 환경에 맞게 재설계하여 등장한 것입니다.

또한 단일 AI 에이전트는 복잡한 장기 프로젝트에서 문맥 손실, 계획 부족, 일관성 저하 등의 한계를 보이는데, 멀티 에이전트 시스템은 이를 보완합니다. 따라서 지금은 여러 AI를 협업시켜 작업을 분산 처리하는 오케스트레이션 방식이 각광받고 있습니다.

전체 구조

oh-my-claude-sisyphus 시스템은 중앙의 시지포스 오케스트레이터가 전체 작업을 관리하고, 기획→실행→검토 단계의 여러 전문 에이전트가 병렬로 작업을 수행하는 구조입니다. 예를 들어 /sisyphus 인증 모듈 리팩터링 명령을 실행하면, Prometheus가 계획을 수립하고, Oracle/Librarian 등 실행 에이전트가 코드 분석 및 작성 작업을 병렬로 처리하며, Momus가 최종 검토를 맡는 식입니다. 각 에이전트는 Opus, Sonnet, Haiku 등 Claude 모델에서 최적화된 버전을 사용하여 자신의 역할을 수행합니다.

설치/준비물

시지포스를 사용하려면 먼저 Anthropic의 ‘클로드코드’ CLI를 설치하고, 해당 구독(API 키)이 필요합니다. macOS/Linux 환경에서는 기본 Bash 셸을 사용해 다음 한 줄 명령어로 쉽게 설치할 수 있습니다:

• macOS/Linux (Bash):curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/scripts/install.sh | bash
• 视窗npm install -g oh-my-claude-sisyphus

위 스크립트는 Claude Code 설정 디렉터리(~/.claude/)에 필요한 에이전트 파일 및 설정을 자동으로 추가합니다. 설치 완료 후 claude 명령어로 ‘클로드코드’를 실행하면 /sisyphus, /ultrawork 등 슬래시 명령어가 활성화됩니다. (Windows 사용자는 Node.js 20+를 설치하고 npm 방식으로, macOS/Linux 사용자는 위 Bash 스크립트 방식을 권장합니다.)

실전 사용법 (Step-by-step)

실제 사용 예를 들어보겠습니다. ‘클로드코드’ 터미널을 실행한 뒤 claude 명령을 입력하면 대화창이 열립니다. 여기에서 /sisyphus로 작업을 지시하면 멀티 에이전트 모드가 시작됩니다.

1. ‘클로드코드’ CLI 실행: 터미널에서 claude 명령어를 입력하여 ‘클로드코드’를 시작합니다.
2. 작업 지시 입력: 예를 들어/sisyphus 인증 모듈 리팩터링 명령을 입력합니다.
3. 진행 및 결과 확인: Prometheus(계획 담당), Oracle/Librarian(코드 실행 담당), Momus(검토 담당) 등 여러 에이전트가 병렬로 작업을 수행합니다. 작업 진행 상황이 순차적으로 출력되고, 모든 에이전트가 과제를 완수하면 최종 결과가 반환됩니다.

이 과정에서 /plan, /review, /ultrawork 등의 슬래시 명령어를 조합하면 기획-실행-검토 워크플로우를 더욱 체계적으로 운영할 수 있습니다. 예를 들어 /plan 사용자 인증 설계로 작업 계획을 먼저 수립한 후, 이어서 /sisyphus 인증 모듈 리팩터링을 실행하면 됩니다.

바로 써먹는 팁 3가지

1. 매직 키워드 활용: 프롬프트에 ultrawork, search, analyze 같은 단어를 포함하면 자동으로 고성능 모드나 심층 검색/분석 모드가 활성화됩니다. 예: ultrawork 사용자 인증 구현은 병렬 실행 모드로 전환됩니다.
2. 슬래시 커맨드 조합: /plan, /review, /ultrawork 등을 조합해 워크플로우를 관리하세요. 예를 들어 /plan 기능 X로 먼저 상세 계획을 수립한 후 /sisyphus 기능 X를 실행하면, 계획-실행-검토 단계를 체계적으로 진행할 수 있습니다.
3. 지속 모드 및 자동 업데이트: /sisyphus-default 명령어를 사용하면 기본 모드를 항상 Sisypus로 설정할 수 있고, /update로 최신 버전으로 유지하세요. /ultrawork 모드는 최대 병렬 처리로 효율을 극대화합니다.

온라인 반응/후기 요약

커뮤니티 반응은 엇갈립니다. 시지포스가 복수 에이전트 실행으로 파일 분석 등 작업을 병렬 처리해 속도가 개선되고 결과가 보다 정교해진다고 평가했습니다. 반면 일부 개발자는 도구가 복잡하고 안정성이 떨어지며, 대체로 느리다고 지적했습니다.

예를 들어, 한 사용자는 oh-my-opencode(시지포스 전신)에서 여러 차례 크래시를 겪었다고 했습니다. 또한 설치와 자동 업데이트에 대한 우려도 있습니다. GitHub 계정 기반의 스크립트 설치와 배경 자동 업데이트 기능은 편리하지만 보안상 주의가 필요하다는 지적이 있습니다.

그럼에도 새로운 AI 코딩 도구라는 점에서 호기심을 보이는 의견이 많습니다.

리스크 & 주의사항 (TOS/보안/비용)

• 费用: 멀티 에이전트가 병렬로 실행되므로 단일 요청당 사용 토큰이 크게 증가합니다. ‘클로드코드’ 구독을 이용하더라도 과도한 요청은 비용 부담이 커질 수 있습니다.
• 보안/개인정보: 모든 코드는 Anthropic 서버로 전송되어 처리되므로, 민감한 데이터를 다룰 때 주의해야 합니다. 또한 서드파티 플러그인 설치이므로 출처가 불분명한 코드가 실행될 수 있으며, 자동 업데이트로 코드가 변경될 수 있음을 염두에 두어야 합니다.
• 이용 약관: oh-my-claude-sisyphus는 공식 ‘클로드코드’ 환경을 사용하므로 현재까지 계정 정지 등의 위험성은 낮지만, Anthropic의 정책 변경 가능성에는 유의해야 합니다. 과거에 OpenCode 우회 사례가 있었던 만큼, 사용 전 최신 TOS를 확인하는 것이 좋습니다.

常见问题

• oh-my-claude-sisyphus는 무엇인가요?
  ‘클로드코드’ CLI에서 동작하는 멀티 에이전트 오케스트레이션 시스템입니다. 여러 전문 AI 에이전트가 협업하여 복잡한 코딩 작업을 완수합니다.
• 설치 방법은 어떻게 되나요?
  ‘클로드코드’가 설치된 환경에서 Bash 또는 npm을 통해 한 줄 스크립트로 설치할 수 있습니다. Windows는 npm install -g oh-my-claude-sisyphus, macOS/Linux는 curl ... | bash로 설치하세요.
• 필요한 사전 조건은요?
  Anthropic Claude Code 구독(API 키)과 Claude Code CLI가 필요합니다. Windows의 경우 Node.js 20+가 필요합니다.
• 몇 개의 에이전트가 있나요?
  Oracle, Librarian, Prometheus 등 11개의 역할별 에이전트와 조율자(Orchestrator)가 기본으로 제공됩니다.
• oh-my-opencode와 다른 점은 무엇인가요?
  oh-my-opencode는 여러 AI 모델(GPT, Gemini 등)을 혼용할 수 있지만, 시지포스는 Claude 전용으로 일관된 환경을 제공합니다. 대신 설치가 간편하고 설정이 단순화된 장점이 있습니다.
• 비용은 얼마나 드나요?
  도구 자체는 오픈소스(MIT)로 무료지만, Claude Code 유료 구독과 사용한 토큰 비용이 발생합니다.
• 어떤 AI 모델을 사용하나요?
  ‘클로드코드’ 환경의 Opus, Sonnet, Haiku 등 Claude 모델이 사용됩니다. 에이전트별로 최적 모델이 할당되도록 구성되어 있습니다.
• 안전한가요?
  프로젝트는 GitHub 오픈소스(MIT)로 공개되어 있으므로 코드를 직접 확인할 수 있습니다. 하지만 자동 업데이트나 서드파티 스크립트 실행은 신뢰할 수 있는 출처인지 검토해야 합니다.

组织起来

oh-my-claude-sisyphus는 Claude Code 기반 AI 코딩 도구의 새 장을 열었습니다. 여러 에이전트의 협업을 통해 복잡한 프로젝트를 자동으로 마무리하는 혁신적인 접근으로, 개발 생산성 향상에 많은 잠재력을 보여줍니다. 오늘 다룬 개념과 설치/사용법을 실습해보면, 멀티 에이전트 워크플로우가 실제 개발에 어떤 도움이 되는지 직접 확인할 수 있을 것입니다.

관심이 있으신 분은 oh-my-claude-sisyphus와 유사한 AI 개발 도구(예: oh-my-opencode) 간 차이점을 비교해보시기 바랍니다.