컨텍스트 손실 없이 Perplexity Spaces(현 Projects)를 Codex로 마이그레이션하는 방법 (2026)

Perplexity가 설명하는 Project의 구성 요소("사용자의 Search 대화, Computer 작업, 파일, 맞춤 지침, 연결된 도구, 작업하면서 Perplexity가 구축하는 컨텍스트")를 바탕으로 Project를 레이어별로 하나씩 뜯어보겠습니다.

파일: 전송 가능하며, 가장 쉽게 해결할 수 있는 부분입니다. Perplexity는 개별 파일 업로드, 폴더, 연결된 파일 소스로부터의 가져오기, 그리고 Computer가 사용자를 대신해 생성하고 관리하는 파일을 영구 파일로 문서화합니다. 실제 문서인 것은 무엇이든 실제 문서로 출력됩니다. Codex 측에서 이들은 리포지토리 또는 Codex가 가리키는 디렉토리 내의 파일이 됩니다. 차이점은 Project의 파일은 워크스페이스에 첨부되는 반면, Codex는 디스크에 있는 파일을 읽는다는 점입니다.

맞춤 지침(Custom instructions): 전송 가능하지만, 크기 제한을 확인해야 합니다. Perplexity는 "Computer에게 이 Project 내에서 작업하는 방법을 지시하는" 최대 8,000자의 Project 지침과 설정에서 "프로젝트에서 실행되는 모든 쿼리에 사용되는" 컨텍스트 지침을 허용합니다. 자연스러운 대상지는 AGENTS.md이며, Codex의 자체 문서에서도 메모리가 이를 기억하도록 신뢰하기보다는 여기에 배치할 것을 권장합니다: "필수적인 팀 가이드는 AGENTS.md나 체크인된 문서에 보관하세요. 메모리는 항상 적용되어야 하는 규칙의 유일한 소스가 아니라, 유용한 리콜 레이어로 취급해야 합니다." 하지만 8,000자는 꽤 긴 분량입니다. 이 길이의 대부분은 대개 엄격한 규칙과 배경 설명이 섞여 있으므로, 항상 로드되는 파일에는 엄격한 규칙만 포함되어야 합니다.

우선순위 웹 링크 및 도메인: 대상지 없음. Project 설정에서는 "우선순위를 지정할 웹 링크 및 도메인을 추가하고 관리"할 수 있습니다. 이는 검색 도구의 검색 기본 설정이며, Codex에는 이에 상응하는 설정이 없습니다. 만약 해당 도메인들이 실제 중요한 정보(예: 이 공급업체의 문서는 신뢰할 수 있고, 저 Stack Overflow 답변은 구식이라는 등)를 담고 있다면, 메커니즘을 그대로 재현하려 하지 말고 그 이유를 노트로 작성해 두세요.

기본 모드 및 오케스트레이터 모델: 대상지 없음, 손실 없음. Project는 기본 모드(Search 대 Computer) 및 기본 Computer 오케스트레이터 모델을 설정할 수 있습니다. 이들은 Perplexity 측의 실행 설정이므로 마이그레이션할 필요가 없습니다.

Brain: 전송 불가. 이 레이어가 가장 중요하지만 마이그레이션 경로가 없는 레이어입니다. Perplexity는 Brain이 축적하는 정보(세션, 연결된 도구, 파일 및 아티팩트, 사용자의 수정 사항으로부터 학습하여 그 결과를 "사용자 세계의 탐색 가능한 위키 및 그래프인 Concepts, Entities, Workstreams"로 구성하며, 각 항목은 "출처로 다시 링크되어 확인하거나 수정할 수 있음")를 문서화하고 있습니다. 연속적인 실행은 여전히 유효한 정보를 강화하고, 변경된 정보를 업데이트하며, 오래된 정보를 표시합니다. 이는 단순히 문서가 쌓여 있는 것 이상으로, 구조화되고 출처가 연결되어 있으며 스스로 유지 관리되는 시스템입니다. 그리고 이에 대해 문서화된 인터페이스는 설정(Settings) → 메모리(Memory)에서 항목을 보고, 편집하고, 삭제하는 것뿐입니다. Perplexity 문서에는 내보내기 기능이 설명되어 있지 않습니다.

