MemoryLake
모든 글로 돌아가기
News2026년 11월 16일·12 분 소요

Codex Plan Mode에서 Clear Context and Implement는 무엇을 하나요? 새로운 스레드가 플랜에서 가져오는 것, 이전 채팅에 남는 것, 그리고 11월 13일 변경 사항 (2026)

Codex plan mode에서 20분을 보냈다고 가정해 봅시다. Codex는 저장소의 절반을 읽고, 세 가지 확인 질문을 던졌으며, 당신은 결제 관련 코드를 건드릴 뻔한 접근 방식을 사용하지 않도록 설득했습니다. 이제 플랜이 준비되었고, Codex는 이를 구현할지 묻습니다. 선택지 중 하나는 'Yes, clear context and implement'입니다.

코딩 작업을 위한 깨끗한 context를 제공하므로 당연한 선택처럼 들립니다. 하지만 합리적인 의문이 생깁니다. context가 지워진다면, 새로운 스레드는 실제로 무엇을 알게 될까요? 결제 관련 결정 사항을 기억할까요, 아니면 오직 플랜만 기억할까요?

이 부분은 최근에 변경되었습니다. OpenAI의 변경 로그에 기재된 11월 13일자 Codex CLI 0.169.0 릴리스 노트에 따르면: "Yes, clear context and implement는 이제 승인된 전체 플랜을 새로운 세션에 전달하며, 핸드오프(handoff)에 실패할 경우 현재 세션을 열린 상태로 유지합니다."

이 가이드에서는 Codex plan mode가 무엇인지, 플랜이 승인되었을 때 주어지는 세 가지 선택지, 새로운 스레드가 시작할 때 갖게 되는 정보, 이전 채팅에 남는 정보, 11월 13일 릴리스의 변경 사항, 플랜이 너무 클 때 발생하는 현상, 그리고 플랜 이면의 결정 사항들이 핸드오프 후에도 유지되도록 하는 방법을 다룹니다.

Codex plan mode란 무엇인가

Plan mode는 Codex가 코드를 작성하기 전에 플랜을 제안하는 작업 방식입니다. OpenAI의 모범 사례 가이드에서는 복잡하거나 모호하거나 설명하기 어려운 작업에 이 모드를 권장합니다: "Plan mode를 통해 Codex는 구현 전에 context를 수집하고, 확인 질문을 던지며, 더 강력한 플랜을 구축할 수 있습니다."

Codex CLI에서 활성 채팅을 plan mode로 전환하려면 /plan을 입력하고, 선택적으로 첫 번째 플랜 요청을 덧붙입니다. 가이드에 따르면 /plan 또는 Shift+Tab으로 토글할 수 있습니다. Codex가 이미 작업 중인 동안에는 /plan을 일시적으로 사용할 수 없습니다.

또한 plan mode에 별도의 추론 수준을 부여할 수 있습니다. 설정 참조 문서에서는 plan_mode_reasoning_effort를 "선택한 모델이 지원하는 수준을 사용하여 plan mode 전용 추론 노력을 재정의하는 설정"으로 설명합니다. 설정되지 않은 경우 plan mode는 내장된 기본값을 사용합니다.

Plan mode는 goal mode와 다릅니다. Goal은 Codex가 작업을 수행하는 동안 채팅에 목표를 계속 부착해 두는 방식으로, Codex goal mode란 무엇인가 가이드에서 다룬 바 있습니다. Plan mode는 먼저 접근 방식에 합의하는 것에 중점을 둡니다.

Codex에서 플랜을 세우는 다른 방법들

OpenAI가 설명하는 옵션은 plan mode만이 아닙니다. 모범 사례 가이드에는 플랜이 필요한 작업을 위한 세 가지 접근 방식이 나열되어 있습니다.

첫 번째는 plan mode 그 자체입니다. 두 번째는 Codex에게 인터뷰를 요청하는 것입니다. 대략적인 아이디어는 있지만 어떻게 설명해야 할지 확신이 서지 않는다면, Codex에게 먼저 질문을 던지고, 가정을 검증하며, 코드를 쓰기 전에 아이디어를 구체화해 달라고 요청하세요.

