Context 이해하기

Claude Code의 Context 시스템을 깊이 이해하고 활용하는 방법을 알아보자.

Context Window란?

Context Window는 AI가 한 번에 머릿속에 띄워놓고 참고할 수 있는 정보의 총량

Claude Code와 같은 AI 코딩 도구에서 **Context Window(컨텍스트 윈도우)**는 AI가 한 번에 "기억"하고 "처리"할 수 있는 **정보의 양(범위)**를 의미한다.

/context 명령어

/context

Context 구성요소

Context Usage

⛁ ⛀ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁   claude-opus-4-5-20251101 · 67k/200k tokens (34%)
⛀ ⛀ ⛀ ⛀ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ System prompt: 3.1k tokens (1.6%)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ System tools: 15.8k tokens (7.9%)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ MCP tools: 1.3k tokens (0.6%)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ Custom agents: 81 tokens (0.0%)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ Memory files: 819 tokens (0.4%)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛝ ⛝ ⛝   ⛁ Messages: 1.1k tokens (0.6%)
⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝   ⛶ Free space: 133k (66.4%)
⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝   ⛝ Autocompact buffer: 45.0k tokens (22.5%)

MCP tools · /mcp
└ mcp__ide__getDiagnostics (ide): 611 tokens
└ mcp__ide__executeCode (ide): 682 tokens

Custom agents · /agents
└ doc-search (Project): 81 tokens

Memory files · /memory
└ Project (/Users/devstefancho/works/claude-code-cheatbook/CLAUDE.md): 819 tokens

SlashCommand Tool · 4 commands
└ Total: 1.6k tokens

⛁ System prompt

영향요소 : Output Style

Output Style 을 변경하면 System Prompt를 변경할 수 있다. Output Style의 keep-coding-instructions을 false로 하면 코드 관련 토큰을 제외할 수 있다. 하지만 완전 기본적으로 들어가있는 system prompt는 1.5k 정도가 있기 때문에 완전히 비울 수는 없다.

⛁ System tools

영향요소 : Metadata (Custom Slash Command, Custom Skills)

여기서 Metadata는 name, description 같은 것을 의미한다. description은 1024 글자까지 가능하기 때문에 key 중에서 영향도가 가장 크긴하지만 이렇게 하더라도 100 tokens 내외 수준이기 때문에 전체 context에서는 미미한 수준이다.

⛁ MCP tools

영향 요소 : Enable 된 MCP Servers

현재 추가되어 있는 mcp tools의 숫자에 영향을 받는다. 단, Tool Search Tool로 defer_loading이 적용된 tool 이라면 context에 초기 로드 되지 않는다. 클로드 코드 입력창에서 @를 입력하면 mcp 서버 목록이 뜨는데 Enter를 입력해서 mcp 서버를 enable/disable 토글할 수 있다.

⛁ Custom agents

영향 요소 : Metadata (Custom Subagents)

.claude/agents/ 디렉토리에 있는 subagents이다. Metadata만 영향을 주기 때문에 context에 영향은 미미한 수준이다.

⛁ Memory files

영향 요소 : CLAUDE.md

메모리 파일인 CLAUDE.md가 영향을 준다. CLAUDE.md에서 @으로 멘션한 파일이 같이 로드된다. 이 파일에는 서버 실행방법과 같은 간략하면서도 모든 작업에 대해서 필요한 내용만 넣도록 한다. 자주 필요하지만 내용이 많은 것들은 Custom Slash Command 실행으로 context에 추가하는 것이 좋다.

⛁ Messages

영향 요소 : User Input Tokens, AI Output Tokens

유저가 입력한 메시지와 AI 응답 메시지가 모두 영향을 준다. thinking 모드를 쓰면 AI Output에 thinking에 대한 추가 token이 소모된다. thinking 수준이 올라갈수록 소모되는 토큰은 더 많아진다. (think < think hard < think harder < ultrathink)

⛝ Autocompact buffer

영향 요소 : Auto-compact

/config 에서 Auto-compact를 true로 하면 추가되는 토큰이다. 사이즈가 많이 크기 때문에 꼭 필요하지 않다면 꺼두는걸 추천하고 싶다.

Context 최적화 전략

필요한 정보만 포함하도록 한다. 불필요한 내용은 단순히 사용량의 낭비가 아니라 불필요한 정보로 인해서 AI의 정보처리 과정에 방해가 될 수 있다.
토큰 최소화를 위해서 한글보다는 영어를 사용한다. 우선 한글로 작성하고 클로드 코드에게 영어로 바꿔달라고 하면 된다.
/context 명령어로 현재 컨텍스트 상태 자주 체크하도록 한다. 특히 신규 md 파일을 추가하는 경우에는 반드시 체크하도록 한다.
토크나이저를 통해서 미리 토큰 사이즈를 확인할 수 있다. 단 공급사(OpenAI, Anthropic)에 따라 토큰 계산방식이 다르기 떄문에 최종적으로는 클로드 코드에서 체크해야한다. (https://claude-tokenizer.vercel.app/)