Claude Code의 서브 에이전트 정의 파일 작성 방법 — .claude/agents/최소 구성 레퍼런스
요약
Claude Code에서 서브 에이전트를 정의하고 추가하는 방법을 설명합니다. .claude/agents/ 디렉토리에 마크다운 파일을 생성하여 특정 역할과 권한을 부여하는 최소 구성 방법을 안내합니다.
핵심 포인트
- .claude/agents/ 폴더 내에 .md 파일로 에이전트 정의
- name과 description은 필수 포함 항목
- tools와 model 설정을 통해 권한 및 비용 제어 가능
- 최소 구성 레퍼런스와 동작 확인 절차 제공
이 글을 통해 알게 될 것: Claude Code에 전용 역할(서브 에이전트)을 하나 추가하는 방법을 배울 수 있습니다. 필요한 것은 .claude/agents/<name>.md라는 텍스트 파일 단 한 장뿐이며, 필수 항목은 name과 description 두 가지입니다. 여기에 tools와 model을 추가하면 권한과 비용을 제한할 수 있습니다. 마지막으로 복사-붙여넣기로 작동하는 최소 정의 파일과 동작 확인 절차를 안내합니다. .claude/agents/는 '역할의 위치'이며, Claude Code는 시작 시 프로젝트 전체의 규칙을 작성하는 CLAUDE.md나 전용 커맨드의 .claude/comm...
AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기