Claude Code는 플랜 파일을 어디에 저장할까? 압축 또는 /clear 이후 플랜의 변화와 레포지토리에 유지하는 방법 (2026)

Anthropic은 플랜 모드를 한 줄로 설명합니다. "Claude에게 변경 사항을 실제로 적용하지 않고 조사하고 제안하도록 지시하는 것"입니다. Claude는 파일을 읽고, 탐색 명령을 실행하고, 플랜을 작성하지만, 사용자가 승인하기 전까지는 소스 코드를 수정하지 않습니다.

플랜은 Claude가 승인을 요청하기 전에 디스크에 기록됩니다. Anthropic의 훅(hooks) 참조 문서에 따르면 "Claude는 도구를 호출하기 전에 플랜을 디스크의 파일에 쓴다"고 명시되어 있습니다. 훅이 해당 승인 단계를 검사할 때, Claude Code는 두 가지 필드를 전달합니다. 하나는 디스크의 플랜 파일에서 주입된 플랜의 마크다운인 plan이고, 다른 하나는 해당 파일의 경로인 planFilePath입니다.

따라서 파일이 신뢰할 수 있는 유일한 원천(source of truth)입니다. 대화에서 보는 것은 Claude가 제시한 플랜의 모습일 뿐이며, 디스크에 있는 것이 나중에 Claude Code가 다시 읽어 들이는 실제 플랜입니다.

기본 위치는 ~/.claude/plans/입니다. Anthropic의 .claude 디렉토리 가이드는 이 폴더를 "플랜 모드 중에 작성된 플랜 파일"을 보관하는 곳으로 나열합니다. 만약 CLAUDE_CONFIG_DIR을 설정하여 Claude Code의 홈 디렉토리를 이동하면 플랜 폴더도 함께 이동합니다.

파일명은 프롬프트를 따릅니다. Claude Code 릴리스 노트에 따르면 "플랜 파일은 이제 순수하게 무작위인 단어 대신 사용자의 프롬프트 이름을 따서 명명됩니다(예: fix-auth-race-snug-otter.md)". 따라서 인증 레이스 컨디션을 수정하기 위한 플랜은 해당 단어로 시작하고, Anthropic의 예시처럼 뒤에 무작위 단어가 붙는 이름을 갖게 됩니다.

모든 프로젝트의 플랜은 동일한 기본 폴더로 이동합니다. 여러 레포지토리에서 작업하는 경우, ~/.claude/plans/에는 모든 프로젝트의 플랜이 나란히 보관됩니다.

파일을 수정하기 위해 직접 찾을 필요는 없습니다.

• 터미널에서: 플랜이 준비되면 "Ctrl+G를 눌러 제안된 플랜을 기본 텍스트 에디터에서 열고 Claude가 진행하기 전에 직접 편집할 수 있습니다."
• VS Code에서: 확장은 플랜을 전체 마크다운 문서로 열어 인라인 주석을 추가할 수 있게 합니다. 이미 플랜 모드인 상태에서 /plan을 입력하면 현재 플랜을 보여주고, /plan open은 에디터에서 플랜 파일을 엽니다.
• 승인 메뉴에서: 플랜을 계속 진행하도록 선택하고 Claude에게 무엇을 변경할지 지시할 수 있습니다.

Claude Code가 다시 읽어 들이는 것은 파일이기 때문에, 파일을 편집하면 Claude가 작업하는 플랜 자체가 변경됩니다.

긴 플랜 세션은 컨텍스트 창을 가득 채우며, 압축(compaction)은 공간을 확보하기 위해 대화를 요약합니다. 플랜은 다른 요소들과 다르게 처리됩니다. 압축 후에도 살아남는 항목을 나열한 Anthropic의 표에는 "플랜 모드에서 Claude가 작성한 플랜"이 포함되어 있으며, 그 결과는 "디스크에서 재주입됨(Re-injected from disk)"으로 표시됩니다.

