코덱스(Codex)와 클로드 코드 사이 설정 이전, /import로 넘어가는 항목 정리

갤럭시에서 아이폰으로, 또는 그 반대로 폰을 바꿀 때 기기 값보다 먼저 확인하는 것이 있습니다. 쓰던 사진과 연락처와 앱이 그대로 넘어가는지입니다. 넘어가지 않는 항목이 많으면 새 기기가 아무리 좋아도 바꾸기를 미루게 됩니다.

코딩 도구를 바꿀 때도 순서가 같습니다. 새 모델이 나올 때마다 한 번씩 옮겨 보는 사람이 늘었는데, 정작 막히는 것은 성능이 아니라 그동안 쌓아 둔 것입니다. 규칙 파일, 스킬, 슬래시 명령, MCP 연결처럼 몇 달에 걸쳐 맞춰 둔 설정이 도구마다 형식이 다르기 때문입니다.

폰과 다른 점은 무엇이 넘어가는지 아직 덜 알려져 있다는 것입니다. 옮길 방법이 없다고 보고 처음부터 다시 쌓거나, 전부 옮겨졌다고 믿고 확인을 건너뛰면 나중에 어긋난 곳을 찾느라 시간을 씁니다. 이 글에서는 코덱스와 클로드 코드가 서로의 설정을 가져오는 기능을 두 회사 공식 문서 기준으로 정리했습니다. 처음 정리한 날짜는 2026년 8월 28일이며, 아래 기능 설명은 2026년 10월 4일 공식 문서 기준으로 갱신했습니다. 두 도구를 설치하고 로그인한 상태에서 진행하는 안내입니다.

먼저 가져오기와 파일 복사를 구분합니다

/import는 설정을 받을 도구의 대화 입력칸에 쓰는 명령입니다. 일반 터미널에 /import만 입력하면 실행되지 않습니다. 스킬은 반복 작업의 지침, MCP는 외부 서비스 연결, 훅은 정해진 시점에 실행할 명령입니다. 서브에이전트는 맡긴 일을 따로 처리하는 보조 AI이고, CLI는 터미널에서 사용하는 프로그램입니다. 각각 가져오더라도 원래와 같은 방식으로 작동하는지 확인해야 합니다. 두 방향을 모두 실행할 필요는 없습니다. Claude Code에서 Codex로 옮긴다면 Claude Code가 원본, Codex가 대상입니다. 반대로 옮기려면 Claude Code에서 미리보는 절만 따라갑니다.

가져오기 전에 원본과 대상의 규칙 파일과 설정 파일을 별도 백업 폴더에 복사해 둡니다. 예를 들어 CLAUDE.md, AGENTS.md, .claude/settings.json, .codex/config.toml 중 실제 사용 중인 파일입니다. 사용자 공통 설정을 가져온다면 ~/.claude/settings.json과 ~/.codex/config.toml도 해당합니다. ~는 사용자 홈 폴더를 뜻합니다. 없는 파일을 새로 만들 필요는 없습니다.

원본 설정이 보존된다는 말은 작업 파일을 따로 복제한다는 뜻이 아닙니다. 기존 프로젝트 폴더를 그대로 쓰면 새 도구가 고친 파일을 이전 도구에서도 보게 됩니다. 두 도구를 동시에 켜 같은 파일을 수정하지 않도록 현재 작업부터 마칩니다.

코덱스가 클로드 코드 설정을 가져오는 화면

위 화면은 2026년 8월에 보관한 가져오기 화면입니다. 표시된 프로젝트 8개와 대화 53개는 당시 환경의 개수이며 가져올 수 있는 공통 한도가 아닙니다. 폴더 모양 아이콘에서 화살표가 오픈AI 쪽을 향하고 있고, 항목이 세 묶음으로 나뉘어 있습니다.

• 도구 및 설정: 설정, 지침, 플러그인, 스킬
• 프로젝트: 기존 프로젝트 폴더를 그대로 씁니다
• 채팅 세션: 최근 채팅입니다

눈에 띄는 것은 부제입니다. 기존 설정에는 영향이 없다고 적혀 있습니다. 공식 문서에도 원래 설정을 보존한다고 안내합니다.

오픈AI 공식 문서는 가져오기가 기존 에이전트 설정을 바꾸거나 지우지 않는다고 밝히고 있습니다.

폰을 바꿔도 옛 폰의 연락처가 남듯이 설정 원본을 보존한다는 설명입니다. 다만 프로젝트 폴더는 그대로 사용할 수 있으므로 파일 복사와는 구분합니다.

/import로 넘어가는 항목

위 표가 공식 문서에 있는 항목별 대응입니다. 그대로 복사되는 것이 아니라 코덱스의 형식으로 바뀌어 들어갑니다.

