클로드 한도 아끼는 두 줄, 규칙 파일 템플릿과 도우미 파일 예시

1. 첫째 줄: 규칙 파일(CLAUDE.md)

한 줄로: 클로드가 매번 시작할 때 읽는 메모장이에요. 여기에 "잔일은 도우미한테"를 적어 둬요.

왜 필요해요? 사장님이 직접 서류 창고를 뒤지면 비싼 시간이 날아가요. 메모장에 "창고 일은 직원한테"라고 붙여 두는 거예요.

사진: 공식 문서 'How Claude remembers your project' (2026-10-26)

따라 하기

1. 파일 위치를 정해요.

2. 파일이 없으면 클로드 코드에서 /init 을 치세요. 프로젝트를 읽고 시작용 CLAUDE.md 를 만들어 줘요.
3. 맨 아래에 이 절을 붙여넣으세요. 템플릿이에요.

## 일 나누기 (한도 아끼기)

- 파일 찾기, 코드 검색, 문서·웹 조사 같은 잔일은 직접 하지 말고 scout 도우미한테 넘긴다.
- 넘길 때는 "무엇을 찾아서, 어떤 모양으로 돌려줄지"를 한 줄로 적는다. (예: 로그인 처리하는 파일 경로와 줄 번호만)
- 나는 도우미가 정리해 온 결과를 보고 설계·판단·코드 수정만 한다.
- 한 파일을 처음부터 끝까지 읽어야 할 때도, 어디를 읽을지 모르면 먼저 scout 한테 위치를 찾게 한다.

확인하는 법: 클로드 코드를 새로 열고 "이 프로젝트에서 로그인 처리하는 곳 찾아 줘"라고 해 보세요. 화면에 도우미(scout)가 일하는 표시가 뜨면 돼요.

막히면

• 길게 쓰지 마세요. 공식 문서는 CLAUDE.md 를 200줄 아래로 쓰라고 해요. 길수록 한도도 먹고 잘 안 지켜요.
• 구체적으로 쓸수록 잘 지켜요. "적당히"보다 "파일 경로와 줄 번호만"처럼 확인할 수 있게 쓰세요.

2. 둘째 줄: 도우미 파일에 model: haiku

한 줄로: 도우미 파일 머리말에 모델은 하이쿠라고 적어서, 잔일을 제일 싼 모델로 돌려요.

왜 필요해요? 공식 문서에도 비용을 아끼려면 Haiku 같은 빠르고 싼 모델로 일을 보내라고 나와요.

사진: 공식 문서 'Create custom subagents' (2026-10-26)

따라 하기

1. 폴더를 정해요. 이 프로젝트만이면 .claude/agents/, 모든 프로젝트면 ~/.claude/agents/.
2. 그 폴더에 scout.md 파일을 만들고 아래를 붙여넣으세요. 도우미 파일 예시예요.

---
name: scout
description: 파일 찾기, 코드 검색, 문서·웹 조사 같은 읽기 전용 잔일 담당. Use proactively whenever something needs to be found or read before deciding.
tools: Read, Glob, Grep, WebFetch
model: haiku
---

너는 조사 담당이다.
- 요청받은 것을 찾고 읽어서 핵심만 짧게 정리해 돌려준다.
- 찾은 곳은 파일 경로와 줄 번호로 알려 준다.
- 파일은 절대 고치지 않는다. 고칠 곳이 보이면 "고칠 곳 제안"으로 따로 적는다.
- 모르는 건 지어내지 말고 "못 찾음"이라고 적는다.

확인하는 법: 클로드 코드에 "scout 도우미로 이 폴더에서 설정 파일 찾아 줘"라고 해 보세요.

막히면

• ~/.claude/agents/ 폴더를 처음 만든 경우엔 클로드 코드를 껐다 켜야 도우미를 찾아요 (공식 안내).
• 머리말 칸 이름은 철자가 정확해야 해요. 틀리면 오류 없이 그냥 무시돼요.

덤: 기본 탐색 도우미(Explore)도 싼 모델로

클로드 코드에는 원래 Explore 라는 탐색 도우미가 들어 있어요. 기본으로는 메인 대화와 같은 모델을 써요 (메인이 Fable이고 구독이면 Opus). 같은 이름 Explore 로 도우미 파일을 만들면 기본 것을 덮어쓰고, 그 파일의 모델을 따라요.

~/.claude/agents/Explore.md

---
name: Explore
description: 파일 찾기, 코드 검색, 코드베이스 둘러보기 담당. 읽기만 한다.
tools: Read, Glob, Grep
model: haiku
---

너는 탐색 담당이다. 요청받은 파일·코드를 찾고, 찾은 위치(경로와 줄 번호)와 핵심만 짧게 돌려준다. 파일은 고치지 않는다.

3. 가격 차이 (참고)

공식 모델 표의 API 가격이에요 (백만 토큰당, 2026-10-26).

구독(Pro·Max) 한도가 모델별로 몇 배 덜 빠지는지는 공식 숫자가 없어요. 그래서 "싼 모델이 덜 먹는다"까지만 말할 수 있어요.

4. 꼭 알고 하세요: 조건 두 개

1. 규칙 파일은 참고지 강제가 아니에요. 공식 문서에 "강제 설정이 아니라 참고 내용으로 다룬다"고 적혀 있어요. 그래서 가끔 안 지켜요. 무슨 일이 있어도 막아야 하는 동작은 규칙 파일 말고 훅(PreToolUse hook) 을 쓰라고 안내해요.
2. 도우미가 쓴 양도 내 한도에서 빠져요. 도우미도 따로 요청을 보내고, 메인 대화와 같은 사용 한도에서 빠져요. 대신 싼 모델이라 덜 먹어요.

용어 정리

체크리스트

• CLAUDE.md 에 '일 나누기' 절을 넣었다 (200줄 아래)
• .claude/agents/scout.md 를 만들었고 model: haiku 다
• 도우미 도구에서 Write·Edit 을 뺐다
• (덤) Explore.md 로 기본 탐색 도우미도 하이쿠로 바꿨다
• 새로 열어서 잔일을 시켰을 때 도우미가 일하는 걸 확인했다
• 꼭 막아야 하는 건 규칙 파일이 아니라 훅으로 한다

출처

• How Claude remembers your project (2026-10-26 확인)
• Create custom subagents (2026-10-26 확인)
• Models overview (2026-10-26 확인)