{"id":"claude-code-context","kind":"workflow","testedWith":[],"durationMin":10,"url":"https://opencurrent.ai/w/claude-code-context","title":"긴 작업의 컨텍스트 관리하기","summary":"긴 작업에서 컨텍스트가 꽉 차 Claude Code가 앞 내용을 놓치는 일을 줄이고, 쓸데없이 쌓인 대화 때문에 늘어나는 비용도 아낄 수 있습니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Claude Code"],"whenToUse":"/context로 무엇이 자리를 차지하는지 보고, 같은 일을 이어 갈 때는 /compact에 남길 것을 적어 요약합니다. 관련 없는 일로 넘어갈 때는 /clear로 새로 시작하고, 넓은 조사는 서브에이전트에 맡겨 요약만 받습니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.","prerequisites":["Claude Code 설치와 로그인"],"inputs":[],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. 단계를 순서대로 진행할 것. kind가 \"ai\"면 프롬프트를 실행하고, \"command\"면 사용자의 허락을 받고 명령을 실행하고, \"human\"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.\n3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.\n4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.\n5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"command","title":"지금 쓰는 양 보기","body":"/context는 컨텍스트 사용량을 색 격자로 보여 줍니다. /context all이면 항목별로 자세히 나옵니다.","prompt":"/context","expected":"컨텍스트 사용 격자","check":"CLAUDE.md·도구·대화가 각각 얼마나 차지하는지 확인","tool":"Claude Code"},{"n":2,"kind":"command","title":"남길 것을 정해 요약","body":"같은 작업을 이어 갈 때는 /compact 뒤에 무엇을 남길지 적습니다. CLAUDE.md에 \"# Compact instructions\" 제목과 한 줄을 두면 요약할 때마다 그 기준을 따릅니다.","prompt":"/compact 바꾼 파일 목록, 남은 할 일, 실패한 테스트 이름은 꼭 남겨","expected":"요약된 대화","check":"/context로 사용량이 줄었는지 확인","tool":"Claude Code"},{"n":3,"kind":"command","title":"다른 일은 새 대화로","body":"관련 없는 일로 넘어갈 때는 /clear로 비웁니다. 나중에 돌아올 대화는 먼저 /rename으로 이름을 붙이면 /resume에서 찾기 쉽습니다.","prompt":"/rename 결제-버그\n/clear","expected":"빈 대화","check":"/resume 목록에 이름 붙은 대화가 보이는지 확인","tool":"Claude Code"},{"n":4,"kind":"ai","title":"넓은 조사는 서브에이전트로","body":"코드베이스 전체를 훑는 조사는 서브에이전트에 맡기면 긴 출력이 메인 대화에 쌓이지 않고 요약만 돌아옵니다.","prompt":"서브에이전트로 토큰 갱신이 어떻게 처리되는지 조사하고, 관련 파일과 흐름만 요약해 줘.","expected":"요약만 받은 조사 결과","check":"/context에서 대화 몫이 크게 늘지 않았는지 확인","tool":"Claude Code"}],"pitfalls":["요약하면 세부 내용이 빠질 수 있음. 꼭 필요한 값은 /compact 지시에 적기","CLAUDE.md가 길면 모든 대화의 바닥 사용량이 올라감. 200줄 안쪽으로","/clear 하면 /usage의 세션 합계도 처음부터 다시 셈"],"sources":[{"title":"Claude Code 문서: 비용 관리","url":"https://code.claude.com/docs/en/costs"},{"title":"Claude Code 문서: 내장 명령","url":"https://code.claude.com/docs/en/commands"},{"title":"Claude Code 문서: 자주 쓰는 작업","url":"https://code.claude.com/docs/en/common-workflows"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-21T10:00:00+00:00","basis":"updated"},"updatedAt":"2026-11-21T10:00:00+00:00","goals":[{"id":"dev","title":"개발"}],"uses":0,"likes":0}