이는 플랜이 다른 내용과 함께 요약본으로 압축되지 않음을 의미합니다. Claude Code는 파일을 다시 읽어 컨텍스트에 다시 넣습니다. 여기서 두 가지 실질적인 포인트가 도출됩니다.

• 파일에 대한 편집 내용이 반영됩니다. 압축이 실행될 때 디스크에 있는 내용이 다시 불러와집니다.
• 플랜에 대한 논의는 동일하게 처리되지 않습니다. 특정 접근 방식을 거부한 이유나 논의한 트레이드오프는 대화의 일부이며, 대화와 함께 요약됩니다. 중요한 이유가 있다면 플랜 파일에 직접 기록하세요.

컨텍스트(/context) 명령 가이드에서 압축이 발생하기 전에 창을 채우고 있는 내용을 확인하는 방법을 확인하세요.

/clear는 새로운 대화를 시작하며, 플랜도 이를 따릅니다. 릴리스 노트에서는 이와 관련된 수정을 다음과 같이 설명합니다. "/clear 명령 전체에서 플랜 파일이 유지되던 문제를 수정하여, 이제 대화를 삭제한 후에는 새로운 플랜 파일이 사용되도록 보장합니다."

따라서 /clear 이후 Claude Code는 새 대화를 위한 새 플랜 파일을 시작합니다. 릴리스 노트에는 이전 파일을 삭제한다는 내용은 없으며, 새 대화가 이전 플랜을 가져오지 않는다는 의미입니다. 삭제 후에도 이전 플랜으로 계속 작업하고 싶다면, 먼저 파일을 열어두거나 Claude에게 경로를 지정해 이전 파일을 읽으라고 요청하세요.

승인 시 clear-context 옵션

플랜을 유지하도록 설계된 특수한 삭제 기능이 있습니다. showClearContextOnPlanAccept 설정은 승인 메뉴에 첫 번째 옵션을 추가하는데, 이는 "플랜을 승인하고, 대화 컨텍스트를 삭제하며, 플랜만으로 구현을 시작"하게 합니다. 이 기능은 기본적으로 꺼져 있습니다. Anthropic이 이 옵션을 제공하는 이유는 "플랜 과정에서 많은 컨텍스트가 사용될 수 있기 때문"입니다.

이 옵션은 긴 탐색 과정을 버리고 그 결과물만 유지하는 깔끔한 방법입니다.

포크(Fork)는 고유한 플랜 파일을 갖습니다. 릴리스 노트를 통해 "포크된 대화(/fork)가 동일한 플랜 파일을 공유하여 한 포크에서의 편집이 다른 포크를 덮어쓰던 문제"가 수정되었습니다. 이제 각 포크는 독립적으로 플랜을 세웁니다.

재개(Resume)는 플랜 모드를 복구합니다. claude --resume 세션 선택기나 /resume을 통해 세션을 재개할 때 플랜 모드가 복구되지 않던 문제를 포함하여 여러 수정 사항이 적용되었습니다. 재개된 세션이 플랜 모드를 벗어난 것처럼 보인다면 최신 버전을 사용 중인지 확인하세요.

클라우드 세션은 재시작 후에도 파일을 유지합니다. 릴리스 노트에는 컨테이너 재시작 후 원격 세션이 플랜 파일을 놓치던 문제와, 플랜이 제시되기 전에 클라우드 세션 컨테이너가 재시작되어 플랜 모드에서 작성된 플랜이 손실되던 문제에 대한 수정 사항이 포함되어 있습니다.

플랜 파일은 영구적이지 않습니다. Claude Code가 일정에 따라 삭제하는 애플리케이션 데이터 목록에는 대화 기록 및 기타 세션 파일과 함께 plans/가 포함되어 있습니다. 규칙은 다음과 같습니다. "Claude Code는 아래 경로의 파일이 cleanupPeriodDays보다 오래되면 삭제합니다." 기본값은 30일입니다.

애플리케이션 데이터를 직접 삭제할 때 잃게 되는 항목에 대한 Anthropic의 표에서 ~/.claude/plans/는 "사용자 대면 내용 없음(Nothing user-facing)" 폴더 중 하나로 분류됩니다. 즉, Claude Code는 기본 폴더의 플랜을 기록이 아닌 세션을 위한 작업 자료로 취급합니다.