세 번째는 파일에 저장된 플랜입니다: "더 고급 워크플로를 위해, 장기 실행 작업이나 다단계 작업을 수행할 때 Codex가 PLANS.md 또는 실행 플랜 템플릿을 따르도록 구성할 수 있습니다."

이 차이점은 이 가이드에서 중요합니다. Plan mode의 플랜은 그것을 생성한 채팅에 속하며, clear-context 옵션은 이를 하나의 새로운 스레드에 전달합니다. 반면 PLANS.md 파일은 저장소에 위치하므로 나중에 어떤 스레드에서도 다시 읽을 수 있습니다. 여러 세션에 걸쳐 진행되는 작업의 경우, 계속 업데이트하는 파일이 더 지속적인 기록이 됩니다.

플랜 승인 시 세 가지 선택지

Plan mode에서 플랜이 승인되면 Codex CLI는 'Implement this plan?'이라고 묻고 세 가지 옵션을 제공합니다. 아래의 레이블과 설명은 OpenAI가 공개적으로 게시한 Codex 소스 코드에서 가져온 것입니다.

Yes, implement this plan. Default 모드로 전환하여 코딩을 시작하는 것으로 설명됩니다. 구현이 동일한 채팅에서 계속되므로, 플랜 수립 대화가 해당 채팅의 일부로 유지됩니다.

Yes, clear context and implement. 이 플랜을 가지고 새로운 스레드(fresh thread)를 시작하는 것으로 설명됩니다. Codex가 현재 context가 얼마나 사용되었는지 알고 있는 경우 설명에 해당 수치가 표시되므로, 선택하기 전에 플랜 채팅이 얼마나 찼는지 확인할 수 있습니다.

No, stay in Plan mode. 모델과 함께 플랜 수립을 계속하는 것으로 설명됩니다.

두 가지 조건에서 중간 옵션이 비활성화될 수 있습니다. Default 모드를 사용할 수 없는 경우 두 구현 옵션 모두 작동하지 않습니다. 승인된 플랜 텍스트가 없는 경우, 승인된 플랜을 사용할 수 없다는 메모와 함께 clear-context 옵션이 비활성화됩니다.

새로운 스레드가 시작할 때 갖는 것

이 부분은 Codex가 무엇을 기억하는지에 있어 가장 중요합니다. context를 지우기로 선택하면, Codex는 플랜을 구현하는 임무를 가진 새로운 스레드를 시작하며, 플랜 수립 대화에서 전달되는 것은 오직 '플랜'뿐입니다.

11월 변경 사항의 배경이 된 풀 리퀘스트(11월 11일 openai/codex 저장소에 머지됨)에서 그 메커니즘을 설명합니다. 이 옵션은 "승인된 플랜을 앱 서버 첨부 파일로 저장하고 이를 참조하는 짧은 프롬프트를 제출"하도록 만듭니다.

따라서 새로운 스레드의 첫 번째 지침은 짧습니다. 특정 파일 경로에 있는 승인된 플랜을 읽고 구현하라는 것입니다. 전환하기 전에 Codex는 새로운 스레드의 실행기가 파일을 읽을 수 있는지, 내용이 승인된 플랜과 일치하는지 확인합니다.

새로운 스레드는 또한 다른 모든 새로운 Codex 스레드와 동일한 방식으로 시작됩니다. OpenAI 문서는 "Codex는 작업을 수행하기 전에 AGENTS.md 파일을 읽는다"고 명시하고 있으므로, 그곳에 보관된 프로젝트 지침은 구현 스레드에도 적용됩니다. 또한 동일한 문서에서 글로벌 가이드라인과 프로젝트별 재정의를 계층화하여 "어떤 저장소를 열든 일관된 기대치를 가지고 각 작업을 시작할 수 있다"고 설명합니다. 새로운 스레드의 첫 번째 요청을 캡처한 Codex 저장소의 테스트를 보면 표준 설정, 환경 context, 그리고 플랜 파일을 가리키는 프롬프트가 나타납니다. 플랜 수립 논의 자체의 내용은 포함되어 있지 않습니다.