Brain을 완전히 장벽으로 취급하기 전에 두 가지 짚고 넘어갈 점이 있습니다. 첫째, 이 기능은 제한적으로 제공됩니다. 문서에 따르면 "Brain은 Computer를 사용하는 Max 및 Enterprise Max 구독자를 대상으로 Research Preview로 출시 중"이므로, 이 글을 읽는 많은 분들이 이 기능을 가지고 있지 않아 이 문제 전체를 건너뛸 수 있습니다. 둘째, 이 기능은 옵트아웃이 가능하며, 설정(Settings) → 메모리 설정(Memory settings) → Brain 아래에 자체 토글이 있고 Enterprise 관리자를 위한 조직 수준의 제어 기능도 제공됩니다. 워크스페이스에서 Brain이 꺼져 있다면, Project의 지식은 이미 파일과 지침에 불과하므로 이 마이그레이션은 2시간 만에 끝낼 수 있는 작업입니다.

Codex 메모리: 존재하지만, 아무것도 전달받지 못함. 대상지 측에서 Codex는 자체 메모리 저장소를 유지합니다. 문서에 따르면 ~/.codex/memories/ 아래의 파일에는 "이전 채팅의 요약, 영구 항목, 최근 입력값 및 지원 증거"가 포함되어 있으며, 채팅이 유휴 상태가 된 후 백그라운드에서 생성되고 config.toml에서 [features] memories = true를 통해 활성화됩니다. 세 가지 문서화된 특성이 이 마이그레이션의 방향을 결정합니다. 첫째, 이 메모리는 로컬이며 머신별로 다릅니다. 둘째, ChatGPT 웹의 메모리와 분리되어 있습니다("ChatGPT 웹은 ChatGPT 메모리를 사용하는 반면, 로컬 Codex 클라이언트는 별도의 로컬 메모리 저장소를 사용합니다"). 셋째, 생성은 최선 노력(best-effort) 방식으로 이루어집니다. 남은 속도 제한 비율이 구성된 임계값 아래로 떨어지면 메모리 패스를 건너뛸 수 있으며, "채팅이 종료된 후 메모리가 즉시 업데이트되지 않을 수 있습니다." 이 레이어에 직접 글을 써서 초기 데이터를 주입할 수 없으며, 문서에서는 수동 편집을 기본 제어 방식으로 삼지 말라고 조언합니다.

양쪽 문서 모두에 없는 결과. Perplexity Project는 설계상 협업이 가능합니다. 소유자(Owner), 편집 가능(Can edit), 보기 가능(Can view) 역할이 있으며, 제한됨(Restricted)부터 조직 전체까지의 액세스 범위가 제공되고, 비Enterprise Project에서는 최대 5명, Enterprise 소유 Project에서는 최대 9,999명의 기여자를 지원합니다. 반면 Codex 메모리는 머신별, 개인별로 관리됩니다. 5인용 Project를 한 엔지니어의 Codex 설정으로 마이그레이션하면 지식의 형식만 바뀌는 것이 아니라 소유자가 바뀝니다. 다른 모든 사람들은 액세스 권한을 잃게 되며, 아무에게도 알림이 전송되지 않습니다.

1단계: 지속 가능한 입력값 먼저 이동하기

파생된 항목을 만지기 전에 이 부분을 먼저 진행하세요. 기계적인 작업이므로 까다로운 부분을 줄일 수 있습니다.

파일을 내보냅니다. Project의 Files 아래에 있는 모든 항목과 6개월 후에도 필요할 것 같은 Computer가 생성한 아티팩트를 포함합니다. 이 파일들을 Codex가 실제로 볼 수 있는 위치에 배치하세요. 코드베이스에 속한다면 리포지토리에, 참조 자료라면 체크인된 docs/ 디렉토리에 넣습니다. Codex가 가리키지 않는 폴더에 파일이 방치되는 것은 사람들이 마이그레이션을 수행한 후 왜 아무것도 전달되지 않았는지 의아해하는 가장 흔한 원인입니다.

지침을 둘로 나눕니다. Project 지침과 설정 수준의 컨텍스트를 가져와 각 줄을 "매번 유지해야 하는 필수 사항"과 "유용한 배경 정보"로 분류합니다. 첫 번째 묶음은 필수 팀 가이드가 체크인된 문서에 있어야 한다는 Codex의 자체 가이드에 따라 AGENTS.md가 됩니다. 두 번째 묶음은 로드할 지침이 아니라 참조할 문서가 됩니다. 8,000자 전체를 AGENTS.md에 붙여넣는 유혹을 뿌리치세요. 항상 로드되는 파일이 너무 길면 작업 자체와 주의력을 다투게 되어 중요한 규칙들이 희석됩니다.