플랜을 기록으로 남기고 싶다면 다른 곳에 보관해야 합니다.

plansDirectory 설정은 플랜 파일의 위치를 이동시킵니다. "Claude Code가 플랜 모드에서 작성하는 플랜 파일을 저장할 위치를 선택하세요. Claude Code는 프로젝트 루트를 기준으로 경로를 해석합니다." Anthropic의 예시 값은 ./plans입니다.

프로젝트의 .claude/settings.json에 이 설정을 추가하면 해당 프로젝트의 플랜은 레포지토리 내의 plans/ 폴더에 저장됩니다. 이 설정은 모든 설정 파일에 적용될 수 있으므로, 로컬 설정에서 본인에게만 적용되도록 설정할 수도 있습니다.

다음 두 가지 경우에는 플랜이 다시 기본 폴더로 저장됩니다.

• 프로젝트 루트 외부의 경로 (예: ../plans).
• macOS, Linux, WSL에서의 백슬래시. Anthropic은 Windows 스타일 경로 대신 docs/plans와 같이 작성할 것을 권장하며, 슬래시(/)는 Windows에서도 작동합니다.

자동 정리 목록은 ~/.claude/ 아래의 plans/ 폴더를 지칭합니다. 레포지토리 내부의 플랜 폴더는 해당 목록에 포함되지 않습니다. 또한 플랜 모드는 여전히 그곳에 쓸 수 있습니다. Anthropic의 보호된 경로 목록은 ~/.claude/plans/ 또는 사용자가 설정한 plansDirectory에 있는 "현재 세션의 자체 플랜 파일"에 대해서는 예외를 둡니다.

커밋하거나 무시하기

플랜이 레포지토리에 들어오면 공유 여부를 결정하세요. 커밋된 플랜은 리뷰어에게 변경 사항 뒤에 숨겨진 논리를 제공합니다. 무시된(ignored) 플랜은 로컬에 유지되며 정리 목록에 포함되지 않습니다. 어느 쪽이든 이제 사용자가 제어하는 파일이 됩니다. Factory가 동일한 문제를 처리하는 방식은 Factory spec 플랜을 홈 디렉토리 밖으로 이동하는 가이드를 참조하세요.

프로젝트 폴더에서 플랜 찾기. 기본적으로 플랜은 레포지토리가 아닌 ~/.claude/plans/에 있습니다.

/clear가 플랜을 유지할 것이라 기대하기. 이는 새로운 플랜 파일을 시작합니다. 이전 플랜을 먼저 열거나 저장하세요.

플랜이 영원히 지속될 것이라 가정하기. 기본 폴더의 파일은 cleanupPeriodDays(기본 30일)에 따라 정리됩니다.

plansDirectory를 상위 폴더로 설정하기. 프로젝트 루트 외부의 경로는 기본 위치로 되돌아갑니다.

플랜을 프로젝트 메모리로 취급하기. 플랜은 하나의 세션에 속합니다. 매번 적용되어야 하는 규칙은 CLAUDE.md 또는 규칙 파일에 있어야 합니다. Claude Code 규칙 가이드에서 차이점을 설명합니다.

1단계: 프로젝트의 plansDirectory 설정

프로젝트 설정에 ./plans와 같이 프로젝트 내부 경로를 가진 plansDirectory를 추가하세요. 해당 프로젝트의 새 플랜은 홈 폴더 대신 레포지토리에 저장됩니다.

2단계: 플랜 파일에 이유 기록하기

승인하기 전에 Ctrl+G 또는 /plan open으로 플랜을 열고 중요한 결정 사항이나 거부된 접근 방식을 추가하세요. 압축 후에도 다시 돌아오는 것은 바로 이 파일입니다.

3단계: 지속적인 결정 사항을 플랜 밖으로 이동하기

