Claude Code 설정을 가볍고 안전하게 유지하는 30가지 원칙

Claude Code를 잘 쓰려면 설정을 많이 넣는 것보다 꼭 필요한 정보만 넣는 편이 낫다. 긴 CLAUDE.md는 매번 읽히기 때문에 비용이 크고, 중요한 규칙도 배경처럼 묻힐 수 있다. 각 줄은 “이 줄이 없으면 Claude가 실제로 실수할까?”라는 기준으로 남기고, 자주 바뀌는 상태 정보는 CLAUDE.md가 아니라 따로 갱신되는 곳에 두는 것이 좋다.

반복되는 실수는 말로만 금지하기보다 훅, 권한 제한, 파일 접근 제한처럼 구조로 막아야 한다. 단순 실행은 스크립트가 맡고, 상황 판단이 필요한 일만 에이전트나 스킬에 맡겨야 비용과 품질을 함께 관리할 수 있다. 위험한 작업은 기본적으로 막되, 되돌릴 수 있는 실수는 관찰해서 더 나은 규칙으로 바꾸는 편이 낫다.

빌더, 평가자, 조정자처럼 역할을 나누면 한 에이전트가 자기 작업을 스스로 후하게 평가하는 문제를 줄일 수 있다. 메모리는 자동으로 쌓이면서 낡을 수 있으므로, 오래가는 사실과 곧 틀릴 수 있는 상태 정보를 구분하고 정기적으로 정리해야 한다. 모델이 좋아질 때마다 예전 실수를 막기 위해 만든 규칙도 다시 점검해야 한다.