여기서 AGENTS.md는 작업 규칙을 적는 파일입니다. 클로드 코드의 CLAUDE.md에 적었던 지시가 다른 도구의 규칙 형식으로 옮겨집니다. 이름이 바뀌었다고 모든 지시가 똑같이 작동한다고 보지는 않습니다.

데스크톱 앱은 현재 ChatGPT 앱의 Settings > Import에서 시작합니다. 메뉴가 없다면 General의 Import other agent setup을 찾습니다. CLI는 터미널에서 codex를 실행한 뒤 대화 입력칸에 /import를 입력합니다. Claude Code를 원본으로 선택하고 필요한 항목을 검토한 뒤 가져옵니다. 처음에는 한 프로젝트의 규칙이나 스킬처럼 결과를 확인할 수 있는 작은 범위부터 선택합니다.

가져오기 뒤 앱에 추가 설정이 남았다는 표시가 있으면 Finish를 선택해 안내를 확인합니다. 프로젝트 하나를 열어 필요한 규칙과 스킬이 있는지 살펴봅니다.

대화에는 상한이 있습니다. Codex CLI는 최근 30일 채팅 가운데 50개까지 가져옵니다. 실행 중인 작업, 원격 세션, 로컬 app-server 데몬(컴퓨터에서 계속 실행되는 연결 서버)에 연결된 상태에서는 /import를 사용할 수 없습니다. 명령이 보이지 않으면 작업을 마치고 로컬 터미널에서 직접 시작한 세션인지 확인합니다.

클로드 코드에도 같은 이름의 명령이 있습니다

위 화면은 과거 명령 목록입니다. 현재는 Cursor도 가져오기 대상으로 추가됐습니다. 방향이 한쪽만 열려 있는 것은 아닙니다. 클로드 코드에도 /import가 있고, OpenAI Codex, Google Gemini CLI, Cursor의 설정을 가져옵니다. 지시 파일, MCP 서버, 명령, 서브에이전트, 스킬이 넘어오고 기본 기능은 Claude Code v2.1.213 이상, Cursor 가져오기는 v2.1.265 이상이 필요합니다.

옵션 두 가지가 유용합니다.

• --dry-run: 아무것도 쓰지 않고 무엇이 넘어올지 미리 보여 줍니다.
• --yes: 항목 선택 화면을 건너뜁니다. 처음 이전할 때는 붙이지 않고 내용을 확인합니다.

쓸 수 없는 환경도 함께 적혀 있습니다. 아마존 베드록, 구글 클라우드의 에이전트 플랫폼, 마이크로소프트 파운드리, AWS의 Claude 플랫폼과 Claude apps gateway 연결에서는 지원하지 않습니다. 기능 설정을 서버에서 가져오는 동작을 꺼 둔 환경에서도 사용할 수 없습니다.

Claude Code로 Codex 설정을 가져올 때는 터미널에서 claude를 실행하고 대화 입력칸에 아래 명령을 넣습니다.

--dry-run은 실제 파일에 쓰지 않고 예정된 변경만 보는 옵션입니다. 출력에서 가져올 원본과 대상 경로, 항목을 확인합니다. 목록이 비어 있으면 이전이 완료된 것이 아니라 지원하는 원본 설정을 찾지 못한 것일 수 있습니다. 사용하던 계정의 홈 폴더와 프로젝트 위치부터 확인합니다.

미리보기 내용이 맞을 때만 다음 명령을 대화 입력칸에 넣고 선택 화면에서 필요한 항목을 고릅니다.

이 명령은 실제 설정을 쓸 수 있습니다. 연습 폴더에서 실행하더라도 사용자 공통 설정까지 살펴볼 수 있으므로 폴더 하나를 새로 만들었다고 이전 범위 전체가 격리되는 것은 아닙니다. 가져온 뒤 대상 파일을 열어 예상한 내용인지 확인합니다.

대화와 훅, 권한 처리에 차이가 있습니다

양쪽 문서를 나란히 놓으면 겹치는 항목이 대부분입니다. 지시 파일, MCP 서버, 스킬, 서브에이전트는 어느 쪽으로 가든 넘어갑니다. 대화 기록 외에도 훅과 세부 권한을 옮기는 방식이 다릅니다.

코덱스는 최근 30일 채팅을 가져오지만, 클로드 코드의 /import가 가져오는 항목에는 대화가 들어 있지 않습니다.

주소록과 앱은 옮겨 주는데 사진첩까지 옮겨 주는 쪽은 한쪽뿐인 상황과 비슷합니다. 며칠 전 대화를 이어서 물어보는 방식으로 일해 왔다면 이어 쓸 대화가 이전 목록에 있는지 먼저 확인해야 합니다.

