Claude Code 작업 흐름에 Codex/Gemini 같은 다른 AI 에이전트를 상담·리뷰 역할로 붙이는 Agent Skill을 만들고, 사용법·구조·주의점을 정리했다.
URL: https://zenn.dev/hiropon22/articles/599e0d5a7517b3
Claude Code에는 평소에 정말 많은 도움을 받고 있지만, 완전히 맡겨두기만 하기는 어려운 것이 현실입니다.
결국 옆에 붙어 있지 않으면 불안해서, 수시로 상태를 보러 가야 했습니다. Claude Code가 자율적으로 좋은 판단을 해주면 더 맡길 수 있을 텐데… 라고 생각하고 있었습니다.
그런데 Codex가 MCP 서버 기능을 갖고 있다는 것을 알게 되었습니다. “내 대신 Codex를 상담역·리뷰역으로 둘 수 없을까?”— 그렇게 생각한 것이 이 Agent Skill을 만들게 된 계기입니다.
처음에는 MCP 서버로 구현해 보았는데, 멈추거나 답변이 느리는 등 불안정했습니다. 그러던 중 Agent Skill이 등장해서 Agent Skill로 구현해 보니 안정적으로 동작하게 되었습니다.
Claude Code가 다른 AI 에이전트(CLI)에게 상담할 수 있는 Agent Skill을 만들었습니다.
준비한 Agent Skill:
| Skill명 | 상담 대상 | 용도 |
|---|---|---|
| ask-codex | Codex CLI | Codex에 상담·리뷰 의뢰 |
| ask-gemini | Gemini CLI | Gemini CLI에 상담·리뷰 의뢰 |
| ask-peer | 서브 에이전트 | 동료 엔지니어 역할로 상담 |
ask-codex, ask-gemini는 외부 AI CLI를 호출합니다. ask-peer는 Claude Code의 서브 에이전트 기능을 사용해, 같은 Claude 내부에서 “동료 엔지니어 역할”로 행동하는 에이전트를 기동합니다.
Claude 이외의 AI 에이전트(Codex 등)용으로, Claude에게 상담할 수 있는 스킬도 준비했습니다.
| Skill명 | 상담 대상 | 용도 |
|---|---|---|
| ask-claude | Claude Code | Codex 등에서 Claude에 상담·리뷰 의뢰 |
“codex에 상담해줘”, “gemini에 리뷰받아줘” 같은 식으로 자연스럽게 부탁하기만 하면 됩니다.
text당신: OAuth 인증을 추가해주세요. 계획을 세우면 codex에 리뷰받아줘. Claude Code: OAuth 인증 추가 계획을 작성했습니다. Codex에 리뷰를 요청합니다. Codex: 몇 가지 확인할게. 1. 세션 관리는 어떻게 할 예정이야? 기존 JWT와 공존시키나? 2. OAuth 실패 시 폴백은 생각해뒀어? ...
/ask-codex, /ask-gemini, /ask-peer처럼 슬래시 커맨드로 직접 호출할 수도 있습니다.
폭넓은 의견이 필요할 때는 “codex랑 peer에 상담해봐”처럼 여러 AI에 브레인스토밍을 유도하기도 합니다. 서로 다른 모델에서 다른 관점의 의견을 받을 수 있어서 재미있습니다.
CLAUDE.md에 아래처럼 적어두면, 작업 시작과 종료 시 자동으로 리뷰가 들어오는 워크플로를 구성할 수 있습니다.
md## 상담 룰 - **중요**: - 작업 시작 시에는 반드시 codex에게 작업 계획을 리뷰받는다 - 작업 완료 시에는 반드시 codex에게 작업에 결함/누락이 없는지 체크받는다 위 외에도 작업 중 아래와 같은 상황에 직면하면 codex에게 상담한다: - 작업 수행에 문제가 발생했다 - 여러 선택지가 있어 판단이 망설여진다 - 에러나 예상치 못한 동작의 원인을 특정할 수 없다 - **주의**: 너와 codex는 성향이 다른 뛰어난 엔지니어다. codex에 상담할 때는 아래를 의식해라: - codex의 제안을 그대로 믿지 말고, 그 근거와 이유를 이해한다 - 내 분석 결과와 codex의 의견이 다르면, 양쪽 관점을 비교 검토한다 - 최종 판단은, 양쪽 의견을 종합적으로 평가한 뒤 내가 내린다
이렇게 하면, 작업 의뢰 → 계획 수립 → Codex 리뷰 → 구현 → 완료 리뷰 → 완료라는 워크플로가 자연스럽게 돌아갑니다. 매번 “Codex에 리뷰해줘”라고 말하지 않아도 자동으로 리뷰가 들어오므로, 옆에 붙어 있지 않아도 안심하고 맡길 수 있게 되었습니다.
참고로 “주의” 부분은 처음엔 적지 않았습니다. 그런데 운용하다 보니 Claude가 Codex의 말을 그대로 믿고, 내가 맞는 케이스에서도 의견을 꺾어버리는 일이 있었습니다. 그래서 “제안을 맹신하지 말고, 양쪽 의견을 종합적으로 평가해 판단한다”라는 룰을 추가했습니다.
또한 CLAUDE.md의 심볼릭 링크로 AGENTS.md(Codex용), GEMINI.md(Gemini CLI용)를 만들어 두면, Codex나 Gemini도 Claude와 동등한 도메인 지식을 가진 상태로 상담에 응해줄 수 있습니다.
위의 “상담 룰”을 적은 CLAUDE.md를 심볼릭 링크하면 Codex나 Gemini에게까지 상담 룰이 읽혀버리므로, 저는 “상담 룰”은 사용자 레벨(~/.claude/CLAUDE.md)에 적고 있습니다.
외부 AI CLI를 호출하는 Skill입니다.
장점:
주의점:
Claude Code의 서브 에이전트 기능을 사용하는 Skill입니다. 외부 CLI를 호출하는 대신, Claude Code 내부에서 다른 에이전트를 기동합니다.
장점:
특징:
Agent Skill의 구현은 매우 단순합니다.
textask-codex/ ├── .claude-plugin/ │ └── plugin.json # 플러그인 메타데이터 └── skills/ └── ask-codex/ └── SKILL.md # Skill 정의
md--- name: ask-codex description: Asks Codex CLI for coding assistance. allowed-tools: Bash(codex:*) --- # Ask Codex Executes the local `codex` CLI to get coding assistance. ## Quick start ```bash codex exec "Your question or task here"
> 완전판은 [GitHub](https://github.com/hiroro-work/claude-plugins/blob/main/plugins/ask-codex/skills/ask-codex/SKILL.md)를 참고하세요.
이것만으로 Claude Code에서 `/ask-codex` 커맨드로 호출할 수 있게 됩니다.
---
## 써본 소감
이 Agent Skill을 쓰기 시작한 뒤, Claude Code에 일을 맡기기 쉬워졌습니다.
- **계획 단계에서의 피드백** - 구현 후 되돌아가는 일이 줄었다
- **놓침(누락) 검출** - 내가 눈치채지 못한 고려 누락을 지적해 준다
- **옆에 붙어있지 않아도 됨** - CLAUDE.md로 자동 리뷰를 설정해 두면 방치할 수 있다
서로 다른 AI 에이전트끼리 상담한다는 것은 흥미로운 경험입니다. 모델에 따라 주목하는 포인트가 달라서, 예상치 못한 지적을 받는 경우도 있습니다.
---
## 주의점
- **토큰/API 소비** - 상담할 때마다 토큰이나 API 콜을 소비합니다
- **최종 판단은 스스로** - AI의 의견을 맹신하지 말고, 스스로 판단하는 것이 중요합니다
---
## 마치며
“옆에 붙어있어야 한다”는 과제를, AI 에이전트끼리의 상담이라는 형태로 해결해 보았습니다.
이 Agent Skill들은 플러그인으로 공개하고 있습니다. 관심이 있다면 시험해 보세요.
**GitHub**: [hiroro-work/claude-plugins](https://github.com/hiroro-work/claude-plugins)
```bash
# 마켓플레이스를 추가
claude plugin marketplace add hiroro-work/claude-plugins
# 설치
claude plugin install ask-codex@hiropon-plugins
claude plugin install peer@hiropon-plugins
이 글은 Zenn/Qiita에 크로스포스트하고 있습니다