작업이 끝나면 확정된 컨벤션이나 제외된 접근 방식 등 작업보다 오래 지속되어야 할 결정 사항을 가져와 CLAUDE.md나 개인 노트에 기록하세요. 구현이 잘못되었다면 Claude Code의 /rewind 가이드에서 편집을 취소하는 방법을 다룹니다.

플랜 파일은 하나의 변경 사항에 대한 논리를 담고 있습니다. 그중 일부 논리는 계속해서 중요합니다. 왜 특정 라이브러리를 선택했는지, 지난번에 어떤 방식이 실패했는지 등입니다. 이러한 사실들은 기본 폴더의 플랜이 정리될 때 사라지며, 다음 세션의 플랜에는 전혀 포함되지 않습니다.

MemoryLake는 이러한 결정 사항을 사용자가 관리하는 한 곳에 보관하여 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트가 사용할 수 있게 해주는 메모리 레이어입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. 사용자의 플랜 파일, Claude Code 세션, CLAUDE.md 파일, 자동 메모리 또는 어떤 벤더의 저장소에서도 내용을 읽거나 쓰거나 삭제하지 않습니다. 플랜 모드와 plansDirectory는 Anthropic이 설명한 방식 그대로 계속 작동합니다.

1단계: API 키 생성

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

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

해결책의 3단계에서 내린 결정 사항부터 시작하세요. 선택한 사항과 제외한 접근 방식, 그리고 각각의 이유를 한 줄씩 적습니다. 한 항목당 하나의 포인트만 작성합니다.

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

Claude Code 및 사용하는 다른 어시스턴트를 연결하세요. 다음 플랜은 사용 가능한 마지막 결정 사항들을 토대로 시작됩니다.

첫 번째 차이점은 플랜을 찾을 수 있다는 것입니다. 플랜은 레포지토리에 있고, 프롬프트에 따라 이름이 지정되며, 정리 목록에 포함되지 않습니다.

두 번째는 세션 이후에도 살아남는 플랜입니다. 압축 시 파일을 다시 읽으므로, 사용자가 추가한 이유들이 함께 돌아옵니다.

세 번째는 반복되는 논쟁이 줄어든다는 점입니다. 지난달에 제외한 접근 방식이 기록되어 있으므로 다음 플랜에서 이를 다시 제안하지 않습니다. 다른 모델로 플랜을 세우고 싶다면 세션 중간에 모델을 전환하는 가이드에서 대화에 미치는 영향을 확인하세요.

기본 폴더를 숙지하세요. plansDirectory를 설정하지 않으면 플랜은 ~/.claude/plans/로 이동합니다.

plansDirectory를 프로젝트 내부에 설정하세요. 루트 외부의 경로는 기본 위치로 되돌아갑니다.

슬래시(/)를 사용하세요. macOS와 Linux에서 백슬래시(\)를 사용하면 플랜이 기본 위치로 저장됩니다.

채팅뿐만 아니라 파일도 편집하세요. 압축 후 복구되는 것은 파일 내용입니다.

/clear 전에 플랜을 저장하세요. 다음 대화는 새로운 플랜 파일을 사용합니다.

30일 정리에 유의하세요. 이는 기본 플랜 폴더에 적용됩니다.

지속적인 결정 사항은 CLAUDE.md로 옮기세요. 플랜은 하나의 세션에만 귀속됩니다.

Claude Code는 승인을 요청하기 전에 모든 플랜을 파일로 작성하며, 기본적으로 ~/.claude/plans/에 프롬프트 이름을 따서 저장합니다. 이 파일은 압축 후 디스크에서 재주입되고, /clear 후에는 새 파일이 사용되며, 각 포크는 고유한 파일을 갖고, 기본 폴더는 30일 후에 정리됩니다.

플랜을 유지하려면 plansDirectory를 프로젝트 내부 폴더로 설정하세요. 플랜을 변경하려면 파일을 편집하고, 이유를 기록하며, 세션보다 오래 지속되어야 할 결정 사항은 나중에 다시 찾을 수 있는 곳으로 옮기세요.