[Claude Code 스킬] --append-system-prompt — 기본 헌법에 내 규칙 한 겹 얹기 | DAKER 커뮤니티
무엇
Claude Code는 매 세션을 시작할 때 '에이전트 헌법'을 읽습니다 — 도구를 어떻게 쓰는지, 무엇이 안전한지, 코딩 관례는 무엇인지 정리된 기본 시스템 프롬프트죠. --append-system-prompt는 이 헌법을 지우지 않고 맨 끝에 내 규칙 한 문단을 덧댑니다. 내가 기능(도구 가이드·안전 규칙·코딩 관례)은 그대로 두고, 그 위에 얇은 규칙 층 하나를 얹는 셈입니다. 형제 플래그 --system-prompt는 반대로 헌법을 통째로 갈아끼웁니다(안전 규칙까지 내가 직접 책임지는, 정체성이 다른 에이전트용).
언제 쓰나
이번 실행에만 적용할 불변 규칙: "항상 한국어로", "커밋은 Conventional Commits로", "SQL은 읽기 전용 쿼리만" 같은 가드레일.
자동화 스크립트(
-p파이프라인)에서 출력 형식·톤을 못 박아 결과를 예측 가능하게 만들 때.CLAUDE.md만으로는 약할 때: CLAUDE.md는 대화 맥락층이라
/compact요약에 희석될 수 있지만, append 규칙은 시스템 프롬프트층이라 세션 내내 흔들리지 않습니다.
사용법
# 한 줄 규칙 덧대기 (기본 헌법은 그대로 유지)
claude --append-system-prompt "항상 한국어로 답하고, 커밋 메시지는 Conventional Commits로"
# 파일로 규칙 주입
claude --append-system-prompt-file ./rules.txt
# (또는 셸 치환) claude --append-system-prompt "$(cat rules.txt)"
# 전체 교체 — 정체성부터 새로 (안전 규칙까지 직접 책임)
claude --system-prompt "You are a strict SQL reviewer. Only read-only queries."
# Agent SDK
systemPrompt: { type: "preset", preset: "claude_code", append: "..." }
팁
대화형에서도 동작: v1.0.51부터
--append-system-prompt가 interactive 세션에서도 먹힙니다. 그 전에는-p(print) 모드 전용이었죠.층을 구분하세요: CLAUDE.md = 팀 공유·버전관리용 대화층(반복 규칙),
--append= 이번 실행 한정 시스템층(불변 규칙). 목적이 다르면 나눠 쓰는 게 깔끔합니다.결합도 가능: append 플래그는
--system-prompt교체와도 함께 쓸 수 있어, 새 정체성 위에 다시 규칙을 얹을 수 있습니다.
출처
공식 문서 — Claude Code CLI reference