nyldn/claude-octopus

Claude Octopus – Claude Code용 멀티 LLM 위원회

개요

• Claude Code(Anthropic의 IDE 스타일 코딩 어시스턴트)용 오픈소스 플러그인으로, 기본 제공되는 Claude 모델과 함께 최대 12개의 외부 LLM 제공업체(예: Codex, Copilot, Ollama, Qwen, Perplexity, OpenRouter 등)를 통합할 수 있습니다.
• 이 플러그인은 /octo:* 슬래시 명령어를 명시적으로 호출하기 전까지는 비활성 상태를 유지합니다. 일반적인 Claude 프롬프트는 평소처럼 실행되며, Octopus는 다른 의견이나 구조화된 다중 모델 검토가 필요할 때만 실행됩니다.

주요 기능

기능	설명
멀티 모델 위원회	/octo:council은 3~7개의 페르소나(Claude Opus, GPT-5.6, Claude Sonnet 등)로 토론을 실행하며, 목표 모드(조언, 결정, 계획, 구현, 검토)와 스타일(균형, 적대적, 레드팀, 임원)을 구성할 수 있습니다. 75% 합의 게이트는 코드가 배포되기 전에 불일치를 표시합니다.
영구 메모리	claude-mem, agentmemory, deja-vu와 통합되어 결정, 연구, 컨텍스트가 세션 간에 유지됩니다.
Dark-Factory 모드	높은 수준의 사양을 받아 연구, 설계, 개발, 전달의 전체 파이프라인을 자동으로 실행하고 최종 출력만 검토용으로 제시합니다.
전문 페르소나 및 스킬	31개의 기본 제공 역할(보안 감사자, 백엔드 아키텍트 등), 54개의 슬래시 명령어, 63개의 재사용 가능한 워크플로우 모듈을 조합하여 사용할 수 있습니다.
제공업체별 활성화	제공업체를 하나씩 추가할 수 있으며, 각 제공업체는 명시적인 Octopus 워크플로우 내에서만 활성화됩니다. 시작하는 데 외부 제공업체가 필요하지 않으며, Claude만으로 충분합니다.
안전 및 비용 가드	합의 게이트, 예산 상한, 토큰 압축, 선택적 피어 체크 라우팅(OCTOPUS_PREMIUM_PEER_CHECK)을 제공합니다.
CLI 및 IDE 지원	Claude Code 슬래시 명령어, Codex 플러그인($skill-doctor, $skill-debug), Cursor IDE용 MCP 서버(octopus_discover 같은 도구 노출)로 작동합니다.
상태 및 진단	octopus doctor, octopus repair, octopus security-audit 같은 명령어로 설치 상태, 제공업체 준비 상태를 확인하고 플러그인 파일을 감사할 수 있습니다.

일반적인 워크플로우

1. 설정 – claude plugin marketplace add … && claude plugin install octo@nyldn-plugins를 실행한 다음 Claude Code 내에서 /octo:setup을 실행합니다.
2. 일반 작업 – Claude의 기본 /init, /review, /security-review 명령어를 사용합니다.
3. 에스컬레이션 – 다른 의견이 필요할 때 /octo:council --goal decision "이 모놀리스를 분할해야 할까요?" 또는 전체 Discover→Define→Develop→Deliver 주기를 위해 /octo:embrace 같은 명령어를 실행합니다.
4. 검토 – Octopus가 응답을 집계하고 합의 게이트를 적용하며 통합된 계획이나 코드 diff를 제시합니다. 개별 제공업체 도구(/octo:debug, /octo:research 등)를 계속 호출할 수도 있습니다.

설치 빠른 시작

# 터미널에서 (Claude Code 외부)
claude plugin marketplace add https://github.com/nyldn/plugins.git
claude plugin install octo@nyldn-plugins

# Claude Code 내부에서
/octo:setup   # 제공업체를 감지하고, 설정을 작성하고, 설치를 완료합니다.

• Linux/macOS를 기본 지원하며, Windows는 WSL 또는 SSH를 통해 지원합니다.
• Codex CLI의 경우: codex plugin marketplace add … && codex plugin add claude-octopus@nyldn-plugins.
• Cursor IDE의 경우: 리포지토리를 클론하고, MCP 서버(npm install)를 설치한 다음 ~/.cursor/mcp.json에 추가합니다.

성숙도

• 활발히 유지 관리 중(최신 릴리스 v11.14.2, CI 배지에서 테스트 통과 표시).
• 버전별 기능 추가, 마이그레이션 가이드, 버그 수정을 포함한 광범위한 변경 로그.
• Claude Code v2.1.14+ 필요(최대 185개 기능 플래그 추적, v2.1.284와 호환).

라이선스

• MIT 라이선스 – 무료로 사용, 수정, 재배포할 수 있습니다.

혜택을 받을 수 있는 대상

• Claude Code에 의존하지만 코드 병합 전에 다른 LLM의 독립적인 검증을 원하는 팀.
• 안전 중요 또는 보안에 민감한 소프트웨어를 개발하고 적대적 검토가 필요한 개발자.
• 필요할 때만 켤 수 있고 모든 프롬프트에서 모든 제공업체에 비용을 지불하지 않는 "자동 연구-코드" 파이프라인을 찾는 모든 사람.

---

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.