`/context` 명령: 토큰을 위한 X-Ray Vision

Source: Dev.to

위에 있는 링크에 있는 전체 글을 번역해 드리려면, 번역이 필요한 본문을 그대로 복사해서 제공해 주시겠어요?
코드 블록, URL, 마크다운 구문 등은 그대로 유지하고, 텍스트 내용만 한국어로 번역해 드리겠습니다.

소개

모든 AI 모델은 컨텍스트 윈도우를 가지고 있습니다—한 번에 고려할 수 있는 정보의 양이 제한되어 있죠. 이를 작업 기억이라고 생각하면 됩니다. Claude의 경우 이 윈도우가 꽤 넓지만 무한하지는 않습니다. 대부분의 개발자는 실제 프롬프트가 그 소중한 공간을 차지하는 전체의 일부분에 불과하다는 사실을 깨닫지 못합니다.

그 뒤에서는 다음과 같은 것들이 조용히 토큰 예산을 소모합니다:

• 시스템 프롬프트
• MCP 서버 설정
• 메모리 파일
• 누적된 대화 기록

이 모든 것이 조용히 토큰을 잡아먹습니다. 지금까지는 이것이 블랙 박스였으며, 왜 제한에 도달했는지 이해하지 못하거나, 원인을 모른 채 응답 품질이 떨어지는 것을 경험했을 것입니다.

우리 시리즈의 Day 8에 오신 것을 환영합니다. 오늘은 /context 명령을 통해 커튼을 걷어올려, Claude Code 세션 내부에서 정확히 무슨 일이 일어나고 있는지 확인할 수 있는 개인 X‑ray를 제공합니다.

문제

AI 도구에서 토큰 관리가 여러 이유로 인해 답답합니다:

컨텍스트 윈도우는 AI 지원 개발에서 가장 중요한 자원이라고 할 수 있습니다. 눈을 가리고 작업하는 것은 전략이 아니라 도박입니다.

해결책

/context 명령은 컨텍스트‑윈도우 사용량에 대한 완전한 가시성을 제공합니다.

사용 방법

/context

그게 전부입니다. Claude Code는 현재 세션에서 토큰을 소비하는 모든 항목에 대한 자세한 분석을 표시합니다.

당신이 보게 될 내용

출력은 포괄적인 개요를 제공합니다:

📊 Context Window Usage
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Total Capacity:    200,000 tokens
Currently Used:     47,832 tokens (24%)
Available:         152,168 tokens

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

BREAKDOWN:

System Prompt           3,247 tokens   (6.8%)
├─ Base instructions      892 tokens
├─ Tool definitions     1,455 tokens
└─ Safety guidelines      900 tokens

MCP Servers             8,921 tokens  (18.6%)
├─ filesystem           2,341 tokens
├─ github                3,892 tokens
└─ database              2,688 tokens

Memory Files            5,443 tokens  (11.4%)
├─ CLAUDE.md            2,156 tokens
└─ project-context.md   3,287 tokens

Conversation History   28,104 tokens  (58.8%)
├─ Turn 1               4,521 tokens
├─ Turn 2               8,932 tokens
├─ Turn 3               6,221 tokens
└─ Turn 4               8,430 tokens

Pending Files           2,117 tokens   (4.4%)
└─ src/utils.ts         2,117 tokens

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

출력 읽기

전문가 팁

1. /context를 일찍 그리고 자주 실행하세요
   복잡한 작업을 시작할 때 컨텍스트를 확인하세요. 아무 작업도 하기 전에 이미 용량이 60 %에 도달했다면 새 세션을 시작하거나 히스토리를 압축하는 것을 고려하세요.

2. MCP 서버를 점검하세요
   특정 서버가 많은 토큰을 사용하고 있지만 해당 기능을 사용하지 않는다면 현재 세션에서 연결을 끊으세요:

   /mcp disconnect database

3. 메모리 파일을 가볍게 유지하세요

   # Good: Essential context
   - TypeScript + React project
   - Uses Zustand for state
   - API base: /api/v2/
   
   # Bad: Excessive detail
   - Complete API documentation (500 lines)
   - Full component inventory
   - Historical decisions log

4. 히스토리가 부풀어 오를 때 /compact를 사용하세요
   대화 히스토리가 주요 자원 소비원이라면, /compact 명령을 사용해 핵심 컨텍스트를 유지하면서 요약하고 줄일 수 있습니다.

5. 새 작업을 위해 새로 시작하세요
   관련 없는 작업을 위해 새 세션을 시작하는 것을 주저하지 마세요. 관련 없는 히스토리를 유지하는 것은 순수한 낭비입니다.

실제 사용 사례

디버깅 세션에 깊이 몰두하고 있습니다. Claude의 응답은 처음엔 훌륭했지만, 이제는 앞서 언급한 명백한 컨텍스트를 놓치고 있습니다.

You run /context:

Total Capacity:    200,000 tokens
Currently Used:    187,432 tokens (94%)
Available:          12,568 tokens

The breakdown shows:

• Conversation History: 142,000 tokens
• Pending Files: 28,000 tokens (several large files)

이 정보를 바탕으로 다음을 수행합니다:

1. /compact을 실행하여 대화 기록을 요약합니다.
2. 더 이상 필요 없는 파일은 /clear files로 닫습니다.
3. 다시 /context를 실행하면 사용량이 약 45 %로 감소합니다.

Claude의 응답이 즉시 개선됩니다. 이제 생각할 여유가 생겼기 때문입니다.

결론

/context 명령은 토큰 관리를 추측에서 과학으로 바꿔줍니다. 연료 게이지가 있는 상태로 운전하는 것과, 연료가 떨어지지 않기를 바라며 눈을 가리고 운전하는 것의 차이와 같습니다.

컨텍스트 사용량을 이해하는 것은 단순히 제한을 피하는 것이 아니라 최적화를 의미합니다. 불필요한 토큰 하나마다:

• Latency(지연) — 필요 없는 지연,
• Cost(비용) — 지불할 필요 없었던 비용,
• Capacity(용량) — 실제 작업에 사용할 수 있었던 용량

을 차지합니다.

/context를 Claude Code 작업 흐름에 정기적으로 활용하세요. 세션은 더 효율적이 되고, 응답은 더 정확해지며, AI 대화의 실제 형태를 마침내 파악할 수 있게 됩니다.

내일 예고: 데스크톱에서 작업을 시작하고 노트북에서 마무리할 수 있다면? 혹은 장시간 실행되는 작업을 시작하고 나중에 이어서 진행한다면? Day 9에서는 Claude Code Remote를 소개합니다 — 기기 간 원활한 세션 이동성을 제공하는 기능. 어디서든 작업을 이어가세요.

이 글은 “Claude Code 기능 31일” 시리즈의 Day 8입니다. 매일 새로운 강력한 기능을 발견하려면 계속 따라오세요.