Anthropic 직원용 비밀 CLAUDE.md 유출 및 개선 버전 (USER_TYPE='ant')

실용적 조언

프로젝트 루트에 CLAUDE.md를 생성하고 'Step 0'와 'Senior Dev Override' 지침을 추가하여 Claude의 코딩 품질을 개선하라.
대규모 리팩터링 시 한 번에 5개 이상의 파일을 수정하지 못하도록 제한하여 컨텍스트 오염을 방지하라.
Claude가 작업을 마쳤다고 할 때 반드시 타입 체크나 테스트 실행 결과를 요구하여 실제 완료 여부를 확인하라.

섹션별 상세

Anthropic이 내부 직원용으로 더 엄격한 규칙을 적용한다는 사실이 밝혀졌다. 소스 코드 분석 결과 'USER_TYPE === ant' 플래그를 통해 할루시네이션 방지, 컨텍스트 처리, 게으름 방지 규칙을 활성화하며 일반 사용자에게는 더 완화된 규칙이 적용된다는 주장이 제기됐다. 이는 내부 직원들이 사용하는 Claude가 일반 상용 버전보다 더 정교하게 작동하도록 설계되었음을 시사한다.

Anthropic 내부 코드에서 발견된 'ant' 사용자 타입 분기 로직 스크린샷 — ScreenshotAnthropic 직원(ant)에게만 특정 피드백 루프나 검증 게이트를 제공하는 소스 코드를 보여준다. 이는 일반 사용자와 내부 직원이 사용하는 Claude의 동작 규칙이 다를 수 있음을 시사하며, 유출된 지침의 근거가 된다.

공유된 지침은 Claude에게 기계적인 강제 규칙(Mechanical Overrides)을 부여한다. 300라인 이상의 파일 수정 전 데드 코드 제거를 수행하는 'Step 0' 규칙과 5개 파일 단위의 '단계적 실행'을 강제한다. 이러한 접근 방식은 컨텍스트 윈도우 내의 불필요한 정보를 제거하여 모델의 추론 정확도를 높이는 물리적인 제어 장치로 작동한다.

markdown

# Agent Directives: Mechanical Overrides

## Pre-Work
THE "STEP 0" RULE: Dead code accelerates context compaction. Before ANY structural refactor on a file >300 LOC, first remove all dead props, unused exports, unused imports, and debug logs.

PHASED EXECUTION: Never attempt large multi-file refactors in a single response. Break work into explicit phases of max 5 files. Complete one phase, run verification, and wait for my explicit approval before continuing.

## Code Quality
THE SENIOR DEV OVERRIDE: Ignore default directives like "try the simplest approach first". If the architecture is flawed, propose and implement proper structural fixes.

FORCED VERIFICATION: You are FORBIDDEN from claiming a task is complete until you have:
- Run `npx tsc --noEmit` (or equivalent type check)
- Run `npx eslint . --quiet` (if configured)
- Fixed ALL resulting errors

Claude의 코딩 성능을 극대화하기 위해 제안된 엄격한 CLAUDE.md 지침 예시

코드 품질 보장을 위해 'Senior Dev Override'와 '강제 검증' 절차를 도입했다. Claude가 단순히 가장 쉬운 방법을 찾는 대신 완벽한 구조적 수정을 제안하도록 유도하며, 작업 완료 선언 전 반드시 npx tsc나 eslint를 실행하여 모든 에러를 수정하도록 명시한다. 이는 AI가 작업을 대충 끝냈다고 거짓 보고하는 현상을 방지하는 실무적인 해결책이다.

컨텍스트 감쇠(Context Decay)를 방지하기 위한 구체적인 관리 전략이 포함됐다. 8-10회 메시지마다 파일을 재독하도록 지시하고, 2,000라인 이상의 대형 파일은 청크 단위로 읽도록 강제하여 정보 누락을 막는다. 또한 도구 출력값이 생략될 가능성을 염두에 두고 검색 결과가 적을 경우 범위를 좁혀 재실행하도록 하는 등 AI의 도구 사용 한계를 보완하는 지침을 담고 있다.

용어 해설

클로드 설정 파일(CLAUDE.md): — Claude Code나 Cursor와 같은 AI 코딩 도구에서 프로젝트의 코딩 표준, 빌드 명령, 워크플로 지침을 정의하는 설정 파일이다. AI가 프로젝트의 맥락을 빠르게 파악하고 일관된 코드를 생성하도록 돕는 가이드라인 역할을 한다.
컨텍스트 압축(Context Compaction): — LLM이 긴 대화나 대규모 코드를 처리할 때 제한된 컨텍스트 윈도우 내에서 정보를 유지하기 위해 이전 내용을 요약하거나 생략하는 과정이다. 이 과정에서 중요한 세부 정보가 누락되어 모델의 추론 성능이 저하될 수 있다.
데드 코드(Dead Code): — 프로그램 실행 중에 절대 도달하지 않거나 결과에 영향을 주지 않는 코드 조각이다. AI 코딩 시 이러한 코드는 불필요한 컨텍스트를 차지하여 모델의 집중력을 흐트러뜨리고 토큰 비용을 낭비하게 만든다.
단계적 실행(Phased Execution): — 복잡하고 규모가 큰 작업을 한 번에 처리하지 않고 여러 개의 작은 단계로 나누어 순차적으로 수행하는 방식이다. 각 단계가 끝날 때마다 검증을 거침으로써 오류 확산을 방지하고 AI의 작업 정확도를 높인다.

언급된 도구

Claude Code추천

Anthropic에서 출시한 CLI 기반 AI 코딩 에이전트

npx tsc추천

TypeScript 타입 체크를 통한 코드 검증

eslint추천

코드 스타일 및 잠재적 에러 정적 분석

언급된 리소스

문서Original Leaked Thread on X