클로드 코드 한도, 설정 한 줄로 아낄 수 있어요.
서브에이전트는 모델을 비우면 대화 모델을 물려받아요. 검색도 Opus가 해야 할까요?
.claude/agents 폴더에 md 파일을 만드세요. 홈 폴더면 전체에 적용돼요.
맨 위에 이름, 설명, 그리고 model: haiku. 세 줄이면 끝이에요.
전부 바꾸려면 환경 변수를 haiku로 두세요. 강제는 2.1.257 버전부터예요.
단, 내장 Explore와 Plan은 안 바뀌어요. 코드 수정은 큰 모델에 맡기세요.
파일 하나, 세 줄. 추가 비용 없이 같은 한도로 더 오래 써요.
다음 편은 AI가 쓴 테스트 검사 체크리스트예요.
정리
- 왜 닳나: 서브에이전트는
model을 비워 두면 대화 모델을 물려받습니다. 대화가 Opus면 파일 검색도 Opus가 합니다. 공식 문서도 간단한 서브에이전트 작업에는model: haiku를 지정하라고 권합니다. - 만들 곳: 이 프로젝트에서만 쓰면
.claude/agents/, 내 컴퓨터의 모든 프로젝트에서 쓰면~/.claude/agents/에 md 파일 하나(예:searcher.md)를 둡니다. - 머리말 세 줄: 파일 맨 위
---사이에name: searcher·description: 파일 찾기와 요약만·model: haiku를 적습니다.model값은 sonnet · opus · haiku · fable · 전체 모델 ID · inherit 중 하나입니다. - 전체 적용: 환경 변수
CLAUDE_CODE_SUBAGENT_MODEL=haiku는 기본값으로 쓰입니다. 모든 서브에이전트에 강제하려면CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1도 함께 둡니다(클로드 코드 v2.1.257 이상). - 주의: 내장 Explore · Plan 서브에이전트는 이 환경 변수만으로는 바뀌지 않습니다. 코드 수정 같은 어려운 일은 큰 모델에 남겨 둡니다.
- 비용: 설정만 바꾸므로 추가 비용은 없습니다. 아끼는 양은 공식 수치가 없어 숫자로 적지 않았습니다. 작은 모델은 같은 한도에서 더 오래 쓸 수 있다는 정도로만 기대하면 됩니다.
따라 한다면: .claude/agents/searcher.md를 만들고 → 머리말 세 줄을 적고 → 검색 · 요약을 시킬 때 이 서브에이전트가 쓰이는지 확인하고 → 어려운 작업은 지금처럼 큰 모델로 둡니다.
출처
- Claude Code 공식 문서 「Create custom subagents」(2026.10.27 확인) — https://code.claude.com/docs/en/sub-agents
- Claude Code 공식 문서 비용 안내(2026.10.27 확인) — https://code.claude.com/docs/en/costs
- 배경 사진: StockSnap(CC0)