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

먼저 Manus가 제공하는 데이터가 무엇인지 Manus의 자체 표현을 통해 살펴보겠습니다.

읽기 가능한 형태는 일반 텍스트(plaintext) 내보내기입니다. 도움말 센터에서는 이 기능의 한계에 대해 매우 직접적으로 설명하고 있습니다. "팀원은 일반 텍스트 내보내기를 통해 작업 데이터의 읽기 가능한 사본을 내보낼 수 있지만, 이는 백업과 다르며 작업 데이터를 가져오거나 복원하는 데 사용할 수 없습니다."

복원 가능한 형태는 백업 패키지입니다. 작업 데이터 백업(Task Data Backup)은 "작업, 생성된 파일(웹사이트 및 슬라이드 등) 및 구성 데이터를 포함합니다." 또한 백업은 생성된 시점에 고정됩니다. "백업은 생성된 순간의 데이터 스냅샷만 캡처하며 새 작업을 자동으로 동기화하지 않습니다." 그리고 이는 Manus 전용 아티팩트입니다. 복원 경로는 이를 다른 도구가 아닌 Manus로만 다시 되돌려 놓습니다.

따라서 솔직하게 인벤토리를 정리하면 다음과 같습니다.

깔끔하게 전송됨. 여러분이 제작한 파일(문서, 슬라이드, 사이트, 데이터 세트 등). 읽고 복사하여 붙여넣을 수 있는 모든 것. 제어 가능한 곳에 보관해 둔 직접 작성한 지침들.

다시 작성해야만 전송됨. 지식 베이스(knowledge base) 항목들. 수개월 동안 Manus에 제공한 고정된 선호도 설정. 긴 작업 스레드에서 Manus가 흡수한 프로젝트 배경 정보. 이 모든 것은 읽을 수 있는 형태로 존재하지만, 가져올 수 있는 형태로는 존재하지 않습니다.

전혀 전송되지 않음. 구조화된 상태로서의 작업 기록. 문서에 따르면 수동으로 다시 활성화해야 하는 승인된 커넥터 구성. Manus가 직접 지시받지 않고 스스로 추론한 모든 것.

Codex 측면에서는 진짜 공짜로 얻는 이점 하나와, 이를 신뢰하기 전에 알아두어야 할 점이 하나 있습니다.

공짜 이점은 AGENTS.md입니다. Codex는 작업을 수행하기 전에 이 파일을 읽으며, 이는 일반 마크다운이므로 텍스트 편집기에서 작성할 수 있는 모든 것을 Codex가 읽을 수 있습니다. 이것이 여러분이 다시 작성해야 하는 모든 것의 랜딩 패드입니다.

알아두어야 할 점: Codex에는 가져오기 도구(importer)가 있지만, Manus는 그 소스 중 하나가 아닙니다. 문서에 따르면, "데스크톱 앱은 Claude Code, Claude Cowork 또는 Cursor에서 가져올 수 있습니다. Codex CLI는 Claude Code 또는 Cursor에서 가져올 수 있습니다." Manus에서 마이그레이션하는 경우, 가져오기 도구는 건너뛸 수 있는 단계가 아닙니다. 마이그레이션은 의도적으로 수동으로 진행되도록 설계되었으므로, 서두르기보다는 계획적으로 수행하는 것이 좋습니다.

두 단계로 진행되며 순서가 중요합니다. 아직 가능할 때 Manus에서 자료를 꺼낸 다음, Codex가 실제로 지침을 조립하는 방식에 맞게 형태를 가다듬으세요.

1단계: 읽기 가능한 사본을 꺼내고, 이를 백업이 아닌 원본 자료로 취급하기

작업 데이터를 일반 텍스트로 내보내고 여전히 필요한 생성된 파일들을 다운로드하세요. 그런 다음 특정 질문을 염두에 두고 가져온 내용을 읽어보세요. '여기서 어떤 문장이 지침(instructions)이고, 어떤 문장이 아티팩트(artifacts)인가?'

