현재 Codex 가져오기 도구가 지원하는 범위
Claude Code 설정, 거의 통째로 가져오기
원래 대상은 Claude Code였으며, 그 범위는 넓습니다. Codex 문서에 따르면 지침(instruction) 파일, config.toml 및 settings.json, 스킬 및 플러그인, MCP 서버 설정, 프로젝트 폴더 및 메모리, 훅(hook) 및 슬래시 명령어, 서브에이전트, 그리고 최근 30일 동안의 채팅을 가져올 수 있다고 설명합니다. CLI에서 /import를 실행하거나 데스크톱 앱의 가져오기 흐름을 사용하면 됩니다.
시도하기 전에 알아두어야 할 제한 사항이 있습니다. 작업이 실행 중이거나, 원격 세션이거나, 로컬 앱 서버 데몬에 연결된 상태에서는 가져오기를 사용할 수 없으며, 일부 플러그인은 가져온 후에 다시 인증해야 합니다.
Cursor에서 관리하는 스킬 (8월 7일 기준)
이 부분이 새로운 내용입니다. 릴리스 노트는 단 한 줄이지만, 그 뒤에 병합된 작업들은 구체적인 메커니즘을 보여줍니다. 풀 리퀘스트 제목은 "Migrate Cursor-managed skills into Codex(Cursor 관리 스킬을 Codex로 마이그레이션)", "Parse Claude and Cursor session records separately(Claude 및 Cursor 세션 기록을 별도로 파싱)", "Preserve working directories when importing external sessions(외부 세션을 가져올 때 작업 디렉터리 보존)" 등입니다.
마지막 항목을 보면 그들이 어떤 문제를 해결하려고 했는지 알 수 있습니다. 세션을 가져오는 것은 단순한 텍스트가 아닙니다. 세션은 특정 디렉터리 내에서 의미를 가지며, 디렉터리 정보를 잃어버린 채 가져오기를 수행하면 읽을 수는 있지만 유용하게 이어서 사용할 수 없는 기록만 남게 됩니다.
중복되지 않고 최신 상태를 유지하는 대화
릴리스 노트의 후반부가 더 흥미로운 부분입니다. "중복을 생성하지 않고 가져온 Claude 및 Cursor 대화의 변경 사항을 동기화"하는 기능으로, "Sync updates to imported external agent sessions(가져온 외부 에이전트 세션의 업데이트 동기화)"로 구현되었습니다.
이전에는 가져오기가 스냅샷에 불과했습니다. 다시 가져오면 두 번째 복사본이 생성되었습니다. 이제 다시 가져오면 이미 가져온 내용과 대조하여 조정합니다. 마이그레이션 중에 두 도구를 병행하여 실행하는 경우(대부분의 사람들이 일주일 정도 그렇게 합니다), 이는 불안해하며 단 한 번만 수행하는 가져오기와 필요할 때마다 반복할 수 있는 가져오기의 차이를 만들어 줍니다.
하지만 여기에 담긴 함의를 주목해야 합니다. 동기화한다는 것은 해당 데이터에 대한 권한이 여전히 다른 도구에 있음을 의미합니다. 이는 두 도구를 모두 사용하는 과도기를 위한 다리일 뿐, 데이터의 소유권이 완전히 이전되는 것은 아닙니다.
가져온 채팅의 실체와 한계
채팅 가져오기에는 문서화된 제한이 있습니다. 최근 30일, 최대 50개의 대화로 제한됩니다. 이는 의도된 범위이며, 이 기능이 아카이브가 아니라 전환하는 동안의 연속성을 위한 것임을 말해줍니다.
이 50개 대화의 가치에 대해 냉정해질 필요가 있습니다. 대화 기록은 과정의 기록이며, 그 과정의 대부분은 정답에 도달하기 전의 오답들로 채워져 있습니다. 가져온 채팅은 검색 가능한 최근 기록과 금요일에 중단했던 맥락을 다시 이어갈 수 있는 능력을 제공합니다. 하지만 결론만을 따로 모아서 제공하지는 않습니다. 탐색 과정에서 결론을 분리해 낸 사람이 아무도 없기 때문입니다. 만약 그 채팅 중 하나에서 어떤 결정이 내려졌다면, 채팅을 가져오는 것은 결정을 기록하는 것과 같지 않으며, 나중에 이를 읽는 에이전트는 기각된 접근 방식과 최종 결정된 방식을 거의 동일한 비중으로 취급할 것입니다.
그리고 여전히 변하지 않은 한계
가져오기 도구의 문서에는 여전히 명확하게 적혀 있습니다. "표준 Claude Chat 데이터는 가져올 수 없습니다." ChatGPT 데이터도 가져올 수 없습니다. 이는 사람들을 놀라게 하는 비대칭성입니다. OpenAI의 자체 CLI는 경쟁사의 개발자 도구를 명령어 하나로 가져오면서도, 두 벤더의 일반 소비자용 앱 데이터는 가져오지 못합니다.
이는 단순한 실수가 아니라 일관된 결정입니다. /import는 개발자 설정 도구이며, 일반 소비자용 제품의 채팅 기록은 개발자 설정이 아니기 때문입니다. 즉, 채팅 앱에서 어시스턴트가 쌓아온 메모리는 여전히 수동으로 옮겨야 함을 의미하며, 이는 그 자체로 별도의 마이그레이션 작업입니다.
사람들이 시도하는 방법들
가져오기 도구가 모든 것을 지원할 때까지 기다리기. 이해는 가지만, 그런 일은 일어나지 않을 것입니다. 왜냐하면 그 공백은 누락된 기능 때문이 아니기 때문입니다. Cursor나 Claude Code에는 여러분의 컨벤션 뒤에 숨겨진 이유를 담고 있는 파일이 없습니다. 아무도 그것을 기록하지 않았으니까요. 가져오기 도구는 존재하는 것만 이동할 수 있습니다.
가져온 후 완벽히 동일할 것이라 가정하기. 가장 흔히 겪는 실망입니다. 규칙도 들어오고, 스킬도 들어오고, MCP 서버도 들어왔는데—새 에이전트는 여전히 지난 분기에 팀에서 거부했던 접근 방식을 제안합니다. 전송 과정에서 유실된 것은 없습니다. 그 지식은 애초에 파일에 없었기 때문입니다.
`AGENTS.md`에 수동으로 규칙 복사하기. 중요하게 생각하는 부분에 대해서는 여전히 올바른 직관이며, 어차피 가져오기 도구도 콘텐츠를 여기에 저장합니다. Codex는 ~/.codex/AGENTS.md(또는 $CODEX_HOME)부터 리포지토리 루트, 중간 디렉터리, 그리고 작업 디렉터리에 이르기까지 AGENTS.md를 해석하며, 가장 가까운 파일이 우선순위를 갖습니다. 위치별로 파일을 정리하는 것이 스코프를 온전히 유지하는 방법입니다.
Codex 메모리를 켜고 끝났다고 생각하기. 해볼 만한 가치는 있지만, 완벽한 기록은 아닙니다. Codex 메모리는 기본적으로 비활성화되어 있으며, 설정의 개인화(Personalization) 항목에서 활성화하거나 [features] memories = true로 켤 수 있습니다. 이는 채팅에서 파생된 요약 및 지속적인 항목과 같은 생성된 상태를 담고 있으며, 프로젝트 단위가 아닌 글로벌 단위로 ~/.codex/memories/에 저장되고 해당 장치에 로컬로 유지됩니다.
두 도구를 평생 켜두기. 솔직한 우회책이며, 이제 재가져오기 동기화가 지원되므로 더 나아졌습니다. 하지만 이는 두 개의 서로 다른 표준 세트를 유지해야 함을 의미하며, 검토 시점에 가서야 어디서 서로 달라졌는지 발견하게 될 것입니다.
패턴은 명확합니다. 모든 우회책은 설정은 잘 관리하지만 지식은 제대로 관리하지 못합니다.
해결책: 두 도구의 설정에서 지식을 분리하기
이전하려는 대상을 두 개의 더미로 나누십시오. 각각 머무를 곳이 다르기 때문입니다.
설정은 도구 내에 있어야 하며, 이제 가져오기 도구가 이를 처리합니다. 규칙, 스킬, MCP 서버, 훅, 명령어, 서브에이전트 등은 /import가 처리하도록 두고, 이후에 다듬으십시오. 마이그레이션은 누군가가 새로운 시각으로 모든 규칙을 읽어보는 유일한 순간이므로, 낡은 규칙을 그대로 가져가지 말고 삭제하십시오.
지식은 두 도구의 외부에 있어야 합니다. 제약 조건 뒤에 숨겨진 이유, 그것을 유발한 장애 사건, 거부했던 대안들, 클라이언트의 요구 사항, 아키텍처 결정 및 그 날짜 등은 벤더의 설정 디렉터리에 속하지 않습니다. 그런 것들이 설정 디렉터리에 들어가기 때문에 도구를 바꿀 때마다 고고학적 발굴 작업을 해야 하는 것입니다.
MemoryLake는 두 번째 더미(결정 사항, 제약 조건, 원본 문서)를 하나의 저장소에 보관하는 메모리 레이어입니다. Claude 및 Codex와 같이 MCP를 지원하는 도구에서 직접 읽을 수 있으며, API를 통해 ChatGPT에서도 읽을 수 있습니다. 이렇게 하면 가져오기 도구는 설정만 이동하면 되며, 이는 가져오기 도구가 실제로 가장 잘하는 영역입니다.
1단계: API 키 생성
키를 생성하고 약 30초 만에 첫 번째 요청을 보내보세요. 세션에 직접 붙여넣기보다는 환경 변수나 비밀 관리자(secret manager)에 보관하는 것이 좋습니다.
2단계: 첫 번째 메모리 업로드
규칙 뒤에 숨겨진 문서, 이미지, 파일들을 업로드하세요. ADR(아키텍처 결정 기록), 장애 보고서, 클라이언트 요구 사항, API 계약서, 모두가 동의한 RFC 등이 이에 해당합니다. 요약본보다는 원본 소스를 업로드하세요. 요약본은 바로 그 이유들이 유실되기 가장 쉬운 형태이기 때문입니다.
3단계: AI 및 에이전트 연결
Claude, Codex, OpenClaw 및 기타 AI 에이전트에게 MCP 또는 API를 통해 메모리 접근 권한을 부여하세요. Codex와 Claude Code는 모두 MCP를 지원하며 동일한 저장소를 직접 읽습니다. ChatGPT의 경우, API를 통해 필요한 정보를 검색하여 프롬프트나 모델을 호출하는 워크플로우에 주입하면 됩니다.
실제 업무에서 달라지는 점
첫 번째 차이점은 가져오기 작업이 지루해진다는 것입니다. 이는 가져오기 작업에서 우리가 가장 바라는 바입니다. 새 에이전트가 모르는 것들을 발견하느라 일주일 내내 고생하는 대신, 설정이 이동하면 다듬고 끝납니다.
두 번째는 병행 실행으로 인한 괴리가 사라진다는 점입니다. 실제 마이그레이션 과정에서는 두 도구를 모두 사용하게 되는데, 이제 대화가 깔끔하게 다시 동기화됩니다. 하지만 한 도구에서 다듬은 규칙은 여전히 다른 도구로 전파되지 않습니다. 제약 조건이 공유 저장소에 있으면 두 에이전트 모두 동일한 최신 버전을 읽게 되며, 계속해서 다시 설명해야 했던 복사본이 두 가지 버전으로 나뉘어 존재하지 않게 됩니다.
세 번째는 특정 도구를 사용 중단하더라도 동기화가 끊어지지 않는다는 점입니다. 동기화는 두 벤더의 저장소 사이를 잇는 다리일 뿐이지만, 공유 레이어는 어느 벤더도 소유하지 않은 저장소입니다. 기존 구독을 해지하더라도 공유 레이어는 계속 작동합니다.
또한 각 도구의 기본 메모리와도 결합됩니다. Codex 메모리는 로컬에서 사용자의 습관을 계속 학습하고, Claude Code의 프로젝트 메모리는 리포지토리별로 빌드 명령어를 계속 축적합니다. 둘 다 유용하고 기기 로컬에 저장되지만, 그렇기 때문에 팀원이 알아야 할 정보가 그곳에만 머물러서는 안 됩니다. 이는 에이전트들이 각자 프로젝트를 따로 학습하는 문제의 이면에 있는 공백과 동일합니다.
코딩 에이전트 간 가져오기 모범 사례
가져온 당일에 바로 다듬기
가져온 모든 것은 이제 여러분이 유지 관리해야 할 대상입니다. 모든 규칙을 한 번씩 읽어보고, 더 이상 존재하지 않는 서비스를 위해 작성된 규칙은 삭제하고, 나머지는 축소하세요. Codex는 매 세션마다 AGENTS.md를 컨텍스트에 로드하므로, 내용이 너무 길어지면 정말 중요한 규칙에 대한 준수율이 떨어질 수 있습니다.
스코프를 디렉터리 위치로 재표현하기
Cursor는 활성화 모드와 glob 패턴으로 스코프를 표현하는 반면, Codex는 파일이 위치한 곳으로 스코프를 표현합니다. 결제 서비스에만 적용되는 규칙은 루트 파일에 수식어를 붙여 넣는 것이 아니라 billing/AGENTS.md에 있어야 합니다. 위치는 강제되지만, 수식어는 희망 사항일 뿐입니다.
가져온 대화는 메모리가 아닌 참조용으로 취급하기
30일간의 채팅을 가져오는 것은 연속성 측면에서는 유용하지만, 지식 베이스로서는 최악입니다. 그것은 대화 기록일 뿐이며, 모든 대화 기록이 가진 한계를 그대로 가지고 있습니다. 만약 그 채팅 내용 중에 결정 사항이 있다면, 다른 곳에 결정 사항으로 명확히 기록해 두십시오.
생성된 메모리 사용 여부를 신중하게 결정하기
Codex 메모리가 기본적으로 꺼져 있는 것은 합리적인 기본값이며, 이를 켜는 것 또한 합리적입니다. 다만 잃어버렸을 때 곤란한 정보가 단 한 대의 기기에만 생성된 상태로 존재하게 두지 마십시오. 또한 이는 프로젝트별이 아닌 글로벌 단위이므로 작업 전반의 컨텍스트가 섞일 수 있음을 기억하세요.
액세스 권한이 있을 때 수동 내보내기 수행하기
파일이 아닌 웹 앱에 존재하는 것들—소비자용 채팅 앱의 메모리, 호스팅된 에이전트의 노트 등—은 수동으로 복사해야 하며, 비용을 지불하고 있는 동안에만 가능합니다. 이것이 기한이 있는 유일한 단계이며, 마이그레이션의 다른 모든 부분은 나중에 다시 할 수 있습니다.
결론
8월 7일 릴리스는 Codex의 가져오기 도구를 의미 있게 개선했습니다. 이제 Cursor에서 관리하는 스킬을 가져올 수 있으며, 이전에 가져온 Claude 및 Cursor 대화는 중복되지 않고 다시 동기화됩니다. 수동으로 다시 빌드해야 한다는 점 때문에 이전을 망설였다면, 이제 그 이유는 대부분 사라졌습니다.
변하지 않은 것은 한계의 형태입니다. 가져오기 도구는 설정과 대화 기록을 이동할 뿐이며, 표준 Claude 채팅 데이터는 여전히 전혀 가져올 수 없습니다. 그리고 여러분의 컨벤션 뒤에 숨겨진 논리는 가져올 파일에 존재한 적이 없습니다. 그러므로 가져오기 도구는 설정용으로만 사용하고, 가져온 내용을 다듬고, 영구적인 자료들—결정 사항, 제약 조건, 장애 사건, 클라이언트 요구 사항—은 두 도구의 내부가 아닌 별도의 저장소에 보관하십시오. 그렇게 하면 다음 릴리스 노트는 구원 투수가 아니라 단순한 편의 기능으로 다가올 것입니다.