긴 선호 목록만으로 Claude Code가 예측 가능해지지는 않습니다. 쓸모 있는 규칙은 허용된 변경, 경계와 증거를 파일, diff, 명령과 종료 코드로 정의합니다.

작은 계약


# Project rules

Goal

Keep changes limited to the requested feature.

Checks

Run npm test and report the command, exit code, and changed files.

Forbidden

Do not read .env or run deploy.

Scope

packages/payments/CLAUDE.md wins only inside that directory.
Root security rules always apply.



“좋은 코드를 작성하라”는 검증할 수 없습니다. “`npm test`를 실행하고 명령, 종료 코드와 변경 경로를 보고하라”는 확인할 수 있습니다.

비밀 정보와 충돌

API Key, CI token, 실제 개인정보를 CLAUDE.md에 쓰지 마세요. placeholder를 사용하고 필요한 값은 환경 변수나 CI secret store로 전달합니다. 공통 규칙은 root에, package 규칙은 package 근처에 둡니다. 로컬 예외가 전역 security 규칙을 취소해서는 안 됩니다.

되돌릴 수 있는 테스트

한 test file의 local variable 하나만 바꾸게 합니다.
git diff --check와 git diff --stat를 확인합니다.
계약에 적힌 test command를 실행합니다.
다른 file이 바뀌거나 command와 종료 코드가 없으면 결과를 거부합니다.

Claude Code API의 Base URL과 model은 BetterToken 문서에서 확인하세요.

Claude Code용 CLAUDE.md: 검증 가능한 규칙