이 글에서 다루는 명령은 받는 도구에서 시작하는 가져오기 기능입니다. Claude Code의 /export는 현재 대화를 평문으로 저장하는 기능이므로 설정 전체 이전과 구분합니다. 대화 기록만 저장해도 스킬이나 로그인 설정까지 이전되는 것은 아닙니다.

옮긴 뒤에 직접 확인해야 하는 것

가져오기가 끝났다고 그대로 쓸 수 있는 것은 아닙니다. 오픈AI 문서는 옮긴 뒤 살펴볼 항목을 따로 적어 두었습니다.

• 스킬과 에이전트의 도구 제한과 권한 설정: 형식이 달라 그대로 옮겨지지 않기도 합니다.
• MCP 서버: 사용자 지정 인증이나 접속 설정을 쓴다면 다시 로그인하거나 설정을 보완해야 할 수 있습니다.
• 훅: 옮긴 뒤 동작이 달라질 수 있습니다.
• 플러그인과 마켓플레이스: 사람이 이어서 설정해야 하는 것이 남습니다.
• 인자나 파일 경로를 쓰는 명령 형태의 프롬프트: 값이 들어가는 방식이 달라 확인이 필요합니다.

연결 설정이 목록에 있어도 로그인이 끝났다는 뜻은 아닙니다. 인증 정보와 권한은 연결 방식에 따라 다시 확인해야 합니다.

지원 항목으로 적혀 있어도 실행 방식과 권한까지 같아지는 것은 아닙니다. 옮긴 직후에는 중요 자료가 없는 메모로 한 작업을 확인합니다. 이전한 프로젝트 안에 중요한 자료가 없는 연습 폴더를 만들고 새 도구에서 그 폴더를 엽니다. 기존 파일을 덮어쓰지 않도록 확인한 뒤 migration-note.md에 “독서 모임: 2026-10-12, 장소 미정”을 저장하고 새 도구에 “migration-note.md만 읽고 날짜와 장소를 두 줄로 정리해 줘. 파일은 수정하지 마.”라고 요청합니다. 날짜와 장소가 원문대로 나오고 파일이 그대로인지 확인합니다.

이 연습은 기본 파일 읽기 확인입니다. 스킬은 실제 사용 목록과 간단한 입력으로, MCP는 연결 상태와 허용된 읽기 작업으로, 훅은 설정한 실행 조건에서 따로 확인합니다. 메모 요약이 됐다고 모든 이전 항목이 정상인 것은 아닙니다. 같은 메모의 날짜를 10월 19일로 바꿔 저장하고 다시 요약해 보면 새 파일 상태를 읽는지도 확인할 수 있습니다.

옮기면 원래 쓰던 도구의 설정이 지워지나요?

지워지지 않습니다. 오픈AI 공식 문서는 가져오기가 기존 에이전트 설정을 바꾸거나 지우지 않는다고 밝히고 있습니다. 코덱스 화면에도 기존 설정에는 영향이 없다는 안내가 함께 나옵니다.

읽어서 복제해 오는 방식이라 원래 도구는 그대로 남습니다. 두 도구를 함께 쓰면서 비교해 보는 것도 가능합니다. 한 번 가져온 뒤의 변경이 항상 양방향으로 동기화되는 것은 아닙니다. ChatGPT 데스크톱 앱의 Settings > Import에는 자동 갱신 옵션이 있으므로 사용 여부를 확인합니다. CLI의 일회성 가져오기와 구분하고, 계속 두 도구를 쓴다면 어느 파일을 공통 원본으로 관리할지 정합니다. 공통 규칙과 순차 작업 예시를 참고할 수 있습니다.

무엇을 먼저 확인하고 옮기는 것이 좋을까요?

클로드 코드로 가져오는 경우에는 --dry-run을 먼저 실행합니다. 아무것도 쓰지 않은 채 무엇이 넘어올지 보여 주므로, 예상과 다른 항목이 있는지 확인한 뒤 진행할 수 있습니다.

코덱스로 가져오는 경우에는 화면에서 항목을 골라 담는 방식입니다. 처음부터 전부 담기보다 설정과 스킬을 먼저 옮겨 확인하고, 대화 기록은 필요할 때 따로 가져오는 순서도 괜찮습니다. 옮긴 다음에는 앞 절의 항목별 확인을 진행합니다. 예상과 다르게 동작하면 가져오기 명령을 반복하기 전에 변경된 설정 파일과 오류 문구를 확인합니다. 자동 갱신을 켰다면 먼저 중지하고, 백업과 비교해 이번 이전에서 바뀐 부분만 복구합니다. 그사이 새로 만든 설정까지 전체 백업으로 덮어쓰지 않습니다.

참고 자료

• Import from another agent, ChatGPT Learn
• Commands, Claude Code Docs
• How Claude remembers your project, Claude Code Docs