컨텍스트 손실 없이 Claude Cowork에서 Codex로 마이그레이션하는 방법 (2026)

지침(Instructions) — 파일 형태였던 경우에만. Codex의 가져오기 도구는 탐색할 위치를 명확히 규정합니다. "가져오기 흐름은 사용자 수준 설정과 기존 프로젝트를 모두 확인합니다. 사용자 수준 설정은 로컬 컴퓨터의 파일에서 가져옵니다. 프로젝트 수준 설정은 선택한 리포지토리 및 폴더의 파일에서 가져옵니다." Cowork의 폴더 지침(folder instructions)은 로컬 폴더에 첨부된 파일이므로, 가져오기 도구가 찾을 수 있는 형태를 띠고 있습니다. 반면 Cowork의 글로벌 지침(global instructions)은 그렇지 않습니다. 이는 설정(Settings) > Cowork에서 텍스트 상자에 직접 입력한 텍스트로 존재하며, "모든 Cowork 세션에 적용되는 상시 지침"으로 설명되어 있습니다. 이는 제품 설정일 뿐이므로, 파일을 스캔하는 가져오기 도구는 이를 감지할 수 없습니다.

스킬 및 플러그인 — 재패키징 단계 필요. Cowork 플러그인은 각각 "스킬, 커넥터, 서브 에이전트를 단일 패키지로 묶은 것"입니다. Codex의 가져오기 테이블에는 스킬(Skills), 플러그인(Plugins), 서브 에이전트(Subagents)에 대한 별도의 행이 있으므로, 패키지가 개별 구성 요소로 나뉘어 전송됩니다. 손실되는 것은 없으며, 단지 패키징 형태만 해제될 뿐입니다.

프로젝트 폴더 — 프로젝트로 전송. 테이블은 "기존 프로젝트 폴더"를 "동일한 폴더를 사용하는 프로젝트"로 매핑합니다. Cowork 프로젝트는 이미 로컬에 존재합니다. 공식 문서에 따르면 Cowork 프로젝트는 "데스크톱에 로컬로 저장"되며, 제한 사항으로 "프로젝트는 데스크톱 전용이며 로컬에 저장됩니다. 현재 프로젝트 데이터에 대한 클라우드 동기화는 지원되지 않습니다"라고 명시되어 있습니다. 로컬에 파일 형태로 존재하는 것은 가져오기 도구가 가장 선호하는 방식입니다.

30일간의 대화 내역. 테이블에는 "최근 30일간의 채팅(Chats from the last 30 days)" 행이 있습니다. 이를 메모리가 아닌 참조용 아카이브로 취급하세요. 가져온 채팅은 다시 읽을 수 있는 대화록일 뿐이며, 에이전트가 적용할 수 있는 사실 정보(fact)가 아닙니다.

추가 방식으로 작동합니다. "가져오기를 수행해도 기존 에이전트 설정이 변경되거나 삭제되지 않습니다." 가져오기를 완료한 후에도 Cowork를 기존 상태 그대로 유지할 수 있으며, 이것이 가장 권장되는 방식입니다.

전송되지 않는 항목: Claude가 기억하는 내용. Cowork의 가장 가치 있는 컨텍스트는 사실 Cowork 자체의 기능이 아니라, 채팅과 공유되는 Claude의 계정 수준 메모리입니다. Anthropic의 문서에 따르면 "Cowork가 클라우드에서 실행될 때 Chat과 Claude Cowork 간에 메모리가 공유되며, 컴퓨터에서 로컬로 실행되는 Cowork 세션은 메모리를 사용하지 않습니다." 따라서 Cowork가 마치 사용자를 잘 알고 있는 것처럼 느끼게 해 주었던 기능(예: "Cowork에 관리자 보고서 초안 작성을 요청하면, 관리자가 누구인지와 보고서가 어떤 스타일로 작성되어야 하는지 이미 알고 있는 것")은 Claude 계정에 종속된 저장소이며, 디스크에 파일로 존재하지 않고, Codex의 가져오기 테이블에도 포함되어 있지 않습니다.