이전 채팅에 남는 것

플랜에 포함되지 않은 모든 것은 뒤에 남겨집니다. 여기에는 다음이 포함됩니다:

  • 확인 질문과 당신의 답변. 특정 제약 조건이 존재하는 이유를 Codex에게 설명했더라도, 플랜에 명시되지 않았다면 새로운 스레드는 이를 알지 못합니다.
  • 거부된 접근 방식. 당신이 Codex를 설득하여 포기하게 만든 접근 방식은 플랜에 제외되었다고 기록되지 않는 한 새로운 스레드에 전달되지 않습니다.
  • Codex가 읽은 내용. 플랜 단계에서의 파일 내용, 검색 결과, 도구 출력 등은 이월되지 않습니다. 새로운 스레드는 필요한 내용을 다시 읽습니다.
  • 당신의 어조와 수정 사항. 공용 함수 이름을 바꾸지 말라고 요청하는 등 플랜 수립 중에 내린 사소한 지시들은 플랜이나 AGENTS.md에 반영되지 않았다면 이월되지 않습니다.

이것이 이 옵션이 취하는 트레이드오프입니다. 새로운 스레드는 긴 플랜 수립 기록이 context를 차지하지 않으므로 구현을 위한 충분한 공간을 확보합니다. 그 대가로, 플랜은 중요한 모든 내용을 담고 있어야 합니다.

플랜 수립 채팅 자체가 사라지는 것은 아닙니다. Codex는 당신을 새로운 스레드로 전환시키며, 이전 대화는 저장된 채팅으로 남습니다. CLI의 /resume 명령은 "세션 목록에서 저장된 채팅을 재개"하는 기능으로 문서화되어 있으므로, 논의된 내용을 확인해야 할 경우 다시 돌아갈 수 있습니다.

이는 /clear가 하는 일과 비슷하지만 한 가지가 추가되었습니다. OpenAI는 /clear를 "새로 시작하고 싶을 때 가시적인 UI와 채팅 context를 함께 초기화하는 방법"으로 설명합니다. 플랜 옵션은 이를 수행하면서 새로운 스레드에 플랜을 전달합니다. 우리는 각 Codex 명령이 무엇을 초기화하는지에 대한 가이드에서 /clear와 /new를 비교한 바 있습니다.

11월 13일 변경 사항

0.169.0 변경 로그 항목은 두 가지를 설명합니다. 새로운 세션이 승인된 전체 플랜을 전달받는다는 것과, 핸드오프에 실패할 경우 현재 세션이 열린 상태로 유지된다는 것입니다.

풀 리퀘스트는 그 방법을 설명합니다. Codex는 이제 플랜을 첨부 파일로 저장하며, 플랜이 성공적으로 준비된 후에만 인터페이스를 지우고 스레드를 전환합니다. OpenAI의 표현을 빌리자면, Codex는 "플랜 준비가 성공한 후에만 UI를 지우고 스레드를 전환"합니다.

이 순서가 중요합니다. 전환 전에 문제가 발생하면 플랜 수립 채팅이 그대로 유지된 채 원래 위치에 머물게 됩니다.

플랜 파일을 읽을 수 없을 때 발생하는 일

첨부 파일 방식이 일반적인 경로이지만 유일한 방법은 아닙니다. 풀 리퀘스트에 따르면: "첨부 파일을 쓰거나 읽을 수 없는 경우, 모델의 context 및 자르기(truncation) 제한 내에서 전체 플랜을 proposed_plan 도구 출력으로 주입합니다."

이 경우 새로운 스레드는 읽을 파일 대신 context에 직접 플랜 텍스트를 받게 됩니다. 그러면 첫 번째 프롬프트는 단순히 플랜을 구현하라는 내용이 됩니다.

제한 사항이 있습니다. 소스 코드는 모델의 사용 가능한 context 창을 기반으로 이 폴백(fallback) 방식이 사용할 수 있는 새로운 스레드의 context 양을 제한합니다. 전체 플랜이 들어가지 않으면, 풀 리퀘스트에 따르면 Codex는 "오류를 보고하고 현재 세션을 유지"합니다.

