Claude Code 시스템 프롬프트 알아보기 - 260314

 

Claude Code System Prompt 핵심 요약

1. Agent 역할 정의

• Claude Code는 CLI 기반 소프트웨어 엔지니어링 에이전트
• 코드 탐색, 수정, 실행을 Tool을 통해 수행

---

2. Tool 기반 구조

모델이 직접 작업하지 않고 도구를 호출하여 작업

기본 흐름

Search → Read → Edit → Execute

 

---

3. 보안 우선 설계

• 악성 코드 관련 작업 거부
• 의심 코드 분석 금지
• 임의 URL 생성 금지

---

4. 응답 스타일 제한

• CLI 환경에 맞게 초간결 응답
• 4줄 이하
• 불필요한 설명 금지

---

5. 코드 수정 규칙

• 기존 코드 스타일 유지
• 기존 라이브러리 사용
• 임의 라이브러리 추가 금지

---

6. 작업 관리 시스템

Todo 기반 작업 관리

pending → in_progress → completed

 

목적

• 복잡한 작업 분해
• 진행 상황 추적

---

7. 실행 검증

코드 수정 후

lint
typecheck
test

 

등으로 결과 검증

---

한 줄 핵심

Claude Code는

코드를 생성하는 AI가 아니라
Tool과 Workflow로 제어되는 개발 에이전트이다.

 

마인드 맵

 

 

시스템 프롬프트에서 배울 수 있는 설계 포인트

1. 역할을 명확히 정의한다

시스템 프롬프트의 첫 부분은 항상 에이전트의 정체성을 정의한다.

예

• CLI 기반 개발 도구
• 소프트웨어 엔지니어링 작업 지원

이렇게 하면 모델이

• 일반 챗봇처럼 행동하지 않고
• 특정 역할 안에서 행동하게 된다.

핵심

Agent Identity 먼저 정의

 

---

2. 보안 규칙을 최상단에 둔다

Claude Code 프롬프트에서 가장 먼저 나오는 것은 보안 정책이다.

대표 규칙

• 악성 코드 거부
• 의심 코드 분석 거부
• URL 임의 생성 금지

이 구조의 의미

모델 행동을 제한하는 규칙은

가장 먼저
가장 강하게

 

배치해야 한다.

---

3. 응답 스타일을 강하게 제한한다

시스템 프롬프트는 응답 길이와 스타일까지 명확히 제한한다.

예

• 4줄 이하
• 불필요한 설명 금지
• 서론/결론 금지

목적

• CLI UX 최적화
• 토큰 비용 절감
• 응답 일관성 유지

---

4. Tool 중심 구조로 설계한다

Claude Code는 모델이 직접 작업하지 않는다.

구조

User →   Agent reasoning →  Tool 호출 →  결과

 

즉 Model → Tool orchestration

 

이 구조가 핵심이다.

---

5. 기존 코드 컨벤션을 강제한다

코드를 생성할 때

• 기존 라이브러리 확인
• 기존 스타일 유지
• 프로젝트 패턴 유지

같은 규칙을 강제한다.

특히 중요한 규칙

NEVER assume library

 

즉

모델이 마음대로 라이브러리를 가져오지 못하게 한다.

---

6. 작업 관리 시스템을 포함한다

Claude Code는 작업을

Todo 기반으로 관리

구조

pending
in_progress
completed

 

이 방식의 장점

• 장기 작업 관리
• 사용자 진행 상황 표시
• LLM 기억 보완

---

7. 실행 검증 단계를 포함한다

작업이 끝나면

• lint
• typecheck
• test

같은 검증을 실행하도록 규정한다.

즉

코드 작성 → 끝 ❌
코드 작성 → 검증 ✅

 

---

8. 능동성의 범위를 제한한다

Claude Code는 능동적으로 행동할 수 있지만

다음은 금지된다.

• 임의 커밋
• 불필요한 행동
• 사용자 요청 범위 초과

특히

commit 금지

 

는 중요한 정책이다.

---

9. 도구 호출 효율을 고려한다

프롬프트에는 성능 규칙도 포함된다

예

• 병렬 Tool 호출
• context 절약
• 검색 우선 전략

이런 규칙은

Agent latency를 줄인다.

---

핵심 요약

Claude Code 시스템 프롬프트에서 배울 수 있는 핵심 설계 원칙

1. Agent Identity 정의
2. 보안 정책 우선 배치
3. 응답 스타일 강제
4. Tool 기반 구조
5. 코드 컨벤션 준수
6. Todo 기반 작업 관리
7. 검증 단계 포함
8. 능동성 제한
9. Tool 호출 최적화

 

참고 자료

https://gist.github.com/wong2/e0f34aac66caf890a332f7b6f9e2ba8f#file-system-prompt-md