전송되지 않는 또 다른 항목: 경계로서의 프로젝트 범위 메모리. Cowork 프로젝트는 각각 자체 메모리를 보유하며, 이 격리성은 문서화되어 있습니다. "메모리는 프로젝트 범위로 제한되므로, Claude가 한 프로젝트에서 학습한 내용은 다른 프로젝트로 이전되지 않습니다." Codex의 로컬 저장소는 이와 다른 형태를 가집니다. 지식은 이동할 수 있지만, 프로젝트 간의 장벽은 사용자가 어떤 내용을 어디에 작성할지 결정하는 문제로 전환됩니다.

1단계: Claude 사용을 중단하기 전에 메모리 읽어오기

내보내기 파일은 제공되지 않지만, 내보내는 방법은 존재하며 Anthropic 문서에 그 형태가 설명되어 있습니다.

설정(Settings) > 메모리(Memory)를 엽니다. Claude가 저장한 모든 내용은 주제(Topics) 아래에 나열되며, 각 주제를 열거나 편집하거나 삭제할 수 있습니다. 목록을 읽어보세요. Anthropic은 또한 이를 한 번에 가져오는 방법으로 Claude에게 "내 메모리에 기록된 내용을 있는 그대로 토씨 하나 틀리지 않고 작성해 줘(Write out your memories of me verbatim, exactly as they appear in your memory)"라고 요청하는 방법을 안내하며, 그 결과를 "백업용으로 저장하거나 컴퓨터의 로컬 파일에 복사하여 붙여넣음으로써 다른 AI 서비스로 가져갈 수 있다"고 설명합니다.

이 작업을 수행하는 동안 알아두어야 할 두 가지 사실이 있습니다. Claude의 메모리 가져오기 기능은 "실험적이며 아직 활발히 개발 중"으로 설명되어 있으므로, 양방향 자유로운 이동을 기대하지는 마세요. 또한 메모리 초기화(Reset memory)는 "프로젝트 메모리를 포함한 모든 메모리를 영구적으로 삭제하며, 이는 되돌릴 수 없습니다." 따라서 초기화를 정리 단계로 사용하지 말고 먼저 내용을 읽어두어야 합니다.

읽으면서 발견한 내용을 다음 세 가지 범주로 분류하세요.

• 이미 폴더 지침이나 리포지토리 파일에 포함된 내용: 건너뜁니다. 가져오기 도구가 파일을 처리합니다.
• 프로젝트 폴더에서 유추할 수 있는 내용: 이 역시 건너뜁니다. Codex가 폴더를 읽습니다.
• 둘 다 해당되지 않는 내용: 이것이 바로 핵심 데이터입니다. 여러분이 제공한 수정 사항, 이유가 첨부된 결정 사항, 담당자 정보, 변경된 마감일, 폴더 외부에 있는 리소스의 위치 등입니다. 더 진행하기 전에 이 내용을 다른 곳에 복사해 두세요.

설계상 이 목록에서 찾을 수 없는 항목이 하나 있습니다. Anthropic은 "정부 발급 ID 번호, 범죄 이력, 금융 계좌 번호, 이민 신분"을 포함하여 "일부 정보는 요청하더라도 메모리에 절대 저장되지 않는다"고 명시하고 있습니다. 이 범주에 속하는 항목은 마이그레이션할 필요가 없습니다.

2단계: 텍스트 데이터 반영 후, 가져오기 도구가 알 수 없는 두 가지 문제 해결하기

ChatGPT 데스크톱 앱에서 가져오기를 실행합니다. 설정(Settings) > 가져오기(Import)로 이동한 다음 가져오기(Import)를 클릭하고 Claude Cowork를 선택한 후 가져올 항목을 선택합니다. 가져오기 옵션이 아직 보이지 않는 경우, 문서에서는 일반(General) 및 "다른 에이전트 설정 가져오기(Import other agent setup)"를 참조하라고 안내합니다. 또한 "가져온 작업을 원본 에이전트와 동기화 상태로 유지"하는 자동 업데이트 옵션도 제공되므로, 당분간 두 도구를 함께 사용할 계획이라면 유용합니다.

