세션이 바뀌어도 규칙이 남는 방법: 해커톤 저장소의 CLAUDE.md 운영 포인트 | DAKER 커뮤니티

해커톤처럼 며칠에 걸쳐 기획, 코드, 데모가 이어지는 작업에서는 같은 설명을 반복하는 비용이 생각보다 큽니다. 어제 말한 스택, 건드리면 안 되는 경로, 꼭 돌려야 하는 테스트를 오늘 다시 설명해야 한다면, 도구를 쓰는 이점도 금방 줄어듭니다.

Sharbel A. 채널의 Learn 95% Of Claude Code In 30 Minutes는 이 반복을 줄이는 핵심으로 CLAUDE.md를 짚습니다. 이 글에서는 영상의 내용을 바탕으로 권한 모드, 비용 감각, 스킬 사용 시 주의점, 그리고 팀이 바로 적용할 수 있는 CLAUDE.md 운영 포인트를 정리합니다.

세션이 바뀌어도 규칙은 남습니다 — Claude Code CLAUDE.md

영상이 먼저 구분하는 세 가지 제품

영상은 Claude 관련 도구를 역할별로 나눠 설명합니다. Claude 앱은 질문하거나 빠르게 조회할 때 쓰는 도구입니다. Cowork는 폴더 정리나 청구서 추출처럼 컴퓨터에서 반복되는 작업을 맡기는 쪽에 가깝습니다. Claude Code는 프로젝트 폴더 안에서 실제로 코드를 수정하고 기능을 추가하며 결과를 저장소에 남기는 도구로 소개됩니다.

Claude Code는 제안만 하는 채팅이 아니라, 작업 결과가 저장소에 남는 도구입니다.

이 구분은 단순해 보이지만 중요합니다. 특히 해커톤 저장소처럼 결과물이 바로 남아야 하는 환경에서는, 대화형 조언과 실제 변경 작업을 분리해서 이해하는 편이 운영에 도움이 됩니다.

권한 모드는 속도보다 먼저 이해하는 것이 좋습니다

영상은 파일 수정이나 명령 실행 전에 어떤 방식으로 멈추고 확인할지를 권한 모드로 설명합니다. 소개되는 모드는 네 가지입니다. Auto는 기본 모드로, 배경에서 확인하다가 중요한 시점에 멈춥니다. Manual은 변경할 때마다 묻습니다. Except edit는 파일 편집은 바로 하고 다른 작업에서 확인을 거칩니다. Plan은 계획만 세우고 승인 전에는 바꾸지 않습니다.

여기에 Bypass permissions를 켜면 묻지 않고 진행합니다. 영상은 초보자라면 Bypass를 끈 상태에서 Auto를 쓰는 편이 안전하다고 봅니다. 도구의 동작을 충분히 이해한 뒤에야 속도를 위해 Bypass를 검토하는 흐름입니다.

처음에는 Bypass를 끈 채 Auto를 쓰는 편이 안전하다고 영상은 설명합니다.

CLAUDE.md가 세션을 넘기는 핵심입니다

영상에서 가장 강조되는 지점은 CLAUDE.md입니다. 프로젝트에 두는 일반 텍스트 파일이며, Claude Code가 시작할 때마다 먼저 읽는다고 설명합니다. 여기에 스택 제약, 금지 경로, 테스트 명령, 리뷰 게이트처럼 코드만 읽어서는 알기 어려운 규칙을 적어 두면 세션이 바뀌어도 같은 설명을 반복하지 않아도 됩니다.

코드만 봐서는 알기 어려운 규칙을 CLAUDE.md에 남겨 두면 세션이 바뀌어도 같은 설명을 다시 하지 않아도 됩니다.

다만 영상은 이 파일을 길게 쓰는 방식은 경계합니다. 파일 트리 전체, 의존성 목록, 장문의 아키텍처 설명까지 모두 넣으면 매 메시지마다 그 내용이 컨텍스트에 실리게 됩니다. 그러면 토큰 비용이 커지고, 정작 중요한 규칙은 묻히기 쉽습니다.

그래서 발표자는 Claude에게 지시 초안을 쓰게 한 뒤 불필요한 부분을 덜어내는 방식을 말합니다. 이미 비대해졌다면 doctor 계열 명령으로 코드에서 이미 알 수 있는 내용을 걷어 내라고도 안내합니다. 동시에 CLAUDE.md는 강제 장치가 아니라 안내라는 점도 분명히 합니다. 매번 반드시 실행되어야 하는 검사는 훅(hooks)으로 다뤄야 한다는 설명입니다.

모델 선택과 세션 길이가 비용에 영향을 줍니다

영상은 가격 숫자를 단정하지는 않지만, 비용이 모델 선택과 컨텍스트 길이에 달려 있다고 설명합니다. 긴 대화는 매 턴마다 이전 메시지를 다시 실어 보내기 때문에 비용 감각에 영향을 줍니다.

모델 구분도 함께 제시됩니다. Haiku는 단순하고 기계적인 작업, Sonnet은 범위가 분명한 일상 작업, Opus는 판단이 필요한 복잡한 문제, Fable은 더 어려운 전문 작업에 가깝다고 설명합니다. 또 세션 중간에 모델을 바꾸면 캐시가 이어지지 않아 대화를 처음부터 다시 읽게 되므로, 가능하면 시작할 때 모델을 정하고 유지하는 편이 낫다고 말합니다.

