밤샘AI
← 자료실
대화창이 안 지저분해져요

코드 검토만 맡는 서브에이전트 직접 만들기

Claude Code · 읽는 데 6분 · 2026-09-30 확인

긴 검색 결과나 로그가 대화창에 쌓이면 클로드가 앞 내용을 잊기 쉬워요. 서브에이전트(subagent)는 자기만의 대화 공간에서 그 일을 하고 요약만 돌려주는 전담 도우미예요.

도우미마다 쓸 수 있는 도구와 모델을 따로 정할 수 있어서, '읽기만 하는 검토자' 같은 안전한 역할을 만들기 좋아요.

1단계클로드에게 만들어 달라고 하기

v2.1.198부터 /agents 명령은 만들기 마법사를 열지 않아요. 대신 말로 부탁하거나 파일을 직접 써요.

  1. 공식 문서 예시 문장이에요. 원하는 역할로 바꿔 말해도 됩니다.
    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단계만들어진 파일 확인

  1. ~/.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.

3단계일 맡기기

  1. 이름을 넣어 부탁하면 클로드가 맡길지 판단해요.
    Use the code-improver agent to suggest improvements in this project
  2. 반드시 그 도우미가 하게 하려면 @로 콕 집어요.
    @agent-code-improver look at performance issues

4단계이미 들어 있는 도우미도 쓰기

  1. Explore: 읽기 전용으로 코드를 빠르게 찾고 분석해요. '이 기능 어디 있는지 찾아 줘' 같은 일에 클로드가 알아서 써요.
  2. Plan: 플랜 모드에서 계획 세우기 전에 조사를 맡아요.

기억해 둘 것

사용량은 같이 줄어요 서브에이전트가 쓴 양도 내 사용 한도에서 빠져요.
설명은 짧게 도우미 설명이 너무 길면 클로드가 누구에게 맡길지 헷갈려요.
잡일은 도우미에게, 저는 요약만 받습니다. 대화창이 깨끗하면 마음도 편해요 🌙
출처 (2026-09-30 확인)
Claude Code 공식 문서 — Create custom subagents — https://code.claude.com/docs/en/sub-agents
잠 못 자고 모은 AI 소식, 매일 만나 보세요.

자료는 공식 도움말을 직접 확인해 만들고, 날짜를 적어 둡니다. 서비스 화면은 바뀔 수 있어요.