시스템 프롬프트(System prompt)
가 대화 앞에 보내는 지시. 무엇인지, 어떻게 돌아가고 어떻게 쓰는지, 조심할 점까지 그림과 예로 풀어 봅니다.
무엇인가요
는 가 요청을 보낼 때마다 대화 앞에 붙이는 지시 묶음입니다. 도구 쓰는 법, 안전하게 행동하는 법, 답을 꾸미는 형식을 에게 알려 줍니다. 사람이 직접 쓰지 않지만 모든 답에 영향을 줍니다. 기본으로는 대화의 첫 요청 때 한 번 만들어 기록하고, 대화가 압축(compaction)될 때까지 그 기록을 계속 씁니다.
어떻게 돌아가나요
-
Claude Code 를 시작합니다
-
기본 를 만듭니다
-
플래그로 글을 더하거나 바꿉니다
-
요청마다 맨 앞에 보냅니다
이렇게 씁니다
-
--append-system-prompt기본 프롬프트 끝에 내 글을 더합니다. 예를 들어
claude --append-system-prompt "Always use TypeScript"처럼 씁니다. -
--append-system-prompt-file파일 내용을 더합니다. 규칙이 길 때 좋습니다.
-
--system-prompt기본 프롬프트 전체를 바꿉니다. 도우미가 아닌 를 만들 때 씁니다.
-
--system-prompt-snapshot off요청마다 프롬프트를 새로 만듭니다.
--continue로 이어 가며 문장을 시험할 때 씁니다.
주의할 점
통째로 바꾸면 기본 도구 안내와 안전 지시가 모두 빠지므로, 필요한 것은 직접 다시 넣어야 합니다. Claude 가 코딩 도우미로 남아야 하면 더하기(append)가 더 안전합니다. CLAUDE.md 와 출력 스타일 지시는 시스템 프롬프트 안에 들지 않고 시스템 리마인더로 갑니다.
함께 보면 좋은 용어
원문과 공식 문서
이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.