아티팩트는 결과물입니다. 팀이 파일을 보관하는 곳에 보관하세요. 그것들은 컨텍스트가 아닙니다.

지침은 수십 개의 작업에 걸쳐 여러분의 프롬프트 속에 묻혀 있는 문장들입니다. 반복해서 수정했던 내용, 계속해서 재진술했던 규칙, "아니요, 우리는 항상 이런 식으로 합니다"라고 바로잡았던 부분들입니다. 이것이 바로 마이그레이션 대상입니다. 이를 추출해 주는 도구는 없으므로 직접 읽으면서 찾아내야 합니다.

두 가지 주의 사항이 있습니다. 첫째, Manus의 지식 베이스에도 항목을 보관하고 있다면, 이를 내보내기 파일 안에 들어있을 것이라 가정하지 말고 별도로 내보내어 확인하세요. knowledge base limit으로 인해 많은 팀이 시간이 지나면서 항목을 정리하여 내부에 무엇이 있는지 더 이상 기억하지 못할 수 있습니다. 둘째, 계정 삭제가 계획에 포함되어 있다면, 버튼을 누르기 전에 복원 메커니즘을 이해해야 합니다. 현재 서비스 변경 기간 동안의 복원은 no deadline but exactly one attempt이며, 일반 텍스트 내보내기는 백업 패키지를 대체할 수 없습니다. 아직 읽지 않으셨다면 backing up Manus data before deletion을 읽어보세요.

2단계: Codex가 실제로 읽는 레이어에, Codex가 읽는 순서대로 작성하기

Codex는 파일에서 지침을 조립하며, 조립 규칙이 매우 구체적이어서 잘못 배치된 파일은 아예 사용되지 않습니다.

글로벌 수준에서, "Codex 홈 디렉터리(기본값은 ~/.codex이며, CODEX_HOME을 설정하지 않은 경우)에서 Codex는 AGENTS.override.md가 존재하면 이를 읽습니다. 그렇지 않으면 AGENTS.md를 읽습니다. Codex는 이 수준에서 비어 있지 않은 첫 번째 파일만 사용합니다." 여러 파일이 있는 디렉터리가 아니라 단 하나의 파일입니다.

프로젝트 수준에서, "프로젝트 루트(일반적으로 Git 루트)에서 시작하여 Codex는 현재 작업 디렉터리까지 내려갑니다. 경로상의 각 디렉터리에서 AGENTS.override.md, AGENTS.md, 그리고 project_doc_fallback_filenames에 정의된 대체 이름 순으로 확인합니다. Codex는 디렉터리당 최대 하나의 파일만 포함합니다."

그런 다음 병합합니다: "Codex는 루트에서부터 아래로 파일을 연결하며, 빈 줄로 구분하여 결합합니다. 현재 디렉터리에 더 가까운 파일은 결합된 프롬프트에서 더 나중에 나타나므로 이전 지침을 덮어씁니다."

마이그레이션에 있어 두 가지 실질적인 결과가 따릅니다. 첫째, 일반적인 Manus 시절의 규칙은 루트에 두고 구체적인 규칙은 더 깊은 곳에 두어야 합니다. 더 깊은 곳에 있는 규칙이 우선하기 때문입니다. 둘째, 한계 용량을 주의하세요: "Codex는 빈 파일을 건너뛰고, 결합된 크기가 project_doc_max_bytes(기본값 32 KiB)로 정의된 제한에 도달하면 파일 추가를 중단합니다." 1년 동안 누적된 Manus 컨텍스트를 하나의 루트 AGENTS.md에 쏟아붓는 팀은 자신도 모르게 하위 파일들을 한도 너머로 밀어내 버릴 수 있습니다. 문서 자체의 조언은 "한도에 도달하면 제한을 늘리거나 중첩된 디렉터리에 지침을 분할하십시오"입니다.

