시스템 리마인더(System reminder)
가 에게 을 주려고 대화에 더하는 메시지. 무엇인지, 어떻게 돌아가고 어떻게 쓰는지, 조심할 점까지 그림과 예로 풀어 봅니다.
무엇인가요
시스템 리마인더는 인 가 에게 을 주려고 대화에 끼워 넣는 메시지입니다. 사람이 직접 보내지 않습니다. 세션이 시작될 때, 훅이 글을 돌려줄 때, 의 파일이 바뀌었을 때처럼 세션이 도는 동안 Claude Code 가 넣습니다. Claude 는 이것을 사람의 메시지와 함께 읽고, Claude Code 는 이것이 사람이 아니라 이 보낸 것이라고 Claude 에게 알려 둡니다.
어떻게 돌아가나요
-
세션에서 어떤 일이 생깁니다
-
Claude Code 가 짧은 메모를 씁니다
-
메모가 대화에 들어갑니다
-
Claude 가 메시지와 함께 읽습니다
이렇게 씁니다
-
CLAUDE.md프로젝트 지시가 리마인더로 갑니다. 기본 행동보다 앞선다는 줄이 앞에 붙습니다.
-
additionalContext훅이 돌려준 글이 리마인더로 갑니다.
-
· 목록 — Claude 가 부를 수 있는 이름과 설명이 이렇게 전해집니다.
-
파일 변경 알림 — Claude 가 전에 읽은 파일이 디스크에서 바뀌었다는 것을 알려 줍니다.
주의할 점
리마인더는 에 들지 않으므로, 시스템 프롬프트를 바꿔도 대부분 그대로 갑니다. 의 메시지 흐름에는 보이지 않으니, 확인하려면 Claude Code 가 보내는 요청을 기록해서 봅니다. 기록된 요청에서는 사용자 메시지 안의 <system-reminder> 태그로 싸여 있거나, 일부 에서는 system 역할의 따로 된 메시지로 보입니다.
함께 보면 좋은 용어
원문과 공식 문서
이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.