claude-council
A Claude Code 플러그인으로, AI 코딩 에이전트들에게 동일한 질문을 병렬로 던지고 그 답변들을 비교할 수 있습니다. 하나의 모델의 편향이 오해를 불러일으킬 수 있는 아키텍처 결정, 디버깅 막다른 길, 보안 검토 또는 프레임워크 선택 등의 상황에서 유용합니다.
Codex, Antigravity, Gemini, and OpenAI answer the SQLite-or-Postgres question while fake Kimi fails
Tests
설치 (Install)
macOS, Linux 또는 Windows의 Git Bash를 통해 curl과 jq가 필요합니다.
/plugin marketplace add hex/claude-marketplace
/plugin install claude-council
Claude Code를 시작하는 셸 환경에 최소한 하나의 제공자(provider)를 설정해야 합니다:
export OPENAI_API_KEY="..."
codex, agy (Antigravity), grok, kimi, 그리고 cursor-agent CLI는 API 키 없이 기존 구독을 사용합니다. 로컬 ollama 모델은 키나 외부 네트워크가 필요 없습니다. 이들 중 어느 것도 사용하지 않을 경우, --local은 Claude 서브에이전트를 사용합니다. 제공자 선택과 로컬 컨실리움을 참조하세요.
60초 만에 첫 실행 (First run in 60 seconds)
코드에 대해 질문하기 전에 무엇이 전송되고 저장되는지를 읽어보세요.
/claude-council:status
/claude-council:ask "SaaS 사용자 테이블의 기본 키로 UUID와 BIGINT 중 무엇을 사용해야 할까요?"
각 제공자들은 독립적으로 답변합니다. Claude는 그들의 합의점, 의견 불일치점, 그리고 추천 사항에 대한 종합(synthesis)을 작성합니다. 합의가 검증은 아닙니다: 모델들은 당신의 설명과 그 가정들을 공유합니다.
종합에서는 답변을 바꿀 수 있는 전제(premise)를 명시합니다.
기능 (Features)
사전 확인 (Heads-up side-check)
The intro hint, a heads-up note, Learn more, and an unsent Tell Claude draft
/config의 "사전 확인(Heads-up side-check)" 행 또는 프로젝트의 .claude/council-heads-up.json을 통해 옵트인할 수 있습니다. 기본적으로 하나의 좌석이 할당되며, codex가 Claude가 작업하는 동안 최근 턴과 도구 결과를 확인합니다. 이 메모는 무엇이 어디로 갔는지 보여줍니다. '더 알아보기(Learn more)'를 누르면 확장되고, 'Claude에게 말하기(Tell Claude)'는 전송하지 않고 프롬프트에 초안을 넣습니다. 데이터 제한 및 비활성화 스위치와 사전 확인 가이드를 읽어보세요.
패널 (The pane)
CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1을 사용하면, 위 애니메이션에서처럼 Claude Code 내부에서 패널이 열립니다. 각 답변의 배너에는 좌석(seat), 모델 및 경과 시간이 표시됩니다. 합성이 도착하면 답변은 접히면서 상단 근처에 위치합니다. 느린 좌석을 취소하거나, 섹션을 접거나, /council-pane으로 마지막 실행을 다시 열 수 있습니다. tmux 내부에서는 모드가 어떤 패널을 원하는지 한 번 묻습니다.
모드는 얼리 액세스 기능입니다. 모드 가이드에는 키, 설정 및 제한 사항이 나열되어 있습니다. 또한 Claude가 도구로 코언실(council)을 호출할 수 있게 합니다. 모든 호출은 먼저 사용자에게 묻습니다.
Real SQLite-or-Postgres answers arrive in tmux beside a fake Kimi failure and the retry offer
모드가 없을 경우, tmux는 답변과 각 제공자의 상태를 스트리밍하는 사이드 패널을 열고 실패한 좌석 재시도를 제안합니다. Esc 키로 닫힙니다. --no-pane 또는 COUNCIL_NO_PANE=1으로 비활성화할 수 있습니다. 두 패널 모드를 벗어나면, 답변은 채팅창에 도착합니다. 터미널 통합을 참조하세요.
councils와 tmux 애니메이션은 '단일 노드 데모 앱에 SQLite를 사용할지 Postgres를 사용할지?'라는 질문에 대한 실제 답변을 보여줍니다. Codex와 Antigravity는 구독(subscriptions)을 사용하며, Gemini와 OpenAI는 API를 사용합니다. Kimi는 속도 제한(rate-limit) 기능입니다. 헤즈업 애니메이션은 가짜 좌석과 실제 Claude Code 호스트를 사용합니다.
캡처 스크립트 및 원본 프레임에서 재현 방법을 기록했습니다.
문제 해결 (Troubleshooting)
| 문제 (Problem) | 해결 방법 (Fix) |
|---|
| 레포를 클론했는데 아무것도 로드되지 않음 | ~/.claude/plugins/에 클론하지 마세요. pluginDirectories는 설정이 아닙니다. 로컬 클론에서 실행하는 방법을 따르세요. |
| ... | |