lucas-flatwhite/claude-code-system-prompts
151 stars · Last commit 2026-03-31
Comprehensive analysis and documentation of Claude Code’s internal prompt architecture and multi-agent reasoning system.
README preview
# Claude Code 시스템 프롬프트 **Claude Code**의 내부 프롬프트 아키텍처와 에이전트 동작 방식을 문서화한 독립 연구 프로젝트입니다. Claude Code는 Anthropic의 AI 기반 소프트웨어 엔지니어링 어시스턴트입니다. 이 문서는 동작 분석, 출력 관찰, 공개 토론 자료 조사를 바탕으로 작성되었습니다. 현대의 에이전트형 AI 코딩 어시스턴트가 어떻게 설계되는지 이해하기 위한 교육 자료로 활용할 수 있습니다. ## 개요 Claude Code는 정교한 다층 프롬프트 아키텍처를 사용합니다. 메인 시스템 프롬프트는 고정 문자열이 아니라, 모듈식 섹션 빌더(section-builder) 함수들을 통해 런타임에 동적으로 조립됩니다. 경계 마커가 전역 캐시 가능한 접두부(prefix)와 세션별 접미부(suffix)를 구분해 주며, 이를 통해 API 호출 전반에서 프롬프트 캐싱이 가능합니다. 핵심 정체성 프롬프트 외에도, 이 시스템에는 특수 에이전트 프롬프트, 멀티 워커 조정자(coordinator), Tool 호출 자동 승인을 위한 2단계 보안 분류기, 그리고 메모리 선택, 세션 검색, Tool 사용 요약을 위한 각종 유틸리티 프롬프트가 포함됩니다. ## 프롬프트 카탈로그 ### 핵심 정체성 | # | 프롬프트 | 설명 | |---|--------|-------------| | 01 | [메인 시스템 프롬프트](prompts/01_main_system_prompt.md) | 정체성, 동작, Tool 사용 지침, 톤, 효율성 전반을 다루는 동적 조립형 마스터 프롬프트 | | 02 | [Simple Mode](prompts/02_simple_mode.md) | `CLAUDE_CODE_SIMPLE`로 활성화되는 최소 4줄 프롬프트 |