Claude Code 2.1: 포크된 컨텍스트, 핫 리로드 & 커스텀 에이전트 가이드
Claude Code 2.1 Skills 기능 심층 분석: 포크된 컨텍스트, 핫 리로드, 커스텀 에이전트 지원. 실제 예제와 코드로 이 기능을 사용하는 방법을 알아보세요.
Claude Code 2.1은 에이전트 워크플로를 구축하고 실행하는 방식을 근본적으로 바꾸는 세 가지 Skill 수준 기능을 출시했습니다: 포크된 컨텍스트, 핫 리로드, 커스텀 에이전트 지원. Skills를 단순한 슬래시 커맨드 단축키로만 사용해 왔다면, 이 가이드가 Skills의 진정한 가능성을 보여줄 것입니다. 작동하는 frontmatter 예제, 구체적인 사용 사례, Claude Code 세션 내에서 전적으로 멀티 에이전트 파이프라인을 구성하기 위한 멘탈 모델을 가지고 돌아갈 수 있습니다.
이 세 가지 기능이 중요한 이유
2.1 이전에 Skills는 본질적으로 상태 비저장 프롬프트 템플릿이었습니다. 모든 호출이 현재 대화 내에서 실행되어 동일한 컨텍스트 윈도우를 공유하고 — 잠재적으로 오염시켰습니다. Skill이 긴 배치 작업을 실행하거나, 잘못된 리서치 경로를 따라가거나, 단순히 많은 중간 출력을 생성하면, 그 모든 것이 메인 세션에 남았습니다.
포크된 컨텍스트는 격리 문제를 해결합니다. 핫 리로드는 반복 속도 문제를 해결합니다. 커스텀 에이전트 지원은 전문화 문제를 해결합니다. 함께 사용하면 Skills를 "스마트 매크로"에서 Unix 파이프처럼 구성할 수 있는 완전한 서브 에이전트 오케스트레이션으로 전환합니다.
context-engineering Skill은 프로덕션 수준의 에이전트 아키텍처를 빠르게 시작하고 싶다면 이러한 패턴 중 많은 것을 캡처합니다. skill-creator Skill도 설치해 두면 좋습니다 — 아래에 표시된 frontmatter를 처음부터 올바르게 작성하는 데 도움이 됩니다.
포크된 컨텍스트: 장기 실행 작업을 위한 격리
Skill의 frontmatter에 context: fork를 추가하여 격리된 서브 세션에서 실행하세요.
---
name: deep-research
description: >
메인 세션을 오염시키지 않고 다단계 리서치 작업을 실행합니다.
주제를 철저히 조사하고 깔끔한 요약을 받아야 할 때 사용하세요.
context: fork
---
사용자가 이 Skill을 호출하면, Claude Code가 현재 대화 상태의 스냅샷을 찍어 서브 에이전트에게 전달합니다. 서브 에이전트는 읽기, 파일 쓰기, 도구 호출, 심지어 실패할 수도 있지만 — 메인 컨텍스트에는 아무것도 영향을 미치지 않습니다. 포크가 완료되면 Claude가 결과를 단일 어시스턴트 메시지로 표시합니다.
포크된 컨텍스트를 사용할 때:
- 스크롤하기 싫은 대량의 중간 출력을 생성하는 리서치 또는 분석 작업
- 배치 처리 작업 (파일 이름 변경, 전체 레포 린팅, 테스트 픽스처 생성)
- 깔끔한 롤백이 필요한 모든 작업: 포크가 나쁜 출력을 생성하면 단순히 폐기
사용하지 말아야 할 때:
- 포크 내에서 대화를 주고받고 싶은 대화형 작업 — 포크는 자율적으로 실행되며 대화형이 아님
- 공유 상태를 수정하고 그 변경이 메인 세션에서 즉시 보여야 하는 작업
좋은 실세계 예시: 포크된 컨텍스트를 context-engineering Skill의 exploration-agent 패턴과 결합하세요. 메인 세션은 깨끗하게 유지되면서 포크가 200개의 소스 파일을 파고들어 관련 파일을 찾습니다.
---
name: codebase-audit
description: >
보안 안티 패턴에 대해 코드베이스를 감사하고 우선순위가 매겨진
발견 보고서를 반환합니다. 메인 세션을 파일 검색 출력으로
오염시키지 않기 위해 포크된 컨텍스트에서 실행됩니다.
context: fork
tools:
- Read
- Glob
- Grep
disable-model-invocation: false
---
당신은 보안 감사자입니다. 현재 프로젝트의 모든 소스 파일을 체계적으로
스캔하여 다음 패턴을 찾으세요: 하드코딩된 시크릿, SQL 문자열 연결,
입력 유효성 검사 누락, 더 이상 사용되지 않는 암호화 API 사용.
심각도별로 정렬된 마크다운 보고서를 반환하세요. 중간 검색 결과는
출력하지 마세요 — 최종 구조화된 발견만 출력하세요.
핫 리로드: 재시작 없이 Skills 반복
핫 리로드 이전에는 Skill 업데이트가 Claude Code 재시작(세션 손실) 또는 새 세션 시작을 의미했습니다. 2.1에서는 SKILL.md 파일을 편집하고 실행하세요:
/reload-skills
Skill 정의가 즉시 업데이트됩니다. 대화 컨텍스트는 그대로 유지됩니다. 이 단일 명령으로 Skill 개발 반복 시간이 실제로 약 80% 단축되었습니다 — 이제 여러 세션 재시작에 걸친 대신 15-30분 안에 작동하는 Skill을 빌드하고 테스트할 수 있습니다.
핫 리로드를 사용한 실용적 개발 워크플로:
- 초안으로
SKILL.md생성 /your-skill-name으로 Skill 호출- Claude가 무엇을 하는지 (또는 잘못하는지) 관찰
- 에디터에서
SKILL.md편집 /reload-skills실행- 다시 호출 — 같은 세션, 업데이트된 동작
이 빠른 피드백 루프는 처음부터 완벽하게 만들려고 하지 않고 반복적으로 Skills를 작성하는 것을 실용적으로 만듭니다. skill-creator Skill은 정확히 이 워크플로를 활용하도록 설계되었습니다 — 첫 번째 초안을 생성하고, 개선하면, 핫 리로드가 변경 사항을 바로 가져옵니다.
파일 감시 팁: 집중적인 Skill 개발을 한다면, 핫 리로드를 에디터의 자동 저장과 결합하세요. 왕복이 됩니다: 파일 저장 → /reload-skills → 테스트 — 30초마다 실행할 수 있는 사이클입니다.
커스텀 에이전트 지원: 전문 서브 에이전트
agent frontmatter 필드를 사용하면 Skill이 실행될 때 사용할 에이전트 설정을 지정할 수 있습니다. 이것은 포크된 컨텍스트와 별개입니다 — Skill은 포크 없이 커스텀 에이전트를 사용할 수 있고, 커스텀 에이전트로 포크할 수도 있습니다.
---
name: pr-reviewer
description: >
로직 오류, 보안 이슈, 스타일 위반에 대해 풀 리퀘스트를 리뷰합니다.
구조화된 피드백을 GitHub 리뷰 코멘트로 반환합니다.
context: fork
agent: .claude/agents/strict-reviewer.md
tools:
- Bash
- Read
---
.claude/agents/strict-reviewer.md 파일은 해당 전문가의 성격, 제약 조건, 도구 권한을 정의합니다. 이는 무엇을(Skill의 작업 정의)과 어떻게(에이전트의 운영 모델)를 분리합니다.
세 가지 에이전트 타겟팅 옵션:
| 필드 값 | 동작 |
|---|---|
agent: explore | 내장 Explore 에이전트 사용 (읽기 전용, 광범위 검색) |
agent: plan | 내장 Plan 에이전트 사용 (분석 및 분해) |
agent: .claude/agents/my-agent.md | 커스텀 에이전트 정의 사용 |
커스텀 에이전트는 에이전트의 역할, 허용된 도구, 시스템 수준 지침을 설명하는 frontmatter 블록이 있는 마크다운 파일입니다. 전문가 라이브러리를 유지할 수 있습니다 — 엄격한 보안 리뷰어, 관대한 브레인스토밍 파트너, 간결한 코드 생성기 — 필요에 따라 Skills에 구성할 수 있습니다.
커스텀 에이전트 정의 예시:
---
name: strict-reviewer
description: >
보안, 정확성, 성능에 초점을 맞춘 보수적인 코드 리뷰어.
간결하고 실행 가능한 피드백을 생성합니다.
테스트되지 않은 엣지 케이스가 있는 코드를 절대 승인하지 않습니다.
tools:
- Read
- Grep
- Bash
model: claude-opus-4-5
---
당신은 구조화된 코드 리뷰를 수행하는 시니어 엔지니어입니다.
구체적이고 줄 번호를 인용하세요. 모호한 것은 차단이 아닌
질문으로 플래그하세요. 리뷰 코멘트의 JSON 배열로 출력을 반환하세요.
세 가지 모두 결합: 완전한 파이프라인 예시
세 가지 기능을 모두 함께 사용하는 실세계 패턴: 리서치에서 보고서까지 파이프라인.
1단계: 리서치 Skill (포크, 커스텀 에이전트)
---
name: market-research
description: >
시장 세그먼트를 리서치하고 구조화된 발견을 반환합니다.
메인 세션을 깨끗하게 유지하기 위해 격리 실행됩니다.
context: fork
agent: .claude/agents/researcher.md
tools:
- WebSearch
- Read
- Bash
---
다음 시장 세그먼트를 철저히 리서치하세요. 키가 overview, key_players,
growth_trends, risks, opportunities인 JSON 객체를 반환하세요.
소스를 인라인으로 인용하세요. 원시 검색 출력은 포함하지 마세요.
2단계: 보고서 Skill (일반 컨텍스트, 리서치 출력 소비)
---
name: generate-report
description: >
구조화된 시장 리서치 JSON을 경영진용 PDF 보고서로 변환합니다.
/market-research 후에 호출하세요.
tools:
- Read
- Bash
disable-model-invocation: false
---
이전 메시지의 시장 리서치 JSON을 가져와 세련된 경영진 보고서를
생성하세요. scripts/generate-report.py 스크립트를 사용하세요.
완료되면 파일 경로를 출력하세요.
1단계의 포크가 모든 복잡한 검색 트래픽을 세션 밖에 유지합니다. 2단계는 깨끗한 JSON 출력을 받아 상호작용할 수 있는 메인 컨텍스트에서 실행됩니다.
Frontmatter의 Hook: 숨겨진 네 번째 기능
2.1 릴리스에서는 별도의 Hook 설정 파일 대신 Skill의 frontmatter에 직접 라이프사이클 Hook을 첨부하는 기능도 추가되었습니다. 다른 세 가지 기능보다 작지만 전체 그림을 완성합니다.
---
name: safe-deploy
description: >
현재 브랜치를 스테이징 환경에 배포합니다.
사전 배포 검사를 실행하고 완료 시 Slack에 알립니다.
disable-model-invocation: true
hooks:
pre-tool-use:
- command: "bash scripts/pre-deploy-check.sh"
on_failure: block
post-tool-use:
- command: "bash scripts/notify-slack.sh"
on_failure: warn
---
pre-tool-use Hook은 Claude가 도구를 호출하기 전에 실행됩니다. on_failure: block으로 설정하면 실패한 검사가 Skill이 진행하지 못하게 합니다 — 배포와 같은 파괴적 작업에 정확히 원하는 것입니다. post-tool-use Hook은 각 도구 호출 후 실행되어 로깅이나 알림에 유용합니다.
disable-model-invocation: true와 결합하면, 이 패턴은 대화형 AI보다 검증된 셸 스크립트처럼 동작하는 Skills를 만듭니다 — 깨끗하게 성공하거나 실패하며, Skill 지침에 묻히지 않고 frontmatter 수준에서 부작용이 제어됩니다.
기존 Skills를 2.1로 마이그레이션
2.1 이전에 작성된 Skills가 있다면, 최소한의 마이그레이션 체크리스트입니다:
1. 포크된 컨텍스트 후보 식별
많은 중간 출력을 생성하는 Skills를 찾으세요: 리서치 Skills, 감사 스크립트, 테스트 실행기. frontmatter에 context: fork를 추가하세요. 다른 변경은 필요 없습니다.
2. 수동 리로드 해결책 제거
Skill 변경을 적용하기 위해 Claude Code를 재시작하는 스크립트나 별칭이 있다면 삭제하세요. /reload-skills가 모두 대체합니다.
3. 재사용 가능한 에이전트 페르소나 추출
특정 "페르소나"(엄격한 리뷰어, 창의적 브레인스토머, 간결한 요약자)를 설명하는 긴 시스템 프롬프트 섹션이 있는 Skills가 있다면, 해당 섹션을 .claude/agents/ 파일로 이동하세요. agent: 필드로 참조하세요. 이렇게 하면 복사-붙여넣기 없이 여러 Skills에서 페르소나를 재사용할 수 있습니다.
4. 위험한 Skills에 Hook 추가
파일을 쓰거나, 배포를 실행하거나, 메시지를 보내거나, 외부 API를 호출하는 모든 Skill에 확인 또는 유효성 검사 스크립트가 있는 pre-tool-use Hook을 추가해야 합니다. 되돌릴 수 없는 부작용이 있는 모든 Skill에 disable-model-invocation: true 플래그를 설정해야 합니다.
이 마이그레이션은 완전히 하위 호환됩니다 — 이러한 새 필드가 없는 Skills는 이전과 정확히 동일하게 작동합니다.
다음에 빌드할 것
이 세 가지 기능은 2.1 이전에는 실용적이지 않았던 워크플로를 열어줍니다:
- 병렬 리서치: 다른 주제에 대해 여러 포크된 리서치 Skills를 동시에 호출한 후 메인 세션에서 합성
- 단계별 코드 리뷰: 엄격한 리뷰어로 포크, 성능 리뷰어로 별도 포크, 메인에서 발견 사항 병합
- 안전한 리팩토링: 대규모 리팩토링을 시도하기 위해 포크, diff 검사, 적용 여부 결정
오늘 바로 설치할 수 있는 준비된 패턴으로, context-engineering Skill이 가장 포괄적인 시작점입니다 — 멀티 에이전트 아키텍처를 위해 특별히 제작되었으며 컨텍스트 포킹, 에이전트 구성, 프로덕션 수준의 오케스트레이션 패턴을 다룹니다. skill-seekers와 함께 사용하여 모든 문서를 이 파이프라인에 맞는 도메인별 Skill로 변환하세요.
Claude Code 2.1 릴리스는 Skills를 편의 기능에서 진정한 오케스트레이션 레이어로 전환했습니다. claudeskills.info의 141개 이상 Skills의 전체 에코시스템은 이제 그 렌즈로 살펴볼 가치가 있습니다 — 포크된 컨텍스트와 커스텀 에이전트를 결합하면 많은 Skills가 훨씬 더 강력해집니다.
