세션마다 프로젝트를 다시 설명하지 않습니다 — CLAUDE.md에 오늘 고신호 규칙만 남기십시오 | DAKER 커뮤니티

해커톤 저장소에서 Claude Code를 켜면, 어제 설명한 스택·금지 경로·테스트 명령을 오늘 또 말하는 일이 자주 생깁니다. Sharbel A. 채널의 「Learn 95% Of Claude Code In 30 Minutes」는 그 반복을 줄이는 축을 CLAUDE.md로 잡습니다. 오늘은 권한 모드·비용 감각·스킬 주의점을 짧게 정리하고, 참가자가 바로 넣을 고신호 규칙 몇 줄을 남깁니다.

세션이 바뀌어도 규칙은 남습니다 — Claude Code CLAUDE.md 설명용 생성 이미지
설명용 생성 이미지입니다. 실제 화면 캡처가 아닙니다.

영상이 가리키는 세 가지 제품

영상은 먼저 역할을 나눕니다. Claude 앱은 질문과 빠른 조회용입니다. Cowork는 폴더 정리·청구서 추출처럼 컴퓨터에서 반복 작업을 맡깁니다. Claude Code는 프로젝트 폴더 안에서 실제로 코드를 고치고, 기능을 추가하며, 결과를 보여 줍니다. 제안만 하는 채팅과 달리, 작업이 저장소에 남습니다.

권한 모드를 먼저 고릅니다

파일을 바꾸거나 명령을 실행하기 전에 멈추는 방식이 권한 모드입니다. 영상은 네 가지를 말합니다. Auto는 기본이며, 배경에서 확인한 뒤 중요한 때만 멈춥니다. Manual은 매 변경마다 묻습니다. Except edit는 파일 편집은 바로 하고, Plan은 계획만 세운 뒤 승인 전에는 바꾸지 않습니다. Bypass permissions를 켜면 묻지 않습니다. 초보자는 Bypass를 끈 채로 Auto를 쓰는 편이 안전하다고 영상은 권합니다. 도구를 이해한 뒤에야 속도를 위해 Bypass를 검토하면 됩니다.

CLAUDE.md가 세션을 넘깁니다

영상에서 「하나만 가져가라」고 하는 부분이 CLAUDE.md입니다. 프로젝트에 두는 일반 텍스트 파일이며, Claude Code가 시작할 때마다 먼저 읽습니다. 스택 제약, 건드리면 안 되는 경로, 테스트 명령, 리뷰 게이트처럼 코드만 봐서는 알기 어려운 규칙을 여기에 적습니다. 그러면 세션을 새로 열어도 같은 설명을 다시 하지 않아도 됩니다.

함정도 있습니다. 파일 트리 전체, 의존성 목록, 긴 아키텍처 설명을 모두 넣으면 매 메시지마다 그 내용이 컨텍스트에 실립니다. 토큰 비용이 커지고, 정작 지켜야 할 규칙은 묻힙니다. 영상은 Claude에게 지시 초안을 쓰게 한 뒤, 불필요한 부분을 빼라고 합니다. 이미 비대해졌다면 의사(doctor) 계열 명령으로 「코드에서 이미 알 수 있는 것」을 걷어 내라고 안내합니다. 다만 CLAUDE.md는 강제 장치가 아니라 안내입니다. 매번 반드시 실행해야 하는 검사에는 훅(hooks)을 쓰라고 말합니다.

모델 선택과 세션 길이가 비용을 만듭니다

영상은 가격 숫자를 단정하지 않고, 비용이 모델 선택과 컨텍스트 채움에 달렸다고 말합니다. 긴 대화는 매 턴마다 이전 메시지를 다시 실어 보냅니다. Haiku는 단순·기계적 작업, Sonnet은 범위가 분명한 일상 작업, Opus는 판단이 필요한 복잡한 문제, Fable은 더 어려운 전문 작업에 가깝다고 구분합니다. 세션 중간에 모델을 바꾸면 캐시가 이어지지 않아 대화를 처음부터 다시 읽게 되므로, 가능하면 시작할 때 모델을 고르고 유지하라고 합니다. 이 글에서는 요금표를 쓰지 않습니다. 계정 화면에서 직접 확인하십시오.

스킬은 한 번 심고, 설치 전에 읽습니다

