anti-patterns

안티패턴 — Claude Code 하네스 내부

1. CLAUDE.md를 위키처럼 쓰기

“우리 팀 컨벤션 50페이지를 다 적어 두자.” 시스템 프롬프트에 매번 들어가 비용·집중도 양쪽이 망가진다. 핵심 디렉티브만 두고 상세는 별도 파일+Read로 끌어 쓰게 한다.

2. 유출된 시스템 프롬프트를 그대로 복붙

빌드마다 바뀌고, 라이선스가 모호하다. 구조만 학습하고 자기 프롬프트는 자기 도메인에 맞게 새로 쓴다.

3. MCP 도구 폭주

“있는 서버는 다 등록하자.” 도구 카탈로그가 부풀면 토큰·정확도 양쪽 손해. 프로젝트별로 필요한 것만 켠다.

4. --debug 한 번도 안 보고 디버깅

짐작으로 프롬프트를 고친다. 30분만 raw 메시지 흐름을 봐도 문제의 절반은 “도구 결과 형식”에 있음을 깨닫는다.