소스 코드의 오류 메시지는 해결 방법을 알려줍니다. 원래 스레드에서 플랜을 구현하라는 것입니다. 실제로 이는 첫 번째 옵션인 'Yes, implement this plan'을 선택하는 것과 같으며, 플랜 수립 context를 유지하고 동일한 채팅에서 계속 진행하게 됩니다.

어떤 옵션을 선택해야 할 때

Yes, implement this plan을 선택해야 할 때: 플랜 수립 대화에 제약 조건의 이유, 작업의 핵심이 되어 Codex가 이미 읽은 파일들, 또는 진행 과정에서 내린 수정 사항 등 플랜에 담기지 않은 context가 포함되어 있을 때입니다. 동일한 채팅이 이 모든 것을 유지합니다.

Yes, clear context and implement를 선택해야 할 때: 플랜 수립 채팅이 길고, 플랜이 완전하며 독립적이고, 구현에 많은 공간이 필요할 때입니다. 옵션 설명에 있는 context 수치는 플랜 채팅이 얼마나 찼는지 판단하는 데 도움이 됩니다.

No, stay in Plan mode를 선택해야 할 때: 플랜이 거의 완성되었지만 코드를 작성하기 전에 무언가를 변경하고 싶을 때입니다.

유용한 습관: clear-context 옵션을 선택하기 전에, Codex에게 플랜을 수정하여 플랜 수립 중에 내린 결정 사항(제외된 사항과 그 이유 포함)을 명시해 달라고 요청하세요. 플랜은 새로운 스레드로 가는 유일한 다리이므로, 중요한 내용을 모두 담도록 만드세요.

실행 예시

송장 생성 방식을 변경하려는 플랜을 세우고 있다고 가정해 봅시다. 플랜 수립 중에 Codex는 공유 헬퍼(helper)를 새로운 모듈로 옮기자고 제안합니다. 당신은 다른 두 서비스가 해당 헬퍼를 직접 임포트하고 있으므로 원래 위치에 두어야 한다고 지적합니다. Codex는 동의하고 접근 방식을 수정합니다. 또한 새로운 형식을 기존 송장에도 적용할지 묻고, 당신은 아니오, 새로운 송장에만 적용하라고 답합니다.

최종 플랜에는 변경할 파일과 단계가 나열됩니다. 승인하기 전에 읽어보세요. 헬퍼를 그대로 유지해야 한다는 내용과 그 이유가 적혀 있나요? 기존 송장은 범위 밖이라는 내용이 있나요?

그렇다면 새로운 스레드는 필요한 정보를 갖게 되며, context를 지우는 것이 구현에 더 많은 공간을 제공합니다. 그렇지 않다면, 새로운 스레드는 두 가지 결정 사항이 누락된 플랜으로 시작하게 됩니다. 아무런 제약 사항이 보이지 않으므로 다시 헬퍼를 옮기자고 제안할 수도 있습니다.

해결 방법은 메시지 한 통이면 충분합니다. Codex에게 플랜에 제약 조건과 결정 사항에 대한 짧은 섹션을 추가해 달라고 요청한 다음, 수정된 버전을 승인하세요. 헬퍼 규칙이 이 작업 이후에도 적용된다면 AGENTS.md에도 추가하여 향후 모든 스레드가 이를 읽을 수 있도록 하세요.

사람들이 흔히 하는 실수

새로운 스레드가 전체 논의 내용을 알고 있다고 가정함. 새로운 스레드는 플랜과 모든 새로운 스레드가 시작할 때 갖는 context만 받습니다.

거부된 아이디어가 계속 거부된 상태로 남을 것이라 기대함. 플랜에 특정 접근 방식이 제외되었다고 명시되지 않으면 새로운 스레드는 이를 알 수 없습니다.

플랜 수립 채팅이 삭제된다고 생각함. 저장된 채팅으로 남아 언제든 재개할 수 있습니다.

플랜을 읽지 않고 승인함. 플랜은 새로운 스레드가 받는 유일한 정보이므로, 해당 스레드의 입장에서 읽어보세요.

