claude-octopus

🐙 Claude Octopus
모든 AI 모델에는 사각지대가 있습니다. Claude Octopus는 열두 개의 외부 프로바이더 통합 — Codex, Antigravity CLI, Copilot, Qwen, Ollama, Perplexity, OpenRouter, OrcaRouter, OpenCode, Cursor CLI, Grok, Kimi Code — 을 내장 Claude Code 호스트와 함께 지원하며, 출시 전에 의견 불일치를 표시하는 합의 게이트를 제공합니다.

Claude 네이티브 우선, Octopus는 에스컬레이션용. Claude만으로 충분할 때는 Claude 네이티브 /init, /review, /security-review를 사용하세요. 여러 모델의 의견, 적대적 리뷰, 또는 더 엄격한 멀티 LLM 워크플로가 필요할 때 Octopus를 사용하세요.

Claude Octopus는 독립 오픈소스 프로젝트입니다. Anthropic과 제휴, 보증, 후원 관계가 없습니다.

🐙 리서치, 빌드, 리뷰, 출시 — 열두 개의 외부 프로바이더가 호스트의 작업을 검증합니다. Claude 네이티브가 일반적인 경로를 처리합니다. Octopus는 명시적으로 /octo:* 를 실행할 때까지 휴면 상태로 있다가 에스컬레이션 경로를 처리합니다. 75% 합의 게이트가 의견 불일치를 프로덕션에 도달하기 전에 잡아냅니다.

🧠 세션 간 기억. claude-mem, agentmemory, deja-vu와 통합되어 영구 메모리를 제공합니다 — 과거 결정, 리서치, 컨텍스트가 세션 경계를 넘어 유지됩니다.

⚡ 스펙 입력, 소프트웨어 출력. Dark Factory 모드는 스펙을 받아 전체 파이프라인 — 리서치, 정의, 개발, 전달 — 을 자율적으로 실행합니다. 모든 단계가 아니라 결과물을 리뷰합니다.

🔄 작업에 필요한 워크플로를 선택하세요. 아키텍처, 디버깅, TDD에는 집중된 방법을 사용하세요. Discover → Define → Develop → Deliver에는 /octo:embrace를 사용하며, 각 단계 사이에 품질 게이트가 있습니다.

🐙 31개의 특화 페르소나(security-auditor, backend-architect 같은 역할별 AI 에이전트), 54개의 커맨드(직접 입력하는 슬래시 커맨드), 63개의 스킬(재사용 가능한 워크플로 모듈). 명시적 워크플로가 필요한 전문가를 선택하며, 일반적인 Claude 요청은 Octopus를 활성화하지 않습니다.

🐙 Claude만으로도 작동합니다. 최대 열두 개의 외부 프로바이더 통합을 추가할 수 있습니다. 시작하는 데 외부 프로바이더는 전혀 필요하지 않습니다. 하나씩 추가하세요 — 각 프로바이더는 감지되면 사용 가능해지며 명시적 워크플로 안에서만 실행됩니다.

💰 이미 접근 권한이 있다면 다섯 개 프로바이더는 추가 비용이 없습니다. Codex, Antigravity CLI, Copilot, Cursor CLI는 기존 구독 또는 로컬 인증을 사용합니다. Ollama는 로컬에서 무료로 실행됩니다. Qwen은 이제 API 키 또는 Coding-Plan 인증이 필요하며, 무료 OAuth 티어는 2026-04-15에 종료되었습니다.

새로운 기능
리뷰가 자체 발견 사항과 증명 패킷을 유지합니다
artifactId가 없는 리뷰는 이제 별도의 실행 ID를 예약하므로, 같은 초에 두 개의
리뷰를 시작해도 더 이상 좌석이 차단되거나 발견 사항이 덮어쓰이지 않습니다.
기본적으로 Claude Code 세션 내에서 반복 및 동시 Octopus 실행도
별도의 증명 패킷을 유지하여 각 실행의 이벤트와 요약을 보존합니다.
OCTOPUS_PROOF_RUN_ID 를 설정하는 경우, 패킷을 분리하려면 실행마다 고유한 값을 사용하세요.
리뷰 증거를 참조하세요.