검색 기본 설정을 텍스트로 작성합니다. 우선순위 도메인 목록은 신뢰하는 소스에 대한 압축된 판단입니다. Codex는 이 목록을 직접 가져갈 수 없지만, "X의 공급업체 문서는 API에 대해 신뢰할 수 있으며, Y에 있는 내용은 버전 3 이전의 것이므로 오해의 소지가 있습니다"라는 문장은 읽을 수 있습니다. 이 문장은 설정 자체보다 훨씬 더 이식성이 높습니다.

협업 경계를 명확히 기록해 둡니다. Project를 종료하기 전에 누가 액세스 권한을 가졌고 누가 기여하고 있었는지 기록하는 짧은 노트를 작성하세요. 이제 역할이 있는 워크스페이스에서 역할이 없는 로컬 저장소로 이동하려고 하므로, 다른 누가 이에 의존하고 있었는지 파악하는 것이 팀 리소스를 자동으로 삭제하는 실수를 방지하는 길입니다.

2단계: Brain이 도출한 내용 재구성 및 소유권 결정하기

이제 내보내기 기능이 없는 부분입니다. 다행히도 Brain의 인터페이스는 필요한 읽기 작업에 딱 맞게 설계되어 있습니다. Memory를 열고 Concepts, Entities, Workstreams를 탐색하며 각 항목 뒤에 있는 출처를 클릭해 보세요. 무엇을 학습했는지 추측할 필요가 없습니다. 출처와 함께 명확히 보여줄 것입니다.

한 가지 필터를 적용하여 검토하세요: 이 도구가 사라져도 이 내용이 여전히 유효할 것인가? 프로젝트, 제약 조건, 사람들, 미해결 루프, 결정 사항을 설명하는 항목들은 유지하세요. 도구가 작업을 어떻게 수행했는지 설명하는 항목들은 사용자의 환경보다는 도구의 실행에 관한 것이므로 건너뛰세요. Perplexity 자체도 이 경계를 명확히 구분합니다. 문서에서는 "사용자의 선호도, 관심사 및 공유한 내용을 저장하는" Memory와 "프로젝트, 사람, 문서, 결정 사항 및 미해결 루프를 연결된 그래프로 구성하는" Brain을 구분합니다. 우리가 찾아내야 할 것은 바로 결정 사항과 미해결 루프입니다.

그 다음 이를 배치해야 하며, 여기서 소유권 결정이 내려집니다. 세 가지 옵션이 있으며, 가장 나쁜 것은 실수로 세 번째 옵션으로 흘러 들어가는 것입니다.

체크인된 문서에 넣기. 작성하는 데 시간이 더 걸리지만 영구적으로 보존됩니다. 팀이 계속 액세스할 수 있고, 지식을 diff로 검토할 수 있으며, Codex가 리포지토리에 있으므로 이를 읽을 수 있습니다. 이는 항상 적용되어야 하는 모든 규칙에 대해 Codex 문서가 권장하는 방식입니다.

공유 메모리 레이어에 넣기. 텍스트 문서보다 유지 관리가 빠르고, 여전히 모든 사람이 액세스할 수 있으며, 여러 도구에서 읽을 수 있습니다. 이에 대한 자세한 내용은 아래를 참조하세요.

Codex 자체 메모리에 축적되도록 두기. 이는 기본적으로 발생하며 보조 수단으로는 괜찮습니다. 하지만 여러분이 선택한 것이 무엇인지 이해해야 합니다. 이는 단일 머신에 국한되고, ChatGPT 웹 메모리와 분리되어 있으며, 최선 노력 일정에 따라 생성되고, 수동 편집을 염두에 두지 않은 저장소입니다. 팀의 축적된 지식을 담는 유일한 공간으로 사용하기에는 백업도 공유도 없는 단일 장애점(single point of failure)이 됩니다. Codex 문서는 이것이 잘못된 사용 방식임을 이례적으로 직접 지적하고 있으며, 오랫동안 다루지 않은 작업에서 Codex가 프로젝트 컨텍스트를 잊어버리는 현상으로 그 공백이 빠르게 드러납니다.

