나의 노트

Claude Code 프롬프트 구성

검증 기준: 2026-02-12 수치(토큰/줄 수/단어 수/컷오프)는 문서/리포지토리 업데이트에 따라 변동될 수 있음.

Claude Code는 단일 프롬프트가 아닌 110개 이상의 모듈형 컴포넌트를 환경과 설정에 따라 동적으로 조합한다. 2026.02.10 측정 기준(/context, MCP 미사용), 시스템 프롬프트+도구 정의가 ~20.5K 토큰이었으며 그 중 도구 정의(~16.7K)가 대부분을 차지했다. 이 수치는 버전·설정에 따라 변동한다.

주요 구성 요소 (조합 순서)

순서구성 요소설명
0모델 기초 프롬프트 (추정 수천 토큰)Anthropic이 모델에 내장한 기본 지시 (안전, 톤, 정체성 등)
1메인 시스템 프롬프트Claude Code의 핵심 정체성. 변수(${SECURITY_POLICY} 등) 확장 포함
2환경별 조건 섹션로컬/클라우드 등 실행 환경에 따라 추가
3도구 정의 (공개 아카이브 기준 18개 내장 도구)Write, Bash, Read, Edit, Glob, Grep 등 각 도구의 사용법. 버전마다 변동
4시스템 리마인더 (~40개)상태 변화에 따라 삽입되는 컨텍스트 지시
5CLAUDE.md 지시사항3단계 스코프에서 로드
6MCP 도구 정의연결된 MCP 서버의 도구들 (컨텍스트 비용 큼)
7대화 히스토리메시지, 도구 결과, 파일 내용 등
8출력 스타일/커스텀 지시포맷팅, 톤 설정

CLAUDE.md 로드 스코프 (우선순위 순)

  1. Managed — 기업 정책 (오버라이드 불가)
  2. CLI 인자 — --append-system-prompt 등
  3. Local — .claude/*.local.* (개인 프로젝트 설정)
  4. Project — .claude/CLAUDE.md (팀 공유)
  5. User — ~/.claude/CLAUDE.md (전역 개인 설정)

컨텍스트 관리

컨텍스트 윈도우가 한계에 가까워지면 자동으로:

주의도 유지 순서 (추정)

가장 잘 유지됨
  ↑ 0. 모델 기초 프롬프트    — 모델 자체에 내재화 + 컨텍스트 최상단
  │ 1. 메인 시스템 프롬프트   — system role, 최상단
  │ 2. 환경별 조건 섹션      — 시스템 프롬프트와 함께 상단 배치
  │ 3. 도구 정의            — 매 호출마다 참조
  │ 4. 시스템 리마인더       — 대화 중간에 반복 주입 (recency 효과)
  │ 8. 출력 스타일/커스텀 지시 — 시스템 레벨 설정
  │ 5. CLAUDE.md           — 보존되지만 중간 위치
  │ 6. MCP 도구 정의        — 외부 서버 의존, 컨텍스트 비용 큼
  │ 7. 대화 히스토리         — compaction 시 요약됨
  ↓    오래된 도구 출력      — 가장 먼저 제거됨
가장 먼저 까먹음

서브에이전트 (Task)

서브에이전트는 별도의 컨텍스트 윈도우를 받으며, Plan/Explore/Bash 등 에이전트 유형별로 전용 시스템 프롬프트가 추가된다.

모델 기초 프롬프트 (Model System Prompt)

Claude Code 프롬프트와 별개로, Anthropic이 모델 자체에 내장하는 기초 시스템 프롬프트가 존재한다. claude.ai, API, Claude Code 등 어떤 인터페이스에서든 동일하게 적용된다.

프롬프트 2겹 구조

[모델 기초 프롬프트]  ← Anthropic이 모델에 내장 (claude.ai에서도 동일)
  └─ [Claude Code 프롬프트]  ← Claude Code 전용 (110개+ 모듈 조합)

모델 기초 프롬프트 주요 내용

모델별 차이

모델지식 커트오프
Opus 4.62025년 5월
Sonnet 4.5출처 버전별 표기 상이 (재확인 필요)
Haiku 4.52025년 1월

토큰 규모 추정

실측 비교 (2026.02.10)

각 CLI의 내장 토큰 사용량 명령으로 측정했다.

제품시스템 프롬프트+도구컨텍스트 윈도우점유율측정 방법
Claude Code~20.5K200K10.3%/context
Codex CLI~8.6K258K3.3%/status
Claude Chat (claude.ai)~24K——외부 측정 (HN)

출처