Piebald-AI/claude-code-system-prompts

팁

새로운 소식 (2026년 6월 12일): Claude Code의 프롬프트(prompts)를 대폭 확장하여—350개에서 515개로 (+165개)—역대 가장 완벽한 범위를 확보했습니다.

이 저장소(repository)는 Claude Code v2.1.191 (2026년 6월 24일) 기준, Claude Code의 모든 다양한 시스템 프롬프트(system prompts)와 그에 따른 토큰 수(token counts)의 최신 목록을 포함하고 있습니다. 또한 v2.0.14 이후 219개 버전에 걸친 시스템 프롬프트의 CHANGELOG.md를 포함하고 있습니다. 이 프로젝트는 다음 팀에서 제작했습니다:

Piebald.

이 저장소는 각 Claude Code 릴리스(release) 직후 몇 분 이내에 업데이트됩니다. 변경 사항(changelog)을 확인하고, X(구 Twitter)에서 @PiebaldAI를 팔로우하여 각 릴리스의 시스템 프롬프트 변경 요약 내용을 확인하세요.

참고

⭐ 새로운 Claude Code 버전에 대한 알림을 받으려면 이 저장소를 Star 하세요. 새로운 Claude Code 버전이 나올 때마다 GitHub에 릴리스를 생성하며, 이는 저장소를 Star 한 모든 사용자에게 알림을 보냅니다.

왜 여러 개의 "시스템 프롬프트(system prompts)"가 존재하나요?

Claude Code는 시스템 프롬프트로 단 하나의 문자열(string)만 사용하는 것이 아닙니다.

대신 다음과 같은 요소들이 존재합니다:

• 환경 및 다양한 설정(configs)에 따라 조건부로 추가되는 방대한 부분들.
• Write, Bash, TodoWrite와 같은 내장 도구(builtin tools)에 대한 설명이며, 일부는 상당히 큽니다.
• Explore 및 Plan과 같은 내장 에이전트(builtin agents)를 위한 별도의 시스템 프롬프트.
• 대화 압축(conversation compaction), CLAUDE.md 생성, 세션 제목 생성 등 고유의 시스템 프롬프트를 특징으로 하는 수많은 AI 기반 유틸리티 함수(utility functions).

그 결과—매우 큰 축소된(minified) JS 파일 내에서 끊임없이 변화하고 이동하는 500개 이상의 문자열이 존재합니다.

중요

본인의 Claude Code 설치 환경에서 특정 시스템 프롬프트 조각을 수정하고 싶으신가요? tweakcc를 사용하세요. 이 도구는—

• 시스템 프롬프트의 개별 조각들을 마크다운(markdown) 파일로 커스텀할 수 있게 해주며,
• 이를 통해 사용자의 npm 기반 또는 네이티브(binary) Claude Code 설치 환경에 패치(patches)를 적용하고,
• 사용자와 Anthropic이 동일한 프롬프트 파일에 대해 서로 충돌하는 수정 사항을 가질 경우, 차이점 비교(diffing) 및 충돌 관리(conflict management) 기능을 제공합니다.

이 저장소(repository)는 Claude Code의 최신 npm 버전에서 스크립트를 사용하여 추출한 시스템 프롬프트(system prompts)를 포함하고 있습니다. 이 프롬프트들은 Claude Code의 컴파일된 소스 코드에서 직접 추출되었으므로, Claude Code가 실제로 사용하는 것과 정확히 일치함이 보장됩니다. 만약 시스템 프롬프트를 맞춤 설정하기 위해 tweakcc를 사용한다면, 이와 유사한 방식으로 작동합니다. 즉, 이 저장소로 추출된 것과 동일한 문자열을 사용자의 로컬 설치 환경에서 패치(patch)합니다.

일부 프롬프트에는 내장 도구 이름(builtin tool name) 참조, 사용 가능한 서브 에이전트(sub agents) 목록, 그리고 기타 다양한 컨텍스트 특정 변수(context-specific variables)와 같은 보간된 부분(interpolated bits)이 포함되어 있다는 점에 유의하세요. 따라서 특정 Claude Code 세션에서의 실제 토큰 수는 약간 다를 수 있지만, 아마도 ±20 토큰 범위를 벗어나지는 않을 것입니다.

