| name | claude-code-bridge |
| description | Bridge Codex with the local Claude Code CLI for real analysis, implementation, and review handoffs. Use when Codex should call `claude` directly from the shell to analyze a codebase, draft or apply targeted code changes, produce a second-opinion review, or compare Codex and Claude outputs in trusted local repositories. |
Claude Code Bridge
Overview
Codex가 메인 오케스트레이터로 남으면서, 필요할 때 로컬 claude CLI를 직접 호출해 분석, 구현, 리뷰를 보조하게 하기.
이 스킬은 Claude를 대체하지 않고, Codex가 검증 책임을 유지한 채 Claude Code를 외부 워커처럼 활용하는 절차를 제공한다.
Quick Start
- 먼저
claude auth status로 인증 상태를 확인하기.
- 작업 디렉터리가 신뢰 가능한 로컬 저장소인지 확인하기.
- iOS/Swift 작업이면 먼저
../ios-multi-agent-dev/references/master-template.md의 Task Brief를 채우기.
- 요청을
analysis, implementation, review, review-incorporation, second-opinion 중 하나로 분류하기.
- 명령 템플릿은
references/cli-recipes.md를 읽기.
- 프롬프트 골격은
references/prompt-templates.md를 읽기.
- 상황별 강화 문구는
references/prompt-boosters.md를 읽기.
- 세션 재사용/분리 규칙은
references/session-strategy.md를 읽기.
- 인증/권한/실패 대응은
references/auth-and-safety.md를 읽기.
- Claude 출력은 그대로 완료 처리하지 말고, Codex가 파일/테스트/리스크를 직접 검증하기.
When to Use Claude Code CLI
다음에 특히 적합하다.
- 큰 코드베이스에서 2차 분석 의견이 필요할 때
- 구현 범위가 명확하고 Claude에게 특정 파일 수정을 맡기고 싶을 때
- Codex 구현 뒤 독립적인 비판적 리뷰가 필요할 때
- Codex와 Claude의 관점을 비교해 더 안전한 수정을 고를 때
다음에는 우선순위가 낮다.
- 매우 단순한 단일 파일 수정
- 현재 로컬 환경에서
claude 인증이 안 되어 있을 때
- CLI 호출보다 내가 바로 수정하는 것이 더 빠른 blocking 작업
Core Principles
- Codex가 최종 판단과 검증을 맡기.
- Claude 출력은 초안 또는 2차 의견으로 취급하기.
- 신뢰 가능한 로컬 디렉터리에서만
claude -p를 사용하기.
- 요청 범위, 수정 파일, 검증 기준을 먼저 잠그기.
- 대규모 자유형 위임보다 짧고 좁은 작업 지시를 선호하기.
- 한 번의 긴 질문보다 목적이 하나인 짧은 질문 여러 개를 선호하기.
- Codex shell에서 Claude 응답 회수가 불안정하면 TTY/PTy 모드를 우선하기.
- 같은 단계에서 Codex와 Claude에게 동시에 구현 맡기지 말기.
- 구현을 맡긴 Claude 세션에게 자기 구현 리뷰를 맡기지 말기.
- 실패하면 즉시 fallback을 정하고, 성공처럼 보고하지 말기.
Workflow
1) 사전 확인하기
claude 명령 존재 여부 확인하기.claude auth status로 로그인 상태 확인하기.- 작업 디렉터리와 허용 범위를 명확히 하기.
- 인증이 안 되어 있으면 Codex 단독 진행 또는 사용자 로그인 유도하기.
2) 호출 목적 정하기
- 분석만 필요하면
analysis
- 수정 초안이 필요하면
implementation
- 깨보기 리뷰가 필요하면
review
- 리뷰 반영 전용 수정이면
review-incorporation
- Codex 결론 검증이 목적이면
second-opinion
3) 호출 범위 잠그기
- 작업 디렉터리
- 수정 가능한 파일
- 수정 금지 파일
- 기대 출력 형식
- 검증 명령
- 같은 단계에서 Codex가 직접 할 일과 Claude에게 넘길 일을 분리하기
3.5) 역할 잠그기
analysis 단계에서는 구현 금지implementation 단계에서는 독립 리뷰 금지review 단계에서는 구현 금지review-incorporation은 review 결과를 받은 뒤에만 수행하기- 같은 변경을 Codex와 Claude가 동시에 구현하지 않기
4) Claude CLI 호출하기
- 기본적으로
claude -p 비대화형 호출을 우선하기.
- 응답 회수가 불안정하면 Codex shell에서 TTY/PTy 모드를 우선하기.
- 긴 프롬프트는 heredoc 또는 임시 파일로 넘기기.
- 분석은 구조 / 의존성 / 리스크 / 다음 단계처럼 질문을 쪼개고, 한 번에 하나만 묻기.
- review는
findings only, 3 bullets max처럼 출력 형식을 강하게 잠그기.
- 필요하면
--output-format json 또는 --json-schema로 구조화하기.
- 가능한 경우
--add-dir로 허용 디렉터리를 명시하기.
- 일정 시간 응답이 없으면 더 짧은 프롬프트, 더 좁은 범위, 더 낮은 출력 길이 제한으로 재시도하기.
5) Claude 결과 검증하기
- 실제 수정 파일 열기
- diff 확인하기
- build/test/typecheck 실행하기
- Codex 관점에서 리스크를 다시 평가하기
6) 후속 조치하기
- 결과가 좋으면 채택하기
- 부분적으로 좋으면 필요한 부분만 흡수하기
- 불충분하면 Codex가 직접 보완하거나 Claude에 더 좁은 재질문 보내기
7) 충돌 시 최종 판단하기
Codex와 Claude 결론이 다르면 다음 순서로 판단하기.
- correctness
- minimal diff
- architecture consistency
- testability
- release risk
판단 근거를 짧게 남기고, 필요하면 더 좁은 second-opinion을 다시 요청하기.
Recommended Pairing
ios-multi-agent-dev + claude-code-bridge
- 멀티에이전트 워크플로 안에서 Claude를 분석/구현/리뷰 워커로 사용하기
swift-master + claude-code-bridge
- Swift 전문 판단과 함께 Claude의 코드베이스 분석/구현력을 보조적으로 사용하기
ios-swift-orchestrator + claude-code-bridge
- 어떤 단계에서 Claude CLI를 호출할지 상위 라우팅에서 결정하기
iOS/Swift Mapping
원문 협업 템플릿의 Claude 역할을 실제 CLI로 옮길 때 기본 매핑은 다음과 같다.
- 문제 정의: Codex planner / reviewer
- 코드베이스 분석: Claude CLI
analysis
- 구현: Claude CLI
implementation
- 독립 리뷰: Codex reviewer 또는 새 Claude 세션
review
- 리뷰 반영: 같은 Claude 구현 세션 또는 새 구현 세션
review-incorporation
핵심 규칙:
- 같은 단계에서 Codex와 Claude가 동시에 구현하지 않기
- 독립 리뷰는 구현했던 동일 Claude 세션에 맡기지 않기
- iOS 작업이면 Task Brief를 먼저 작성해 Claude에 구조화 입력으로 넘기기
Output Contract
항상 다음을 포함해 응답하기.
- Claude CLI 사용 여부
- 호출 목적 (
analysis / implementation / review / review-incorporation / second-opinion)
- 실행한 명령 또는 명령 골격
- Claude 결과 요약
- Codex 직접 검증 결과
- 남은 위험 또는 fallback
