시스템 프롬프트와 사용자 프롬프트 차이, 프로젝트 지침이 하는 일 이해하기

🤔 같은 말을 대화마다 다시 적고 있을 때

보고서 초안을 시킬 때마다 "결론을 첫 문단에 쓰고, 평가어는 빼고, 숫자에는 출처를 붙여 주세요"를 다시 적고 있다면 그 문장은 이미 이번 요청이 아니라 늘 지켜야 할 규칙입니다. 규칙과 요청이 한 칸에 섞여 있으면 요청을 바꿀 때마다 규칙을 빠뜨리게 되고, 결과의 형식이 대화마다 달라집니다.

모델에게 말을 거는 칸이 두 개로 나뉘어 있는 이유가 여기에 있습니다. 하나는 대화 내내 유지되는 규칙을 적는 곳이고, 다른 하나는 이번에 시킬 일을 적는 곳입니다.

🔑 시스템 프롬프트와 사용자 프롬프트의 정의

시스템 프롬프트는 대화 전체에 걸쳐 모델의 역할과 규칙을 정해 두는 지침이고, 사용자 프롬프트는 그 대화에서 이번에 시킬 일을 적는 요청입니다. API에서는 system 파라미터가 시스템 프롬프트이고 messages의 사용자 턴이 사용자 프롬프트입니다.

앤트로픽 공식 문서는 시스템 프롬프트에 역할을 정하면 모델의 행동과 어조가 그 용도에 맞게 집중되고, 한 문장만 적어도 차이가 난다고 설명합니다. 채팅 화면에서는 이 칸이 보이지 않지만, 클로드 앱의 계정 전체 지침과 프로젝트 지침이 같은 역할을 맡습니다.

⚖️ 무엇을 어느 쪽에 적을지 나누는 기준

주방 벽에 붙여 둔 조리법은 매일 그대로 두고 그날 들어온 주문서만 바꾸듯, 시스템 쪽에는 매번 같은 조건을 적고 사용자 쪽에는 이번 주문을 적습니다.

나누는 질문은 하나입니다. 이 조건이 다음 대화에서도 그대로 필요한지 봅니다. 필요하면 시스템 쪽이고, 이번 한 번이면 사용자 쪽입니다. 앤트로픽 공식 안내도 프로젝트 전반의 맥락과 형식, 클로드가 맡을 역할은 지침에 두고 작업별 지시는 대화에 남기라고 설명합니다.

한 가지 더 나눌 것이 있습니다. 행동 방식과 참조 자료입니다. 브랜드 가이드 전문을 지침 칸에 붙여 넣는 대신 파일로 올려 두고, 지침에는 "초안을 쓰기 전에 브랜드 가이드의 금지 표현을 먼저 확인합니다"라고만 적는 편이 다루기 쉽습니다. 행동은 지침에, 내용은 자료에 둡니다.

🗂️ 클로드 앱에서 시스템 프롬프트를 대신하는 세 곳

API를 쓰지 않아도 시스템 프롬프트에 해당하는 칸이 있습니다. 2026년 9월 28일 앤트로픽 도움말 기준으로 세 곳입니다.

• 계정 전체 지침: 설정 화면의 Instructions for Claude에 적으면 클로드와 나누는 모든 대화에 적용됩니다. 어느 작업에나 똑같이 적용할 말투와 답변 길이를 둡니다
• 프로젝트 지침: 그 프로젝트 안에서 열리는 모든 대화에 자동으로 적용됩니다. 그 업무의 맥락과 형식, 금지 표현, 모를 때의 행동을 둡니다. 무료 계정도 프로젝트를 다섯 개까지 만들 수 있고, 기본 구성은 클로드 프로젝트 활용하기에 있습니다
• 스킬: 특정 작업에서 불러 쓰는 절차입니다. 매번 걸리는 지침과 달리 필요한 작업에서만 읽히므로, 반복 절차는 클로드 스킬 활용하기 쪽이 맞습니다

세 곳은 범위가 다릅니다. 계정 지침이 가장 넓고 프로젝트 지침이 그 안이며 대화창은 그 대화 하나입니다. 도움말에는 세 곳이 부딪힐 때 어느 쪽이 우선하는지 적혀 있지 않으므로, 같은 항목을 두 곳에 다르게 적지 않는 편이 안전합니다.