서브 에이전트(Sub-agents) 및 유틸리티(utilities).

• 에이전트 프롬프트: Explore (871tks) - Explore 서브 에이전트를 위한 시스템 프롬프트.

• 에이전트 프롬프트: Plan mode (enhanced) (715tks) - Plan 서브 에이전트를 위한 강화된 프롬프트.

• 에이전트 프롬프트: Agent creation architect (1110tks) - 상세 사양을 가진 커스텀 AI 에이전트를 생성하기 위한 시스템 프롬프트.

• 에이전트 프롬프트: CLAUDE.md creation (513tks) - 코드베이스를 분석하고 CLAUDE.md 문서 파일을 생성하기 위한 시스템 프롬프트.

• 에이전트 프롬프트: Status line setup (2433tks) - 상태 표시줄(status line) 표시를 구성하는 statusline-setup 에이전트를 위한 시스템 프롬프트.

• 에이전트 프롬프트 (Agent Prompt): /batch 슬래시 명령어 (slash command) (
  1106tks) - 코드베이스 전반에 걸쳐 대규모의 병렬화 가능한 변경 사항을 조율하기 위한 지침.

• 에이전트 프롬프트 (Agent Prompt): /code-review 파트 1 기본 탐색 관점 (base finder angles) (
  145tks) - /code-review 슬래시 명령어의 탐색 관점 (finder-angle) 단계에서 수행하는 라인 단위 차이점(diff) 스캔 지침.

• 에이전트 프롬프트 (Agent Prompt): /code-review 파트 2 저노력 모드 (low effort mode) (
  345tks) - 차이점(diff)을 한 번 읽고 최대 4개의 덩어리(hunk) 가시적 런타임 정확성 발견 사항을 반환하는 저노력(low-effort) /code-review 프롬프트.

• 에이전트 프롬프트 (Agent Prompt): /code-review 파트 3 초고노력 및 최대노력 모드 (extra-high and maximum effort modes) (
  0tks) - 5개의 탐색 관점(finder angles), 단일 투표 검증(one-vote verification), 갭 스윕(gap sweep), 그리고 제한된 JSON 발견 사항을 실행하는 초고노력(extra-high) 및 최대노력(maximum-effort) /code-review 프롬프트.

• 에이전트 프롬프트 (Agent Prompt): /code-review 파트 4 3단계 검증 단계 (three-state verification phase) (
  98tks) - 하나의 에이전트 검증기(verifier)가 각 후보를 확인됨(confirmed), 그럴듯함(plausible), 또는 반박됨(refuted)으로 분류하도록 요청하는 /code-review 검증 단계.

• 에이전트 프롬프트 (Agent Prompt): /code-review 파트 5 재현율 편향 검증 단계 (recall-biased verification phase) (
  175tks) - 코드가 반박하지 않는 한 현실적인 불확실한 발견 사항을 그럴듯함(plausible)으로 취급하는 재현율 편향(recall-biased) /code-review 검증 단계.

• 에이전트 프롬프트 (Agent Prompt): /code-review 파트 6 중간노력 모드 (medium effort mode) (
  0tks) - 3개의 탐색 관점(finder angles), 단일 투표 검증(one-vote verification), 그리고 최대 8개의 JSON 발견 사항을 통해 정밀도(precision)를 우선시하는 중간노력(medium-effort) /code-review 프롬프트.

• 에이전트 프롬프트 (Agent Prompt): /code-review 파트 7 고노력 모드 (high effort mode) (
  0tks) - 3개의 탐색 관점(finder angles), 재현율 편향 검증(recall-biased verification), 그리고 최대 10개의 JSON 발견 사항을 통해 재현율(recall)을 우선시하는 고노력(high-effort) /code-review 프롬프트.

• 에이전트 프롬프트 (Agent Prompt): /code-review 파트 8 GitHub 댓글 게시 (GitHub comment posting) (
  152tks) - --comment 옵션이 전달되었을 때 발견 사항을 GitHub 인라인 PR 댓글로 게시하기 위한 선택적 /code-review 지침.