스킬은 반복 절차를 저장한 것입니다. 기본으로 /code-review(실제 버그 위주), /security-review가 있다고 소개합니다. 영상은 Anthropic 문서 팩, Superpowers(인터뷰→계획→테스트 우선→서브 에이전트 리뷰), 작업을 모델에 나누는 라우팅 스킬을 첫날에 두라고 합니다. 다만 스킬은 텍스트만이 아니라 셸 명령을 실행할 수 있습니다. 설치 전에 Claude에게 내용을 읽히고 안전한지 확인하라고 강조합니다. Sep16에 다룬 「하네스·스킬 층을 레포에 잡는다」와 겹치지 않게, 오늘은 설치 전 감사와 CLAUDE.md 규칙에 초점을 둡니다.

참가자가 오늘 할 일

제목의 다음 행동은 이것입니다. 오늘은 CLAUDE.md에 고신호 규칙만 남기십시오.

  1. 해커톤·제출용 저장소 하나를 고릅니다.
  2. 프로젝트 루트에 CLAUDE.md가 없으면 만들고, 있으면 엽니다.
  3. 코드만 읽어서는 알기 어려운 규칙을 5~10줄로 적습니다. 예: 사용 중인 런타임, 금지 디렉터리, 반드시 통과할 테스트 명령, 사람이 검토할 제출물.
  4. 파일 트리·장문 아키텍처 설명은 넣지 않습니다. 이미 길면 doctor로 「추론 가능한 부분」을 줄입니다.
  5. Claude Code를 새로 연 뒤, 규칙이 반영되는지 한 작업으로 확인합니다.

「고신호 규칙 5~10줄 기록」이 오늘의 완료 기준입니다. 권한이 Auto인지, Bypass가 꺼져 있는지도 함께 확인하면 안전합니다.

문제가 났을 때와 보안 플러그인

영상은 실패 유형을 세 가지로 나눕니다. 같은 수정을 반복하는 루프, 오해한 채 자신 있게 바꾸는 경우, 너무 많이 바꿔서 되돌리고 싶은 경우입니다. 루프에는 같은 말을 반복하지 말고 지시를 바꾸라고 합니다. 오해에는 실행 전 설명을 요구하고, 엉망이 되면 대화 복구 명령을 쓰라고 합니다. Anthropic Security Guidance 플러그인은 쓰기 패턴 검사, 턴 끝 보안 리뷰, 커밋 시 더 깊은 리뷰를 돕지만, 쓰기·커밋을 막지는 않는다고 분명히 말합니다. 자동 차단이 아니므로 사람 검토는 남습니다.

다른 각도와의 차이

최근 잡담에는 Cursor Projects의 공유 컨텍스트·완료 조건, 에이전트 하네스의 플래시·Boost·스킬 층이 있었습니다. 이 영상은 터미널 에이전트 Claude Code에서 세션이 바뀌어도 남는 규칙 파일을 중심에 둡니다. DAKER처럼 며칠에 걸쳐 기획·코드·데모가 이어지는 팀은, 모델만 바꾸는 것보다 CLAUDE.md에 「무엇이 올바른 제출인지」를 먼저 고정하는 편이 인수인계 비용을 줄입니다.

팀에 바로 쓰는 CLAUDE.md 예시

고신호 규칙은 길수록 좋지 않습니다. 아래처럼 검사 가능하게 쓰면 됩니다.

이 네 줄이 있으면 새 세션에서도 「무엇을 맞추면 끝나는지」가 같습니다. 규칙을 바꿀 때도 채팅에만 남기지 말고 CLAUDE.md를 갱신하십시오. 채팅 수정은 다음 세션에 전달되지 않을 수 있습니다.

데모 전에 남길 한 줄 기록

팀 채널이나 이슈에 「CLAUDE.md 위치 · 고신호 규칙 줄 수 · 사람이 검토할 항목」을 한 줄로 남기면 인수인계가 짧아집니다. 영상이 말하는 세션을 넘는 기억은 도구 이름보다 이 습관에 가깝습니다. 가격·할당량·플러그인 권한은 시점에 따라 달라지므로 계정과 공식 안내를 직접 확인하십시오.

정리

Claude Code의 실무 변화는 권한 모드로 위험을 조절하고, CLAUDE.md로 규칙을 세션 너머로 옮기며, 스킬은 설치 전에 읽는 습관입니다. Sharbel A.의 이 영상은 그 95%를 짧게 보여 줍니다. 해커톤 저장소에서 오늘은 CLAUDE.md에 고신호 규칙 몇 줄을 남기고, 새 세션에서 한 번만 확인하십시오.

출처

#ClaudeCode #CLAUDEmd #에이전트 #해커톤 #잡담