카운슬이 고유 파일명 인용을 인식합니다
카운슬 좌석은 .github/workflows/ 를 생략했다는 이유로 blind 처리되지 않고
pr-watchdog.yml:249 같은 고유 파일명을 인용할 수 있습니다. 그라운딩과
인용 검증은 중첩 체크아웃의 사본을 제외하고 고유 파일명과 경로 접미사를 해석합니다.
그라운딩은 모호하거나 누락되었거나 안전하지 않은 경로, 그리고 파일 끝을 넘는
줄 번호를 거부합니다. 인용 검증은 해석된 파일에서 일치하는 텍스트를 확인하며
줄 번호가 범위를 벗어나더라도 성공할 수 있습니다. 저장소 접미사보다 고유하게
일치하는 첨부 컨텍스트를 먼저 확인합니다. 인용 검증을 참조하세요.

🆕 v11.15.3 — 동시 리뷰와 증명 패킷을 분리하고, 카운슬에서 고유 파일명 인용을 해석합니다.

기본 로스터: Claude Opus 5.5가 아키텍처, 계획, 보안 추론, 최종 판단을 이끌고, GPT-5.6 Sol이 독립적인 구현/리뷰 피어이며, Claude Sonnet 5.5가 표준 Claude 좌석이고, Fable 5.1은 옵트인 판단 에스컬레이션으로 남습니다. 기존 모델 핀과 프로바이더 구성이 여전히 우선합니다. 라우팅 전략을 참조하세요.

/octo:model-config # 프론티어 로스터 조회 또는 재정의
OCTOPUS_OPUS5_AUTO_XHIGH=1 # 자동 xhigh Opus 5 단계 옵트인
OCTOPUS_OPUS_MODEL=claude-fable-5-1 # Fable 5.1 명시적 옵트인
OCTOPUS_CODEX_MODEL=gpt-6-astra # Astra 명시적 옵트인
/octo:model-config tier premium claude claude-fable-5-1 # 경계가 정해진 Fable 판단 좌석 하나
/octo:model-config tier premium codex gpt-6-astra # 경계가 정해진 Astra 판단 좌석 하나

🆕 v9.41 — 멀티 LLM 카운슬. /octo:council은 Claude, Codex, Antigravity, OpenCode에 걸쳐 구조화된 3/5/7인 페르소나 심의를 실행하며, 목표 모드(advice, decision, plan, implement, review), 스타일(balanced, adversarial, red-team, executive, implementation), 벤치마크 인식 역할 라우팅, 정족수 + 핵심 거부권 게이트, 예산 상한, 승인된 계획에 대한 게이트된 워크트리 핸드오프를 제공합니다. 한 모델의 의견으로 충분하지 않을 때 사용하세요.

/octo:council --goal decision --style adversarial " 이 서비스는 모놀리식으로 유지해야 할까? "
/octo:council --goal implement --implement plan-only " 인증 흐름을 리팩터링해줘 "

버전
주요 기능

v11.15.3 (신규)
동시 리뷰와 증명 패킷을 분리하고, 카운슬에서 고유 파일명 인용을 해석합니다.

v9.50
Claude Code 2026 호환성 레이어 — 루틴 매니페스트(스케줄 + GitHub 이벤트 자동화), SubagentStop 품질/비용 게이트, /octo:usage 비용 귀속, worktree.bgIsolation 옵트아웃, Claude Agent SDK 좌석(Opus 4.8과 함께 도입되었으며 이제 현재 Opus 5 기본값을 따름), 스타터 스킬 팩, 예상 컨텍스트 비용이 포함된 /plugin browse 매니페스트.

v9.41
/octo:council이 일급 워크플로로 승격 — 목표 모드, 적대적/레드팀 스타일, 벤치마크 인식 페르소나 라우팅, 정족수 및 핵심 거부권 게이트, 예산 사전 점검, 승인된 구현 계획에 대한 게이트된 워크트리 핸드오프를 갖춘 구조화된 멀티 LLM 심의.

