KilimcininKorOglu/claude-code-mods/tree/main/plugins/council
council
모델이 도구를 호출하거나 /council <question>을 실행하면 어려운 문제를 모델 위원회에 묻습니다. Claude 모델은 물론 gemini-core에 키가 있을 때의 Gemini 모델도 병렬로 답하고, 세션의 모델이 그 답변에서 하나의 판정을 작성합니다.
이 mod 소개
council
한 번 더 시도한다고 해결되지 않는 문제가 있습니다. 같은 오류가 모든 수정 뒤에도 남거나 두 설계가 모두 맞아 보이는 경우입니다. 두 번째 의견도 도움이 되고, 여러 독립적인 의견은 더 도움이 됩니다. 이 Mod는 문제를 모델 위원회에 묻습니다. 각 구성원이 같은 질문에 독립적으로 답하고 세션 자체의 모델이 의장으로서 답변을 하나의 판정으로 만듭니다. 모델이 막히면 도구로 호출하며 /council <question>을 직접 실행할 수도 있습니다.
기능
- 구성원은 Opus 5.5, Sonnet 5, Fable 5.1, Haiku 4.5이며 gemini-core가 설치되어 키를 가지고 있으면
gemini-3.8-flash도 추가됩니다. gemini-core가 없거나 키가 없으면 Gemini 구성원을 건너뛰고 이유를 결과에 적습니다./council members로 목록을 바꿀 수 있습니다. - 모든 구성원에게 동시에 묻습니다.
- 세션 자체의 모델에서 실행되는 구성원은
$.model.fork로 세션을 분기하므로 prompt cache에서 전체 대화를 읽습니다. - 다른 Claude 구성원은
$.model.complete을 통해 텍스트로 대화를 받고higheffort로 실행됩니다. 400,000자를 넘으면 가장 긴 도구 출력부터 자른 뒤 오래된 메시지를 제외합니다. Haiku 4.5는 창이 200k token이므로 최대 560,000자를 읽습니다. - Gemini 구성원은 gemini-core를 통해 같은 텍스트를 받습니다. gemini-core가 키, 티어, 사고 수준을 보관합니다. 각 요청이 자체 모델을 지정하므로 gemini-core 0.3.0 이상이 필요합니다.
- 세션 자체의 모델에서 실행되는 구성원은
- 의장도 세션을 분기합니다. 모델 이름이 아니라 문자(
Member A,Member B) 아래의 답변을 읽고, 구성원이 동의한 부분과 의견이 갈린 부분, 대화가 지지하는 쪽, 놓친 내용과 다음 단계를 작성합니다. - 호출자는 판정과 모든 답변을 읽으며 각 답변에는 문자, 모델, 시간이 붙습니다. 실패한 구성원은 이유와 함께 표시됩니다. 아무 구성원도 답하지 않으면 각 이유와 함께 호출이 거부되고 의장은 실행되지 않습니다.
- 하위 에이전트의 호출은 대화를 보내지 않습니다. 분기와
$.session.messages()가 주 스레드를 읽기 때문입니다. 이후 모든 구성원과 의장은 질문만 completion으로 받습니다.
모델이 호출하는 때
도구는 question 입력 하나를 받는 mcp__council__convene입니다. ToolSearch 없이 목록에 표시되며 시스템 prompt의 메모가 모델에 호출 시점을 알려 줍니다.
- 같은 오류가 두 번의 수정 시도 뒤에도 남았을 때
- 조사했는데도 근본 원인이 여전히 불분명할 때
- 실제 트레이드오프가 있는 두 설계 중 하나를 골라야 할 때
- 되돌리기 어려운 변경을 하기 전에
메모는 세션 시작과 /clear에서 고정되므로 /council on은 즉시 모델에 도구를 제공하고, 메모는 다음 /clear 또는 세션부터 적용됩니다. 모델이 호출하는 횟수에는 제한이 없습니다. 이 설정은 모든 창에서 공유됩니다. 다른 창에서 /council on을 실행하면 이 창의 모델이 다음 턴에 도구를 얻고 다음 /clear 또는 세션에 메모를 얻습니다. 그곳에서 /council off를 실행하면 여기의 도구도 즉시 거부합니다.
표시 내용
sidebar를 열면 실행 뒤에 고정 섹션이 이어집니다. 질문과 실행 시간, 각 구성원과 상태 단어(running은 노란색, answered는 시간과 token이 있는 녹색, failed는 이유가 있는 빨간색), 의장, 마지막으로 판정의 첫 단어가 표시됩니다. 모델 이름은 family별로 색칠됩니다. opus는 빨강, fable은 노랑, sonnet은 초록, haiku는 흐린 색, Gemini는 파랑입니다.
council: run
avg.js boş dizi için ne dönmeli: NaN, 0, yoksa hata mı fırl… · done in 44s
opus 5.5 · fork · answered 11s · 89k in, 902 out
sonnet 5.5 · complete · answered 17s · 6.7k in, 1.1k out
fable 5.1 · complete · answered 24s · 6.7k in, 1.4k out
haiku 4.5 · complete · answered 9s · 5.2k in, 634 out
gemini-3.8-flash · gemini · answered 8s · 4.7k in, 1.3k out · free tier
chair · opus 5.5 · fork · done 20s
sidebar를 닫으면 마지막에 한 줄이 표시됩니다.
council: 1 of 2 members answered in 4s; the chair wrote the verdict
명령
/council on or off, the members, the chair, the last run (also /council status)
/council on | off whether the model has the tool; off by default
/council members the members
/council members <model> ... opus, sonnet, fable, haiku, a claude- id, a gemini- or gemma- id
/council members reset the default members
/council <question> runs the council now, also while it is off
/council <question>은 즉시 convened: 5 members라고 답합니다. 구성원과 의장이 답하면 Mod는 /council:send를 통해 판정을 모델에 전달하고, 모델은 이를 사용자의 메시지로 읽은 뒤 얻은 내용을 말합니다. 그동안 실행 중인 턴이 있으면 턴이 끝날 때까지 보관합니다(2.1.283에서 측정).
비용
실행마다 구성원당 요청 하나와 의장용 요청 하나를 만듭니다. Claude Code 2.1.283에서 측정했습니다.
- 기본 구성원 5명의 실행은 25~44초가 걸렸고 가장 느린 구성원이 속도를 정합니다. 분기는 4~11초가 걸리며 짧은 세션에서는 캐시에서 대화를 읽습니다(83k token).
- 400,000자 대화(기본 한도)는 Opus 5.5, Sonnet 5, Fable 5.1에서 163,828 입력 token, Haiku 4.5에서 128,018, gemini-3.8-flash에서 120,057입니다.
전체 400,000자를 목록 가격으로 계산하면 실행 하나가 약 $2.20입니다. Fable 5.1은 약 $1.70(입력 token 백만 개당 $10), Sonnet 5.5는 약 $0.34(Sonnet 5와 같은 목록 가격이며 검사에서 측정한 token 수는 Sonnet 5 기준), Haiku 4.5는 약 $0.13, 두 분기의 캐시 읽기는 몇 센트입니다. 대화가 짧으면 비례해 저렴해집니다. Claude 구독에서는 요청이 사용량 제한에 포함됩니다. 비용을 낮추려면 /council members로 구성원을 빼세요(예: /council members opus sonnet haiku gemini-3.8-flash).
검사에서 gemini-3.1-pro-preview는 모든 무료 티어 키에 HTTP 429로 답했습니다. 무료 티어에 해당 모델의 quota가 없기 때문입니다. 유료 키가 있을 때만 구성원에 추가하세요.
설치
claude plugin marketplace add KilimcininKorOglu/claude-code-mods
claude plugin install council@kilimcininkoroglu-mods
함수 hook은 얼리 액세스입니다. Claude Code 2.1.288 이상은 기본으로 로드하므로 켤 것이 없습니다.
설치 후
- Claude Code를 다시 시작합니다.
- 모델이 스스로 위원회를 호출해야 하면
/council on을 실행합니다. 설치 후에는 꺼져 있으며/council <question>은 어느 상태에서나 작동합니다. - Gemini 구성원은 gemini-core 0.3.0 이상을 설치하고 키를 제공하세요(README 참조). 위원회는 이에 의존하지 않으며 이것이 없어도 Claude 구성원만으로 실행됩니다.
옵션
| Option | Default | What it sets |
|---|---|---|
| maxInputChars | 400000 | 세션을 분기하지 않을 때 각 구성원이 읽는 대화의 문자 수; 20,000~2,000,000 |
접근 범위
Claude Code 2.1.283에서 claude plugin validate로 검증했습니다.
❯ ./register.ts hooks: session.start, turn.start, classic.SessionStart, command.run{command=council}, prompt.section{name=env_info_simple}, tool.describe{tool=/"^mcp__council__convene$"/}, tool.call{tool=/"^mcp__council__convene$"/}, turn.step
❯ ./register.ts calls: $.clock.after (via runManual), $.clock.now (via askClaude, askGemini, askGeminiModel, convene, drawRun, ended, verdictOf), $.command.register, $.command.run (via send), $.gemini.enroll (via enrollGemini), $.gemini.read (via askGeminiModel), $.gemini.request (via askGeminiModel), $.gemini.settings (via geminiReach), $.http.fetch (via askGeminiModel), $.model.complete (via askChair, askClaude), $.model.fork (via askChair, askClaude), $.prompt.submit (via send), $.session.messages (via contextOf), $.sidebar.set (via drawRun), $.store.delete (via runCommand), $.store.get (via isEnabled, membersNow), $.store.set (via runCommand, storeEnabled), $.tool.register (via declareTool), $.ui.log (via enrollGemini, runManual, send, toPerson)
Reach L3: 구성원마다 요청 하나와 의장용 요청 하나입니다.
1. 읽음: 주 스레드의 대화, 질문, 각 메인 루프 요청의 모델
2. 실행: 프로세스 없음
3. 전송: Claude Code 자체 API 연결을 통해 각 Claude 구성원에게 대화와 질문을 보내고, gemini-core를 통해 각 Gemini 구성원과 Google에 보냅니다.
4. 저장: $.store에 켜짐/꺼짐 설정과 구성원 목록을 저장하며 실행은 메모리에 있습니다.
5. 악성 입력: 답변은 모델이 읽는 텍스트일 뿐 실행되지 않습니다. 구성원 ID는 Gemini URL에 도달하기 전에 [a-z0-9.-]와 일치해야 하며, 무료 티어 Gemini 키가 있으면 Google이 전송된 내용을 읽을 수 있습니다.
제한
- 각 구성원은 받은 내용에서 답합니다. 분기하지 않는 구성원은 대화를 텍스트로 읽고
maxInputChars에서 자르므로 잘린 내용을 놓칠 수 있습니다. - 의장은 세션의 모델에서 실행되며 자기 family의 답변도 판단합니다. 문자는 어느 모델에서 온 답인지 숨기지만 답변 내용은 숨기지 않습니다.
- 구성원 또는 의장의 답은 사고를 포함해 8,192 token으로 제한되며 5분 뒤에도 답하지 않은 구성원은 실패로 처리됩니다.
- Gemini HTTP 503 뒤에는 gemini-core가 지정한 대기 없이 요청을 즉시 다시 보냅니다.
$.clock.sleep이 hook의 10초 예산에 포함되기 때문입니다(2.1.283에서 측정). 빠른 재시도 3번이 같은 부하에 걸릴 수 있습니다. - 2.1.283에서 플러그인 도구 호출이 타임아웃 없이 333초 실행되었습니다. 2.1.277에서는 제한이 60초였으므로 이전 Claude Code는 느린 실행을 중간에 끊을 수 있습니다.
개발
make install # eslint, typescript-eslint, typescript
make lint # complexity limit 10, the build fails above it
make typecheck # needs .claude/types/ from /plugin-types with --plugin-dir ../sidebar --plugin-dir ../gemini-core
make validate
make test # claude plugin test
설치
먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.
claude plugin marketplace add KilimcininKorOglu/claude-code-mods claude plugin install council@kilimcininkoroglu-mods
원문 / README
council
Some problems do not yield to one more attempt: the same error survives every fix, or two designs each look right. A second opinion helps, and several independent ones help more. This mod asks a council of models about the problem: each member answers the same question on its own, and the session's own model, as the chair, turns their answers into one verdict. The model calls it through a tool when it is stuck, and you can run it yourself with /council <question>.
What it does
- The members are Opus 5.5, Sonnet 5, Fable 5.1 and Haiku 4.5, plus
gemini-3.8-flashwhen gemini-core is installed and has a key. Without gemini-core, or without a key, the Gemini members are skipped and the result says why./council memberschanges the list. - Every member is asked at the same time:
- The member that runs on the session's own model forks the session with
$.model.fork, so it reads the whole conversation from the prompt cache. - Every other Claude member gets the conversation as text through
$.model.complete, athigheffort. Above 400,000 characters the longest tool outputs are cut first, then the oldest messages are left out. Haiku 4.5 reads at most 560,000 characters, because its window is 200k tokens. - A Gemini member gets the same text through gemini-core, which holds the key, the tier and the thinking level. It needs gemini-core 0.3.0 or later, because each request names its own model.
- The member that runs on the session's own model forks the session with
- The chair forks the session too. It reads the answers under letters (
Member A,Member B), not model names, and writes where the members agree, where they disagree and which side the conversation supports, what they missed, and the next step. - The caller reads the verdict and every answer, each headed with its letter, model and time. A member that failed is named with its reason. When no member answers, the call is refused with each reason, and no chair runs.
- A call from a subagent sends no conversation, because a fork and
$.session.messages()read the main thread. Every member and the chair then get the question alone, as a completion.
When the model calls it
The tool is mcp__council__convene with one question input. It is listed without ToolSearch, and a note in the system prompt tells the model when to call it:
- the same error survived two attempts to fix it;
- the root cause is still unclear after it investigated;
- it has to choose between two designs that each have real trade-offs;
- before a change that is hard to undo.
The note is fixed at the session's start and at /clear, so /council on gives the model the tool at once and the note from the next session. There is no limit on how often the model calls it. The setting is shared by every window: a /council on in another window gives this window's model the tool at its next turn and the note at its next /clear or session, and a /council off there makes the tool refuse here at once.
What you see
With the sidebar open, a standing section follows the run: the question and how long the run has taken, then every member with its state word (running yellow, answered green with its time and tokens, failed red with the reason), then the chair, and finally the first words of the verdict. Each model's name is coloured by its family: opus red, fable yellow, sonnet green, haiku faint, Gemini blue.
council: run
avg.js boş dizi için ne dönmeli: NaN, 0, yoksa hata mı fırl… · done in 44s
opus 5.5 · fork · answered 11s · 89k in, 902 out
sonnet 5.5 · complete · answered 17s · 6.7k in, 1.1k out
fable 5.1 · complete · answered 24s · 6.7k in, 1.4k out
haiku 4.5 · complete · answered 9s · 5.2k in, 634 out
gemini-3.8-flash · gemini · answered 8s · 4.7k in, 1.3k out · free tier
chair · opus 5.5 · fork · done 20s
With the sidebar closed, you get one line at the end:
council: 1 of 2 members answered in 4s; the chair wrote the verdict
Command
/council on or off, the members, the chair, the last run (also /council status)
/council on | off whether the model has the tool; off by default
/council members the members
/council members <model> ... opus, sonnet, fable, haiku, a claude- id, a gemini- or gemma- id
/council members reset the default members
/council <question> runs the council now, also while it is off
/council <question> answers convened: 5 members at once. When the members and the chair have answered, the mod hands the verdict to the model through /council:send, so the model reads it as your message and tells you what it takes from it. A turn that is running meanwhile holds it until the turn ends (measured on 2.1.283).
Cost
Each run makes one request per member and one for the chair. Measured on Claude Code 2.1.283:
- A run of the five default members took 25 to 44 seconds; the slowest member sets the pace. Forks took 4 to 11 seconds and read the conversation from the cache (83k tokens in a short session).
- 400,000 characters of conversation, the default limit, are 163,828 input tokens on Opus 5.5, Sonnet 5 and Fable 5.1, 128,018 on Haiku 4.5 and 120,057 on gemini-3.8-flash.
At list prices, one run at the full 400,000 characters costs about $2.20, estimated: Fable 5.1 about $1.70 ($10 per million input tokens), Sonnet 5.5 about $0.34 (the same list price as Sonnet 5, whose token count the check measured), Haiku 4.5 about $0.13, and the two forks a few cents of cache reads. A shorter conversation costs proportionally less. On a Claude subscription the requests count toward your usage limits instead. To lower the cost, leave a member out with /council members, for example /council members opus sonnet haiku gemini-3.8-flash.
gemini-3.1-pro-preview answered HTTP 429 on every free-tier key in the check, because the free tier has no quota for it. Add it to the members only with a paid key.
Install
claude plugin marketplace add KilimcininKorOglu/claude-code-mods
claude plugin install council@kilimcininkoroglu-mods
Function hooks are early access. Claude Code 2.1.288 and later load them by default, so there is nothing to switch on.
After installing
- Restart Claude Code.
- Run
/council onif the model should call the council by itself. It is off after an install, and/council <question>works either way. - For Gemini members, install gemini-core 0.3.0 or later and give it a key (see its README). The council does not depend on it and runs with Claude members alone without it.
Options
| Option | Default | What it sets |
|---|---|---|
| maxInputChars | 400000 | How much of the conversation, in characters, each member reads when it does not fork the session; from 20,000 to 2,000,000 |
What it can reach
Validated with claude plugin validate on Claude Code 2.1.283:
❯ ./register.ts hooks: session.start, turn.start, classic.SessionStart, command.run{command=council}, prompt.section{name=env_info_simple}, tool.describe{tool=/"^mcp__council__convene$"/}, tool.call{tool=/"^mcp__council__convene$"/}, turn.step
❯ ./register.ts calls: $.clock.after (via runManual), $.clock.now (via askClaude, askGemini, askGeminiModel, convene, drawRun, ended, verdictOf), $.command.register, $.command.run (via send), $.gemini.enroll (via enrollGemini), $.gemini.read (via askGeminiModel), $.gemini.request (via askGeminiModel), $.gemini.settings (via geminiReach), $.http.fetch (via askGeminiModel), $.model.complete (via askChair, askClaude), $.model.fork (via askChair, askClaude), $.prompt.submit (via send), $.session.messages (via contextOf), $.sidebar.set (via drawRun), $.store.delete (via runCommand), $.store.get (via isEnabled, membersNow), $.store.set (via runCommand, storeEnabled), $.tool.register (via declareTool), $.ui.log (via enrollGemini, runManual, send, toPerson)
Reach L3: one request per member and one for the chair.
1. Reads: the conversation of the main thread, the question, and the model of each main-loop request
2. Runs: no process
3. Sends: the conversation and the question to each Claude member through Claude Code's own API connection, and to Google for each Gemini member through gemini-core
4. Persists: in $.store, the on/off setting and the member list; a run lives in memory
5. Hostile input: the answers are text the model reads and never run; a member id must match [a-z0-9.-] before it reaches a Gemini URL; a free-tier Gemini key lets Google read what it is sent
Limits
- Every member answers from what it is sent. A member that does not fork reads the conversation as text, cut at
maxInputChars, so it can miss what was cut. - The chair runs on the session's model and judges answers from its own family too; the letters hide which answer came from which model, not what the answers say.
- A member or chair answer is capped at 8,192 tokens, thinking included, and a member that has not answered after 5 minutes counts as failed.
- After a Gemini HTTP 503 the request goes out again at once, without the wait gemini-core names, because
$.clock.sleepcounts against the hook's 10-second budget (measured on 2.1.283). Three quick retries can all hit the same load. - Measured on 2.1.283: a plugin tool call ran 333 seconds without a timeout. On 2.1.277 the limit was 60 seconds, so an older Claude Code can cut a slow run short.
Development
make install # eslint, typescript-eslint, typescript
make lint # complexity limit 10, the build fails above it
make typecheck # needs .claude/types/ from /plugin-types with --plugin-dir ../sidebar --plugin-dir ../gemini-core
make validate
make test # claude plugin test
배지 받기
내 프로젝트인가요? 이 배지를 README나 웹사이트에 넣으면 이 페이지로 연결됩니다.
동명의 다른 작품
- councildanzerzine · ★ 2



