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

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

Anthropic 내부용으로 추정되는 엄격한 코딩 지침을 기반으로 Claude의 성능과 정확도를 극대화하는 CLAUDE.md 설정 공유

배경

Anthropic의 Claude Code 소스 코드 분석을 통해 직원 전용 플래그(USER_TYPE='ant') 뒤에 숨겨진 엄격한 검증 및 컨텍스트 관리 규칙이 발견되었으며, 이를 일반 사용자가 활용할 수 있도록 개선한 CLAUDE.md 파일이 공유되었다.

의미 / 영향

이 토론을 통해 Anthropic 내부의 개발 표준이 일반 상용 서비스보다 훨씬 엄격하다는 점이 확인됐다. 사용자가 직접 CLAUDE.md를 통해 엄격한 제약 조건을 부여함으로써 모델의 고유한 성능을 더 끌어낼 수 있다는 실무적 합의가 형성됐다.

커뮤니티 반응

Anthropic이 내부적으로 더 나은 모델 성능을 숨기고 있었다는 사실에 놀라워하며, 공유된 CLAUDE.md 설정이 실제 코딩 작업의 질을 높여준다는 긍정적인 반응이 주를 이룬다.

주요 논점

01찬성다수

Anthropic 내부 지침을 모방한 엄격한 규칙이 Claude의 코딩 정확도를 눈에 띄게 향상시킨다.

02중립소수

내부 플래그의 존재는 흥미로우나, 프롬프트 지침만으로 실제 내부 모델의 동작을 완전히 재현할 수 있는지는 의문이다.

합의점 vs 논쟁점

합의점

Claude는 컨텍스트가 길어질수록 게을러지거나 정보를 누락하는 경향이 있다.
작업을 작은 단위로 나누고 실제 린트 도구로 검증하는 것이 AI 코딩의 신뢰성을 높이는 핵심이다.

논쟁점

Anthropic이 의도적으로 일반 사용자에게 성능이 낮은(더 게으른) 규칙을 제공하고 있는지에 대한 논란

실용적 조언

프로젝트 루트에 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의 도구 사용 한계를 보완하는 지침을 담고 있다.

실무 Takeaway

Anthropic 내부에서는 Claude의 성능을 높이기 위해 일반 사용자보다 훨씬 엄격한 검증 및 컨텍스트 관리 규칙을 사용한다.
CLAUDE.md에 'Step 0(데드 코드 제거)'와 'Phased Execution(단계적 실행)' 규칙을 추가하면 대규모 리팩터링 시 발생하는 컨텍스트 압축 문제를 완화할 수 있다.
단순한 프롬프트 대신 npx tsc 등 실제 검증 도구 실행을 강제함으로써 Claude의 '완료했다'는 거짓 보고를 방지할 수 있다.
대형 파일 처리 시 2,000라인 단위의 읽기 제한과 도구 출력 생략 가능성을 명시하여 AI의 정보 누락 오류를 줄일 수 있다.

언급된 도구

Claude Code추천

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

npx tsc추천

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

eslint추천

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

언급된 리소스

문서Original Leaked Thread on X