컨텍스트 손실 없이 Codex 설정을 새 컴퓨터로 마이그레이션하는 방법 (2026)

OpenAI의 고급 설정 페이지에서는 이를 한 줄로 요약합니다. "Codex는 로컬 상태를 CODEX_HOME(기본값: ~/.codex) 아래에 저장합니다." 해당 디렉터리에서 찾을 수 있는 항목은 다음과 같습니다:

• "config.toml (로컬 설정)"
• "auth.json (파일 기반 자격 증명 저장소를 사용하는 경우) 또는 OS 키체인/키링"
• "history.jsonl (기록 보존이 활성화된 경우)"
• "로그 및 캐시와 같은 기타 사용자별 상태"

문제 해결 페이지에는 채팅 기록이 추가로 명시되어 있습니다. 세션 트랜스크립트는 $CODEX_HOME/sessions에, 아카이브된 세션은 $CODEX_HOME/archived_sessions에 저장되며, 기본값은 각각 ~/.codex/sessions 및 ~/.codex/archived_sessions입니다.

이 폴더가 마이그레이션의 핵심입니다. 폴더 내부에 포함된 항목과 포함되지 않은 항목은 다음과 같습니다.

로컬 메모리

Codex 메모리는 기기별로 저장됩니다. OpenAI의 메모리 페이지에 따르면 "ChatGPT 웹은 ChatGPT 메모리를 사용하는 반면, 로컬 Codex 클라이언트는 별도의 로컬 메모리 저장소 및 제어 기능을 사용합니다." 데스크톱 앱의 'Enable Codex memories' 설정은 "선택한 기기"에 대해 이 기능을 켜거나 끕니다.

파일 자체는 Codex 홈 디렉터리에 있습니다. "기본 메모리 파일은 ~/.codex/memories/ 아래에 저장되며 요약, 영구 항목, 최근 입력 및 이전 채팅의 지원 증거를 포함합니다." OpenAI는 또한 이 파일들을 다루는 방법을 다음과 같이 설명합니다. "이 파일들을 생성된 상태(generated state)로 취급하세요. 문제 해결 시 또는 Codex 홈 디렉터리를 공유하기 전에 검사할 수는 있지만, 이를 직접 수동으로 편집하는 것을 주요 제어 수단으로 삼지 마십시오."

이에 따라 두 가지 실질적인 사항을 유의해야 합니다. "로컬 Codex 메모리는 기본적으로 비활성화되어 있습니다"이므로, 새 기기에서는 직접 켜기 전까지 메모리가 꺼져 있습니다. 또한 공식 문서에는 메모리 저장소를 한 컴퓨터에서 다른 컴퓨터로 이동하는 방법이 설명되어 있지 않습니다. 대신 파일을 읽는 방법이 설명되어 있습니다. Codex 로컬 메모리 활성화 가이드에서 관련 설정을 다룹니다.

개인 지침

사용자 본인의 상시 지침은 동일한 폴더의 파일에 저장됩니다. OpenAI의 개인화 페이지에 따르면 "Codex에서 이러한 개인 지침은 글로벌 AGENTS.md 파일에 저장됩니다." AGENTS.md 문서에 명시된 위치는 다음과 같습니다. "Codex 홈 디렉터리(CODEX_HOME을 설정하지 않은 경우 기본값은 ~/.codex)에서 Codex는 AGENTS.override.md 파일이 존재하면 이를 읽고, 그렇지 않으면 AGENTS.md를 읽습니다."

테스트 명령, 커밋 스타일, 계획 작성 방식 등을 글로벌 AGENTS.md에 의존해 왔다면, 새 기기로 복사하기 전까지는 해당 지침 없이 시작하게 됩니다.

설정, 규칙 및 훅

사용자의 config.toml에는 모델, 샌드박스, 승인 선택 사항, MCP 서버 및 메모리 설정이 포함되어 있습니다. 승인한 명령 규칙도 사용자 레이어에 저장됩니다. "TUI의 허용 목록에 명령을 추가하면, Codex는 향후 실행 시 프롬프트를 건너뛸 수 있도록 사용자 레이어인 ~/.codex/rules/default.rules에 기록합니다." 사용자 수준의 훅은 ~/.codex/hooks.json에 위치할 수 있습니다.

이러한 항목들은 작업에 대한 사실 정보라는 의미에서의 컨텍스트는 아니지만, 모든 세션이 실행되는 방식을 결정합니다. 이 설정들이 없는 새 기기에서는 이미 승인했던 권한을 다시 요청하거나, 설정해 둔 훅 없이 실행됩니다.

개인 스킬