아무것도 하지 않는 것이 네 번째 옵션이며, 이것이 진짜 위험 요소입니다. Brain은 오래된 항목을 표시하고 최신 상태를 유지하지만, 반쯤 기억된 결론들이 담긴 폴더는 그렇지 못합니다. 불완전한 마이그레이션은 지식이 캡처된 것처럼 보이지만 실제로는 그렇지 않은 상태를 초래합니다.

구체적인 내용에서 한 걸음 물러서서 보면 패턴이 명확해집니다. 두 개의 훌륭한 도구, 두 개의 유능한 메모리 시스템이 있지만 상호 운용성은 전혀 없습니다. 그리고 질문의 대상이 되는 지식은 사실 두 도구 중 어느 쪽과도 직접적인 관련이 없었습니다. 그것은 바로 여러분의 프로젝트에 관한 것이었습니다. 도구가 바뀔 때마다 지식을 발견하는 데 우연히 도움을 준 도구 내부에 저장되어 있었기 때문에, 매번 지식을 수동으로 다시 도출해야 했습니다.

MemoryLake는 두 도구의 외부에 존재하는 메모리 레이어입니다. 프로젝트의 지속 가능한 지식을 위한 단일 공간으로, 현재 사용 중인 어떤 어시스턴트든 읽을 수 있습니다. Perplexity에서 조사하고 Codex에서 빌드하며, 각자 내보낼 수 없는 비공개 사본을 유지하는 대신 두 도구 모두 동일한 메모리를 읽습니다. 설정은 세 단계로 진행됩니다.

1단계: API 키 생성

MemoryLake에 로그인하고 API 키를 생성합니다. 연결하는 모든 도구에 대해 단 하나의 자격 증명만 있으면 되므로, 다음 마이그레이션에서도 지식을 보존할 수 있습니다.

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

위의 2단계에서 추출한 내용(결정 사항, 제약 조건, 미해결 루프, 그 뒤에 숨겨진 이유)과 프로젝트를 설명하는 참조 파일을 업로드합니다. 검색 시 텍스트 장벽 대신 유용한 결과를 반환할 수 있도록 각 항목은 하나의 아이디어만 담아 짧고 사실적으로 유지하세요. 특정 방식을 거부한 이유에 대한 항목은 선택한 방식에 대한 항목보다 두 배의 가치가 있습니다. 거부된 이유가 없다면 새로운 어시스턴트가 매번 동일한 방식을 다시 제안할 것이기 때문입니다.

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

도구를 연결합니다. MemoryLake는 MCP 및 API를 통해 액세스할 수 있으므로, Codex, Claude Code, OpenClaw를 포함한 MCP 네이티브 에이전트들은 MCP 서버를 가리켜 연결하고, 다른 도구들은 API를 통해 동일한 메모리를 읽습니다. Codex는 로컬 메모리가 잘하는 일(이 머신에서의 최근 작업 회상)을 계속 수행하도록 두고, 지속 가능한 지식은 팀원들과 다른 도구들도 접근할 수 있는 곳에 보관됩니다.

솔직한 한계: MemoryLake는 Brain을 가져오지 못합니다. Brain은 문서화된 내보내기 기능이 없기 때문입니다. 결론을 직접 수동으로 한 번 재진술해야 하며, 이것이 실제 치러야 하는 비용입니다. 또한 MemoryLake는 리서치 도구가 아닙니다. Perplexity의 역할을 대체하지는 않으며, Perplexity가 찾는 데 도움을 준 후 여러분이 내린 결론을 보관하는 역할을 합니다.

마이그레이션이 더 이상 재도출 작업이 되지 않습니다. 이 이동에서 비용이 많이 드는 부분은 파일이나 지침이 아닙니다. 그것들은 한 시간이면 충분합니다. 진짜 비용은 메모리 그래프를 읽고 그 결론을 다시 타이핑하는 것입니다. 이를 도구 독립적인 레이어에 기록해 두면 다음 이동 역시 한 시간밖에 걸리지 않습니다.

팀 지식이 팀 지식으로 유지됩니다. 이것이 조용한 승리입니다. Project는 Enterprise에서 최대 9,999명의 기여자를 지원하지만, Codex 메모리는 단 하나의 머신만 지원합니다. 대신 공유 레이어에 지식을 보관하면 Project를 가치 있게 만들었던 협업 특성을 그대로 유지할 수 있습니다.