그다음, 가져오기 도구가 대신해 줄 수 없는 두 가지 작업을 수동으로 수행합니다.

글로벌 지침 재입력. 글로벌 지침은 파일이 아니라 설정 필드였습니다. 새 위치는 Codex가 모든 리포지토리에서 읽는 ~/.codex/AGENTS.md입니다. 파일을 생성하기 전에 이 수준에서 Codex의 탐색 규칙을 알아두는 것이 좋습니다. Codex는 AGENTS.override.md가 있으면 이를 먼저 읽고, 없으면 AGENTS.md를 읽으며, "Codex는 이 수준에서 비어 있지 않은 첫 번째 파일만 사용합니다." 즉, 하나의 글로벌 파일만 적용되고 두 번째 파일은 비활성 상태가 됩니다.

폴더 지침 범위 재조정. Codex는 프로젝트 루트에서 작업 디렉토리까지 내려가며 각 디렉토리에서 AGENTS.override.md, AGENTS.md, 그리고 구성된 대체 이름을 확인하여 지침 체인을 빌드합니다. 이때 "Codex는 디렉토리당 최대 하나의 파일만 포함합니다." 파일은 루트부터 순서대로 병합되므로, 작업 디렉토리에 가장 가까운 파일이 이전 지침을 덮어씁니다. 이는 Cowork의 폴더별 텍스트보다 더 체계적인 구조이며 활용할 가치가 있지만, 한계가 있습니다. Codex는 "결합된 크기가 project_doc_max_bytes(기본값 32 KiB)로 정의된 제한에 도달하면 파일 추가를 중단합니다." 줄글 형태의 긴 Cowork 지침은 이 바이트 제한에 걸리기 쉬우므로, 지금이 내용을 정리할 적기입니다.

편집 시 동작상의 차이점 한 가지: Cowork의 폴더 지침은 일부 Claude에 의해 작성되기도 했습니다("Claude는 세션 중에 이를 스스로 업데이트할 수도 있습니다"). 반면 Codex의 AGENTS.md는 온전히 사용자의 몫입니다. 어떤 것도 자동으로 내용을 추가하거나 최신 상태로 유지해 주지 않습니다.

그다음, 가져온 스킬 및 에이전트의 도구 제한, 사용자 정의 인증 또는 전송 방식을 사용하는 MCP 서버, 동작이 다를 수 있는 훅(hooks), 후속 조치가 필요한 플러그인, 인수나 파일 경로 플레이스홀더에 의존하는 프롬프트 등 Codex의 체크리스트를 사용하여 전송된 내용을 검토하세요.

이것으로 텍스트 데이터 처리는 끝났습니다. 하지만 1단계에서 모아둔 핵심 데이터는 아직 갈 곳이 없습니다.

Codex에는 로컬 메모리 저장소가 있습니다. 기본적으로 비활성화되어 있으며 ~/.codex/memories/ 아래에 위치합니다. 공식 문서에서는 이 저장소의 용도에 대해 다음과 같이 주의를 줍니다. "메모리를 유용한 보조 기억 레이어로 취급하되, 항상 적용되어야 하는 규칙의 유일한 소스로 취급하지는 마십시오." 또한 이 파일들을 직접 제어 도구로 사용하지 말라고 경고합니다. "이 파일들을 생성된 상태(generated state)로 취급하십시오... 수동 편집을 주요 제어 방식으로 의존하지 마십시오."

이는 합리적인 설계이지만, 방금 구출해 낸 데이터를 보관하기에는 적절하지 않은 목적지입니다. 생성된 상태의 파일에는 내용을 직접 붙여넣을 수 없으며, 결국 특정 계정에 종속된 저장소를 특정 기기에 종속된 저장소로 바꾸는 것에 불과하기 때문입니다.