• 에이전트 프롬프트 (Agent Prompt): /code-review 파트 9 수정 사항 적용 (fix application) (
  126tks) - --fix 옵션이 전달되었을 때 발견 사항을 작업 트리(working tree)에 적용하기 위한 선택적 /code-review 지침.

• Agent Prompt: /rename 자동 세션 이름 생성 (80tks) - 대화 문맥으로부터 kebab-case 세션 이름을 자동으로 생성하기 위해 /rename (인자 없음) 명령에서 사용하는 프롬프트.

• Agent Prompt: /review 슬래시 명령 (412tks) - gh를 사용하여 PR(Pull Request) 문맥과 diff를 수집하고, 선택적인 사용자 지침을 적용하며, 검증된 결과물을 제시하여 GitHub pull request를 검토하기 위한 /review 명령 지침.

• Agent Prompt: /schedule 슬래시 명령 (3131tks) - Anthropic cloud API를 통해 cron 트리거를 사용하여 원격 Claude Code 에이전트를 예약, 업데이트, 목록화 또는 실행하도록 사용자를 안내.

• Agent Prompt: /security-review 슬래시 명령 (2521tks) - 악용 가능한 취약점에 초점을 맞추어 코드 변경 사항을 분석하기 위한 종합적인 보안 검토 (security review) 프롬프트.

• Agent Prompt: /simplify 슬래시 명령 (362tks) - 변경된 코드를 재사용성, 단순화, 효율성 및 고도화된 정리 (altitude cleanups) 측면에서 검토한 후 수정 사항을 적용하는 /simplify 슬래시 명령 지침.

• Agent Prompt: Agent Hook (122tks) - '에이전트 훅 (agent hook)'을 위한 프롬프트.

• Agent Prompt: 자동 모드 규칙 검토자 (Auto mode rule reviewer) (292tks) - 사용자가 정의한 자동 모드 분류기 (auto mode classifier) 규칙의 명확성, 완전성, 충돌 및 실행 가능성을 검토하고 비평.

• Agent Prompt: 부재 중 요약 생성 (Away summary generation) (73tks) - 사용자가 돌아왔을 때 목표, 현재 작업 및 다음 작업을 요약할 수 있도록 도구 없이 (no-tools) 부재 중 요약 생성을 실행하는 프롬프트.

• Agent Prompt: 백그라운드 에이전트 상태 분류기 (Background agent state classifier) (4405tks) - 백그라운드 에이전트 트랜스크립트(transcript)의 끝부분을 작업 중 (working), 차단됨 (blocked), 완료 (done) 또는 실패 (failed)로 분류하고 간결한 상태 JSON을 반환.

• Agent Prompt: 백그라운드 작업 에이전트 지침 (Background job agent instructions) (427tks) - 내장된 백그라운드 작업 에이전트가 진행 상황을 설명하고, 도구 결과를 재진술하며, 명시적인 결과 (result), 입력 필요 (needs input) 또는 실패 (failed) 상태 신호를 내보내도록 지시.

• Agent Prompt: Bash 명령 설명 작성자 (Bash command description writer) (207tks) - Bash 명령에 대해 능동태를 사용하여 명확하고 간결한 명령 설명을 생성하기 위한 지침.

• 에이전트 프롬프트 (Agent Prompt): Bash 명령 접두사 탐지 (823tks) - 명령 접두사 및 명령 주입 (command injection)을 탐지하기 위한 시스템 프롬프트.

• 에이전트 프롬프트 (Agent Prompt): Claude Code 가이드 (143tks) - Claude Code 기능/SDK/API 질문에 답변하는 서브에이전트 (Subagent).

• 에이전트 프롬프트 (Agent Prompt): Claude 가이드 에이전트 (833tks) - 사용자가 Claude Code, Claude Agent SDK 및 Claude API를 효과적으로 이해하고 사용할 수 있도록 돕는 claude-guide 에이전트를 위한 시스템 프롬프트.