리서치와 빌드가 서로 다른 메모리로 분리되지 않습니다. 대부분의 사람들이 실제로 겪는 패턴은 한 도구에서 리서치를 하고 다른 도구에서 구현을 하며, 동일한 컨텍스트를 두 번 설명하는 것입니다. 양쪽 모두 읽을 수 있는 단일 레이어가 있으면 두 번째 설명이 필요 없어집니다. 이 문제는 AI에게 컨텍스트를 반복해서 설명하지 않는 방법에서도 다루고 있습니다.

공급업체의 변경이 더 이상 큰 사건이 되지 않습니다. Spaces가 Projects가 되었습니다. Brain이 Research Preview로 출시되었습니다. Codex 메모리는 구성 가능하며 활성화하지 않으면 꺼져 있습니다. 지식이 도구 외부에 존재한다면 이 모든 변화는 그저 문서 업데이트에 불과하지만, 그렇지 않다면 대대적인 수습 작업이 됩니다.

요금제를 취소하기 전에 Brain을 먼저 읽으세요. 요금제 이용 권한이 종료되면 그래프에 대한 액세스도 종료됩니다. 권한이 있을 때 읽기 작업을 수행하고, 동일한 과정에서 Project의 파일도 확인하세요. Space 내부에서 누락된 것처럼 느껴졌던 콘텐츠는 대개 여전히 존재하며 검색되지 않았을 뿐입니다.

출처 링크를 활용하세요. 모든 Brain 항목은 그 뒤에 있는 세션, 파일 또는 소스로 연결됩니다. 항목이 중요해 보이지만 모호할 때는 링크를 클릭해 보세요. 대개 소스에 보존할 가치가 있는 구체적인 버전이 포함되어 있습니다.

필수 규칙은 체크인된 파일에 보관하세요. Codex 문서에서도 직접 언급하고 있으며, 어떤 메모리 레이어를 채택하든 동일하게 적용됩니다. 항상 적용되어야 하는 규칙은 리콜 레이어가 아니라 AGENTS.md나 문서에 있어야 합니다.

Codex 메모리가 즉시 나타날 것이라 기대하지 마세요. 생성은 채팅이 유휴 상태가 된 후 백그라운드에서 이루어지며, 속도 제한 압박이 있을 때 건너뛸 수 있습니다. 또한 문서에서는 메모리가 "채팅이 종료된 후 즉시 업데이트되지 않을 수 있음"을 명시하고 있습니다. 세션 직후에 보이지 않는 것은 버그가 아니라 정상적인 현상입니다.

의존하기 전에 머신 경계를 확인하세요. Codex 메모리는 로컬 및 머신별로 관리되며, IDE 익스텐션은 연결된 호스트의 저장소를 사용합니다. 두 대의 컴퓨터에서 작업하는 경우, 두 개의 별도 메모리가 존재한다고 가정해야 합니다.

협업자들에게 알리세요. Project에 기여자가 있었다면, 마이그레이션으로 인해 그들이 사용하던 지식 베이스에 대한 액세스 권한이 제거됩니다. 이는 혼자 결정할 부작용이 아니라 명확히 공유해야 할 결정 사항입니다.

이전 버전의 마이그레이션은 "Spaces 콘텐츠를 내보내서 어딘가에 붙여넣는 것"이었습니다. 하지만 이제는 양쪽 끝에서 서로 공유하지 않는 파생 메모리를 유지하기 때문에 그것만으로는 충분하지 않습니다. 파일과 지침은 한 시간이면 이동할 수 있습니다. Brain의 결론은 사용자가 직접 읽고 다시 타이핑하는 속도로 이동해야 하며, Codex의 메모리는 초기 데이터를 주입할 수조차 없습니다.

그러니 읽기 작업은 한 번만 수행하고, 그 결과물은 두 도구 중 어느 쪽 내부도 아닌 곳에 두세요. 규칙이 항상 유지되어야 하는지 여부에 따라 분류하여 체크인된 문서나 공유 메모리 레이어, 혹은 이상적으로는 둘 다에 보관하세요. 그렇게 하면 다음 이름 변경, 다음 Research Preview, 다음 도구 출시는 일정을 잡아야 하는 프로젝트가 아니라 그저 읽고 지나가는 뉴스가 될 것입니다. 목적지가 다른 에이전트라면 Perplexity Spaces를 Claude Code로 마이그레이션하기에서 해당 경로를 다루고 있으며, ChatGPT 메모리를 Codex로 마이그레이션하기에서는 동일한 목적지를 향한 또 다른 흔한 소스를 다룹니다.