hex/claude-council

Claude Council은(는) Anthropic의 Claude Code용 플러그인으로, 여러 다른 AI 모델에 동시에 질의하고 답변을 나란히 표시하며, 일치하는 부분과 차이가 있는 부분을 보여주는 종합 결과를 함께 표시합니다. 단일 모델의 편향이 잘못된 결정을 초래할 수 있는 상황(아키텍처 선택, 디버깅 난관, 보안 검토, 프레임워크 선택 등)에 유용합니다.

작동 방식

• 병렬 쿼리: 질문(예: /claude-council:ask "Should I use UUID or BIGINT primary keys?")을 하면 플러그인이 구성된 모든 공급자에게 동시에 전송합니다.
• 공급자: Gemini, OpenAI(GPT/Codex), Grok, Perplexity, Kimi 및 OpenRouter의 모든 모델과 통신할 수 있습니다. 또한 로컬 CLI(Codex, Antigravity, Grok 등)나 API 키가 필요 없는 로컬 Ollama 모델도 사용할 수 있습니다.
• 나란히 보기: tmux 창(또는 Claude 인터페이스)에서 각 공급자의 답변을 공급자와 모델을 나타내는 색상 헤더와 함께 볼 수 있으며, 마지막으로 일치와 차이를 구분하는 종합이 표시됩니다.
• 종합의 미묘함: 모든 공급자가 동의하는 경우 종합은 그 동의의 기반이 되는 근본적인 가정을 명시합니다(예: "모두가 검사할 수 없는 시스템에 대한 동일한 설명을 받았습니다"). 이는 만장일치 답변으로 인한 잘못된 확신을 방지합니다.

주요 기능

• 역할 – --roles를 사용하여 각 공급자에게 다른 관점(보안, 성능, 악마의 대변인 등)을 할당합니다.
• 토론 모드 – --debate는 두 라운드로 실행됩니다. 공급자가 답변한 후 서로의 답변을 보고 반박하여 더 깊은 종합을 이끌어냅니다.
• 에이전트 강화 분석 – --agents는 Claude 분석 에이전트를 사용하여 각 공급자의 응답을 비판하고, 신뢰도 가중 합의와 맹점 분석을 생성합니다(느리고 더 비쌉니다).
• 로컬 카운슬 – --local은 외부 API 키가 없을 때 다른 역할을 가진 여러 블라인드 Claude 하위 에이전트를 사용합니다(훈련 데이터를 공유한다는 정직한 경고와 함께).
• 자동 컨텍스트 주입 – 관련 파일(예: auth → src/auth/*.ts)을 감지하여 질문에 포함합니다.
• 이미지 지원 – --image는 비전 지원 공급자에게 스크린샷을 첨부합니다.
• 캐싱 – 응답은 캐시되어(프롬프트+공급자+모델+역할로 키 지정) 시간과 비용을 절약합니다.
• 백그라운드 작업 – --async는 긴 쿼리를 백그라운드에서 실행하고 나중에 가져올 수 있습니다.
• 내보내기 – --output는 마크다운 결정 로그를 저장합니다.

설치 및 사용법

Claude Code의 플러그인 마켓플레이스를 통해 설치합니다.

/plugin marketplace add hex/claude-marketplace
/plugin install claude-council

그런 다음 하나 이상의 API 키(예: OPENAI_API_KEY, GEMINI_API_KEY)를 설정하거나 Codex와 같은 CLI를 설치합니다. 다음으로 질문합니다.

/claude-council:ask "Your question"

또는 /claude-council:status로 설정을 확인합니다.

개인정보 및 주의사항

• 전체 프롬프트(및 포함된 파일)는 캐시 및 내보낸 기록에 평문으로 저장되지만 커밋을 방지하기 위해 .gitignore가 배치됩니다.
• 이미지는 비전 지원 공급자에게 전송되지만 캐시나 기록에는 저장되지 않습니다.
• 로컬 카운슬은 여러 Claude 하위 에이전트가 동일한 훈련 데이터와 사전 지식을 공유한다는 점을 정직하게 인정합니다. 그곳의 일치는 교차 공급업체 검증이 아닙니다.

Claude Council은 AI 조언을 교차 확인하기 위한 실용적인 도구로, 특히 한 모델의 확신 있는 답변이 틀릴 수 있는 경우에 유용합니다. 래퍼나 데모가 아닌 실제 작동하는 프로젝트입니다.