• 에이전트 프롬프트 (Agent Prompt): 코딩 세션 제목 생성기 (314tks) - 코딩 세션의 제목을 생성합니다.

• 에이전트 프롬프트 (Agent Prompt): 컨텍스트 팁 수신 평가기 (311tks) - 표시된 Claude Code 컨텍스트 팁이 실행되었는지, 그리고 그 수신 반응이 긍정적(positive), 중립적(neutral), 부정적(negative) 또는 알 수 없음(unknown)인지 평가합니다.

• 에이전트 프롬프트 (Agent Prompt): 컨텍스트 팁 선택기 (1341tks) - 최근 트랜스크립트(transcript) 및 세션 메타데이터를 적절한 컨텍스트 팁 상황과 매칭하여 짧은 Claude Code 기능 팁을 보여줄지 여부를 선택합니다.

• 에이전트 프롬프트 (Agent Prompt): 대화 요약 (1201tks) - 상세한 대화 요약을 생성하기 위한 시스템 프롬프트.

• 에이전트 프롬프트 (Agent Prompt): 첨부할 메모리 파일 결정 (271tks) - 메인 에이전트에게 첨부할 메모리 파일을 결정하는 에이전트.

• 에이전트 프롬프트 (Agent Prompt): 드림 메모리 통합 (Dream memory consolidation) (859tks) - 에이전트에게 다단계 메모리 통합 패스(multi-phase memory consolidation pass)를 수행하도록 지시합니다. 이는 기존 메모리에 대한 방향 설정, 로그 및 트랜스크립트로부터 최근 신호 수집, 업데이트 내용을 주제 파일(topic files)에 병합, 그리고 인덱스 정리(pruning)를 포함합니다.

• 에이전트 프롬프트 (Agent Prompt): 범용 에이전트 (General purpose agent) (63tks) - 복잡한 질문 연구, 코드 검색 및 다단계 작업 실행을 위한 범용 에이전트를 정의합니다.

• 에이전트 프롬프트 (Agent Prompt): 범용 (285tks) - 코드베이스 전반에서 코드를 검색, 분석 및 편집하면서 발견 사항을 호출자에게 간결하게 보고하는 범용 서브에이전트 (subagent)를 위한 시스템 프롬프트.

• 에이전트 프롬프트 (Agent Prompt): 범용 작업 에이전트 (99tks) - Claude Code 작업 에이전트가 사용자의 요청을 완전히 완료하고 필수적인 결과를 보고하도록 지시합니다.

• 에이전트 프롬프트 (Agent Prompt): 훅 조건 평가기 (stop) (319tks) - Claude Code에서 훅 조건, 특히 중단 (stop) 조건을 평가하기 위한 시스템 프롬프트입니다.

• 에이전트 프롬프트 (Agent Prompt): 훅 조건 평가기 (88tks) - 사용자가 제공한 훅 조건이 충족되었는지 판단하도록 에이전트에게 지시합니다.

• 에이전트 프롬프트 (Agent Prompt): 워크트리 서브 에이전트 (worktree sub-agent)를 위한 상속된 컨텍스트 (121tks) - 서브 에이전트에게 부모 세션의 컨텍스트를 상속받았으며, 현재 자체적인 격리된 git 워크트리 (worktree)에서 작업하고 있음을 브리핑합니다.

• 에이전트 프롬프트 (Agent Prompt): 관리형 에이전트 (Managed Agents) 온보딩 흐름 (3806tks) - 작업을 설명하고, 도구 및 리소스를 제안하며, 환경 및 세션을 설정하고, 액세스를 테스트하고, 통합 코드를 생성함으로써 사용자가 관리형 에이전트를 구성할 수 있도록 돕는 대화형 인터뷰 스크립트입니다.

• 에이전트 프롬프트 (Agent Prompt): 온보딩 가이드 초안 공유 링크 워크플로 (323tks) - 검토 전에 온보딩 초안 (ONBOARDING.md)을 공유하도록 지시하고, 사용자가 검토 질문에 답변한 후 동일한 ShareOnboardingGuide 링크를 업데이트하는 지침을 추가합니다.