✍️ 잘 듣는 지침의 조건

시스템 쪽에 적는 문장은 오래 남으므로 막연하면 그 막연함이 대화마다 반복됩니다. 준이아빠블로그의 프로젝트 지침 쓰는 법에서 정리한 원칙은 네 가지입니다.

1. 확인할 수 있는 조건으로 적습니다. 형용사 대신 문장 수와 항목 수, 소수점 자리, 날짜 형식처럼 결과물에서 눈으로 확인할 수 있는 값을 씁니다.
2. 금지만 적지 말고 대신 할 행동을 적습니다. "추측하지 마세요"만 적으면 빈칸이 남으므로 "확인 필요로 표시합니다"까지 함께 적습니다.
3. 모를 때의 행동을 지정합니다. 자료가 없거나 서로 어긋날 때 무엇을 하라고 정해 두면 지어낸 수치가 끼어들 여지가 줄어듭니다.
4. 매번 반복되는 조건만 넣습니다. 이번 자료에만 해당하는 조건을 지침에 넣으면 다음 대화에서 엉뚱하게 적용됩니다.

네 번째가 실무에서 가장 자주 무너집니다. 급한 작업 하나를 처리하다가 그때의 요청을 지침에 적어 두고 지우지 않으면 몇 주 뒤 다른 작업에서 그 조건이 그대로 따라붙습니다. 지침을 고칠 때는 새로 넣는 줄만 보지 말고 이미 있는 줄이 아직 유효한지도 같이 봅니다.

아래는 그대로 복사해 쓸 수 있는 형태입니다. 역할, 형식, 하지 않는 일, 모를 때의 행동 네 항목이 뼈대입니다.

🔧 지침을 고쳤는데 결과가 그대로일 때

지침 문장부터 다시 쓰게 되는데 원인이 다른 곳에 있는 경우가 적지 않습니다. 확인 순서를 정해 두면 헤매는 시간이 줄어듭니다.

• 저장 여부: 지침을 고친 뒤 저장을 누르지 않으면 반영되지 않습니다
• 새 대화 여부: 진행 중인 대화에는 앞선 맥락이 쌓여 있어서 새로 연 대화로 확인하는 편이 정확합니다
• 서로 부딪히는 줄: "간결하게 쓰세요"와 "근거를 모두 적으세요"가 같이 있으면 어느 쪽이 우선인지 지침에 적어야 합니다
• 계정 전체 지침: 프로젝트 지침과 다른 말투가 계정 설정에 남아 있을 수 있습니다
• 옛 자료: 지난 분기 양식이 지식 파일에 그대로 올라가 있으면 그 형식이 따라옵니다

그래도 같은 결과가 반복되면 지침을 늘리는 대신 프로젝트를 나눕니다. 한 프로젝트에 성격이 다른 업무를 같이 넣으면 조건이 서로 충돌해서 조건을 더 써 넣을수록 결과가 흐려집니다.

📎 클로드 코드의 CLAUDE.md와 다른 점

터미널에서 쓰는 클로드 코드에도 세션마다 읽는 지시 파일 CLAUDE.md가 있습니다. 시스템 프롬프트와 같은 역할처럼 보이지만 공식 문서는 다르게 규정합니다. CLAUDE.md 내용은 시스템 프롬프트의 일부가 아니라 그 뒤에 오는 사용자 메시지로 전달되고, 클로드가 읽고 따르려 하지만 엄격한 준수가 보장되지는 않는다는 설명입니다. 권장 길이도 파일 하나당 200줄 미만입니다. 어떤 동작을 반드시 막아야 한다면 지침 문장이 아니라 훅이나 권한 설정을 써야 하는데, 이 구분은 CLAUDE.md 세팅과 공식 문서 정리에 있습니다.

같은 규칙을 CLAUDE.md와 프로젝트 지침과 대화창 세 곳에 따로 적으면 조금씩 달라진 뒤 어느 쪽이 원본인지 알 수 없게 됩니다. 클로드 코드 공식 문서는 규칙 두 개가 어긋나면 어느 하나를 임의로 고를 수 있다고 밝히고 있어, 원본을 한 곳에 두고 나머지는 그곳을 참조하게 하는 편이 안전합니다.