v9
Claude Code 호스트와 함께 최대 10개의 외부 프로바이더 통합(Codex, Antigravity CLI, Copilot, Qwen, Ollama, Perplexity, OpenRouter, OrcaRouter, OpenCode, Grok). 구조화된 프로바이더 토론과 구성 가능한 멀티 LLM 카운슬. 기본적으로 명시적 전용 활성화, 선택적 스마트 라우터 제공. 에이전트 요약 표가 실제로 기여한 프로바이더를 보여줍니다. 프로바이더 인식 프롬프트 사전 점검이 조용한 초과 크기 실패를 방지합니다. 리서치 폭 모드가 light, standard, exhaustive 조사를 펼칩니다. 설정 별칭과 퍼지 /octo:* 교정이 커맨드 마찰을 줄입니다. 옵트인 규율 게이트와 토큰 압축. 2단계 리뷰. 활성 워크플로 내에서 자동 프로바이더 복구를 갖춘 서킷 브레이커. Cursor + OpenCode + Codex 상호 호환성. bin/octopus CLI. v2.1.219까지 182개의 Claude Code 기능 플래그(Opus 5, Sonnet 5, 동적 워크플로 인식 포함).

v8
인라인 PR 코멘트가 포함된 멀티 LLM 코드 리뷰. 격리된 git 워크트리의 병렬 워크스트림. 반응 엔진 — CI 실패에 자동 응답. 32개의 특화 페르소나. Dark Factory 자율 파이프라인.

v7
Double Diamond 워크플로. 멀티 프로바이더 디스패치. 품질 게이트와 합의 점수. 구성 가능한 샌드박스 모드.

전체 변경 로그 →

V10 마이그레이션 가이드 →

v10으로 업그레이드
V10은 내구성 있는 실행 계약, fail-closed 기여 검증, Doctor 2.0, Provider Registry 2.0, 프로세스 트리 취소 증거, 옵트인 eval 라우팅을 추가합니다. 기존 프로바이더 및 모델 핀이 여전히 우선합니다. doctor --json을 사용하는 자동화는 유효한 JSON 본문을 유지하면서 종료 코드 1을 처리해야 하며, 잘못된 인수는 2 를 반환합니다. 호환성 및 롤백 세부 사항은 마이그레이션 가이드를 참조하세요.

9.5x로 업그레이드

현재의 새 구성은 Codex 구현/리뷰에 GPT-5.6 Sol, 프리미엄 Claude 작업에 Claude Opus 5.5, 표준 Claude 좌석에 Claude Sonnet 5.5를 사용합니다. 기존 환경, 세션, providers.json 핀은 변경되지 않으며, OCTOPUS_LEGACY_ROLES=1 은 프론티어 이전 역할 매핑을 복원합니다.

새 claude-sdk 좌석 환경 변수(v9.50): CLAUDE_SDK_API_KEY, OCTOPUS_CLAUDE_SDK_MODEL, OCTOPUS_CLAUDE_SDK_MAX_TOKENS, OCTOPUS_CLAUDE_SDK_ALLOWED_MODELS, OCTOPUS_CLAUDE_SDK_CONTEXT_BUDGET.
Fable 가드는 claude-fable-5-1 및 보존된 claude-fable-5 핀에 적용됩니다. OCTOPUS_FABLE5_MAX_EFFORT는 다른 가드를 비활성화하지 않고 기본 high 상한을 높입니다.
프리미엄 Claude 역할 라우팅(architect, strategist, security-reviewer를 Opus로)은 v9.29에 도입되었으며, OCTOPUS_LEGACY_ROLES=1 로 이전 매핑을 복원할 수 있습니다.

빠른 시작
# 터미널(Claude Code 세션 내부가 아님):
claude plugin marketplace add https://github.com/nyldn/plugins.git
claude plugin install octo@nyldn-plugins

# 그런 다음 Claude Code 내부에서:
/octo:setup
이게 전부입니다. 설정은 설치된 프로바이더를 감지하고, 누락된 항목을 보여주며, 구성을 안내합니다. 시작하는 데 외부 프로바이더는 전혀 필요하지 않습니다 — Claude는 내장되어 있습니다.

지원 플랫폼: Linux와 macOS는 네이티브로 실행됩니다. Windows의 경우
WSL 또는 데스크톱 SSH 세션 내에서 Claude Code CLI를 사용하세요.
네이티브 Git Bash, MSYS2, Cygwin은 지원되지 않습니다. Octopus 훅은 해당 호스트에서
Claude Code와 Codex 모두에서 즉시 종료되며, 설치 또는 세션 상태를 기록하지 않습니다.

