개념한 문장
여러 Claude를 동시에, 충돌 없이
세션 하나로는 한 번에 한 갈래입니다. 기능 개발과 버그 수정을 동시에 돌리면 빠르지만, 같은 파일을 건드리면 충돌합니다 — git worktree가 이를 막습니다.
한 문장으로worktree는 브랜치마다 독립된 폴더를 만들어 Claude를 따로 돌리는 것입니다.
세 방식언제 무엇을
용도가 다릅니다
| 방식 | 쓰는 때 | 명령 |
|---|---|---|
| 서브에이전트 | 큰 코드베이스 조사로 문맥이 차는 걸 막을 때 | 프롬프트로 위임 |
| worktree | 두 작업을 동시에, 파일 충돌 없이 | claude --worktree <name> |
| 백그라운드 | 여러 병렬 세션을 한눈에 관리 | claude agents |
실습20분
병렬로 돌려보기
터미널 두 개를 열어 각각 실행합니다. 두 세션은 서로의 파일을 건드리지 않습니다.
claude --worktree feature-auth
claude --worktree bugfix-login
한 세션 안에서 조사만 위임하려면 서브에이전트를 씁니다 — 결과 요약만 돌아와 메인 대화가 깨끗합니다.
서브에이전트를 써서 인증 시스템이 토큰 갱신을 어떻게 처리하는지 조사해줘
전제 조건worktree는 git 저장소 + 커밋 1개 이상이 필요합니다. .claude/worktrees/를 .gitignore에 추가하세요.
자주 쓰는 에이전트는 파일로 고정한다
매번 역할을 설명하는 대신 .claude/agents/에 적어두면, 같은 조건으로 반복해 부를 수 있습니다.
# .claude/agents/code-reviewer.md --- name: code-reviewer description: 커밋 전 변경분을 리뷰할 때 사용. 버그와 누락된 예외 처리를 찾는다. tools: Read, Grep, Glob, Bash model: sonnet --- 너는 시니어 리뷰어다. `git diff`로 변경분만 본다. 1. 변경된 줄에서만 문제를 찾는다 (주변 코드 지적 금지) 2. 각 지적은 `파일:줄 — 문제 — 재현 조건` 형식 3. 스타일 취향은 말하지 않는다. 동작이 틀린 것만.
| 항목 | 의미 |
|---|---|
| description | 언제 부를지를 Claude가 이 문장으로 판단 — 가장 중요 |
| tools | 생략하면 전체 도구 상속. 읽기 전용이면 Read, Grep, Glob만 |
| model | 가벼운 작업은 저렴한 모델로 — 생략 가능 |
- worktree로 두 세션을 동시에 돌려봤다
- 서브에이전트로 조사를 위임해봤다
- 언제 어느 방식을 쓸지 구분할 수 있다
- .claude/agents에 에이전트를 하나 만들었다
클로드코드 시작하기Claude Code · 규칙과 확장