使用说明
Claude MCP Turbo
Codex Pro Max + Gemini MCP 최적화 설정 & OMC 버그 패치.
문제
OMC v4.2.15에서 Codex/Gemini MCP 호출 시:
- Codex 에러:
isRateLimitError()의 regexrate.?limit가 응답 본문의rate_limit변수명을 매칭 (false positive) - Gemini 에러: Codex 실패의 연쇄 에러 (sibling tool call errored)
- MCP 미활용:
useMcp: false설정으로 자동 라우팅 비활성
설치
# 원하는 위치에 clone
git clone https://github.com/hyunseok-blue/claude-mcp-turbo.git
cd claude-mcp-turbo
# 원커맨드 설치 (경로 자동 감지, zsh/bash 자동 감지)
bin/setup.sh
이 스크립트가 하는 일:
- 환경변수 설정 (Codex Pro Max 최적화)
.omc-config.json업데이트 (useMcp: true, 역할별 프로바이더 라우팅)CLAUDE.md에 MCP-first 정책 추가- OMC 버그 패치 적용
- SessionStart 훅 등록 (OMC 업데이트 시 자동 패치)
- 전체 진단 실행
구조
claude-mcp-turbo/
├── bin/
│ ├── setup.sh # 원커맨드 설치
│ ├── doctor.sh # 건강 진단 (9개 체크)
│ ├── status.sh # 사용 현황 대시보드
│ ├── update.sh # 설정 업데이트
│ ├── patch-omc.sh # OMC 버그 패치
│ └── auto-patch-check.sh # SessionStart 훅 (자동 패치)
├── config/
│ ├── env.sh # 환경변수 (Pro Max 최적화)
│ ├── omc-config.patch.json # .omc-config.json 패치
│ ├── model-routing.json # 역할→프로바이더 라우팅
│ └── claude-md-patch.md # CLAUDE.md MCP-first 정책 + reasoning effort 라우팅
├── patches/
│ ├── codex-core.patch # isRateLimitError 수정
│ └── gemini-core.patch # isGeminiRetryableError 수정
└── docs/
└── TROUBLESHOOTING.md
일상 사용
# 진단 (clone 디렉토리에서)
bin/doctor.sh
# 상태 확인
bin/status.sh
자동 패치:
setup.sh실행 후에는 OMC가 업데이트되어도 Claude Code 시작 시 자동으로 패치가 적용됩니다. 수동 패치(patch-omc.sh)는 더 이상 필요하지 않습니다.
Codex Reasoning Effort 자동 라우팅
Codex 호출 시 역할에 따라 reasoning_effort를 자동 설정:
| Level | 역할 | 설명 |
|---|---|---|
xhigh |
architect, security-reviewer | 깊은 추론 필요 |
high |
critic, analyst, code-reviewer | 분석/리뷰 |
medium |
planner, tdd-guide | 계획/전략 (기본값) |
low |
explore, writer | 빠른 탐색/작성 |
토큰 최적화 가이드
진심모드(삼중 병렬)는 기본 비활성화로 변경되었습니다. 필요시 수동 활성화하세요.
| 설정 | 기본값 | 토큰 영향 |
|---|---|---|
seriousMode.enabled |
false |
삼중 디스패치 해제 → 비용 1/3~1/5 |
execution.maxConcurrentAgents |
7 |
과도한 병렬 방지 |
execution.alwaysUseTripleDispatch |
false |
필요시만 삼중 실행 |
externalModels.usage |
on-demand |
MCP 필요시만 호출 |
CLAUDE.md 크기도 중요합니다. 매 메시지마다 시스템 프롬프트가 재전송되므로:
- CLAUDE.md는 8KB 이하 권장
@파일참조는 해당 파일 전체가 포함됨 (COMMANDS.md 3KB + PERSONAS.md 5KB + SYSTEM.md 6KB = 14KB 추가)- 상세 에이전트 카탈로그, 스킬 목록 등은 OMC 플러그인이 자동 주입하므로 CLAUDE.md에 중복 불필요
버그 상세
rate.?limit → rate[- ]limit
원본 regex rate.?limit에서 .?는 임의의 문자 0~1개를 매칭.
rate_limit (underscore)도 매칭되어 Codex 응답 본문에 포함된
Python 변수명이 rate limit 에러로 오탐.
수정: rate[- ]limit — 하이픈과 공백만 허용, underscore 제외.
Event Type Filtering
Codex JSONL 출력에서 item.completed, message, output_text 등
정상 응답 이벤트는 스킵하고, error와 turn.failed 이벤트만 검사.