마지막으로, Codex 자체의 메모리(memories)를 어떻게 할지 결정해야 합니다. 메모리는 존재하며 선택 사항(opt-in)입니다: "로컬 Codex 메모리는 기본적으로 꺼져 있습니다." 이를 켜면 ~/.codex/memories/ 아래에 "이전 대화의 요약, 영구 항목, 최근 입력 및 지원 증거를 포함하는" 파일들이 생성됩니다. 유용하지만, 문서에서는 이것이 무엇이 아닌지 명확히 밝히고 있습니다: "이 파일들을 생성된 상태(generated state)로 취급하십시오. 문제 해결 시 또는 Codex 홈 디렉터리를 공유하기 전에 검사할 수는 있지만, 이를 기본 제어 수단으로 삼아 수동으로 편집하는 것에 의존하지 마십시오." 그리고 필수 규칙이 있어야 할 위치를 명시하고 있습니다: "필수적인 팀 가이드는 AGENTS.md 또는 체크인된 문서에 보관하십시오. 메모리는 항상 적용되어야 하는 규칙의 유일한 소스가 아니라 유용한 회상 레이어로 취급하십시오."

In other words, Codex's memories are not the destination for your migrated Manus context. AGENTS.md is.

1단계와 2단계를 거치면 작동하는 Codex 환경이 구성됩니다. 하지만 이미 한 번 겪었던 구조적인 문제도 고스란히 남게 됩니다. 방금 다시 작성한 모든 내용이 이제 특정 도구의 파일 규칙에 따라 특정 리포지토리에 저장되며, 다음 마이그레이션 때 또다시 수동으로 재작성해야 한다는 점입니다.

이것이 바로 Manus 내보내기가 주는 진짜 교훈입니다. 이동이 고통스러운 이유는 Manus가 인색해서가 아닙니다. 문서는 꼼꼼하고 내보내기는 실제로 작동합니다. 진짜 이유는 "도구가 학습한 내용"에 이식 가능한 형태가 없었기 때문에 오직 읽을 수만 있을 뿐 이동할 수 없었기 때문입니다. 두 도구의 외부에 존재하는 메모리 레이어가 바로 이를 가능하게 해줍니다. MemoryLake는 세 단계로 설정할 수 있습니다.

1단계: API 키 생성하기

로그인하고 대시보드에서 API 키를 생성합니다. 이는 에이전트가 메모리를 읽고 쓰는 데 사용하는 자격 증명입니다. 이는 Manus나 Codex에 종속되지 않으며, 바로 이 점이 핵심입니다. 저장소는 현재 사용 중인 도구보다 더 오래 지속됩니다.

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

수동 마이그레이션의 1단계에서 추출한 자료가 여기에 들어갑니다. 프로젝트 배경, 고정된 규칙, 결정 사항과 그 배경 논리, 팀에서 사용하는 정의와 명칭 등 일반 텍스트 내보내기에서 추출한 아티팩트가 아닌 지침에 해당하는 모든 것입니다.

이 모든 내용을 루트 AGENTS.md에 붙여넣는 대신 이 작업을 수행하세요. AGENTS.md는 항상 적용되어야 하는 규칙을 위해 남겨두고, 누적되고 성장하는 컨텍스트 본문은 32 KiB 용량 제한과 경쟁하지 않는 이곳에 보관하세요.

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

Codex가 이 저장소를 가리키도록 설정하면, 다음에 어떤 도구를 사용하든 동일한 지식을 사용할 수 있습니다. 전환 기간 동안 팀의 일부가 Manus에 남아 있는 경우(흔하고 합리적인 방식임), 양쪽 모두가 한 분기 동안 서로 멀어지지 않고 동일한 레이어를 읽을 수 있습니다.

