nyldn/claude-octopus

Claude Octopus – Claude Code를 위한 다중 LLM 오케스트레이션 계층

무엇인가요 – Claude Octopus는 Claude Code (Anthropic의 IDE 스타일의 코딩 어시스턴트)용 플러그인입니다. 명시적으로 /octo:* 명령을 실행하기 전까지는 대기 상태에 있으며, 그 시점에서 최대 12개의 외부 LLM 제공자 (예: Codex, Antigravity CLI, GitHub Copilot, Qwen, Ollama, Perplexity, OpenRouter, OrcaRouter, OpenCode, Grok, Kimi Code)를 병렬 또는 구조화된 '의회' 형태로 호출하여 실행할 수 있습니다. 내장된 Claude 모델은 기본값으로 유지되며, Octopus는 여러 의견, 적대적 검토, 또는 더 엄격한 품질 게이트가 필요한 경우에만 상향 처리로 사용됩니다.

주요 기능

• 합의 게이트 – 75% 합의 기준을 통해 코드 배포 전 불일치를 사전에 탐지합니다.
• 지속적 메모리 – claude‑mem 및 agentmemory와 통합되어 세션 간에 결정과 연구 결과가 유지됩니다.
• '다크 팩토리' 모드 – 사양을 제공하면 Octopus가 자동으로 전체 파이프라인(연구 → 정의 → 개발 → 배포)을 실행하고, 최종 출력만 검토하면 됩니다.
• 메서드 인식 워크플로우 – 아키텍처, TDD, 디버깅 등에 특화된 사전 구성된 흐름으로, 각각 적절한 페르소나 세트를 선택합니다.
• 다중 LLM 의회 – /octo:council는 3~7명의 페르소나를 다양한 제공자에서 구성할 수 있으며, 목표(조언, 결정, 계획, 구현, 검토)와 스타일(균형, 적대적, 레드팀, 경영진)을 구성 가능합니다.
• 풍부한 페르소나 라이브러리 – 보안 감사관, 백엔드 아키텍트 등 31개의 전문 AI 에이전트와 63개의 재사용 가능한 워크플로 모듈에 매핑되는 53개의 슬래시 명령어.
• 제로 제공자 시작 – Octopus를 설치하고 Claude만으로 사용 가능; 외부 제공자는 하나씩 추가되며, 명시적 워크플로우 내에서만 사용 가능합니다.
• 비용 인식 – Codex, Antigravity CLI, Copilot, Cursor CLI, Ollama의 5개 제공자는 기존 구독 또는 로컬 실행 시 추가 비용 없이 사용 가능합니다.

사용 방법

1. 설치 – Claude Code의 플러그인 마켓플레이스에서 (/plugin → marketplace → install octo).
2. Claude 세션 내에서 /octo:setup 실행 – 명령어가 설치된 외부 제공자를 감지하고 필요한 설정을 안내합니다.
3. 워크플로우 호출 예시:

   /octo:embrace   # 완전한 Discover → Define → Develop → Deliver 파이프라인
   /octo:council --goal decision --style adversarial "이 모노리스를 분리해야 할까요?"
   /octo:review   # 두 번째 모델에 의한 독립적인 코드 리뷰
   

4. 선택 사항 자동 라우터 모드는 일반 프롬프트에 대해 Octopus의 제안 또는 자동 호출을 가능하게 합니다 (OCTOPUS_AUTO_ROUTER_MODE=suggest|invoke).

지원 환경 – Claude Code에서 네이티브로 작동하지만, 리포지토리에는 다음도 포함되어 있습니다:

• Codex CLI 플러그인 (codex plugin add claude‑octopus).
• MCP 서버 (Cursor IDE용; Node.js 서버로 octopus_discover와 같은 도구를 노출).
• OpenCode 및 기타 Claude 호환 호스트용 간단한 설치 스크립트.

버전 11.2.0 주요 업데이트

• Matt Pocock의 기술 세트에서 유도된 새로운 엔지니어링 방법.
• 기본 모델 로스터: Claude Opus 5 (아키텍처 및 보안), GPT‑5.6 Sol (구현/검토), Claude Sonnet 5 (표준 세션), 선택적 Claude Fable 5.1.
• 세부 제어를 위한 환경 변수 (예: OCTOPUS_OPUS5_AUTO_XHIGH, OCTOPUS_CONTEXT_AWARENESS).

안전성 및 업데이트

• 모든 Octopus 명령은 명시적인 슬래시 명령어 호출을 통해 제한됩니다; 모델은 사용자가 명시하지 않으면 Octopus를 자동으로 호출할 수 없습니다.
• 내장 진단 도구 (octopus doctor config, octopus doctor skills, octopus doctor updates).
• 자동 업데이트는 기본적으로 비활성화되어 있으며, Claude UI에서 활성화하거나 제공된 orchestrate.sh 스크립트를 실행할 수 있습니다.

대상 사용자 – 이미 Claude Code를 사용하고 있으며, 고위험 코드, 아키텍처 결정, 또는 자율적인 사양에서 코드로의 파이프라인에 대해 통제된 다중 모델 리뷰 계층을 원하는 개발자.

---

결론 – Claude Octopus는 오픈소스 오케스트레이션 플러그인으로, Claude Code가 12개의 다른 LLM 제공자에게 호출하고, 합의 검사를 수행하며, 명시적인 사용자 명령 뒤에 에ンド투엔드 개발 워크플로우를 자동화할 수 있게 합니다.