클로드 코워크 활용법 5가지: claude.md·memory.md 구조와 300줄 규칙으로 토큰 25% 절약

핵심 메시지

• 코워크의 지침·메모리는 .md 파일에 사는데, 무료 앱 옵시디언을 워크스페이스 폴더에 연결하면 헤딩·굵게·불릿이 제대로 렌더링돼 읽고 편집하기 쉬워진다. 옵시디언을 배울 필요는 없고 .md를 보는 렌즈로만 쓴다.
• 루트 claude.md는 매 세션 로드되므로 비대하면 토큰을 낭비한다. 발표자는 600줄에서 약 250줄로 줄여 토큰 사용량을 약 25% 낮췄고, 200~250줄(최대 300줄)을 권한다.
• 내용이 들어갈 자리를 구분하라. '항상·절대' 같은 규범적 지침은 claude.md, 바뀔 수 있는 사실은 memory.md에 둔다. 매 세션 필요 없는 규칙은 참조 파일로 빼고 한 줄 포인터만 남긴다.
• memory.md도 매 세션 로드되므로 다이어트가 필요하다. 한두 문장 제한과 150줄 상한을 두고, 넘으면 압축·보관(archive.md)으로 해결한다. archive.md는 세션마다 읽지 않아 토큰 비용 없이 모든 기록을 보존한다.
• 클로드 프로젝트는 코워크로 이전하는 게 낫다. 프로젝트 지침은 워크스테이션 claude.md로, 프로젝트 메모리는 memory.md로, 지식 파일은 리소스 폴더로 옮긴다. 그리고 '일하는 공간'은 워크스테이션, '매번 똑같이 하는 반복 작업'은 스킬로 나눈다.

쉽게 이해하기

제프 수는 코워크가 대단히 강력하지만 워크스페이스 설정의 정석이 아직 없어, 기초를 잘못 잡으면 피할 수 있는 문제에 계속 부딪힌다고 말한다. 그는 5개월간 코워크로 일상 전체를 운영하며(토큰 비용을 감당하느라 빚까지 졌다고 농담한다) 얻은, 첫날부터 잡아야 할 다섯 가지를 정리한다.

첫째는 '마크다운 번역기'다. 코워크의 지침과 메모리는 .md 파일에 저장되는데 그대로 읽고 편집하기 불편하다. 무료 앱 옵시디언을 코워크 워크스페이스 폴더에 '보관함'으로 열면 모든 .md가 헤딩·굵은 글씨·불릿으로 깔끔하게 렌더링된다. 옵시디언의 다른 기능을 배울 필요 없이 .md를 읽고 고치는 렌즈로만 쓰면 된다.

둘째는 '300줄 규칙'이다. 루트 claude.md는 매 세션 로드되므로 비대하면 토큰을 크게 낭비한다. 그는 자기 파일을 600줄 이상에서 약 250줄로 줄여 토큰 사용량을 약 25% 낮췄다. 비결은 세 가지다. 핵심만 담기(메모리 시스템·선호·규칙·라우팅 맵·참조·새 워크스테이션 생성의 여섯 섹션), 매 세션 필요 없는 규칙은 참조 파일로 옮기고 한 줄 포인터만 남기기, 그리고 권장 200~250줄(최대 300줄) 지키기다.

셋째 팁과도 이어지는 '올바른 자리에 쓰기'다. 많은 사용자가 claude.md 내용을 memory.md에 넣거나 그 반대로 해 품질을 떨어뜨린다. 판별법은 두 가지다. '항상·절대'처럼 규범적이면 claude.md, 바뀔 수 있는 사실이면 memory.md다. 그는 코워크에게 두 파일을 검토해 잘못 놓인 항목을 표시·재배치하게 하는 프롬프트를 권한다. 이어 '메모리 다이어트'로 memory.md도 명확한 구조(진행 중 작업·예약 작업·핵심 메모리)와 항목당 한두 문장 제한, 150줄 상한을 두고, 넘으면 상한을 올리지 말고 압축·보관하라고 한다.

넷째는 '프로젝트 이식'이다. 클로드 프로젝트를 코워크로 옮기면 한계가 사라진다. 프로젝트 지침은 워크스테이션 claude.md로, 프로젝트 메모리는 편집 가능한 memory.md로, 지식 파일은 리소스 폴더로 옮겨지고, 라우팅 맵에도 새 워크스테이션 항목이 자동 추가된다. 다섯째는 '스킬 점검'이다. 사람이 판단을 내려야 하고 자체 맥락·목소리가 쌓이는 '일하는 공간'은 워크스테이션, 매번 똑같이 자동 실행하고 싶은 반복 과정은 스킬이다. 기준은 간단하다. '내가 일하는 장소인가, 내가 하는 일인가'다.

주요 인사이트

• 옵시디언은 코워크 워크플로를 바꾸는 별도 도구가 아니라 .md 파일을 읽기 쉽게 보여주는 '렌즈'일 뿐이다. 읽기 모드로 잠그면 실수 편집을 막고, 설정에서 모든 파일 형식 표시를 켜면 스프레드시트·PDF·이미지도 사이드바에서 볼 수 있다.
• 루트 claude.md와 memory.md가 매 세션 로드된다는 사실이 토큰 경제의 핵심이다. 그래서 한 줄 포인터·참조 파일·150줄 상한·archive.md 같은 '계단식' 구조로 평소 로드량을 줄이는 것이 곧 비용 절감이자 출력 품질 개선이다.
• archive.md는 세션마다 읽지 않으므로 상한이 필요 없다. '석 달 전 그 건 어떻게 됐지?'처럼 물을 때만 참조돼, 토큰 비용 없이 모든 기록을 보존하는 '서류 캐비닛' 역할을 한다.
• 워크스테이션·프로젝트별로 별도 memory.md를 두는 계단식 구조 덕분에 루트 memory.md를 먼저 보고 해당 프로젝트 memory.md로 점프한다. 이 방식으로 그의 루트 memory.md는 몇 달을 써도 100줄을 넘은 적이 없다.
• 워크스테이션과 스킬의 차이는 '판단이 필요한가'에 있다. 뉴스레터 작성처럼 사람이 결정·판단을 내려야 하는 진행형 작업 영역은 워크스테이션, 제목 후보 생성처럼 체크리스트로 자동 실행되는 반복 과정은 스킬이다.

자주 묻는 질문

관련 AI 소식