첫 번째 차이점은 둘째 주에 나타납니다. 순수하게 수동으로 마이그레이션한 경우, 둘째 주는 Codex가 이전 환경에서는 하지 않았던 행동을 하면서 미처 기록하지 못한 규칙을 발견하는 시기입니다. 외부 레이어를 사용하면, 각자가 로컬 파일을 패치하는 대신 놓쳤던 세 가지 규칙을 추가하기만 하면 모두가 이를 즉시 적용받게 됩니다.

두 번째 차이점은 크기 제한입니다. AGENTS.md 파일은 훌륭하지만 유한합니다. 항상 적용되어야 하는 지침은 그곳에 속합니다. 하지만 고객의 세부 정보, 과거의 결정, 용어집, 이상한 해결 방법이 존재하는 이유와 같은 롱테일 정보는 무한히 늘어나며, 모든 프롬프트에 병합되는 파일에 포함되기를 원치 않습니다.

세 번째는 다음 마이그레이션입니다. Codex는 팀이 사용할 마지막 도구가 아닙니다. 오늘 하는 이동이 비용이 많이 드는 이유는 컨텍스트가 아무도 이동할 수 없는 형태에 갇혀 있었기 때문입니다. 일반 텍스트 내보내기가 아닌 저장소에서 다시 마이그레이션을 수행하는 것은 거대한 프로젝트와 가벼운 오후 작업 정도의 차이를 만듭니다.

• 다른 것을 변경하기 전에 먼저 내보내기를 수행하세요. 일반 텍스트 내보내기가 첫 번째, 아티팩트가 두 번째, 삭제 결정이 마지막입니다. 내보내기는 복원할 수 없고 읽기만 가능하므로, 안전망이 아니라 작업용 사본입니다.
• 내보낸 파일에서 콘텐츠가 아닌 지침을 읽어내세요. 가치는 생성된 결과물이 아니라 여러분이 Manus를 바로잡았던 문장들에 있습니다.
• 항상 참인 규칙은 루트 AGENTS.md에, 구체적인 규칙은 중첩된 파일에 두세요. 더 깊은 곳에 있는 파일이 나중에 나타나며 이전 지침을 덮어씁니다.
• project_doc_max_bytes를 주시하세요. 32 KiB 기본값은 1년 치 컨텍스트를 붙여넣기 전까지는 넉넉해 보입니다. 의도적으로 제한을 늘리거나 디렉터리별로 분할하세요.
• Codex 메모리를 제어 수단으로 취급하지 마세요. 공급업체 자체 설명에 따르면 이는 생성된 상태(generated state)입니다. 필수 규칙은 AGENTS.md나 체크인된 문서에 있어야 합니다.
• 커넥터를 수동으로 다시 활성화하고 각각 확인하세요. Manus 문서에는 승인된 커넥터가 자동으로 복구되지 않는다고 명시되어 있으며, Codex에 연결한 모든 항목도 마찬가지입니다.
• 두 도구의 외부에 프로젝트 지식의 단일 정본(canonical copy)을 유지하세요. 두 개의 리포지토리에 있는 두 개의 파일에 동일한 단락을 붙여넣고 있다면, 그 단락은 다른 곳에 있어야 합니다. Turning project docs into AI memory에서 그 메커니즘을 다룹니다.

Manus에서 Codex로의 마이그레이션은 수동으로 진행되며, 이번 분기에는 어떤 도구로도 이를 바꿀 수 없습니다. Codex의 가져오기 도구는 Claude Code, Claude Cowork, Cursor를 읽으며, Manus의 내보내기는 설계상 가져올 수 있는 형태가 아니라 읽을 수 있는 형태입니다.

여러분이 바꿀 수 있는 것은 이 작업을 다시 반복할지 여부입니다. 파일은 전송되고, 아티팩트도 전송되며, 지침은 다시 작성하면 전송됩니다. 누적된 컨텍스트가 가장 비용이 많이 드는 부분이며, 이에 대해 반복적으로 비용을 지불하지 않는 유일한 방법은 현재 사용 중인 도구 내부에 컨텍스트를 저장하는 것을 중단하는 것입니다.