CLAUDE.md를 외부 작업 기억 (External Working Memory)으로 활용하세요: Stack, Voice, Gotchas, 그리고 Current checkpoint 섹션을 추가하여, 자체 보고된 데이터에 따르면 세션 재시작 시간을 5~15분에서 1분 미만으로 단축할 수 있습니다.

무엇이 바뀌었는가 — 구체적인 통찰

ADHD를 가진 한 개발자가 자신의 Claude Code 세션을 추적한 결과, CLAUDE.md 없이 프로젝트를 다시 여는 것은 매번 5~15분의 "내가 어디까지 했더라"라는 시간을 소모한다는 것을 발견했습니다. 구조화된 CLAUDE.md를 작성한 후, 그 시간은 1분 미만으로 줄어들었습니다. 핵심은 새로운 기능이 아니라, CLAUDE.md를 **외부 작업 기억 (External Working Memory)**으로 사용하는 것이었습니다.

CLAUDE.md는 Claude Code가 매 세션 시작 시 자동으로 읽는 Markdown 파일입니다. 사용자가 직접 붙여넣을 필요도 없고, Claude에게 존재를 상기시킬 필요도 없습니다. 첫 번째 작업 라인을 작성하기 전, 매번 자동으로 읽힙니다.

이 파일은 두 군데에 위치합니다:

• ./CLAUDE.md: 프로젝트 루트에 위치하며 해당 프로젝트를 위한 규칙(기술 스택 (Tech Stack), 컨벤션 (Conventions), 주의사항 (Gotchas))을 담습니다.
• ~/.claude/CLAUDE.md: 전역 규칙을 담습니다. 당신이 만드는 모든 것에 적용되는 사항(당신의 말투 (Voice), 기본 설정 (Defaults), 다시 논쟁하고 싶지 않은 사항들)을 포함합니다.

왜 작동하는가 — 작업 기억 (Working Memory) 논거

작업 기억 (Working Memory)은 "내가 지금 무엇을 하고 있는지, 그리고 방금 그것에 대해 결정한 세 가지 사항"을 유지하는 정신적 연습장 (Mental scratchpad)입니다. ADHD는 이 연습장을 축소시키고 내용이 새어나가게 만듭니다. Slack 알림, 엉뚱한 생각, 이메일로의 컨텍스트 스위칭 (Context-switch) 등 모든 방해 요소는 연습장에서 항목들을 떨어뜨립니다. 다시 돌아왔을 때, 연습장은 비어 있고 당신은 처음부터 다시 구축해야 합니다.

미국 심리학회 (American Psychological Association)는 일반적인 뇌의 경우 컨텍스트 스위칭 한 번당 재구축 비용을 약 23분으로 산정합니다. 비자발적으로 더 자주 전환하고 더 느리게 재구축하는 ADHD 뇌의 경우, 실제 비용은 더 높으며 복리로 쌓입니다.

CLAUDE.md는 이 연습장을 당신의 머릿속에서 꺼내 파일로 옮겨줍니다. 그렇지 않았다면 기억하고, 유지하고, 다시 설명해야 했을 컨벤션 (Conventions)들이 이제는 내용이 새어나가지 않는 곳에 존재하게 됩니다:

• 당신의 **기술 스택 (tech stack)**을 기억하므로, "Next가 아니라 SvelteKit을 사용합니다"라고 다시 설명할 필요가 없습니다.
• 당신의 **컨벤션 (conventions)**을 기억하므로, 동일한 명명 규칙 문제를 반복해서 결정할 필요가 없습니다.
• 당신의 **말투 (voice)**를 기억하므로, 긴 지침을 주지 않아도 출력 결과가 당신의 말투처럼 나옵니다.
• **현재 작업 (current task)**을 기억하므로, 프로젝트를 다시 열었을 때 "잠깐, 내가 뭘 만들고 있었지?"라며 시작하지 않아도 됩니다.

적용 방법 — 단계별 가이드

완벽한 파일을 설계하려고 애쓰지 마세요. 프로젝트를 열고, 루트(root)에 CLAUDE.md를 생성한 뒤, 네 개의 헤더를 작성하세요:

# Project: my-app

## Stack (do not re-ask)
...

현재 체크포인트 (Current checkpoint) 블록이 가장 중요합니다. 이전에는 모든 세션을 시작할 때마다 "좋아, 어디까지 했더라"라며 1~2분 동안 헤매곤 했습니다. 이제 Claude는 당신이 한마디도 하기 전에 체크포인트를 읽기 때문에, 당신이 무엇을 하고 있었고 다음 단계가 무엇인지 가장 먼저 알려줍니다.

전역 파일(Global File)은 반복되는 결정 사항을 처리합니다

프로젝트 파일은 프로젝트별 사실(facts)을 처리합니다. 전역 ~/.claude/CLAUDE.md는 모든 곳에서 반복해서 결정하느라 지쳤던 사항들을 처리합니다:

## Defaults (do not ask, just do)
- 완료되었다고 주장하기 전에 검증하세요. 빌드 결과물을 보여주세요. "작동할 것입니다"라고만 말하지 마세요.
- 모호한 목표를 3~5개의 원자적 작업 (atomic tasks)으로 나누고 제가 하나를 선택하게 하세요. 절대 빈 도화지를 넘겨주지 마세요.
...

마지막 규칙은 순수하게 ADHD를 위한 배려입니다. "A를 원하시나요, B를 원하시나요? 그리고 C나 D는 어떠세요? E는요?"와 같은 질문의 벽은 컨텍스트 스위칭 (context-switch) 수류탄과 같습니다. "첫 번째 것을 묻고, 기다리세요"라는 규칙은 당신이 한 번에 하나의 결정에만 집중할 수 있게 해줍니다.

지금 바로 시도해보세요

1. 프로젝트 루트에서 touch CLAUDE.md를 실행하세요.
2. 위에 제공된 4개 섹션 템플릿을 붙여넣으세요.
3. 현재 알고 있는 내용을 채우세요. 나머지는 빈칸으로 두세요.
4. 전역 규칙(global rules)을 위해 mkdir -p ~/.claude && touch ~/.claude/CLAUDE.md도 실행하세요.
5. Claude가 당신이 이미 알고 있기를 바랐던 무언가를 물어볼 때마다, 그 답변을 파일에 기록하세요.

Claude가 당신이 이미 알고 있기를 바랐던 무언가를 물어볼 때마다 파일은 더 좋아집니다. 왜냐하면 그 질문이 바로 당신이 기록해야 할 바로 그 내용이기 때문입니다.

오래된 컨텍스트(stale context)를 주의하세요. 업데이트되지 않은 CLAUDE.md는 도움을 주지 못할 뿐만 아니라, 매우 자신만만하게 당신에게 거짓 정보를 제공합니다. 구조적인 변경 사항이 생기면, 그 즉시 파일을 업데이트하세요.

출처: dev.to

[16 Jun 업데이트 (hn_claude_code 경유)]

커뮤니티에서 제작한 새로운 확장 프로그램인 Claude Code for Visual Studio는 공식 IDE 플러그인에서 사용되는 것과 동일한 프로토콜을 Microsoft의 IDE로 가져옵니다. 여기에는 승인/거절(accept/reject) 버튼이 있는 네이티브 diff 뷰어와, Claude가 재시도할 수 있도록 거절 사유를 입력할 수 있는 기능이 추가되었습니다. 또한 [HN에 따르면] 컴파일러 오류와 현재 선택 영역을 자동으로 공유합니다.

원문 게시: gentic.news