더 이상 프롬프트를 손으로 만들지 마세요: Claude Code에는 전체 템플릿 시스템이 있습니다
더 이상 프롬프트를 손으로 만들지 마세요: Claude Code에는 전체 템플릿 시스템이 있습니다
많은 사람들이 처음 Claude Code를 사용할 때 미묘한 실망감을 느낍니다:
모델은 강력하지만 매번 "어떻게 작업하는지 다시 가르쳐야 합니다".
하지만 이것은 당신의 잘못이 아닙니다. 이는 도구 형태의 문제입니다.
Claude Code 자체는 단지 "대화형 프로그래밍 엔진"일 뿐입니다. 사용자 개발 효율성과 개발 경험을 향상시키기 위해, Anthropic은 Claude Code를 위해 확장 가능한 템플릿/플러그인 생태계와 CLI 관리 도구인 claude-code-templates를 만들었습니다. 이를 통해 Claude Code에 스마트 에이전트, 자동화 명령, 외부 서비스 통합, 모니터링 도구 등을 플러그인처럼 추가할 수 있어 작업 흐름을 구축, 관리 및 최적화하는 속도를 크게 높일 수 있습니다.
claude-code-templates가 하는 일은 단 하나입니다 — "AI에게 반복적으로 가르친 경험"을 재사용 가능하고 설치 가능하며 조합 가능한 능력 모듈로 고정하는 것입니다.
이 글에서는 그것을 완전히 분해해 보겠습니다.
01 claude-code-templates 소개
claude-code-templates = Claude Code의 템플릿/플러그인 생태계 + 공식 CLI 관리 도구
https://github.com/davila7/claude-code-templates 이는 "AI를 다시 포장하는 것"이 아니라 세 가지 매우 공학적인 일을 수행합니다:
- Claude Code의 능력을 표준화된 구성 요소로 분해
- CLI를 사용하여 이러한 구성 요소를 설치 가능하고 조합 가능하며 재사용 가능하게 변환
- 전체 생태계에 웹 브라우저(aitmpl.com)를 제공
VS Code + 플러그인 마켓
편집기가 Claude Code로 바뀌고, 플러그인이 AI 행동 템플릿으로 바뀌었습니다.
02 claude-code-templates가 해결하는 문제는 무엇인가요?
모든 Vibe Coding 플레이어가 겪는 함정 중 하나를 먼저 말해보겠습니다.
1. 맥락은 일회성입니다
당신이 Claude에게 말합니다:
- 당신은 엄격한 Python 리뷰어입니다.
- PEP8을 준수합니다.
- 먼저 분석한 후 코드를 제공합니다.
templates가 하는 일: 이러한 "역할 설정 + 행동 제약 + 출력 구조"를 → 에이전트 템플릿으로 고정합니다.
2. 각 프로젝트에서 반복적으로 프롬프트를 생성합니다
- 단위 테스트를 AI가 신뢰성 있게 작성하도록 하려면?
- PR 리뷰를 어떻게 하면 숙련된 엔지니어처럼 만들 수 있을까요?
- 리팩토링할 때 먼저 제안을 강제하려면 어떻게 해야 할까요?
3. Claude Code 자체는 "자동으로 작업하지 않습니다"
Claude Code는 기본적으로 수동적입니다. 당신이 호출하지 않으면 움직이지 않습니다.
templates는 다음을 도입했습니다:
- Hooks(자동 트리거)
- MCP(외부 시스템 접속)
03 claude-code-templates의 핵심 구성 요소
화려한 장식 없이, 능력에 따라 직접 분해합니다.
1. 에이전트: "프롬프트"를 "역할"로 업그레이드
에이전트 본질 = 장기적으로 유효한 시스템 프롬프트
전형적인 에이전트에는 다음이 포함됩니다:
- 시니어 코드 리뷰어
- 테스트 엔지니어
- 보안 감사관
- 리팩토링 전문가
- 문서 작성자
AI가 이 프로젝트에서 기본적으로 누구의 역할을 수행합니까?
공학적 직관은 매우 간단합니다:
- 프롬프트는 일회성입니다.
- 에이전트는 상태화된 자산입니다.
2. 슬래시 명령: 프로세스를 명령으로 변환
슬래시 명령은 claude-code-templates의 가장 유용한 부분입니다.
예를 들어:
- /review: 코드 검토
- /add-tests: 테스트 추가
- /refactor: 구조 리팩토링
- /explain: 복잡한 논리 설명
- /optimize: 성능 최적화
- 입력 형식
- 분석 단계
- 출력 구조
3. Hooks: AI가 자동으로 "반응하도록" 합니다
Hooks는 많은 사람들이 인식하지 못하는 고급 기능입니다.
이것은 당신이 정의할 수 있게 해줍니다:
- 파일이 변경될 때
- 테스트가 실패할 때
- PR이 생성될 때
이 단계의 의미는:
Claude Code는 더 이상 단순한 대화 상대가 아니라 프로젝트의 "자동화된 참여자"입니다.
4. MCP(모델 컨텍스트 프로토콜): 실제 세계에 접속
MCP는 Claude Code가 다음을 할 수 있게 합니다:
- GitHub 읽기
- 데이터베이스 조회
- API 호출
- 내부 도구 접속
AI는 더 이상 당신이 맥락을 붙이는 것에 의존하지 않고, 스스로 정보를 "가져올 수 있습니다."
claude-code-templates는 MCP 접속 템플릿을 제공하여 당신이 함정을 피할 수 있도록 도와줍니다.
04 claude-code-templates는 어떻게 사용하나요?
1. CLI 설치
npx claude-code-templates@latest 이 단계에서 당신이 얻는 것은 "템플릿"이 아니라 상호작용식 설치 프로그램입니다.
2. 템플릿 탐색(강력 추천)
열기: https://www.aitmpl.com
이곳은 claude-code-templates의 공식 웹 디렉토리입니다.
당신은:
- 유형별로 필터링(에이전트/명령/후크/MCP)
- 각 템플릿의 용도 보기
- 설치 명령을 직접 복사
3. 필요한 능력 설치
예를 들어 코드 검토 에이전트를 설치합니다:
claude-code-templates install agent senior-code-reviewer 명령을 설치합니다:
claude-code-templates install command review 핵심 포인트: 이들은 "예시"가 아니라 당신의 Claude Code 환경에 직접 들어갑니다.
- 에이전트: 시니어 엔지니어
- 명령: /review + /add-tests
- 후크: 파일 변경 자동 리뷰
- 당신이 코드를 수정합니다.
- Claude가 자동으로 리뷰합니다.
- 문제를 발견하고 제안을 합니다.
- 당신은 /add-tests로 테스트를 추가합니다.
당신이 코드를 쓰고, AI가 동료 역할을 합니다.
05 claude-code-templates와 "일반 프롬프트 저장소"의 본질적 차이
많은 사람들이 물어볼 것입니다: 이것은 단지 프롬프트의 집합이 아닌가요?
공학적으로 답은 매우 명확합니다:
프롬프트 Claude Code 템플릿 일회성 설치 수동 복사 CLI 관리 무상태 지속적 효과 조합 불가 에이전트 + 명령 + 후크 차이는 "잘 쓰는 것"이 아니라 "장기적으로 사용할 수 있는지"입니다.
이것이 Claude Code가 진정으로 "강해지는" 부분입니다.
Claude Code 자체는 엔진입니다. claude-code-templates는 변속기, 브레이크, 자동 운전 시스템입니다.
이것은 AI 프로그래밍을 다음으로 업그레이드합니다:
즉흥적으로 반복하는 것에서 "축적 가능하고, 재사용 가능하며, 진화 가능한 공학 시스템"으로.