⚠️ 자주 하는 실수

• 이번 한 번만 필요한 조건을 지침에 넣습니다: 다음 대화에서 그 조건이 따라붙습니다
• 브랜드 가이드 전문을 지침 칸에 붙여 넣습니다: 행동은 지침에, 참조 내용은 지식 파일에 둡니다
• 역할만 적고 하지 않는 일과 모를 때의 행동을 비워 둡니다: 자료가 없을 때 지어낸 수치가 들어옵니다
• 지침을 고친 뒤 진행 중인 대화에서 확인합니다: 쌓인 맥락 때문에 반영 여부를 알기 어렵습니다
• 성격이 다른 업무를 한 프로젝트에 넣고 지침을 늘립니다: 조건이 충돌해 결과가 흐려집니다

❓ 자주 묻는 질문

채팅 화면에는 시스템 프롬프트 칸이 없는데 어떻게 쓰나요?

클로드 앱에서는 설정의 계정 전체 지침과 프로젝트의 지침 칸이 그 역할을 합니다. 모든 대화에 걸 조건은 계정 지침에, 특정 업무에만 걸 조건은 프로젝트 지침에 적습니다. API를 쓴다면 system 파라미터에 같은 내용을 넣습니다.

지침을 길게 쓰면 더 잘 듣나요?

길이보다 조건의 종류가 중요합니다. 앤트로픽 안내는 지침에 맥락과 형식과 역할을 적고 작업별 지시는 대화에 남기라고 설명합니다. 참조할 내용이 많다면 지침을 늘리는 대신 지식 파일로 올리고 지침에는 그 파일을 언제 확인할지만 적습니다.

프로젝트 지침과 스킬은 무엇이 다른가요?

적용되는 시점이 다릅니다. 프로젝트 지침은 그 프로젝트에서 여는 대화마다 자동으로 걸리고, 스킬은 필요한 작업에서 불러 쓰는 방식입니다. 매번 같은 형식이 필요하면 지침이 맞고, 특정 작업에서만 쓰는 절차라면 스킬 쪽이 맞습니다.

계정 지침과 프로젝트 지침이 부딪히면 어느 쪽이 이기나요?

2026년 9월 28일 기준 앤트로픽 도움말에 우선순위가 적혀 있지 않습니다. 같은 항목을 두 곳에 다르게 적지 않는 편이 안전하고, 프로젝트에서 다른 말투가 필요하다면 계정 지침의 해당 줄을 지우거나 프로젝트 지침에 "이 프로젝트에서는 이 규칙이 우선합니다"라고 적어 둡니다.

📋 3줄 요약

1. 시스템 프롬프트는 대화 전체에 걸쳐 모델의 역할과 규칙을 정해 두는 지침이고 사용자 프롬프트는 그 대화에서 이번에 시킬 일을 적는 요청이라, 매번 같은 조건은 시스템에 적고 이번 자료와 이번 작업은 사용자 쪽에 적습니다.

2. 클로드 앱에서는 설정의 계정 전체 지침이 모든 대화에, 프로젝트 지침이 그 프로젝트의 모든 대화에 적용되어 API의 system 파라미터와 같은 역할을 하고 2026년 9월 28일 기준 무료 계정도 프로젝트를 다섯 개까지 만듭니다.

3. 지침을 고쳤는데 결과가 같으면 저장 여부와 새 대화 여부, 서로 부딪히는 줄, 계정 지침과의 충돌을 순서대로 확인하고 성격이 다른 업무는 프로젝트를 나눕니다.

📚 참고 자료

• Prompting best practices: Give Claude a role, Claude Platform Docs
• What are projects?, Claude Help Center
• Understanding Claude's personalization features, Claude Help Center
• How Claude remembers your project, Claude Code Docs
• 클로드 프로젝트 지침 쓰는 법, 준이아빠블로그
• SSOT 뜻과 AI 시대에 문서를 한곳에서만 고쳐야 하는 이유, 준이아빠블로그

2026년 9월 28일 기준으로 공식 문서를 확인했습니다.