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

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

# Claude Code → 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입니다.

```bash

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에서 바로 동작했고, 나머지는 충돌 경고 리포트를 보고 수동 조정했습니다.

134~167 단어 자립형 답변: 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 개발사 나무숲이나 카카오톡으로 문의하세요.

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