대화창이 안 지저분해져요
코드 검토만 맡는 서브에이전트 직접 만들기
긴 검색 결과나 로그가 대화창에 쌓이면 클로드가 앞 내용을 잊기 쉬워요. 서브에이전트(subagent)는 자기만의 대화 공간에서 그 일을 하고 요약만 돌려주는 전담 도우미예요.
도우미마다 쓸 수 있는 도구와 모델을 따로 정할 수 있어서, '읽기만 하는 검토자' 같은 안전한 역할을 만들기 좋아요.
1단계클로드에게 만들어 달라고 하기
v2.1.198부터 /agents 명령은 만들기 마법사를 열지 않아요. 대신 말로 부탁하거나 파일을 직접 써요.
- 공식 문서 예시 문장이에요. 원하는 역할로 바꿔 말해도 됩니다.
Create a personal code-improver subagent in ~/.claude/agents/ that scans files and suggests improvements for readability, performance, and best practices. It should explain each issue, show the current code, and provide an improved version. Make it read-only and have it use Sonnet.
2단계만들어진 파일 확인
- ~/.claude/agents/code-improver.md 를 열어 이런 모양인지 봅니다.
--- name: code-improver description: Scans files and suggests improvements for readability, performance, and best practices. Use after writing or modifying code. tools: Read, Grep, Glob model: sonnet --- You are a code improvement specialist. For each issue you find, explain the problem, show the current code, and provide an improved version.
- name·description은 꼭 있어야 해요. description을 보고 클로드가 언제 맡길지 정해요.
- tools를 빼면 모든 도구를 물려받아요. 검토자는 Read, Grep, Glob만 주면 파일을 못 고쳐서 안전해요.
- ~/.claude/agents/ 에 두면 모든 프로젝트, 프로젝트 안 .claude/agents/ 에 두면 그 프로젝트에서만 쓰여요.
3단계일 맡기기
- 이름을 넣어 부탁하면 클로드가 맡길지 판단해요.
Use the code-improver agent to suggest improvements in this project
- 반드시 그 도우미가 하게 하려면 @로 콕 집어요.
@agent-code-improver look at performance issues
- 새로 만든 도우미가 안 보이면 클로드 코드를 껐다 켜세요. 세션 도중에 agents 폴더가 처음 생기면 못 알아채요.
4단계이미 들어 있는 도우미도 쓰기
- Explore: 읽기 전용으로 코드를 빠르게 찾고 분석해요. '이 기능 어디 있는지 찾아 줘' 같은 일에 클로드가 알아서 써요.
- Plan: 플랜 모드에서 계획 세우기 전에 조사를 맡아요.
기억해 둘 것
사용량은 같이 줄어요 서브에이전트가 쓴 양도 내 사용 한도에서 빠져요.
설명은 짧게 도우미 설명이 너무 길면 클로드가 누구에게 맡길지 헷갈려요.

잡일은 도우미에게, 저는 요약만 받습니다. 대화창이 깨끗하면 마음도 편해요 🌙
출처 (2026-09-30 확인)
Claude Code 공식 문서 — Create custom subagents — https://code.claude.com/docs/en/sub-agents
Claude Code 공식 문서 — Create custom subagents — https://code.claude.com/docs/en/sub-agents