Claude Code → Codex 마이그레이션 툴 오픈소스 공개

Claude Code에서 Codex로 플러그인·MCP·메모리·하네스를 한 번에 이관하는 오픈소스 마이그레이션 도구. Claude Code Max 월 100만원 쓰던 TreeSoop이 Codex 하이브리드 전환하며 만든 실전 툴 공개.

TreeSoop은 Claude Code Max 3계정(월 약 100만원)을 쓰는 Claude-native 팀입니다. 그런데 최근 일부 워크로드를 Codex로 옮기기 시작했습니다. 옮기면서 가장 어려웠던 점 — Claude Code에서 쓰던 플러그인, MCP, 메모리, 하네스를 그대로 가져오기 어렵다는 것. 그래서 팀에서 쓰던 마이그레이션 도구를 github.com/treesoop/claude2codex에 공개했습니다.

왜 Codex로 일부 이관하는가

Claude-native 팀이 Codex를 쓰기 시작한 이유는 두 가지입니다.

1. Claude 불안정성

2026년 2월부터 Claude Code의 성능 저하 이슈가 있었습니다. Anthropic이 공식 인정한 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 워크어라운드까지 필요한 상황. 미션 크리티컬한 작업을 Claude 한 모델에만 의존하기에 리스크가 있습니다.

2. 토큰 비용

Claude Code Max는 월 100만원 정도 쓰면 충분하지만, Codex가 특정 반복 워크로드에서 1/3~1/5 비용입니다. 긴 체인의 간단한 작업(예: 문서 정리, 테스트 작성)에 Codex가 훨씬 경제적입니다.

결론: 양쪽 다 쓰는 하이브리드가 현시점 최적입니다.

마이그레이션의 실제 어려움

Claude Code → Codex 전환이 간단할 것 같았지만 세부 설정이 많이 달랐습니다.

설정 파일 차이

Claude Code           Codex
────────────          ────────
~/.claude/CLAUDE.md   ~/.codex/config.md
~/.claude/settings.json  codex.toml
~/.claude/skills/     ~/.codex/prompts/

구조가 다르니 파일만 옮기면 안 되고, 포맷 변환이 필요했습니다.

MCP 서버 등록

Claude Code는 claude mcp add로 MCP를 등록합니다. Codex는 별도 설정 파일 섹션을 편집해야 합니다. 10개가 넘는 MCP를 수동 이관하면 시간이 많이 들고 누락 위험도 있습니다.

메모리/프로필

~/.claude/user_profile.md 같은 개인화 파일이 Codex 포맷으로 안 들어갑니다. 변환이 필요합니다.

하네스 플로우

Claude Code의 하네스 스킬 호출 로직이 Codex에서는 다른 트리거 방식입니다. 재작성해야 하는 부분이 있습니다.

claude2codex의 접근

claude2codex는 이 이관 작업을 자동화하는 CLI입니다.

npx claude2codex init  # 감지
npx claude2codex migrate --dry-run  # 시뮬레이션
npx claude2codex migrate  # 실제 이관

주요 기능:

기능	설명
CLAUDE.md → config.md 변환	포맷 자동 변환
MCP 서버 이관	등록된 MCP를 Codex 포맷으로 변환·등록
스킬 → 프롬프트 변환	skills/*.md를 Codex prompts/ 구조로
user_profile 이관	개인 프로필 데이터 이관
하네스 트리거 재매핑	기본적인 트리거 로직 변환
충돌 경고	Codex가 지원 안 하는 기능 리포트

실제 이관 후기

TreeSoop 팀원 9명이 각자 쓰던 Claude Code 환경을 Codex로 이관하는 데 claude2codex를 쓴 결과, 평균 이관 시간이 수작업 대비 상당히 단축됐습니다. 자동 변환된 설정 중 95% 이상이 Codex에서 바로 동작했고, 나머지는 충돌 경고 리포트를 보고 수동 조정했습니다.

claude2codex란?

claude2codex는 Claude Code에서 OpenAI Codex로 개발 환경을 이관할 때 설정 파일·MCP 서버·스킬·사용자 프로필·하네스 트리거 등을 자동 변환해주는 오픈소스 CLI 도구입니다. 2026년 4월 TreeSoop이 github.com/treesoop/claude2codex에 공개했으며, npx claude2codex migrate 명령 한 번으로 주요 이관 작업이 자동화됩니다. Claude Code Max 3계정(월 약 100만원)을 쓰던 AI-Native 팀이 Codex 하이브리드 전환을 경험하며 내부적으로 쓰던 도구를 공개한 것으로, 95% 이상의 설정이 자동 변환되어 Codex에서 바로 동작했습니다. Claude와 Codex 양쪽을 병행하는 팀, Claude 불안정성이나 토큰 비용 문제로 Codex 이관을 검토 중인 개발팀에게 실무적으로 유용한 마이그레이션 자동화 도구입니다.

자주 묻는 질문

Q: Windsurf, Cursor 등 다른 AI IDE로도 이관되나요?

A: 현재 버전은 Claude Code → Codex 전환 특화입니다. 다른 도구 지원은 로드맵에 있습니다.

Q: 이관 후 원래 Claude Code 설정은 유지되나요?

A: 네. 기본적으로 원본 파일은 건드리지 않고 Codex 포맷으로 복사·변환합니다. 양쪽 병행 사용 가능합니다.

Q: 팀 전체 이관 자동화도 되나요?

A: 스크립트 단위 이관이라 팀 환경에서 각자 실행하면 됩니다. CI/CD 통합은 아직 없습니다.

Q: 충돌 경고는 어떻게 처리하나요?

A: Codex가 지원 안 하는 Claude Code 고유 기능(예: 특정 하네스 훅)을 리포트합니다. 리포트를 보고 수동으로 조정하거나 해당 워크플로우를 Claude에 남겨둘 수 있습니다.

Q: 라이선스는요?

A: MIT 라이선스 오픈소스입니다. 상업적 사용 자유입니다.

글쓴이: 남대현 | TreeSoop CEO, POSTECH 컴퓨터공학 AI/MR/HCI 석사

AI-Native 개발 환경 컨설팅이나 Claude Code/MCP 기반 에이전트 개발이 필요하시면 AI-Native 개발사 트리숲이나 카카오톡으로 문의하세요.

마이그레이션 실전 절차를 찾는다면

이 글은 툴 자체의 release 노트와 자동 변환 범위에 집중한다. 실제 팀이 어떤 순서로 자산을 이전하고, Skills·Hooks를 어떻게 대체하며, 어떤 워크로드는 분기 사용하는 게 더 나은지는 별도의 실전 가이드에서 7단계로 정리했다 — Claude Code → Codex 마이그레이션 실전 가이드 2026.

Claude Code → Codex 마이그레이션 툴 오픈소스 공개 | AI-Native 팀 실전