• 에이전트 프롬프트 (Agent Prompt): 온보딩 가이드 생성기 (1135tks) - 생성자의 사용 데이터를 분석하고, 세션 유형을 분류하며, 초안을 협업하여 반복 수정함으로써 새로운 Claude Code 사용자를 위한 팀 온보딩 가이드 (ONBOARDING.md)를 공동 작성합니다.

• 에이전트 프롬프트 (Agent Prompt): PR 후속 크론 (PR follow-up cron) (172tks) - 세션에서 생성된 풀 리퀘스트 (pull request)를 확인하고 실패, 코멘트 또는 충돌을 수정하기 위한 크론 (cron) 프롬프트입니다.

• 에이전트 프롬프트 (Agent Prompt): 프롬프트 제안 생성기 v2 (Prompt Suggestion Generator v2) (344tks) - Claude Code를 위한 프롬프트 제안을 생성하기 위한 V2 지침입니다.

• 에이전트 프롬프트 (Agent Prompt): 빠른 PR 생성 (986tks) - 컨텍스트가 미리 채워진 상태로 커밋과 풀 리퀘스트 (pull request)를 생성하기 위한 간소화된 프롬프트입니다.

• 에이전트 프롬프트 (Agent Prompt): 읽기 전용 검색 에이전트 (Read-only search agent) (93tks) - 파일 덤프 대신 결론을 반환하는 광범위한 팬아웃 (fan-out) 코드 검색을 위한 읽기 전용 검색 에이전트를 정의합니다.

• Agent Prompt: 최근 메시지 요약 (Recent Message Summarization) (
  804tks) - 최근 메시지를 요약하는 데 사용되는 에이전트 프롬프트 (Agent prompt). - Agent Prompt: 스케줄 작업 선택 (Schedule action selection) (
  114tks) - 클라우드 스케줄링 에이전트가 사용자에게 어떤 스케줄 작업을 먼저 수행할지 묻도록 지시합니다. - Agent Prompt: 보안 모니터 편집-제거 가이드 (Security monitor edit-removal guidance) (
  368tks) - 보안 모니터가 Edit 및 NotebookEdit 제거, 잘린 삭제 (truncated deletions), 누락된 결과 (missing outcomes), 그리고 전체 교체 편집 (replace-all edits)을 어떻게 평가해야 하는지 설명합니다. - Agent Prompt: 자율 에이전트 작업을 위한 보안 모니터 (첫 번째 부분) (Security monitor for autonomous agent actions (first part)) (
  7776tks) - Claude에게 프롬프트 주입 (prompt injection), 범위 이탈 (scope creep), 그리고 우발적인 손상을 방지하기 위해 차단/허용 규칙에 따라 자율 코딩 에이전트의 작업을 평가하는 보안 모니터 역할을 수행하도록 지시합니다. - Agent Prompt: 자율 에이전트 작업을 위한 보안 모니터 (두 번째 부분) (Security monitor for autonomous agent actions (second part)) (
  8875tks) - 에이전트가 수행할 수 있는 도구 작업과 수행할 수 없는 작업을 규정하는 환경 컨텍스트 (environment context), 차단 규칙 (block rules), 그리고 허용 예외 (allow exceptions)를 정의합니다. - Agent Prompt: 세션 검색 (Session search) (
  158tks) - .jsonl 트랜스크립트 (transcript) 파일을 스캔하여 일치하는 세션 ID를 반환함으로써 과거 Claude Code 대화 세션을 검색하는 서브 에이전트 (Subagent) 프롬프트입니다. - Agent Prompt: 세션 제목 및 브랜치 생성 (Session title and branch generation) (
  307tks) - 간결한 세션 제목과 git 브랜치 이름을 생성하는 에이전트입니다. - Agent Prompt: 세션 트랜스크립트 청크 요약 (Session transcript chunk summary) (
  89tks) - 에이전트에게 Claude Code 세션 트랜스크립트의 한 청크 (chunk)를 간결하게 요약하도록 지시합니다. - Agent Prompt: 요약 도구 미사용 가드 (Summarization no-tools guard) (
  107tks) - co