개인적으로 유지하는 스킬은 Codex 폴더 외부에 저장됩니다. 스킬 문서에 명시된 사용자 위치는 $HOME/.agents/skills이며, "사용자의 개인 폴더에 체크인된 모든 스킬"로 설명됩니다. 리포지토리의 .agents/skills 폴더에 체크인된 스킬은 리포지토리와 함께 이동합니다.

로컬 채팅

로컬 채팅은 ~/.codex/sessions 아래의 세션 파일입니다. codex resume 명령은 현재 사용 중인 기기에 저장된 채팅 목록을 보여주므로, 새 컴퓨터에서는 이 목록이 비어 있는 상태로 시작됩니다.

OpenAI는 저장된 채팅에 포함되는 내용을 다음과 같이 설명합니다. "채팅은 트랜스크립트와 기록된 작업 디렉터리를 유지하는 반면, Codex는 현재 작업 트리에서 파일을 읽습니다." 세션을 이동할 때 이 기록된 작업 디렉터리가 중요합니다. 새 컴퓨터에서는 경로가 다를 수 있기 때문입니다. 명령 참조 문서에서는 이 경우를 다룹니다. codex resume에는 "현재 세션 디렉터리와 저장된 세션 디렉터리가 다를 때"를 위한 tui.resume_cwd 설정이 있습니다.

공식 문서에서는 컴퓨터 간에 세션 파일을 복사하는 것을 지원되는 마이그레이션 경로로 설명하지 않습니다. 이를 시도하려는 경우, 실험적인 방법으로 취급하고 원본 파일을 반드시 보관해 두세요.

일부 Codex 컨텍스트는 기존 컴퓨터에 전혀 저장되지 않습니다.

리포지토리. 프로젝트 AGENTS.md 파일, 프로젝트 .codex/config.toml 파일 및 리포지토리 스킬은 클론할 때마다 함께 제공됩니다. 영구적으로 유지되어야 하는 항목에 대한 OpenAI의 권장 사항은 여기에 두는 것입니다. "향후 채팅에서 사용할 수 있도록 영구적인 프로젝트 가이드를 AGENTS.md 또는 체크인된 문서에 보관하세요."

클라우드 작업. Codex Cloud는 클라우드에서 작업을 실행하며, OpenAI는 "웹, 모바일 또는 데스크톱 앱에서 변경 사항을 검토하고 계속 진행할 수 있습니다"라고 설명합니다.

고정된 채팅. 8월 17~21일 업데이트를 통해 통합 고정 스레드가 추가되었습니다. "데스크톱과 iOS 간에 고정된 채팅을 동기화 상태로 유지하세요." 고정 상태는 동기화되지만, 고정이 가리키는 로컬 채팅은 여전히 해당 채팅이 실행된 컴퓨터에 남아 있습니다. 사라진 ChatGPT 고정 채팅 가이드에서 다양한 뷰와 기기 간에 고정이 작동하는 방식을 다룹니다.

새 기기에서 확인해야 할 한 가지 사항: Codex는 신뢰할 수 있는 프로젝트에 대해서만 프로젝트 범위 설정을 로드합니다. OpenAI의 설정 기본 페이지에 따르면, 프로젝트를 신뢰할 수 없음으로 표시할 경우 "Codex는 프로젝트 로컬 설정, 훅, 규칙을 포함한 프로젝트 범위의 .codex/ 레이어를 건너뜁니다." 새 기기에서 사용하는 각 리포지토리에 대해 신뢰 여부를 확인하세요.

첫날에 모든 것을 옮길 필요는 없습니다. 원격 연결을 통해 기존 기기에 남아 있는 작업에 액세스할 수 있습니다. OpenAI 페이지에 따르면 "원격 액세스는 연결된 호스트의 프로젝트, 채팅, 파일, 자격 증명, 권한, 플러그인, Computer Use, 브라우저 설정 및 로컬 도구를 사용합니다."

따라서 기존 컴퓨터를 켜두고 연결된 상태로 유지하면, 새 컴퓨터를 설정하는 동안 휴대폰이나 다른 기기에서 기존 채팅을 열 수 있습니다. 이는 진행 중인 작업을 마무리하는 데 유용합니다. 이 방법은 데이터를 실제로 이동시키지는 않으며, 기존 기기를 초기화하거나 전원을 끄면 종료됩니다.

~/.codex 폴더 전체 복사하기. 이 폴더에는 설정뿐만 아니라 자격 증명도 포함되어 있습니다. OpenAI는 "~/.codex/auth.json을 비밀번호처럼 취급하세요. 여기에는 액세스 토큰이 포함되어 있습니다"라고 경고합니다. 새 기기에서 다시 로그인하는 것이 더 안전한 방법이며, 나머지 파일들은 하나씩 복사할 수 있습니다.

메모리가 계정과 동기화될 것이라 기대하기. Codex 메모리는 선택한 기기에 종속된 로컬 저장소입니다. 웹상의 ChatGPT 메모리는 별개의 시스템입니다.

