본문으로 건너뛰기

© 2026 Molayo

Qiita헤드라인2026. 06. 16. 11:32

Claude Code Cowork 모드의 제약 극복하기: 작업 상황 md화를 통한 컨텍스트 영속화 테크닉

요약

Claude Code Cowork 모드의 세션 종료 시 컨텍스트가 휘발되는 제약을 Markdown 파일을 활용해 극복하는 방법을 소개합니다. 작업 상황을 status.md 파일에 기록하여 다음 세션에서 즉시 재개할 수 있는 워크플로우를 제안합니다.

핵심 포인트

  • Cowork 모드는 세션 종료 시 대화 컨텍스트가 초기화되는 제약이 있음
  • 휘발성인 대화 컨텍스트를 비휘발성인 Markdown 파일로 전환하여 해결
  • status.md 파일을 활용해 작업 개요, 진행 상황, 결정 이유를 기록
  • 컨텍스트 압박을 방지하기 위해 200행 이내의 핵심 요약 권장

「어제 하던 거 계속해줘」

그렇게 전달하면, Claude는 이렇게 대답합니다.

「어떤 작업을 계속할까요? 자세히 알려주세요」

……나도 모르게 한숨이 나옵니다. 어제 그렇게나 설명했는데, 또 처음부터?

Claude Code의 Cowork 모드는 문서 작성, 리서치, 파일 정리와 같은 「지식 노동」 전반을 자율적으로 수행할 수 있는 강력한 에이전트입니다. 하지만 세션을 넘길 때마다 컨텍스트 (Context)가 완전히 리셋된다는 제약이 있어, 며칠에 걸친 대규모 태스크에서는 「재설명 비용」이 쌓여갑니다.

이 기사에서는 그 문제를 작업 상황을 Markdown 파일로 써 내려가는 것만으로 해결하는 워크플로우를 소개합니다. 특별한 도구나 설정은 필요 없으며, 오늘부터 즉시 사용할 수 있습니다.

집필 시점의 환경: Claude Desktop (macOS / Windows), 2026년 6월 시점의 사양을 바탕으로 합니다. 도구의 업데이트에 따라 아래에서 설명하는 제약이 향후 해소될 가능성이 있습니다.

「Claude Code」에는 터미널에서 사용하는 CLI와 데스크톱 앱에서 사용하는 Cowork 모드의 두 가지 방식이 있습니다. 이 둘은 컨텍스트 관리 측면에서 크게 다릅니다.

Claude Code CLICowork 모드
실행 방법터미널에서 claude
Claude Desktop 앱의 「Cowork」 탭
주요 용도코딩·개발 작업
/compact 커맨드✅ 사용 가능
세션 재개claude -c로 리줌 (Resume) 가능

CLI에는 /compact라는 커맨드가 있어, 길어진 대화를 그 자리에서 요약·압축하여 「다음」부터 작업을 이어갈 수 있습니다. 반면, Cowork 모드에는 이 커맨드가 없으며, 공식 문서에도 다음과 같이 명시되어 있습니다.

「세션 영속성: Claude Desktop 앱이 열려 있어야 하며, 컴퓨터가 켜져 있어야 합니다. 앱을 닫거나 컴퓨터가 슬립 모드에 들어가면 활성 태스크는 중단됩니다. 현재 시점에서는 세션 간 메모리 영속화 기능이 없습니다.」

— Get started with Claude Cowork

AI의 대화 컨텍스트는 컴퓨터로 치면 **RAM (휘발성 메모리)**입니다. 전원이 꺼지면 사라집니다. 세션이 종료된 후의 새로운 Cowork 태스크에서 Claude는 다음 사항을 모두 잊어버립니다.

  • 지난번에 어디까지 작업이 진행되었는지
  • 어떤 설계 판단을 내렸는지
  • 남아있는 문제·보류 사항은 무엇인지
  • 왜 그 기술 선택을 했는지

수 시간의 작업을 하루에 몇 번이고 중단·재개하는 것만으로도, 매번 10~20분의 「재설명 타임」이 발생합니다. 일주일 동안 쌓이면 상당한 로스 (Loss)가 됩니다.

발상의 전환은 심플합니다.

대화 컨텍스트 (휘발성) → 파일 (비휘발성)

세션을 넘겨도 사라지지 않는 것은 파일입니다. 작업 상황을 Markdown으로 써 두면, 다음 세션에서 그것을 읽게 하는 것만으로 「다음」부터 시작할 수 있습니다.

■ 기존 워크플로우
세션 시작
↓
...

다음 템플릿을 status.md로 작업 폴더에 두십시오. 처음에는 빈 상태여도 상관없습니다.

# 작업 상황 스냅샷
최종 업데이트: {일시}
## 태스크 개요
...

200행 이내를 기준으로 합니다. CLAUDE.md와 같은 원칙으로, 너무 길면 컨텍스트를 압박하여 역효과를 냅니다. 「다음에 무엇을 할 것인가」와 「왜 그 판단을 했는가」에만 집중하는 것이 요령입니다.

작업을 마치기 전에 이 프롬프트를 보냅니다.

이 작업을 일단 종료합니다.
다음번에 재개할 수 있도록, 현재 작업 상황을 status.md에 작성해 주세요.
다음 내용을 빠짐없이 기재해 주세요:
...