기본적으로 휴면
Octopus를 설치해도 일반 프롬프트가 라우팅되거나, 프로바이더 워크플로가 실행되거나,
Octopus 에이전트로 위임되지 않습니다. 배포된 모든 커맨드와 스킬은 Claude
Code의 네이티브 수동 호출 게이트를 사용합니다. /octo:* 로 시작하세요.

disable-model-invocation 때문에 Skill 도구와 함께 사용할 수 없다는 메시지가 보이나요?
그것은 게이트가 의도대로 작동하는 것입니다 — 모델이 Octopus 스킬을 자동 호출하려 한 것입니다.
대신 명시적으로 호출하세요: skill-doctor 스킬에 대한 모델 호출이 아니라
수동으로 호출 가능한 스킬인 /octo:skill-doctor 를 입력하세요. 슬래시 스킬은
사용자가 호출하므로 이 호출 게이트를 우회합니다. 아래 라우터를 옵트인하지 않는 한
모델이 스스로 Octopus 스킬을 호출하지 않습니다. 경험칙:
Octopus는 /octo:… 로 호출하고, Claude가 알아서 찾아주기를 기대하지 마세요.

선택적 자동화는 여전히 사용 가능하지만 명시적 옵트인입니다:

export OCTOPUS_AUTO_ROUTER_MODE=suggest # 일반 프롬프트에 경로 제안
# 또는: OCTOPUS_AUTO_ROUTER_MODE=invoke # 일치하는 커맨드 경로 로드
export OCTO_DONE_CRITERIA=on # 복합 작업 완료 코칭
export OCTOPUS_COMPRESS_ENABLED=true # PostToolUse 출력 압축
export OCTO_STRATEGY_ROTATION=on # 실패 전략 로테이션
export OCTOPUS_CONTEXT_AWARENESS=on # 상태줄-컨텍스트 강화
export OCTOPUS_SESSION_MEMORY=on # SessionStart 환경설정 복원
이 레거시 옵트인은 일반 프롬프트를 검사합니다. invoke는 유료
외부 프로바이더 워크플로를 시작하고 라우팅된 프롬프트 컨텍스트를 구성된
프로바이더와 공유할 수 있습니다. 그 동작이 의도된 것이 아니라면 suggest를 선호하세요. 프로바이더 측
보존은 각 프로바이더 계정 정책을 따릅니다. 변수를 해제하거나(또는 off 로 설정) 직접 /octo:* 커맨드를 비활성화하지 않고 옵트아웃하세요.

잘못된 직접 Codex, Qwen, 또는 은퇴한 Gemini CLI 디스패치를 방지하는
안전 가드는 계속 사용 가능하지만, 호스트 측 커맨드 필터가 관련 없는 도구 호출에서
이를 배제합니다.

설치 상태
어떤 커맨드를 사용해야 할지 모르겠나요? /octo:guide 또는 /octo:auto help를 실행하여
설치된 버전의 커맨드를 둘러보세요. 둘 다 프로바이더 워크플로를 시작하지 않습니다.

Octopus는 각 호스트에 대해 비밀이 아닌 설치 메타데이터를 기록합니다. Claude Code와
Codex는 별도 항목을 유지하므로, 호스트를 전환하거나 하나의 캐시를 업데이트해도
다른 쪽이 최신으로 보이지 않습니다. SessionStart는 로드된 루트, 버전, 범위, 또는 프로필이
변경되면 활성 호스트 항목을 새로 고칩니다.

octopus capabilities --json # 프로바이더 준비 상태 및 지원 인터페이스
octopus doctor installation # 로드된 루트, 안정 루트, 저장된 메타데이터
octopus cache-check --json # 활성, 최신, 오래된, 안정 플러그인 루트
octopus repair --dry-run # 깨졌거나 오래된 안정 링크 설명
octopus repair --apply # 해당 링크 복구 및 설치 메타데이터 새로 고침
octopus security-audit --json # 설치된 플러그인 파일의 오프라인 검사
octopus handoff export --json # 다른 지원 호스트용으로 정제된 체크포인트
repair --apply는 Octopus가 소유한 안정 플러그인 루트와 설치
메타데이터만 변경합니다. 심볼릭 링크를 지원하지 않는 플랫폼에서 안정 루트에는
Octopus 스크립트 진입점용으로 생성된 래퍼가 포함됩니다. Repair …