📅 2026년 10월 21일 · 집중 연구 · 클로드 코드 A to Z 2편 · 2026년 10월 공식 문서 기준
클로드 코드 기능 핵심 정리: CLAUDE.md·권한 모드·계획 모드·되돌리기
💡 한 줄 요약: 클로드 코드를 ‘잘’ 쓰는 사람과 그냥 쓰는 사람의 차이는 네 가지 기능에서 갈립니다. 규칙을 기억시키는 CLAUDE.md, 얼마나 맡길지 정하는 권한 모드, 먼저 계획을 세우게 하는 계획 모드, 실수를 되돌리는 체크포인트입니다.
📚 클로드 코드 A to Z 시리즈 (전 5편)
- 1편 · 입문: 클로드 코드 사용법, 설치부터 첫 작업까지
- 2편 · 핵심 기능: CLAUDE.md·권한 모드·계획 모드·되돌리기 ← 지금 읽는 글
- 3편 · 고급 기능: 스킬·서브에이전트·훅·MCP·플러그인·자동화
- 4편 · 활용 사례: 무엇을 만들 수 있나 + 실제 구현 기록
- 5편 · 수익화: 클로드 코드로 돈을 버는 7가지 길과 함정
📋 이 글에서 알 수 있는 것
- 클로드에게 프로젝트 규칙을 매번 설명하지 않으려면?
- 6가지 권한 모드는 각각 언제 쓰나?
- 계획 모드로 ‘먼저 생각하고 나중에 고치기’는 어떻게 하나?
- 실수했을 때 되돌리는 방법은?
- 대화가 길어질 때 정확도와 사용량을 지키는 방법은?
1편에서 설치와 첫 작업을 해 봤다면, 이제 매일 쓰는 클로드 코드 기능을 익힐 차례입니다. 처음 며칠은 “분명 말한 규칙을 왜 또 잊어버리지?”, “파일을 고칠 때마다 허락을 묻는 게 번거롭다”, “엉뚱하게 고쳐 버렸는데 어떻게 되돌리지?” 같은 불편을 겪기 쉽습니다. 이 세 가지 불편은 각각 CLAUDE.md, 권한 모드, 체크포인트라는 기능으로 해결됩니다. 여기에 계획 모드와 대화(컨텍스트) 관리까지 더하면, 공식 문서가 말하는 ‘좋은 사용 습관’의 대부분을 갖추게 됩니다.
🧭 클로드 코드 기능 1: CLAUDE.md로 규칙 기억시키기
클로드 코드는 대화를 새로 시작할 때마다 이전 대화를 기억하지 못합니다. 대신 시작할 때마다 CLAUDE.md라는 메모 파일을 자동으로 읽습니다. 여기에 프로젝트 설명, 자주 쓰는 명령어, 지켜야 할 규칙을 적어 두면 매번 설명할 필요가 없습니다.
🔎 쉽게 말하면: CLAUDE.md는 새로 온 아르바이트생에게 건네는 ‘업무 안내 메모’입니다. “계산대는 이렇게 쓰고, 영수증은 꼭 주고, 냉장고 2번 칸은 건드리지 마세요.” 메모가 짧고 분명할수록 실수가 줄고, 너무 길면 중요한 줄을 놓칩니다.
어디에 두나: 4단계 위치
| 위치 | 적용 범위 | 용도 |
|---|---|---|
| ./CLAUDE.md 또는 ./.claude/CLAUDE.md | 이 프로젝트(팀과 공유) | 빌드·테스트 명령, 코드 규칙, 폴더 구조 |
| ./CLAUDE.local.md | 이 프로젝트, 본인만 | 개인 테스트 주소, 개인 취향(공유 저장소에 올리지 않음) |
| ~/.claude/CLAUDE.md | 모든 프로젝트, 본인만 | 모든 작업에 쓰는 개인 습관(예: 한국어로 답하기) |
| 회사 관리 정책 위치 | 회사 전체 | 보안·규정 같은 조직 공통 규칙 |
만드는 법과 잘 쓰는 법
프로젝트 폴더에서 클로드를 켜고 /init을 입력하면, 클로드가 폴더를 살펴보고 CLAUDE.md 초안을 자동으로 만들어 줍니다. 이후 /memory로 열어 고칠 수 있습니다. 공식 문서는 파일 하나를 200줄 이내로 유지하라고 권합니다. 길어지면 @docs/규칙.md처럼 다른 파일을 불러오거나(import), .claude/rules/ 폴더에 주제별 규칙 파일을 나눠 둘 수 있습니다.
# 프로젝트: 블로그 자동화 도구
## 명령어
- 테스트: npm test
- 실행: npm run dev
## 규칙
- 답변과 주석은 한국어로
- 새 기능을 만들면 반드시 테스트를 추가하고 실행해서 통과를 확인
- .env 파일은 읽거나 수정하지 말 것💡 초보자 팁: CLAUDE.md에는 ‘클로드가 코드만 봐서는 알 수 없는 것’을 적으세요. 이미 코드에 드러난 내용이나 “깔끔하게 짜 줘” 같은 막연한 말은 효과가 적습니다.
이와 별도로 자동 메모리(auto memory) 기능도 있습니다. 클로드가 작업하다 알게 된 사실(예: 이 프로젝트는 테스트 전에 서버를 켜야 한다)을 스스로 메모해 두고 다음 대화에서 참고합니다. 사람이 쓰는 CLAUDE.md와 클로드가 쓰는 자동 메모리가 함께 작동하는 구조입니다.
🔐 클로드 코드 기능 2: 6가지 권한 모드
권한 모드는 ‘클로드가 무엇을 사람에게 묻지 않고 해도 되는가’를 정하는 스위치입니다. 실행 중 Shift+Tab을 누르면 모드가 차례로 바뀌고, 화면 아래에 현재 모드가 표시됩니다.
| 모드 | 묻지 않고 하는 일 | 어울리는 상황 |
|---|---|---|
| default(기본·수동) | 파일 읽기만 | 처음 쓰는 프로젝트, 중요한 작업을 하나하나 확인할 때 |
| acceptEdits | 파일 읽기·수정, 기본 파일 명령(mkdir, mv 등) | 고친 내용을 나중에 한꺼번에 검토할 때 |
| plan(계획) | 읽기만, 수정은 하지 않음 | 고치기 전에 구조를 파악하고 계획을 세울 때 |
| auto(자동) | 대부분 허용, 별도 안전 검사 모델이 위험한 행동만 차단 | 긴 작업을 덜 끊기게 맡길 때(최신 버전 기본값) |
| dontAsk | 미리 허용 목록에 넣은 도구만, 나머지는 자동 거절 | 자동화·CI처럼 사람이 없는 환경 |
| bypassPermissions | 모든 것(보호 경로 제외) | 격리된 컨테이너·가상 머신에서만 |
🔎 쉽게 말하면: 권한 모드는 운전 연수의 단계와 비슷합니다. 처음엔 강사가 브레이크를 잡고(default), 익숙해지면 직진은 맡기고(acceptEdits), 고속도로는 보조 시스템이 위험할 때만 개입합니다(auto). 브레이크 없는 차(bypassPermissions)는 연습장(격리 환경)에서만 탑니다.
특정 명령만 늘 허락하고 싶다면 /permissions에서 규칙을 추가하거나, 설정 파일에 "allow": ["Bash(npm test)"]처럼 적습니다. 반대로 "deny"에 넣은 것은 어떤 모드에서도 막힙니다.
⚠️ 주의: 자동(auto) 모드의 안전 검사는 위험을 줄여 줄 뿐 완벽하지 않습니다. 비밀 정보가 있는 폴더나 실제 서버에 연결된 환경에서는 default 또는 acceptEdits로 확인하며 진행하는 것이 안전합니다.
🗺️ 클로드 코드 기능 3: 계획 모드로 먼저 생각하게 하기
공식 문서가 권하는 작업 순서는 탐색 → 계획 → 구현 → 커밋 네 단계입니다. 바로 “만들어 줘”라고 하면 클로드가 엉뚱한 문제를 푸는 일이 생기는데, 계획 모드는 이것을 막아 줍니다.
① 탐색 — 계획 모드로 전환 후 “로그인 관련 파일을 읽고 구조를 설명해 줘” — 수정 없이 읽기만
⬇
② 계획 — “구글 로그인을 추가하려면 어떤 파일을 바꿔야 하는지 계획을 세워 줘” — Ctrl+G로 계획서를 편집기에서 직접 고칠 수 있음
⬇
③ 구현 — 기본 또는 자동 모드로 바꾼 뒤 “계획대로 만들고 테스트까지 통과시켜 줘”
⬇
④ 저장 — “설명이 담긴 메시지로 커밋해 줘” — Git에 저장 지점이 생김
단, 오타 수정이나 한 줄 변경처럼 결과가 뻔한 작업은 계획 없이 바로 시켜도 됩니다. 공식 문서도 “변경 내용을 한 문장으로 설명할 수 있으면 계획을 건너뛰어도 된다”고 안내합니다.
⏪ 클로드 코드 기능 4: 체크포인트와 되돌리기
클로드가 파일을 고치기 전에는 자동으로 저장 지점(체크포인트)이 만들어집니다. Esc를 두 번 누르거나 /rewind를 입력하면 이전 시점 목록이 나오고, 대화만, 코드만, 또는 둘 다 되돌릴 수 있습니다. 같은 지점에서 다른 방법을 시도하고 싶을 때 특히 유용합니다.
| 되돌릴 수 있는 것 | 되돌릴 수 없는 것 |
|---|---|
| 클로드가 파일 편집 도구로 고친 내용 | Bash 명령으로 바뀐 파일(삭제·이동·설치 등) |
| 대화 흐름(해당 시점 이후 대화를 지움) | 데이터베이스·외부 서비스에 이미 보낸 변경 |
| 여러 번 이전 시점까지 선택 가능 | 다른 프로그램이 동시에 바꾼 파일 |
🔎 쉽게 말하면: 체크포인트는 게임의 ‘자동 저장’, Git은 ‘수동 저장 슬롯’입니다. 자동 저장만 믿다가 저장되지 않는 행동(명령 실행)을 하면 되돌릴 수 없으니, 중요한 단계마다 Git으로 수동 저장을 해 두는 것이 정석입니다.
🧠 클로드 코드 기능 5: 대화(컨텍스트) 관리
클로드가 한 번에 기억할 수 있는 대화량을 ‘컨텍스트 창’이라고 합니다. 공식 문서는 이것을 “가장 중요하게 관리해야 할 자원”이라고 부릅니다. 대화가 길어지면 앞부분 지시를 잊거나 실수가 늘고, 사용량도 빨리 줄어듭니다.
| 명령 | 하는 일 | 언제 |
|---|---|---|
/clear |
대화를 비우고 새로 시작(CLAUDE.md는 다시 읽음) | 다른 작업으로 넘어갈 때마다 |
/compact |
지금까지 대화를 요약해 압축. /compact API 변경 위주로처럼 무엇을 남길지 지정 가능 |
같은 작업을 계속하는데 대화가 길어졌을 때 |
/context |
컨텍스트 창을 무엇이 얼마나 차지하는지 표시 | 느려지거나 이상해졌을 때 원인 확인 |
/usage |
요금제 한도와 사용량 표시 | 한도가 걱정될 때 |
/btw |
대화 기록에 남기지 않는 짧은 곁가지 질문 | 작업 중 잠깐 궁금한 것을 물을 때 |
claude -c / -r |
이전 대화 이어 가기 | 다음 날 같은 작업을 계속할 때 |
💡 초보자 팁: 같은 실수를 두 번 이상 고쳐 달라고 했는데도 계속 틀리면, 대화를 이어 가지 말고 /clear 후 그동안 배운 점을 담아 처음부터 다시 요청하세요. 공식 문서가 권하는 방법이며, 대부분 더 빨리 끝납니다.
📎 기능 6: 파일·이미지·명령을 함께 주기
| 방법 | 예시 | 효과 |
|---|---|---|
| @파일 참조 | @src/login.js 이 파일의 오류를 찾아 줘 |
클로드가 해당 파일을 바로 읽음 |
| 이미지 붙여넣기 | 화면 캡처를 끌어다 놓거나 붙여넣기 | 디자인 시안·오류 화면을 보고 작업 |
| ! 명령 | !npm test |
대화창에서 직접 명령을 실행하고 결과를 클로드가 참고 |
| 주소 주기 | 문서 주소를 주고 “이 문서대로 설정해 줘” | 웹 문서를 읽어 반영 |
| 파이프 입력 | cat error.log | claude -p "원인 설명" |
로그를 바로 분석 |
📝 좋은 지시 vs 나쁜 지시
| 나쁜 지시 | 좋은 지시 |
|---|---|
| 로그인 고쳐 줘 | 로그인 후 세션이 끊기는 문제가 있어. src/auth/ 의 토큰 갱신 부분을 확인하고, 문제를 재현하는 테스트를 먼저 만든 뒤 고쳐 줘 |
| 테스트 추가해 줘 | foo.py에 로그아웃한 사용자 경우를 다루는 테스트를 추가해 줘. 가짜 객체(mock)는 쓰지 말고 |
| 예쁘게 만들어 줘 | 첨부한 시안 이미지대로 만들고, 결과를 캡처해서 시안과 다른 점을 목록으로 알려 준 뒤 고쳐 줘 |
| 왜 이상해? | 빌드가 이 오류로 실패해: [오류 붙여넣기]. 오류를 숨기지 말고 근본 원인을 고쳐 줘 |
공식 문서 ‘Best practices’의 예시를 한국어 상황에 맞게 옮겼습니다. 공통점은 ① 어디를 ② 무엇을 ③ 어떻게 확인할지를 말해 준다는 것입니다.
이렇게 사람의 판단을 기계에 맡기는 범위를 정하는 문제는 소프트웨어만의 이야기가 아닙니다. 로봇이 공장과 도로에서 스스로 움직이는 흐름은 피지컬 AI 관련 기업 지도와 가치 평가에서 다뤘는데, 권한을 얼마나 줄지에 대한 고민은 같은 구조입니다.
🌍 연결 지도: 작업 습관이 비용이 되는 구조
① 습관 — CLAUDE.md 정리, 작업마다 /clear, 계획 먼저
⬇
② 1차 효과 — 같은 설명 반복이 줄고, 엉뚱한 수정이 줄어듦
⬇
③ 2차 효과 — 토큰(사용량) 소비가 줄어 같은 요금제로 더 많은 일을 처리
⬇
④ 영향 — 개인은 한도 걱정 감소, 회사는 개발자당 AI 비용 관리
⬇
⑤ 생활 — 같은 월 구독료로 얻는 결과물의 양과 질이 달라짐
⚖️ 반대 의견과 위험 요인
‘자동’이 늘수록 검토가 줄어드는 위험이 있습니다. 자동 모드와 acceptEdits는 편하지만, 사람이 변경 내용을 읽지 않게 되는 습관을 만들 수 있습니다. 특히 결제, 개인정보, 배포 설정처럼 틀리면 비용이 큰 부분은 계획 모드로 먼저 확인하고 변경 내용을 직접 읽는 것이 좋습니다.
CLAUDE.md를 너무 길게 쓰는 실수도 흔합니다. 규칙이 많을수록 클로드가 모든 규칙을 고르게 지키기 어렵습니다. 공식 문서는 “이 줄을 지우면 클로드가 실수할까?”라고 물어보고, 아니라면 지우라고 권합니다.
✅ 클로드 코드 기능을 읽는 포인트
| 포인트 | 한 줄 설명 |
|---|---|
| CLAUDE.md는 짧고 구체적으로 | 200줄 이내, 코드만 봐서는 모르는 규칙만 |
| 모드는 상황에 맞춰 바꾸기 | 탐색은 plan, 구현은 auto·acceptEdits, 위험 작업은 default |
| 계획 → 구현 순서 | 여러 파일을 바꾸는 일일수록 계획이 시간을 아낌 |
| 되돌리기는 두 겹 | 체크포인트(자동) + Git(수동) |
| 대화는 작업 단위로 | 작업이 바뀌면 /clear, 길어지면 /compact |
📘 함께 알면 좋은 용어
컨텍스트 창(Context window): AI가 한 번에 기억하며 참고할 수 있는 대화·파일의 양. 가득 차면 오래된 내용이 요약되거나 밀려납니다.
체크포인트(Checkpoint): 클로드가 파일을 고치기 전 자동으로 만드는 저장 지점. Esc 두 번이나 /rewind로 돌아갑니다.
커밋(Commit): Git에 ‘이 시점의 파일 상태’를 설명과 함께 저장하는 것. 언제든 이 시점으로 돌아올 수 있습니다.
❓ 자주 묻는 질문
Q1. CLAUDE.md는 꼭 만들어야 하나요?
필수는 아니지만 권장됩니다. 프로젝트 폴더에서 /init을 입력하면 클로드가 초안을 만들어 주므로, 핵심 명령과 규칙만 남기고 200줄 이내로 다듬으면 됩니다.
Q2. 클로드 코드 권한 모드는 어떻게 바꾸나요?
실행 중 Shift+Tab을 누르면 기본, 자동 편집 허용, 계획 모드 등이 차례로 바뀝니다. 시작할 때 claude --permission-mode plan처럼 지정할 수도 있습니다.
Q3. 클로드가 잘못 고친 코드를 되돌릴 수 있나요?
Esc를 두 번 누르거나 /rewind를 입력하면 이전 시점으로 코드와 대화를 되돌릴 수 있습니다. 다만 명령 실행으로 바뀐 파일은 기록되지 않으므로 Git 커밋을 함께 쓰는 것이 안전합니다.
➡️ 3편 예고: 반복 업무를 버튼 하나로 만드는 스킬, 일을 나눠 맡기는 서브에이전트, 자동 검사 훅, 외부 서비스와 연결하는 MCP, 묶음 설치 플러그인, 그리고 사람 없이 돌아가는 자동화(GitHub Actions·Agent SDK)까지 고급 기능을 정리합니다.
📚 함께 읽으면 좋은 글
- 스페이스X 3분기 실적으로 본 AI 연산 돈의 흐름 — 클로드 코드의 사용량 한도와 요금 뒤에는 막대한 AI 연산 비용이 있습니다. 그 비용이 누구에게 흘러가는지 함께 보면 요금 구조가 이해됩니다.
참고 자료
Claude Code 공식 문서 – 메모리(CLAUDE.md) · Claude Code 공식 문서 – 권한 모드 · Claude Code 공식 문서 – 모범 사례 · Claude Code 공식 문서 – 명령어 목록 · Claude Code 공식 문서 – 비용과 컨텍스트 관리
⚠️ 이 글은 2026년 10월 기준 Anthropic 공식 문서와 공개 보도를 바탕으로 정리한 정보 제공용 콘텐츠입니다. 기능·요금·명령어는 업데이트로 바뀔 수 있으니 실제 사용 전 공식 문서를 확인하세요. 특정 상품의 구매나 투자를 권유하지 않습니다.