Cowork 모드는 로컬 파일에 직접 쓸 수 있기 때문에, Claude가 status.md를 생성·업데이트해 줍니다. 스스로 쓸 번거로움은 전혀 없습니다.

체크포인트를 둡니다. 세션 종료 시뿐만 아니라, 큰 작업 단위가 하나 완료된 타이밍에도 업데이트하게 하면 더욱 정밀도 높은 상태가 저장됩니다. 「○○가 완성되면 status.md를 업데이트해 줘」라고 미리 지시해 두는 것도 효과적입니다.

다음 Cowork 태스크를 시작할 때 보내는 것은, 단지 이것뿐입니다.

status.md를 읽고, 지난 작업의 이어서 작업을 재개해 주세요.

Claude는 이전의 진척 상황, 설계 판단, 미결 과제를 모두 파악한 상태에서 "그럼 □□ 구현부터 시작하겠습니다"라고 답변해 줍니다.

Cowork 모드에는 Global instructions라는 설정이 있어 매 세션 자동으로 읽어 들여집니다 (Claude Code로 치면 CLAUDE.md에 해당). 이를 status.md와 결합하면 워크플로우가 완전히 자동화됩니다.

Global instructions (CLAUDE.md 상당)status.md
역할
프로젝트의 영구적인 규칙그 시점의 작업 상태
업데이트 빈도
거의 변하지 않음세션마다 업데이트
내용 예시코딩 규약, 출력 형식 선호도, 사용 스택

Global instructions에 다음과 같이 추가해 두면 매번 프롬프트를 보낼 필요조차 없어집니다.

## 작업 시작 시의 규칙
- 작업 폴더에 status.md가 존재하는 경우, 가장 먼저 반드시 읽어서 현재 상황을 파악할 것
- 작업 완료 시 또는 중단 시에는 status.md를 최신 상태로 업데이트할 것
Before (워크플로우 없음)After (status.md 도입)
재개 시의 대화"어떤 작업인가요?", "어디까지 진행됐나요?", "기술 스택은요?", "이전의 판단은?"…
...

참고로, 유사한 접근 방식을 취하는 오픈 소스 도구인 "devpace"의 비교 테스트에서는, 구조화된 Markdown 상태 파일 덕분에 3번의 중단 지점을 거쳤음에도 수정 사항이 0건을 달성(수동으로 CLAUDE.md를 관리했을 경우 동일 조건에서 8번의 수정이 필요했음)했다는 결과가 보고되었습니다. 원리적으로 동일한 status.md 방식에서도 동등한 효과를 기대할 수 있습니다.

며칠에서 몇 주 규모의 프로젝트에서는 status.md작업 로그를 누적시켜 감으로써, 과거의 판단 경위를 Claude가 참조할 수 있게 됩니다.

# 작업 상황 스냅샷
## 현재 상황 (항상 최신)
→ 다음에 할 일: ○○ 구현
...

"왜 이 구성을 선택했는가", "왜 이 라이브러리를 선택했는가"와 같은 배경이 축적됨으로써, Claude가 과거의 판단을 뒤집는 제안을 하는 빈도가 대폭 줄어듭니다.

status.md가 오래되면 역효과가 납니다.

업데이트를 잊어버리면 오래된 상태에서 잘못된 방향으로 작업이 재개됩니다. "세션 종료 시 반드시 업데이트한다"를 규칙으로 정하거나, Global instructions를 통해 자동 업데이트를 의무화하세요.

너무 많이 담아 넣는 것은 금물입니다.

"전부 적어두면 안심이 된다"는 마음은 이해하지만, 방대한 status.md는 그 자체로 컨텍스트 (Context)를 압박합니다. "다음에 무엇을 할 것인가"와 "왜 그렇게 하는가"라는 두 가지 포인트에 집중하면, 대부분 200행 이내로 수렴합니다.

Git과 역할을 분리하세요.

status.md는 "Claude를 위한 인수인계 메모"이며, 변경 이력의 대체재가 아닙니다. 실제 코드 및 파일의 변경 관리는 Git으로 수행하고, status.md는 Git에 커밋할지 혹은 .gitignore에 넣을지는 프로젝트 방침에 따라 결정하세요.

Cowork 모드의 제약과 그 대처법을 정리합니다.

제약대처
앱을 닫으면 세션 종료중단 전에 status.md로 내보내기
/compact 명령어를 사용할 수 없음status.md가 "외부 메모리"로서 대체
세션 간의 메모리 계승 없음Global instructions로 자동 읽기 설정

컨텍스트를 외부 파일로 내보낸다는 아이디어 자체는 단순하지만, 실제로 운용에 포함시키면 "재설명 비용"이 거의 제로가 되어 AI와의 협업 경험이 크게 달라집니다. Cowork 모드에 국한되지 않고, AI 에이전트를 며칠에 걸쳐 사용하는 모든 상황에 응용할 수 있는 범용 패턴입니다.

우선 하나의 프로젝트에서 시도해 보세요.

본 기사의 내용은 2026년 6월 시점의 사양을 바탕으로 합니다. Claude Desktop 및 Cowork 모드의 사양은 향후 변경될 가능성이 있습니다. 최신 정보는 공식 문서를 확인해 주세요.

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0