MemoryLake는 특정 도구에 종속되지 않는 독립적인 메모리 레이어입니다. 따라서 Claude가 작업에 대해 학습한 내용을 지금 바로 Codex에서 읽을 수 있을 뿐만 아니라, 향후 어떤 도구를 사용하더라도 그대로 활용할 수 있습니다. 설정은 세 단계로 진행됩니다.

1단계: API 키 생성

로그인하고 API 키를 생성합니다. 연결할 여러 도구에서 이 하나의 인증 정보를 공유하여 사용합니다.

2단계: 첫 번째 메모리 업로드

각 항목은 하나의 사실만 담은 짧은 문장으로 작성합니다. 소스는 1단계에서 분류한 세 번째 데이터 더미이며, Claude가 기억하는 내용에 대한 자체 설명이 좋은 분류 기준이 됩니다. "역할, 프로젝트 및 전문적 컨텍스트", "업무 및 생활 속의 인물과 장소", "소통 선호도 및 업무 스타일", "기술적 선호도 및 코딩 스타일", "프로젝트 세부 정보 및 진행 중인 작업" 등이 이에 해당합니다.

인물 및 선호도. 관리자가 누구인지, 보고서가 어떤 스타일로 작성되기를 원하는지 등입니다. 이 범주는 Cowork가 사용자를 잘 알고 있다고 느끼게 만든 핵심 요소이지만, 어디에도 파일로 존재하지 않는 영역입니다.

결정과 그 이유. 지침은 AGENTS.md에 속하지만, 그 이유는 여기에 속합니다. 이유를 기록해 두어야 다음 분기에 규칙이 임의로 되돌려지는 것을 방지할 수 있습니다.

적용된 수정 사항. Claude에게 무엇을 중단하라고 지시했는지, 그리고 그 이유는 무엇인지 기록합니다. 일반적인 지침 형식에는 이를 기록할 필드가 없습니다.

폴더에 없는 작업 컨텍스트. 마감일, 현재 우선순위, 대시보드, 트래커 정보 등입니다.

3단계: AI 및 에이전트 연결

사용 중인 도구를 연결합니다. MemoryLake는 MCP 및 API를 통해 액세스할 수 있으며, Codex는 MCP 서버를 지원합니다. Claude Code, Cline, Cursor, OpenClaw도 동일한 방식으로 연결되며, 다른 도구들도 API를 통해 동일한 메모리를 읽을 수 있습니다. 즉, 이미 알고 있는 지식을 두 군데에 중복으로 유지 관리할 필요 없이, Claude가 더 잘하는 작업에는 Claude를 계속 활용할 수 있습니다.

세 가지 명확한 한계가 있습니다. MemoryLake는 Claude의 메모리를 읽거나 내보내거나 삭제할 수 없습니다. 해당 저장소용 API가 없기 때문에 1단계에서 수동으로 읽어와야 하는 것입니다. 또한 MemoryLake가 사용자의 AGENTS.md를 직접 작성하지 않으며, Codex의 탐색 순서나 32 KiB 제한을 변경하지도 않습니다. 마지막으로 메모리는 컨텍스트일 뿐 강제력을 갖는 규칙이 아닙니다. Codex의 자체 문서에서도 동일한 점을 지적합니다. 필수 지침은 AGENTS.md나 버전 관리되는 문서에 포함되어야 하며, 매번 반드시 준수해야 하는 사항은 실행을 실패하게 만드는 검사(check) 단계에 포함되어야 합니다.

설정 형태의 데이터가 유실되지 않습니다. 글로벌 지침은 파일로 존재한 적이 없기 때문에 어떤 가져오기 도구도 찾을 수 없었을 것입니다. 이제 이를 수동으로 재입력해야 함을 알게 되었습니다.

지침 범위가 더 명확해집니다. Cowork는 폴더별 텍스트를 제공한 반면, Codex는 디렉토리별 오버라이드 기능과 크기 제한이 있는 체계적인 체인을 제공하므로 우선순위를 강제로 고려하게 만듭니다.