이 글에서는 요금표를 따로 옮기지 않습니다. 가격과 할당량은 계정 화면에서 직접 확인하는 것이 좋습니다.

스킬은 반복 절차를 저장하지만, 설치 전에 읽어야 합니다

영상은 스킬을 반복 절차를 저장한 것으로 소개합니다. 기본 예시로 /code-review와 /security-review가 언급되며, Anthropic 문서 팩, Superpowers, 작업을 모델에 나누는 라우팅 스킬도 첫날에 둘 만한 대상으로 설명합니다.

다만 여기에는 분명한 주의점이 붙습니다. 스킬은 텍스트만 담는 것이 아니라 셸 명령을 실행할 수 있습니다. 그래서 설치 전에 Claude에게 내용을 읽히고 안전한지 확인하라고 강조합니다.

스킬은 편리하지만 셸 명령을 실행할 수 있으므로 설치 전에 내용을 읽고 확인해야 합니다.

이 글에서는 스킬 자체를 넓게 다루기보다, 설치 전 감사와 CLAUDE.md 규칙 정리에 초점을 둡니다.

해커톤 저장소에서는 고신호 규칙만 남기는 편이 낫습니다

영상의 실천 포인트를 해커톤 저장소에 맞춰 옮기면, 핵심은 CLAUDE.md를 짧고 분명하게 유지하는 데 있습니다. 길고 친절한 설명보다, 실제로 작업 기준을 바꾸는 규칙 몇 줄이 더 중요합니다.

예를 들어 사용 중인 런타임, 수정하면 안 되는 디렉터리, 반드시 통과해야 하는 테스트 명령, 사람이 최종 검토할 제출물처럼 코드만으로는 드러나지 않는 기준을 적어 두면 됩니다. 반대로 파일 트리나 장문의 아키텍처 설명은 넣지 않는 편이 낫습니다.

고신호 규칙은 길게 설명하는 문서보다, 작업 기준을 바로 바꾸는 몇 줄에 가깝습니다.

팀에 바로 쓰는 CLAUDE.md 예시

이처럼 짧고 검사 가능한 규칙이 있으면, 새 세션에서도 무엇을 맞추면 끝나는지가 달라지지 않습니다. 규칙이 바뀌었을 때 채팅에만 남기지 말고 CLAUDE.md를 갱신해 두는 편이 좋습니다. 채팅에서 수정한 내용은 다음 세션에 그대로 전달되지 않을 수 있기 때문입니다.

문제가 생길 때 자주 보이는 패턴

영상은 실패 유형을 세 가지로 나눕니다. 같은 수정을 반복하는 루프, 오해한 채 자신 있게 바꾸는 경우, 너무 많이 바꿔서 되돌리고 싶은 경우입니다.

루프에 빠졌다면 같은 말을 반복하기보다 지시 자체를 바꾸는 편이 낫다고 설명합니다. 오해가 의심될 때는 실행 전에 설명을 요구하고, 작업이 크게 어긋났다면 대화 복구 명령을 쓰는 흐름을 제시합니다.

또 Anthropic Security Guidance 플러그인은 쓰기 패턴 검사, 턴 종료 시 보안 리뷰, 커밋 시 더 깊은 리뷰를 도울 수 있지만, 쓰기나 커밋 자체를 막지는 않는다고 분명히 말합니다. 자동 차단 장치가 아니므로 사람 검토는 여전히 남습니다.

왜 지금 CLAUDE.md를 먼저 정리하는가

최근에는 공유 컨텍스트, 완료 조건, 에이전트 하네스, 스킬 층처럼 다양한 운영 방식이 함께 이야기됩니다. 그 가운데 이 영상이 특히 강조하는 것은 터미널 에이전트 Claude Code에서 세션이 바뀌어도 남는 규칙 파일입니다.

DAKER처럼 며칠에 걸쳐 기획, 코드, 데모가 이어지는 팀이라면 모델만 바꾸는 것보다 먼저 CLAUDE.md에 무엇이 올바른 제출인지 남겨 두는 편이 인수인계 비용을 줄이는 데 더 직접적일 수 있습니다. 팀 채널이나 이슈에 CLAUDE.md 위치, 고신호 규칙 줄 수, 사람이 검토할 항목을 한 줄로 남겨 두는 습관도 같은 맥락에서 도움이 됩니다.

정리

이 영상이 보여 주는 실무 변화는 세 가지로 요약됩니다. 권한 모드로 위험을 조절하고, CLAUDE.md로 규칙을 세션 너머로 옮기며, 스킬은 설치 전에 읽는 습관을 갖는 것입니다. 해커톤 저장소라면 특히 CLAUDE.md에 고신호 규칙 몇 줄을 남기고, 새 세션에서 그 규칙이 반영되는지만 확인해도 반복 설명을 크게 줄일 수 있습니다.

참고 자료

여러분 팀에서는 세션이 바뀌어도 꼭 남아 있어야 하는 규칙을 CLAUDE.md에 어떤 식으로 적고 계신가요?