claude-consensus
Claude Code 및 Codex를 위한 다중 모델 코드 검토(code review), 계획 검토(plan review), 그리고 일반 검토
License: MIT
Claude Code
여러 AI 모델이 코드, 구현 계획(implementation plans), 문서 또는 기술 제안서를 독립적으로 검토한 후, 구조화된 합성(structured synthesis) 및 승인 라운드를 통해 수렴합니다. 주도 호스트가 직접 참여합니다: Claude는 Claude Code에서 주도하며, Codex는 Codex에서 주도합니다.
빠른 시작 (Quick Start)
Claude Code
Claude에게 다음을 알려주세요:
"claude-consensus를 설정하세요: https://github.com/AltimateAI/claude-consensus"
수동 설치(Manual install):
/plugin marketplace add AltimateAI/claude-consensus
/plugin install consensus
/consensus-setup
그런 다음 사용하세요:
/code-review "staged changes"
/plan-review "Add caching to the API layer"
/consensus:review docs/architecture.md
Codex
로컬 클론(local clone)에서 이 레포지토리 마켓플레이스를 Codex에 추가하고 consensus 플러그인을 설치하세요:
git clone https://github.com/AltimateAI/claude-consensus.git
다음 위치의 레포지토리 마켓플레이스를 사용하세요:
.agents/plugins/marketplace.json
그런 다음 구성하고 실행하세요:
consensus-setup
consensus-code-review staged changes
consensus-plan-review Add caching to the API layer
...
code-review, plan-review, plan-reviwe, 그리고 claude-consensus에 대한 별칭 스킬(Alias skills)도 제공됩니다.
전제 조건 (Prerequisites)
| 요구 사항 | 필수 여부 | 참고 사항 |
|---|
| Claude Code 또는 Codex | 예 | 호스트 환경이 주도 검토자(lead reviewer)를 결정합니다 |
| ... | | |
| 최소 설정: 주도 호스트 1명과 외부 모델 1개만으로 합의 검토(consensus reviews)가 가능합니다. | | |
지원되는 패널 (Supported Panels)
| 모델 | 제공사 | OpenRouter ID | Claude 네이티브 | Codex 외부 |
|---|
| Claude | Anthropic | built-in | 주도 | 사용 안 함 |
| ... | | | | |
| Codex는 이미 주도 검토자(lead reviewer)이므로 외부 패널에서 Codex/GPT를 의도적으로 제외합니다. | | | | |
설정은 또한 슬롯을 더 새로운 OpenRouter 모델로 대체하거나 자체 ID를 가진 추가 패널리스트를 추가할 수도 있습니다. 규칙은 설정 명령(setup command)을 참조하십시오.
구성 (Configuration)
| 호스트 (Host) | 사용자 구성 (User config) | 기본 구성 (Default config) | 환경 파일 (Env file) |
|---|
| Claude Code | ~/.claude/consensus.json | plugins/consensus/consensus.config.json | ~/.claude/.env |
| Codex | ~/.codex/consensus.json | plugins/consensus/consensus.codex.config.json | ~/.codex/.env 먼저, 그다음 ~/.claude/.env 읽기 전용 폴백 (read-only fallback) |
Claude 설정은 라이브 모델 호출에 대한 스모크 테스트(smoke-test)를 수행할 수 있습니다. Codex 설정은 크레딧을 소모하기 때문에 요청하지 않는 한 라이브 스모크 테스트를 실행하지 않습니다.
Codex 구성 예시:
{
"version": "1.7.0",
"lead": {
...
명령 및 기능 (Commands And Skills)
| 호스트 (Host) | 명령/기능 (Command / skill) | 용도 (Purpose) |
|---|
| Claude | /consensus-setup | 모델, API 키 및 쿼럼(quorum) 구성 |
| ... | | |
작동 방식 (How It Works)
Host lead Model 1 Model 2 Model N
| | | |
v v v v
...
- 쿼럼 (Quorum): 호스트별로 구성 가능합니다.
- 점진적 저하 (Graceful degradation): 쿼럼이 유지되는 경우 사용 불가능한 모델은 건너뜁니다.
- 세션 아티팩트 (Session artifacts): 디버깅 및 감사(auditability)를 위해
/tmp/에 저장됩니다.
- 독립적인 검토 (Independent reviews): 각 모델은 교차 오염(cross-contamination) 없이 동일한 프롬프트에서 시작합니다.
- Codex 격리 (Codex isolation): Codex는 별도의 구성을 사용하며 Claude 사용자 구성 파일을 절대 작성하지 않습니다.
기여 (Contributing)
기여를 환영합니다. PR을 제출하기 전에 기여 가이드(Contributing Guide)를 읽어주십시오.
본 프로젝트는 기여자 서약 강령(Contributor Covenant Code of Conduct)을 따릅니다.
라이선스 (License)
MIT License. Copyright (c) 2026 Altimate AI.