지침이 리포지토리에 있다고 가정하기. 프로젝트 AGENTS.md 파일은 리포지토리에 있지만, 글로벌 지침 파일은 기존 컴퓨터의 Codex 홈 디렉터리에 있습니다.

메모리 파일을 직접 편집하여 가져오기. OpenAI는 이를 생성된 상태(generated state)로 부르며, 수동 편집을 주요 제어 수단으로 삼지 말라고 권장합니다.

기존 노트북을 처분할 때까지 기다리기. 로컬에 있는 모든 데이터는 기존 기기를 계속 켤 수 있을 때 수집하는 것이 가장 쉽습니다.

1단계: 기존 컴퓨터에서 데이터 수집하기

기존 기기를 초기화하거나 반납하기 전에 Codex 홈 폴더와 개인 스킬 폴더를 확인하세요.

• 글로벌 지침. ~/.codex/AGENTS.md 파일과 AGENTS.override.md 파일(존재하는 경우)을 복사합니다.
• 설정. config.toml을 복사합니다. 절대 경로 또는 로컬 모델 제공업체와 같이 기기별로 다를 수 있는 설정이 있는지 검토하세요.
• 규칙 및 훅. 사용하는 경우 ~/.codex/rules/ 및 ~/.codex/hooks.json을 복사합니다.
• 개인 스킬. ~/.agents/skills를 복사합니다.
• 여전히 필요한 채팅. 다시 읽고 싶은 대화를 내보냅니다. 계속 작업할 대화가 있다면 Codex에 현재 진행 상황에 대한 짧은 요약을 요청하세요. 데스크톱 앱은 로컬 Codex 스레드의 읽기 전용 스냅샷을 공유할 수도 있습니다. OpenAI는 "스냅샷은 원본 스레드가 변경되어도 업데이트되지 않습니다" 및 "개인 계정 링크는 링크가 있는 사람이라면 누구나 열 수 있습니다"라고 명시하고 있으므로, 스냅샷 링크는 공유된 것으로 취급하고 포함된 내용을 검토하세요.
• 메모리가 학습한 내용. 메모리 파일을 열고 요약 및 영구 항목을 읽어보세요. 향후 세션에서 기억해야 할 규칙, 선호도, 결정 사항 등의 핵심 사항을 기록해 둡니다. 이 내용들은 나중에 수동으로 다시 입력하게 됩니다.

auth.json은 그대로 둡니다. 새 기기에서 새로 로그인하게 됩니다.

2단계: 새 컴퓨터의 올바른 위치에 각 요소 배치하기

새 기기에 Codex를 설치하고 로그인합니다. 그런 다음 아래 단계를 진행하세요.

1. 글로벌 AGENTS.md를 ~/.codex/에 복원하고, 메모리에서 기록해 둔 영구적인 핵심 사항들을 추가합니다. 항상 적용되어야 하는 규칙은 메모리 대신 여기에 보관하라는 것이 OpenAI의 권장 사항입니다. "메모리는 유용한 회상 레이어로 취급하되, 항상 적용되어야 하는 규칙의 유일한 원천으로 삼지 마십시오."
2. config.toml, 규칙 및 훅을 복원하고, 변경된 경로가 있다면 수정합니다.
3. 개인 스킬을 ~/.agents/skills에 복원합니다.
4. 메모리를 사용하려면 활성화합니다. 설정 > 개인화(Personalization) 메뉴를 이용하거나 config.toml에서 memories 기능 플래그를 설정할 수 있습니다. 새 저장소는 비어 있는 상태로 시작하며, 이 컴퓨터에서 나누는 채팅을 바탕으로 새로 구축됩니다.
5. 리포지토리를 신뢰할 수 있는 프로젝트로 설정하여 프로젝트 설정, 훅 및 규칙이 로드되도록 합니다.
6. 테스트를 진행합니다. 리포지토리에서 채팅을 시작하고 Codex에 현재 따르고 있는 지침을 요약해 달라고 요청하세요. AGENTS.md 문서에서도 동일한 확인 방법을 제안합니다. 리포지토리 루트에서 Codex를 실행하고 현재 지침을 요약하도록 요청해 보세요.

이전 대화를 새 기기에서 계속 이어가야 하는 경우, 새 채팅을 시작하고 저장해 둔 요약을 붙여넣으세요. Codex 채팅 포크 가이드에서 단일 컴퓨터 내에서 세션을 복사하는 방법을 다룹니다.

