ONEDEV

claude-delegator

AI Agent OrchestrationskillJavaScript

★ 999주당 +4조회 3

무엇인가

Claude Delegator는 Claude Code 안에서 GPT·Gemini 기반 전문 서브에이전트를 호출하도록 위임 절차를 정의하는 플러그인이다. 아키텍처 결정, 보안 검토, 코드 리뷰, 교착된 디버깅처럼 단일 모델의 판단에 의존하기 어려운 영역을 외부 제공자 모델로 분리해 처리하는 규칙을 다룬다.

어떻게 동작하나

동작은 MCP 서버 등록과 프롬프트 파일 두 축으로 이루어진다. prompts/ 디렉터리에 전문가별 시스템 프롬프트가 있고, 각 프롬프트는 역할 정의, 자문 모드와 구현 모드, 응답 형식, 호출 조건과 비호출 조건을 담는다. Claude는 요청을 읽고 전문가를 선택한 뒤 mcp__codex__codex 또는 mcp__gemini__gemini 도구로 위임하며, 응답은 원문 그대로 전달되지 않고 Claude가 종합해 판단을 적용한다. 구현 연쇄는 threadId를 반환받아 mcp__*__*-reply로 문맥을 이어가고, 실패 시 최대 3회 재시도 후 에스컬레이션한다.

무엇과 다른가

CLAUDE.md에 규칙 문장을 직접 적는 방식과 달리 위임 대상이 별도 프로세스로 분리되어 있고, 전문가별 프롬프트가 파일로 관리된다. 프롬프트를 직접 작성해 붙여 넣는 방식은 모델 선택과 문맥 유지가 수동이지만, 이 플러그인은 제공자 자동 감지와 라우팅, 다중 턴 상태를 MCP 계층에서 처리한다. 단순 파일 조작이나 첫 시도 수정처럼 위임이 불필요한 경우는 호출하지 않는 조건이 프롬프트에 명시된다.

어떻게 쓰나

설치는 Claude Code 인스턴스에서 /plugin marketplace add jarrodwatts/claude-delegator, /plugin install claude-delegator, /claude-delegator:setup 순서로 진행한다. setup이 동작하지 않으면 claude mcp add --transport stdio --scope user codex -- codex -m gpt-5.3-codex mcp-server 형태로 수동 등록하고 claude mcp list로 확인한다. 개발 중에는 claude --plugin-dir 경로로 재설치 없이 시험할 수 있다.

전제와 한계

Claude Code 전용이며 Codex CLI 또는 Gemini CLI 중 최소 하나가 설치·인증되어야 한다. 둘 다 설정하면 자동 감지해 라우팅한다. Codex 기본값은 ~/.codex/config.toml의 sandbox_mode, approval_policy로 지정하고 호출별 인자가 이를 덮어쓴다. 전문가 프롬프트는 prompts/에서 수정할 수 있으나, 제공자 CLI가 없는 환경에서는 위임이 성립하지 않는다.

관련 논문 4

유사 도구