핸드오프 오류 후 계속 재시도함. 플랜이 폴백(fallback)으로 처리하기에 너무 크다면, 대신 원래 스레드에서 구현하세요.

모든 플랜에 상시 규칙을 반복함. 모든 작업에 적용되는 규칙은 새로운 스레드가 읽는 AGENTS.md에 두어야 합니다.

해결책: 플랜에 중요한 내용 담기

1단계: 플랜에 결정 사항 추가 요청하기

승인하기 전에 Codex에게 제약 조건과 제외된 사항을 포함하여 플랜 수립 논의에서 나온 결정 사항들을 추가해 달라고 요청하세요.

2단계: context 수치 확인하기

옵션 설명을 보고 새로운 스레드를 시작할 가치가 있는지 판단하세요.

3단계: 상시 규칙을 AGENTS.md로 이동하기

컨벤션이나 건드리지 말아야 할 것 등 이 작업 이후에도 적용되는 모든 사항은 모든 스레드가 읽는 지침 파일에 두어야 합니다.

4단계: 채팅 외부에도 이유를 기록하기

결정이 내려진 이유를 기록해 두어 이 플랜뿐만 아니라 나중의 스레드와 다른 도구들도 사용할 수 있게 하세요.

MemoryLake에서 설정하기

플랜은 새로운 스레드에 무엇을 할지 알려줍니다. 결제 코드가 왜 금지 구역인지, 지난번에 어떤 접근 방식이 실패했는지와 같은 그 이면의 이유는 다음 플랜, 다음 스레드, 그리고 다음 도구에도 필요한 정보입니다.

MemoryLake는 결정 사항, 제약 조건, 이전 시도의 교훈과 같은 프로젝트 context를 한곳에 유지하고 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트가 사용할 수 있게 해주는 memory 레이어입니다.

항목은 직접 자신의 언어로 작성합니다. Codex 채팅, 플랜 또는 플랜 첨부 파일, AGENTS.md 파일, 세션 기록 또는 공급업체의 저장소에서 아무것도 읽거나 쓰거나 삭제하지 않습니다. Plan mode와 clear-context 핸드오프는 OpenAI가 설명한 방식 그대로 작동합니다.

1단계: API 키 생성

로그인하고 대시보드에서 키를 생성합니다. 다른 자격 증명과 마찬가지로 저장소 외부에 보관하세요.

에이전트에서 사용할 새 키를 생성하고 복사하는 API 키 화면을 보여주는 MemoryLake 콘솔
에이전트에서 사용할 새 키를 생성하고 복사하는 API 키 화면을 보여주는 MemoryLake 콘솔

2단계: 첫 번째 memory 업로드

해결책 4단계에서 작성한 내용부터 시작하세요. 최근 플랜 이면의 결정 사항, 제외된 접근 방식, 계속 발생하는 제약 조건 등을 입력합니다. 항목당 하나의 결정을 담습니다.

첫 번째 문서가 업로드되어 각 파일이 검색 가능한 memory가 되는 과정을 보여주는 MemoryLake 워크스페이스
첫 번째 문서가 업로드되어 각 파일이 검색 가능한 memory가 되는 과정을 보여주는 MemoryLake 워크스페이스

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

Codex, Claude Code, ChatGPT 또는 사용하는 다른 어시스턴트를 연결하세요. 새로운 스레드나 다른 도구에서도 동일한 결정 사항을 활용할 수 있습니다.

memory 레이어에 연결할 수 있는 AI 클라이언트와 에이전트 프레임워크 목록을 보여주는 MemoryLake 통합 화면
memory 레이어에 연결할 수 있는 AI 클라이언트와 에이전트 프레임워크 목록을 보여주는 MemoryLake 통합 화면

실제 작업에서의 변화

첫 번째 차이점은 중요한 context를 유지하면서도 더 짧아진 플랜입니다. 상시적인 이유는 이미 기록되어 있으므로 플랜에는 무엇을 구축할지만 명시하면 됩니다.

두 번째는 번복의 감소입니다. 한 번 제외했던 접근 방식이 다음 스레드에서 다시 나타나지 않는데, 그 이유가 기록되어 있기 때문입니다.

