---
name: opencurrent-code-context
description: "긴 작업에서 컨텍스트가 꽉 차 Claude Code가 앞 내용을 놓치는 일을 줄이고, 쓸데없이 쌓인 대화 때문에 늘어나는 비용도 아낄 수 있습니다. 이럴 때 사용: /context로 무엇이 자리를 차지하는지 보고, 같은 일을 이어 갈 때는 /compact에 남길 것을 적어 요약합니다. 관련 없는 일로 넘어갈 때는 /clear로 새로 시작하고, 넓은 조사는 서브에이전트에 맡겨 요약만 받습니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다. 도구: Claude Code."
metadata:
  source: "https://opencurrent.ai/w/claude-code-context"
  opencurrent-id: "claude-code-context"
  verification: "pending"
  exported-at: "2026-11-21T11:03:05.303Z"
---

# 긴 작업의 컨텍스트 관리하기

긴 작업에서 컨텍스트가 꽉 차 Claude Code가 앞 내용을 놓치는 일을 줄이고, 쓸데없이 쌓인 대화 때문에 늘어나는 비용도 아낄 수 있습니다.

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/claude-code-context
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("claude-code-context")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

/context로 무엇이 자리를 차지하는지 보고, 같은 일을 이어 갈 때는 /compact에 남길 것을 적어 요약합니다. 관련 없는 일로 넘어갈 때는 /clear로 새로 시작하고, 넓은 조사는 서브에이전트에 맡겨 요약만 받습니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

## 준비물

- Claude Code 설치와 로그인

## 단계

### 1. 지금 쓰는 양 보기 (명령 실행 · Claude Code)

/context는 컨텍스트 사용량을 색 격자로 보여 줍니다. /context all이면 항목별로 자세히 나옵니다.

프롬프트:

```text
/context
```

기대 결과: 컨텍스트 사용 격자

확인 방법: CLAUDE.md·도구·대화가 각각 얼마나 차지하는지 확인

### 2. 남길 것을 정해 요약 (명령 실행 · Claude Code)

같은 작업을 이어 갈 때는 /compact 뒤에 무엇을 남길지 적습니다. CLAUDE.md에 "# Compact instructions" 제목과 한 줄을 두면 요약할 때마다 그 기준을 따릅니다.

프롬프트:

```text
/compact 바꾼 파일 목록, 남은 할 일, 실패한 테스트 이름은 꼭 남겨
```

기대 결과: 요약된 대화

확인 방법: /context로 사용량이 줄었는지 확인

### 3. 다른 일은 새 대화로 (명령 실행 · Claude Code)

관련 없는 일로 넘어갈 때는 /clear로 비웁니다. 나중에 돌아올 대화는 먼저 /rename으로 이름을 붙이면 /resume에서 찾기 쉽습니다.

프롬프트:

```text
/rename 결제-버그
/clear
```

기대 결과: 빈 대화

확인 방법: /resume 목록에 이름 붙은 대화가 보이는지 확인

### 4. 넓은 조사는 서브에이전트로 (AI에게 · Claude Code)

코드베이스 전체를 훑는 조사는 서브에이전트에 맡기면 긴 출력이 메인 대화에 쌓이지 않고 요약만 돌아옵니다.

프롬프트:

```text
서브에이전트로 토큰 갱신이 어떻게 처리되는지 조사하고, 관련 파일과 흐름만 요약해 줘.
```

기대 결과: 요약만 받은 조사 결과

확인 방법: /context에서 대화 몫이 크게 늘지 않았는지 확인

## 주의할 점

- 요약하면 세부 내용이 빠질 수 있음. 꼭 필요한 값은 /compact 지시에 적기
- CLAUDE.md가 길면 모든 대화의 바닥 사용량이 올라감. 200줄 안쪽으로
- /clear 하면 /usage의 세션 합계도 처음부터 다시 셈

## 출처

- [Claude Code 문서: 비용 관리](https://code.claude.com/docs/en/costs)
- [Claude Code 문서: 내장 명령](https://code.claude.com/docs/en/commands)
- [Claude Code 문서: 자주 쓰는 작업](https://code.claude.com/docs/en/common-workflows)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/claude-code-context 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
