Claude Code 운영 가이드: Plan Mode·CLAUDE.md·테스트를 분리하는 법

AI좌표 편집 이미지 · 기준일 2026-07-13

Claude Code를 안전하게 쓰는 핵심은 좋은 프롬프트 하나가 아니라 계획 → 규칙 확인 → 제한된 구현 → 테스트와 diff 검토를 분리하는 것입니다.

이 글은 실제 저장소에서 성공률을 측정한 후기가 아닙니다. 2026년 7월 13일 공식 문서와 독립 연구를 바탕으로 만든 첫 실행 운영안입니다.

세 기능의 역할

요소	맡길 일	맡기지 않을 일
Plan Mode	구조 탐색, 영향 범위, 구현 계획	승인 전 소스 수정
`CLAUDE.md`	빌드·테스트 명령, 구조, 관례, 금지 범위	이번 작업의 긴 대화와 임시 메모 전부
테스트·diff	요구사항, 회귀, 변경 범위 확인	모델이 쓴 테스트의 무조건 승인

Plan Mode는 코드를 수정하지 않고 접근 방식을 검토합니다. Accept Edits는 파일 편집 승인을 넓히지만 모든 행동을 자동 승인하지는 않습니다.

Claude Code 운영 가이드: Plan Mode·CLAUDE.md·테스트를 분리하는 법 관련 공식 실제 화면

실제 공식 화면 캡처 · 출처는 본문 참고 · 2026-07-13

CLAUDE.md에는 실행 가능한 규칙만

# Project commands
- Install: npm ci
- Test: npm test
- Lint: npm run lint

# Scope
- src/와 tests/만 수정
- migrations/와 배포 설정은 사전 승인 없이 수정 금지

# Done
- 기존 테스트 통과
- 새 동작의 회귀 테스트 추가
- 변경 파일과 남은 위험 보고

명령은 실제 저장소에서 동작하는 것만 넣고 비밀키·고객 데이터·개인 경로는 적지 않습니다.

Claude Code 운영 가이드: Plan Mode·CLAUDE.md·테스트를 분리하는 법 실행 순서

AI좌표 실행 순서 도식 · 2026-07-13

첫 작업을 여섯 단계로

작은 작업 하나를 고르고 현재 브랜치와 변경 상태를 확인합니다.
Plan Mode에서 읽을 파일, 바꿀 파일, 테스트, 복구 방법을 포함한 계획을 요청합니다.
범위를 벗어난 파일·새 의존성·데이터 변경을 사람이 제거하거나 승인합니다.
승인한 파일만 수정하게 하고 위험한 명령은 별도 확인합니다.
기존 테스트와 린트를 실행하고 실패 로그를 남깁니다.
최종 diff에서 테스트가 요구사항을 약하게 바꾸지 않았는지 확인합니다.

독립 연구는 사람의 결정권과 파일 기반 정책을 중요한 설계 축으로 분석합니다. 또 테스트 수보다 명시적 사양에 근거한 테스트가 중요하다고 보고했습니다.

공개 저장소·업무 코드 체크리스트

작업 전 git status와 되돌릴 기준점을 확인합니다.
요구사항과 완료 조건을 사람이 먼저 씁니다.
계획에 변경 파일·테스트·복구 방법이 있는지 봅니다.
API 키, .env, 고객 정보가 로그에 들어가지 않게 합니다.
테스트 삭제·완화·skip 추가는 별도 검토합니다.
자동 커밋·푸시·배포는 처음부터 허용하지 않습니다.

실전 튜토리얼로 확장하려면 폐기 가능한 저장소에서 명령, 권한, 실패, 복구 시간을 기록한 실행 로그가 필요합니다.

Claude Code 운영 가이드: Plan Mode·CLAUDE.md·테스트를 분리하는 법