프로젝트 메모리가 기본 설정이 아닌 선택 사항이 됩니다. Cowork는 프로젝트를 자동으로 격리했습니다. 하지만 이를 벗어나면, 적절한 위치에 항목을 작성함으로써 격리 여부를 직접 결정할 수 있습니다.

다음 마이그레이션 비용이 줄어듭니다. 지식이 특정 벤더의 계정 저장소나 기기의 홈 디렉토리에 갇히지 않기 때문입니다.

Claude 사용을 중단하기 전에 주제(Topics) 목록을 읽어두세요. 이는 학습된 데이터의 유일한 인벤토리이며, 초기화하면 되돌릴 수 없습니다.

CLI가 아닌 데스크톱 앱에서 가져오기를 실행하세요. Cowork는 ChatGPT 데스크톱 앱의 소스로만 나열되어 있으며, CLI는 Claude Code와 Cursor만 지원합니다.

글로벌 지침을 가장 먼저 재입력하세요. 이는 가져오기 도구가 구조적으로 감지할 수 없는 가장 가치 있는 정보입니다.

글로벌 AGENTS.md 파일은 두 개가 아닌 하나만 유지하세요. Codex는 해당 수준에서 비어 있지 않은 첫 번째 파일만 사용하므로, 두 번째 파일은 겉보기에는 활성화되어 있는 것처럼 보여도 실제로는 무용지물입니다.

32 KiB 결합 제한을 주의하세요. Codex는 이 제한에 도달하면 지침 파일 추가를 중단합니다. 긴 줄글은 가장 먼저 정리해야 할 대상입니다.

자동 업데이트를 기대하지 마세요. Cowork는 때때로 자체 폴더 지침을 직접 작성하기도 했습니다. 하지만 AGENTS.md는 스스로 유지 관리되지 않습니다.

2주 동안 두 도구를 병행하여 실행해 보세요. 가져오기는 기존 설정을 유지하는 추가 방식이며 Claude에 영향을 주지 않으므로, 성급하게 이전 도구를 정리할 필요가 없습니다. 또한 why agent skills aren't memory에서 설명하듯이 스킬은 학습된 메모리를 대체할 수 없습니다.

이번 마이그레이션은 다른 도구들에 비해 비교적 수월한 편입니다. Cowork는 "터미널이 필요 없는, Claude Code를 구동하는 것과 동일한 에이전트 아키텍처를 사용"하며, Codex는 이를 가져오기 소스로 지정하고 있습니다. 또한 구조적 요소들이 문서화된 테이블의 각 행에 잘 매핑됩니다. 지침 파일은 AGENTS.md로, 스킬은 스킬로, 프로젝트 폴더는 프로젝트로, 30일간의 채팅은 채팅으로 매핑됩니다.

차이점은 좁고 구체적입니다. Cowork의 글로벌 지침은 파일이 아닌 설정 필드이므로 자동으로 찾아주지 않습니다. 그리고 Cowork를 마치 동료처럼 느끼게 해 주었던 메모리는 Claude의 계정 수준 저장소입니다. 이는 채팅과 공유되고 Cowork가 클라우드에서 실행될 때만 활성화되며, 디스크에 파일이 없고 가져오기 테이블에도 Claude Code를 지정한 행 외에는 존재하지 않습니다. Anthropic은 이 내용을 읽을 수 있는 방법은 제공하지만, 다른 곳으로 직접 넘겨주는 방법은 제공하지 않습니다.

따라서 기회가 있을 때 주제(Topics) 목록을 읽어두고, 글로벌 지침을 재입력하고, 32 KiB 제한을 준수하는 체인으로 폴더 지침의 범위를 재조정하고, 수정 사항과 결정 사항을 두 도구 모두에 종속되지 않는 곳에 보관하세요. 가져오기 도구가 반나절 만에 나머지를 처리해 줄 것입니다. 만약 결과가 기대보다 미흡하게 느껴진다면, why Codex forgets your project context에서 관련 증상을 확인하고 how to audit what your AI assistants actually remember에서 확인 방법을 알아보세요.