Claude Code 상세 사용법 20: checkpoint와 plugin으로 팀 루틴 고정하기 | DAKER 커뮤니티
Claude Code 상세 사용법 20: checkpoint와 plugin으로 팀 루틴 고정하기
Claude Code를 오래 쓰면 두 가지 문제가 반복된다. 첫째, 실험하다가 좋은 상태를 잃는다. 둘째, 잘 만든 프롬프트와 hook, MCP 설정이 사람마다 흩어진다. 공식 checkpoint 문서는 세션 안 되돌리기와 요약을, plugin 문서는 skill, agent, hook, MCP를 팀 단위로 묶는 방법을 제공한다.
1. checkpoint는 Git 대체물이 아니다
공식 문서 기준 Claude Code는 파일 편집 도구로 만든 변경을 프롬프트마다 checkpoint로 추적한다. /rewind를 실행하거나 빈 입력에서 Esc를 두 번 눌러 메뉴를 연다.
/rewind선택지는 분리해서 봐야 한다. 코드가 깨졌으면 Restore code, 대화 방향만 틀렸으면 Restore conversation, 긴 디버깅 대화를 줄이고 싶으면 Summarize를 고른다. Bash 명령이 만든 파일 변경, 외부 편집기에서 바꾼 파일, 다른 동시 세션의 변경은 checkpoint가 완전히 책임지지 않는다. 장기 이력은 여전히 Git branch와 commit으로 관리한다.
2. 실험 프롬프트에는 복구 기준을 붙인다
간단한 manifest는 이렇게 시작한다.
{
"name": "team-dev-loop",
"description": "Shared review and test workflows",
"version": "1.0.0"
}skill은 namespaced 명령이 된다. 예를 들어 team-dev-loop plugin의 skills/review-pr/SKILL.md는 /team-dev-loop:review-pr로 호출된다. 수정 중에는 /reload-plugins로 다시 로드하고, 구조가 이상하면 먼저 디렉터리가 .claude-plugin/ 안에 들어가지 않았는지 확인한다.
4. 팀 배포 전 체크리스트
plugin에 비밀값을 넣지 않는다. MCP 서버가 API 키를 요구하면 키 이름과 승인 절차만 문서화한다. hook은 자동 수정보다 검증 중심으로 시작한다. LSP나 외부 바이너리가 필요하면 설치 전제도 같이 쓴다. 무엇보다 plugin은 "좋은 프롬프트 모음"이 아니라 팀의 개발 워크플로우 계약이어야 한다.
Senior takeaway: checkpoint는 실험의 손실을 줄이고, plugin은 성공한 실험을 팀 루틴으로 만든다. 클로드 코드 운영은 이 두 축을 연결할 때 코드 리뷰, 테스트 자동화, MCP 도구 연결이 일회성 바이브코딩을 넘어 반복 가능한 LLM 개발 워크플로우가 된다.
리팩터링을 맡길 때는 Claude에게도 중단 기준을 알려야 한다.
Refactor the payment error mapping.
Keep the public API unchanged.
Run npm test -- payment-errors.
If more than three files need changes, stop and explain why before editing further.이렇게 쓰면 결과가 틀렸을 때 /rewind로 돌아갈 지점도 선명하다. AI 코딩에서 중요한 것은 "되돌릴 수 있음"이 아니라 "어디로 돌아가야 하는지 알고 있음"이다.
3. 반복 루틴은 plugin 후보로 승격한다
개인 실험은 .claude/ 설정으로 충분하다. 하지만 코드 리뷰, 릴리스 점검, 보안 검사처럼 여러 프로젝트에서 반복되는 루틴은 plugin이 낫다. 공식 plugin 문서 기준 plugin은 .claude-plugin/plugin.json manifest와 루트 수준의 skills/, agents/, hooks/, .mcp.json 등을 묶는다.
mkdir my-team-plugin
mkdir my-team-plugin/.claude-plugin
mkdir -p my-team-plugin/skills/review-pr
claude --plugin-dir ./my-team-plugin