세 번째는 도구 간의 연속성입니다. 한 어시스턴트에서 플랜을 세우고 다른 어시스턴트에서 구현할 때도 동일한 결정 사항을 사용할 수 있습니다.

Codex plan mode 모범 사례

어려운 작업에 플랜을 활용하세요. OpenAI는 복잡하거나 모호한 작업에 plan mode를 권장합니다.

승인 전에 플랜을 읽으세요. 이는 새로운 스레드가 전달받는 플랜 수립 채팅의 유일한 부분입니다.

이유를 플랜에 기록하세요. 제약 조건과 제외된 접근 방식은 명시적이어야 합니다.

중요할 때는 플랜 수립 채팅을 유지하세요. 논의 내용에 플랜에 담기지 않은 context가 있다면 동일한 채팅에서 구현하는 것을 선택하세요.

상시 규칙에는 AGENTS.md를 사용하세요. 모든 새로운 스레드는 작업을 시작하기 전에 이를 읽습니다.

장기 작업에는 파일을 선호하세요. PLANS.md 파일은 나중의 스레드를 위해 저장소에 남습니다.

핸드오프 오류와 싸우지 마세요. 플랜이 너무 크다면 원래 스레드에서 구현하세요.

0.169.0 이상으로 업데이트하세요. 더 안전한 핸드오프 기능이 해당 릴리스에 도입되었습니다.

결론

Codex plan mode에서 'Yes, clear context and implement'는 새로운 스레드를 시작하고 승인된 플랜을 전달합니다. 11월 13일 0.169.0 릴리스 이후, Codex는 플랜을 첨부 파일로 저장하고 새로운 스레드가 이를 읽을 수 있는지 확인한 후 성공 시에만 전환합니다. 파일을 사용할 수 없는 경우 플랜은 context에 직접 들어가며, 그마저도 너무 크면 Codex는 당신을 원래 세션에 유지시킵니다.

새로운 스레드가 받지 못하는 것은 플랜 수립 대화 내용(답변, 거부된 접근 방식, Codex가 읽은 파일들)입니다. 이들은 이전 채팅에 남으며 재개할 수 있습니다. context를 지우기 전에 플랜, AGENTS.md, 그리고 본인의 메모가 다음 스레드에 필요한 결정 사항들을 담고 있는지 확인하세요.

자주 묻는 질문

Codex에서 clear context and implement는 무엇을 하나요?

승인된 플랜을 구현하기 위해 새로운 스레드를 시작합니다. 새로운 스레드는 플랜 수립 대화가 아닌 플랜 자체를 전달받습니다.

새로운 스레드는 플랜 수립 논의 내용을 기억하나요?

아니요. 다른 새로운 스레드와 마찬가지로 AGENTS.md를 읽으며 시작하고 플랜을 받습니다. 확인 답변이나 거부된 아이디어는 플랜에 포함된 경우에만 이월됩니다.

플랜 수립 채팅은 삭제되나요?

아니요. 저장된 채팅으로 유지되며 /resume으로 돌아갈 수 있습니다.

Codex 0.169.0에서 무엇이 바뀌었나요?

변경 로그에 따르면 이제 승인된 전체 플랜을 새로운 세션에 전달하며, 핸드오프에 실패할 경우 현재 세션을 열린 상태로 유지합니다.

플랜이 너무 크면 어떻게 되나요?

플랜 파일을 읽을 수 없고 전체 플랜을 context로 보내기에도 너무 큰 경우, Codex는 오류를 보고하고 당신을 원래 스레드에 유지시켜 그곳에서 구현할 수 있게 합니다.

Codex에서 plan mode를 어떻게 켜나요?

OpenAI의 가이드에 따라 CLI에서 /plan을 실행하거나 Shift+Tab으로 토글합니다.

구현하기 전에 항상 context를 지워야 하나요?

항상 그런 것은 아닙니다. 플랜 수립 채팅에 플랜이 담지 못한 context가 있다면 동일한 채팅에서 구현하는 것이 해당 정보를 유지하는 방법입니다.