cablate/ctx-handoff-mod
요약
ctx-handoff 모드는 Claude 코드 세션의 연속성을 유지하고, 사용자가 반복적인 작업을 할 때 발생하는 문제들을 해결합니다. 대화 내용이 가득 차거나 장시간 자리를 비울 경우에도 이전 맥락을 기억하며, 프로젝트 노트와 스킬을 통해 지침과 사실을 관리할 수 있습니다.
핵심 포인트
- 대화 세션의 연속성을 유지하여 반복적인 작업에 용이함.
- 장시간 부재 시 최대 4시간까지 캐시를 유지하여 비용 절감.
- 프로젝트별 노트 및 스킬로 핵심 정보를 구조적으로 저장하고 로드함.
- 사용자 소유 파일 형태로 관리되어 Anthropic 외부에 전송되지 않음.
자체적으로 긴 Claude 코드 세션을 유지하고, Claude가 학습한 내용을 기억하게 하며, 일반적인 오류를 포착합니다.
English · 繁體中文 · 설치 · 기능 · 가이드 · 변경 로그
긴 Claude 코드 세션은 같은 작업을 반복해야 하는 상황에 자주 직면합니다. ctx-handoff는 이를 백그라운드에서 처리하므로, 일반적인 사용 시에는 명령어를 입력할 필요가 없습니다.
| 언제… | 이것이 없을 때 | ctx-handoff를 사용할 때 |
|---|---|---|
| 대화 내용이 거의 가득 찼을 때 | 요약문을 작성하고, /clear 후 붙여넣기 함 | 요약문이 작성되고, 대화가 지워지며, 새로운 대화가 계속됨 |
| 한 시간 동안 자리를 비울 때 | 다음 메시지가 모든 내용을 전체 비용으로 다시 읽음 | 캐시가 최대 약 4시간 동안 유지됨 |
| 지침을 반복할 때 | 다음 대화에서 이를 잊어버림 | 프로젝트 노트가 되며, 리포지토리의 라인당 3회 이후에 적용됨 |
/clear를 하거나 Claude Code를 다시 열 때 | 새로운 대화가 아무것도 모른 채 시작됨 | 마지막으로 어디서 끝났는지 알려줌 |
| Claude가 실패한 명령을 재시도하거나, 테스트 없이 |
60만 토큰에 도달하면 Claude와 그 하위 에이전트가 완료될 때까지 기다린 후, 검증된 작업과 미검증 변경 사항을 분리하는 요약본을 작성하고, 실패한 목록, 사용자가 직접 설정한 제한 사항, 이미 발견된 내용을 나열하며, 다음 단계 하나로 마무리합니다. 이후 대화는 초기화되고 새로운 대화에서 계속됩니다. 그 사이에 입력하는 모든 내용은 유지됩니다.
선호도(Preferences), 수정 사항(corrections) 및 사실(facts)은 프로젝트당 하나의 Markdown 노트 파일이 되어 모든 새 대화에 로드됩니다. 반복하는 루틴은 프로젝트 스킬(project skills)이 됩니다. Sonnet 5.5는 낮은 노력으로 대화의 새로운 부분만 읽습니다.
/handoff guard suggest
자주 발생하는 규칙을 도구 호출(tool calls) 검사로 변환하며, 승인할 때까지 아무것도 적용되지 않습니다. /handoff panel
프롬프트 위에 가드(guards), 메모리(memories), 규칙(rules), 최신 노트 업데이트 및 모든 설정을 위한 패널을 엽니다.
모든 것은 패널의 설정(Settings) 탭( /handoff panel, 그리고 5)에 있으며, 각 값이 어디서 왔는지와 재설정 버튼이 있습니다. 기본값은 그대로 두는 것이 좋습니다. 가이드에서 모든 설정을 나열합니다.
자체 서버가 없습니다. 사용자의 Claude Code 로그인으로 실행되며, 대화 자체처럼 Anthropic 외에는 아무 곳에도 전송하지 않습니다.작고 예측 가능한 비용입니다. 핸드오프(handoff)는 하나의 요청이며, 캐시 새로 고침은 입력 가격의 약 1/10로 캐시에서 읽어옵니다. 노트 업데이트는 대화의 새로운 부분만 전송합니다. 알림(nudges)은 비용이 들지 않습니다.사용자가 소유한 일반 파일입니다. 노트는 ~/.claude/projects/에 Markdown 형식으로 저장됩니다. claude plugin validate로 모드가 무엇을 할 수 있는지 확인해 보세요. 가이드에서 모든 항목을 설명합니다.
- 가이드(Guide): 기능, 설정, 명령어, 권한, 지원 환경, 제한 사항, 문제 해결 및 제거를 상세히 다룹니다.
- 변경 로그(Changelog): 각 버전별로 무엇이 바뀌었는지 그리고 업그레이드할 가치가 있는 이유를 설명합니다.
- 기여하기(Contributing): 소스에서 실행하고 변경 사항을 전송하는 방법을 안내합니다. 버그 보고 및 아이디어는 이슈(issues)에 남겨주세요.
- 보안(Security): 취약점을 비공개로 신고하는 방법을 알려줍니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기