수동 마이그레이션도 작동하지만, 이는 컨텍스트가 단 하나의 노트북 폴더에 종속되어 있었음을 보여줍니다. 메모리는 해당 기기에 묶여 있었고, 글로벌 AGENTS.md는 홈 디렉터리에 있었으며, 채팅은 세션 파일에 있었습니다. 다음에 컴퓨터를 바꾸거나 두 대의 기기에서 작업할 때 이 과정을 다시 반복해야 합니다.

MemoryLake는 사용자가 직접 관리하는 하나의 목록에 작업 규칙, 선호도, 결정 사항을 보관할 수 있는 메모리 레이어입니다. 이를 통해 Codex뿐만 아니라 ChatGPT, Claude Code 등 연결된 다른 어시스턴트에서도 동일한 정보를 사용할 수 있습니다.

사용자가 직접 자신의 언어로 항목을 작성합니다. Codex 홈 폴더, Codex 메모리, 세션 파일, ChatGPT 메모리 또는 기타 공급업체의 저장소에서 데이터를 읽거나, 쓰거나, 삭제하지 않습니다. 업무용 리포지토리의 경우, 리포지토리 외부에 보관하는 정보에 대해 조직의 정책을 따르십시오.

1단계: API 키 생성하기

로그인한 후 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 ChatGPT 계정과는 별개입니다.

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

수동 마이그레이션의 1단계에서 Codex 메모리로부터 기록해 둔 규칙, 선호도, 결정 사항 등의 핵심 사항부터 시작하세요. 항목당 하나의 핵심 사항을 작성하고, 날짜를 기입하고, 적용되는 리포지토리 또는 프로젝트의 라벨을 지정합니다.

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

Codex 및 사용하는 다른 어시스턴트를 연결합니다. 새 컴퓨터, 기존 컴퓨터, 그리고 로그인하는 다른 모든 기기에서 동일한 컨텍스트를 사용할 수 있습니다.

첫 번째 차이점은 기존 기기에 무엇이 있었는지 명확히 파악하게 된다는 것입니다. 설정, 규칙, 훅, 스킬, 글로벌 지침, 메모리, 채팅의 위치를 각각 알게 되었고, 이를 이전하거나 기록해 두었습니다.

두 번째는 중요한 부분들이 단 하나의 폴더에 의존하지 않는다는 점입니다. 항상 적용되어야 하는 규칙은 리포지토리 또는 글로벌 파일의 AGENTS.md에 있으며, 그렇지 않았다면 새로 구축해야 했을 컨텍스트가 문서화되어 기록됩니다.

세 번째는 다음번 이전 과정이 훨씬 단축된다는 점입니다. 몇 개의 파일만 복사하고, 로그인한 뒤, 연결하기만 하면 됩니다. Claude Code도 함께 사용하신다면, Claude Code 세션을 다른 기기로 내보내는 가이드에서 해당 측면의 동일한 이전 방법을 다룹니다.

초기화 전에 수집하기. 로컬 메모리, 세션 및 글로벌 AGENTS.md는 기존 기기에 있습니다.

다시 로그인하기. auth.json을 복사하지 마세요. OpenAI는 이를 비밀번호처럼 취급하라고 권장합니다.

메모리 파일 읽어보기. 생성된 상태를 그대로 복사하기보다, 영구적인 핵심 사항들을 AGENTS.md로 가져가세요.

메모리 다시 켜기. 새 기기에서는 기본적으로 메모리가 꺼져 있습니다.

리포지토리 신뢰하기. 신뢰할 수 없는 프로젝트는 프로젝트 설정, 훅 및 규칙을 건너뜁니다.

당분간 기존 기기의 연결 유지하기. 원격 액세스를 통해 기존 기기에 남아 있는 작업을 마무리할 수 있습니다.

지속적인 가이드는 리포지토리에 두기. 체크인된 AGENTS.md 파일과 문서는 클론할 때마다 함께 제공됩니다.

이전 후 채팅을 찾을 수 없는 경우, 누락된 Codex 채팅 기록 찾기 가이드에서 다른 저장 위치를 확인해 보세요.

Codex를 새 컴퓨터로 마이그레이션한다는 것은 ~/.codex에서 중요한 콘텐츠(글로벌 AGENTS.md, 설정, 규칙, 훅)와 ~/.agents/skills에 있는 개인 스킬을 이동하는 것을 의미합니다. 로컬 메모리는 이를 생성한 기기에 종속되므로, 파일을 읽고 영구적인 핵심 사항들을 지침에 반영하세요. 필요한 채팅은 기존 기기를 처분하기 전에 내보내거나 요약해 두는 것이 가장 좋습니다.

리포지토리, 클라우드 작업 및 고정 항목은 이미 자동으로 함께 이동합니다. 새로 로그인하고, 프로젝트를 신뢰할 수 있는 프로젝트로 설정하고, 메모리를 활성화한 뒤, Codex가 예상한 지침을 잘 따르고 있는지 테스트해 보세요.