03-실전

03. 실전 — 회피와 대응 절차

함정 1 — 권한 우회: 회피 절차

예방 (1회 셋업, 5분):

1. 첫 세션 전에 샌드박싱(Sandboxing) 옵션을 활성화한다(자세한 절차는 Part 5/03).
2. settings.json에 hooks를 등록해 다음 패턴을 사전 차단:
   • rm -rf /
   • rm -rf ~
   • rm -rf $HOME
   • git push --force (main/master 대상)
3. 첫 세션을 회사 메인 리포가 아닌 throwaway 폴더에서 한다.

대응 (사고 발생 시):

1. 즉시 세션 종료(Ctrl+C → /exit).
2. git reflog로 복구 시도.
3. 백업이 있다면 복원.
4. Postmortem 작성(03-실전 마지막 섹션).

함정 2 — 비용 폭주: 회피 절차

예방:

1. Anthropic Console 또는 사용 중인 백엔드의 **사용량 알림(Usage Alerts)**을 일일 한도로 설정한다.
2. 24시간 무인 실행은 처음 한 달 동안 금지(매뉴얼 룰).
3. 한 세션에 코드베이스 전체를 올리지 않는다 — 필요한 파일만 명시적으로 지정.
4. Cloud scheduled tasks를 쓸 때는 일일 실행 횟수에 상한을 둔다.

대응:

1. 청구서가 예상보다 크다면 즉시 API 키를 회수(rotate)한다.
2. 어느 작업이 비용을 만들었는지 로그/대시보드에서 추적.
3. 사내 비용 관리 채널에 보고.

함정 3 — 자동 갱신 표류: 회피 절차

예방:

1. Anthropic의 changelog/공식 블로그를 RSS 또는 사내 슬랙 채널로 구독.
2. 팀 단위로 “이번 주 Claude Code가 바뀐 것” 5분 공유 회의(주 1회).
3. 핵심 워크플로우는 버전을 명시한 스크립트로 고정.

대응 (“어제는 됐는데” 발생 시):

1. claude --version으로 현재 버전 확인.
2. 동료의 버전과 비교.
3. changelog에서 해당 버전 변경 사항 검색.
4. 한국어 트러블슈팅 자료 1순위: sources/21-korean-resources/blogs/brunch-joypinkgom-claude-code-update-troubleshooting.md.

함정 4 — 컨텍스트 폭주: 회피 절차

예방:

1. 한 세션 = 한 작업. 작업이 끝나면 세션을 닫는다.
2. 한 세션이 1시간을 넘기면 의식적으로 끊는다.
3. /compact 명령으로 컨텍스트를 압축한다(Part 5/09).
4. 큰 코드베이스에서는 작업 폴더 단위로 cd해서 들어간다.

대응 (응답이 흐려질 때):

1. 세션을 종료하고 새 세션을 시작.
2. 새 세션 첫 입력에 INTENT.md와 직전 작업 요약을 직접 붙여 넣는다.
3. 같은 질문에 답이 달라진 경우, 어느 답이 맞는지 분리된 모델/사람에게 검증.

함정 5 — 자기 검증: 회피 절차

예방:

1. 모든 변경은 PR로. 1줄 변경도 예외 없음.
2. PR마다 분리된 reviewer(다른 모델/세션/사람)를 지정.
3. 사내에 reviewer 에이전트를 만들 수 있다면 PR 자동 검토 hook 설정(Part 5/07, Part 7).

대응 (이미 자기 검증으로 머지된 변경 발견 시):

1. 사후라도 분리된 검증을 1회 추가 실행.
2. 발견된 문제는 후속 PR로 수정.
3. Postmortem에 “자기 검증으로 머지” 항목을 명시.

포스트모템(Postmortem) 최소 양식

사고가 났을 때 다음 5줄을 적는다. 더 적지 말고 덜 적지 말고 정확히 5줄.

# Postmortem — <한 줄 제목>
시각: 2026-04-07
함정: <1~5 중 하나>
신호 (놓친 것): ...
즉시 대응: ...
재발 방지 (1개): ...

이 5줄을 사내 채널에 공유하면 다음 사람이 같은 함정을 피한다. 위키의 wiki/cases/ 트리에 등록되면 합의의 일부가 된다.