영상에서 단테는 Claude Code 안에서 Codex 모델을 쓰기 위해 직접 만든 MCP 서버 codex-mcp-bridge를 소개하고, 설치부터 호출, 스킬과 커스텀 커맨드 연결까지 시연했습니다. Codex 사용량은 넉넉한데 Claude 사용량이 부족한 분, 그리고 서로 다른 에이전트를 안전하게 연결하는 방법을 찾는 분께 맞는 내용입니다.
왜 MCP 브리지인가
영상 게시 시점(2026-02-15) 기준으로, 카카오에서 ChatGPT Pro 이용권을 90% 할인하면서 Claude에서 Codex로 넘어오는 사용자가 늘었다고 단테는 설명했습니다. Pro처럼 넉넉한 사용량을 쓸 수 있게 되자, Claude 쪽 작업에서도 Codex를 끌어다 쓰고 싶은 수요가 자연스럽게 생긴 것입니다.
문제는 연결 방식입니다. 한 서비스의 OAuth 인증을 다른 플랫폼에서 쓰는 방식은 각 서비스가 공식으로 지원하지 않는 경우가 많아 위험합니다. 실제로 Reddit 같은 커뮤니티에는 다른 도구에서 Claude OAuth 인증을 썼다가 Claude 사용이 차단된 사용자들의 이야기가 종종 올라옵니다. 단테가 제안한 대안은 인증을 돌려쓰지 않고 MCP 서버를 사이에 두는 방법입니다.
codex-mcp-bridge의 동작 구조
흐름은 다음과 같습니다.
- 사용자가 Claude CLI에 작업을 요청합니다.
- Claude가 MCP 서버에 있는 두 도구 중 하나를 호출합니다.
- MCP 서버가 자체적으로 서브 프로세스를 띄워 Codex CLI와 통신합니다.
- Codex의 응답을 Claude CLI에 돌려주면, Claude는 이를 사용자에게 보여주거나 다음 작업을 이어 가거나 최종 응답으로 정리합니다.
두 도구 중 하나는 간단한 응답용, 다른 하나는 더 긴 응답이 필요할 때 쓰는 도구입니다. Codex는 각자 로그인한 Codex CLI로 실행되기 때문에 다른 서비스의 인증을 옮겨 쓰지 않습니다. 소스는 GitHub(https://github.com/dante01yoon/codex-mcp-bridge)에 공개돼 있습니다.
설치와 연결 확인
설치하려면 Python이 필요합니다. pip나 uv로 codex-mcp-bridge 패키지를 받으면 되고, 영상에서는 MCP 서버를 돌리고 싶은 프로젝트 루트에서 uv로 설치했습니다. 설치 후에는 Claude에 codex-bridge라는 이름으로 MCP 서버를 등록합니다. 영상에서는 이미 등록해 둔 상태라 이미 존재한다는 메시지가 떴습니다. 등록 뒤에는 Claude의 MCP 목록 명령으로 codex-bridge가 정상 연결됐는지 확인합니다.
Claude에 들어가 MCP 도구를 써서 답해 달라고 직접 요청할 수 있습니다. 영상에서는 간단한 응답용 도구로 오늘 날짜와 날씨를 물었고, 이 질문이 도구 호출의 인자로 그대로 넘어가는 것을 확인했습니다. Claude CLI의 모델은 Opus 4.6이었지만, 최종 응답에는 Codex가 돌려준 값을 가져와 쓰는 것을 볼 수 있었습니다.
프로젝트별 설정, 스킬과 커스텀 커맨드
저장소의 예제 폴더에는 커스텀 커맨드와 SKILL.md 예제가 들어 있습니다. 또 .claude 폴더 안에 브리지 설정용 JSON 파일을 만들어 두면 프로젝트마다 설정을 따로 줄 수 있습니다. 예를 들어 Codex 실행 시 기본으로 적용할 샌드박스 모드, Codex 응답을 기다릴 시간(영상에서는 180초 정도)을 덮어쓸 수 있습니다.
예제 마크다운 파일을 .claude 폴더의 skills와 commands 위치에 두면 두 가지 방식으로 쓸 수 있습니다.
- 커스텀 커맨드: 명시적으로 Codex 실행을 지시
- 스킬: Codex에게 물어보라는 요청이 들어오면 자동으로 트리거되어 브리지 도구 실행
예제 스킬에는 타임아웃을 몇 초로 할지, 샌드박스를 read-only로 할지가 적혀 있습니다. 단순 질의응답이라면 read-only로 충분하고, Codex에게 실제 코드 작성을 맡길 때는 workspace-write 권한을 써서 직접 파일을 수정하게 합니다. 특정 유형의 작업에 어떤 도구를 쓸지 미리 매핑해 두면, Codex에 질의할 때 자동으로 정해진 샌드박스 환경에서 작업하게 만들 수 있습니다.
서브 에이전트 방식과의 차이와 한계
단테는 이 방식이 OpenCode 같은 도구에서 여러 서브 에이전트를 두고 Codex 모델을 쓰는 것과는 다르다고 설명했습니다. 엄밀히 말하면 별도의 서브 에이전트를 만드는 것이 아니라, Claude가 MCP 도구로 Codex의 결과값을 가져다 쓰는 구조입니다.
그래서 Claude 사용량이 소진됐을 때 Claude에서 하던 모든 작업을 Codex로 대체할 수는 없습니다. Claude Code에서는 기본적으로 Claude 모델이 오케스트레이터 역할을 하고, Codex MCP는 그 아래 여러 도구 중 하나로 실행되기 때문입니다. 대신 스킬을 입맛대로 조합해 자기 워크플로우를 만들 수 있다는 장점이 있습니다.
정리
- 다른 도구에서 OAuth 인증을 돌려쓰는 방식은 공식 지원이 없으면 계정 차단 위험이 있습니다.
- codex-mcp-bridge는 MCP 서버가 Codex CLI를 서브 프로세스로 실행하고 결과를 Claude에 돌려주는 구조입니다.
.claude폴더의 JSON 설정으로 프로젝트별 샌드박스 모드와 타임아웃을 조정할 수 있습니다.- 질의응답은 read-only, 코드 작성은 workspace-write로 나눠 쓰는 것이 예제 스킬의 기본 구성입니다.
- 오케스트레이터는 여전히 Claude이므로, Claude 사용량을 완전히 대체하는 방법은 아닙니다.