Claude Code를 실행했지만, 아직 아무것도 입력하지 않은 상태입니다. 이 시점의 Claude가 아무것도 읽지 않았다고 생각하시나요?
토큰(AI가 문장을 세는 단위) 소비량은 화면을 보고만으로는 알아차리기 어렵습니다. 내용물을 확인하지 않은 채 자료나 설정을 계속 추가하면, 소비량이 늘어날 뿐만 아니라 Claude가 일관성을 잃을 수도 있습니다.
본문에서는 실행만으로도 context(해당 대화에서 Claude에게 보이는 정보 전체)에 포함되는 항목들을 공식 문서를 바탕으로 정리합니다. 후반부 내용은 빈 폴더에서 /context를 입력하여, CLAUDE.md를 배치하기 전(28.2k 토큰)과 후(35k 토큰)의 두 화면을 비교한 내용입니다. 28.2k 토큰 중 23.2k는 System tools 항목과 이어서 언급할 네 가지 외부 항목으로 구성되어 있습니다.
결론부터 말씀드리자면, Claude Code는 사용자가 말을 걸기 전부터 CLAUDE.md, auto memory, MCP의 도구 이름 및 skill 설명을 context에 포함하고 있습니다. 내역을 확인할 수 있는 명령어는 /context입니다. 네 가지 항목의 의미는 후속 절의 표에 정리했습니다.
| 질문 | 답변 |
|---|
| 실행만으로 무엇이 들어가는가? | 공식적으로 언급하는 것은 CLAUDE.md, auto memory, MCP의 도구 이름 및 skill 설명 4가지입니다. 화면에는 그 외 system prompt와 tools 항목도 표시됩니다. |
| 어떻게 확인할 수 있는가? | /context를 입력합니다. 항목별 목록까지 확장하려면 /context all을 사용합니다. |
| 가장 먼저 봐야 할 곳은? | 실행 시 포함되는 네 가지 중, 양이 가장 많은 항목입니다. 이것이 매번 필요한 것인지에 따라 구분할 수 있습니다. |
| CLAUDE.md의 적정 길이는? | 공식적인 기준으로 200줄 미만입니다. |
본문에서 알 수 있는 내용:
- 말을 걸기 전에 context에 포함되는 네 가지 항목
/context로 내역을 확인하는 절차 - 화면을 보고 어느 부분부터 줄여야 할지 결정할 기준
대상 독자:
- Claude Code를 사용하기 시작했거나 앞으로 사용할 기술자
- 토큰이나 context를 의식적으로 사용해 본 적이 없는 사람
- CLAUDE.md를 배치했지만, 얼마나 많은 양을 사용하는지 확인해 본 적이 없는 사람
실험 환경:
- Claude Code:
2.1.319 (Claude Code)
- OS: macOS
- 실험일: 2026-11-07
Claude Code는 업데이트에 따라 동작 방식이 변경될 수 있습니다. 본문의 내용은 위 버전과 아래 참고 링크를 읽은 시점의 것입니다.
context란, 해당 대화에서 Claude에게 보이는 정보 전체입니다. 공식 문서의 'Explore the context window'에서는 지시사항, 읽은 파일, Claude 자신의 답변 외에도 터미널에 표시되지 않는 내용까지 포함된다고 설명합니다.
context는 작업 책상과 같습니다. Claude는 책상 위에 펼쳐진 자료만을 보면서 작업을 진행합니다. 실행하는 시점부터 이미 책상 위에는 여러 장의 자료가 놓여 있습니다.
사용자가 입력한 문장만이 context가 아닙니다. 화면에 표시되지 않는 내용도 포함되기 때문에, 보이는 대화의 길이만으로는 양을 측정할 수 없습니다.
이는 토큰 소비와 Claude의 작동 방식 모두에 영향을 미치기 때문입니다. 공식 설명은 다음과 같습니다:
| 영향 받는 부분 | 공식 설명 | 출처 |
|---|
| 토큰 소비 | context가 클수록 처리하는 토큰이 증가합니다. 늘어난 분량은 API 비용이나 플랜 사용 상한(정액제 플랜으로 사용할 수 있는 양의 한계) 소모로 이어집니다. | "Manage costs effectively" |
즉, 내용물을 확인하지 않은 채 계속 추가하면 소비량이 늘어나는 것만으로는 충분하지 않을 때가 있습니다. /context를 통해 네 가지 항목 중 가장 많은 양을 차지하는 항목을 아는 것이 줄일지 여부를 판단하는 출발점이 됩니다.
공식적으로 언급되는 것은 CLAUDE.md, auto memory, MCP의 도구 이름 및 skill 설명 4가지입니다. 'Explore the context window'의 'Before you type anything' 섹션에 이 네 가지가 나열되어 있습니다.
Context에 포함되는 항목
| 항목 | 내용 | 시작 시 로드 범위 |
|---|
| CLAUDE.md | 사용자가 직접 작성하는 프로젝트 지침 파일 | 시작 시 읽는 파일 전체 내용 |
| auto memory | Claude가 스스로 기록하는 메모 | MEMORY.md (auto memory의 목차 파일)의 처음 200줄 또는 25KB, 둘 중 먼저 도달하는 쪽 |
| MCP의 도구 이름 | 외부 서비스와 연결하는 시스템(MCP)의 도구 이름 | 도구 이름과 서버(연결 대상) 지침문. 자세한 정의는 필요할 때 로드됨 |
| skill 설명 | 절차나 지식을 정리한 파일(skill)의 이름과 설명 | 이름과 설명. 본문은 사용할 때 로드됨 |
CLAUDE.md의 전체 내용은 시작 시 읽힌 후 context에 남아, 요청(Claude Code가 AI에게 보내는 한 번의 통신)이 있을 때마다 함께 전송됩니다. 여기서 '전체 내용이 매번 요청에 포함된다'고 언급하는 것은 바로 이 움직임을 의미합니다. 요청은 메시지를 보낼 때뿐만 아니라, Claude가 도구(파일 읽기, 명령어 실행 등의 기능)를 사용할 때도 전송됩니다.
사용자 설정에 따라 위 4가지 외의 내용이 추가될 수도 있습니다.
CLAUDE.md의 200줄은 참고치이며, auto memory의 200줄은 로드 기준선입니다.
| 대상 | 200줄의 의미 | 초과했을 때 |
|---|
| CLAUDE.md | 길이의 참고치 (공식 표현은 'under 200 lines') | 시작 시 읽는 파일은 잘라낼 수 없습니다. 4 MiB(메비바이트. MB와 유사한 파일 크기 단위) 이하일 경우 전체가 읽히고, 초과하면 전혀 읽히지 않습니다. 서브 폴더의 CLAUDE.md에는 별도의 상한선이 있습니다. |
auto memory의 MEMORY.md | 시작 시 로드 범위 기준선 | 처음 200줄 또는 25KB를 초과하는 내용은 시작 시 읽히지 않습니다. |
시작 시 읽는 CLAUDE.md는 4 MiB 이하일 경우 200줄을 넘어도 전체 내용이 포함됩니다. 길어진 부분은 그대로 context에 남아 있다고 생각하시면 됩니다.
빈 폴더에서 두 번 실행하고, CLAUDE.md의 유무만 바꿔서 비교해 보겠습니다. 평소 사용하는 폴더라면, claude로 시작하여 /context를 입력하기만 하면 됩니다. Claude Code가 아직 설치되지 않은 분은 공식 Quickstart 가이드에 따라 macOS, Linux, WSL(Windows에서 Linux를 구동하는 시스템), Windows용 설치 방법을 참고하세요.
실행 후 아무 말도 하지 않고 다음을 입력해 주세요.
종료할 때는 /exit를 입력합니다.
평소 폴더에서 실행하면, 본인의 설정 내용까지 상세 내역에 표시됩니다. 이 글에서는 차이를 보기 쉽게 하기 위해 빈 폴더를 사용했습니다.
같은 방식으로 테스트하려면, 시작 명령어에 user (전체 설정)를 제외합니다. user를 제외하면, ~/.claude/의 settings.json・CLAUDE.md・rules・skill은 로드되지 않습니다. 전체 설정에서 금지 규칙(특정 작업을 Claude가 하지 못하도록 설정하는 것)이나 훅(특정 상황에서 자동으로 작동하는 처리)을 사용하고 있는 경우, 이 부분이 제외된 상태로 테스트됩니다.
user를 제외하는 지정은 해당 시작 시에만 유효하며, 평소 실행에는 영향을 미치지 않습니다. 이 시작에서는 Claude에게 작업을 요청하지 말고,
/context와 /exit만 입력해 주세요. 절차는 macOS에서 테스트한 것이며, Windows에서는 테스트하지 않았습니다. mkdir -p, echo, seq, sed를 사용하므로, PowerShell과 CMD에서는 그대로 실행되지 않을 가능성이 있습니다. 실행하지 않는 분은 절차 창을 닫고 아래 출력으로 진행하시면 됩니다.
빈 폴더와 설정을 제외하고 시작하는 절차
버전을 확인합니다. 이는 시작이 아니라 버전만 출력하는 명령어입니다.
폴더를 만들고 Git 리포지토리를 초기화합니다.
mkdir -p ~/qiita-try/01/.claude && cd ~/qiita-try/01 && git init
설정 파일을 이 폴더 안에 만듭니다.
cd ~/qiita-try/01 && echo '{"disableClaudeAiConnectors": true, "autoMemoryEnabled": false}' > .claude/settings.local.json
실행 명령어는 다음 형태입니다.
claude --setting-sources project,local --strict-mcp-config
| 지정 | 의미 |
|---|
--setting-sources project,local | 읽을 설정을 project (이 폴더의 CLAUDE.md와 .claude/ 설정)와 local (자신만의 .claude/settings.local.json 등)로 한정하고, user (~/.claude/ 설정)는 제외합니다 |
--strict-mcp-config | --mcp-config로 전달된 MCP 서버만 사용합니다. 여기서는 아무것도 전달하지 않습니다 |
disableClaudeAiConnectors | claude.ai의 커넥터(claude.ai 측에서 설정한 MCP 서버)를 가져오지 않습니다 |
autoMemoryEnabled | 자동 메모리(auto memory)의 활성화 여부입니다. 여기서는 false로 비활성화합니다 |
아래 출력의 가져오는 방식과 화면에서의 표시 방식은 다음과 같습니다.
- 전체 설정, MCP, auto memory를 제외한 상태로 가져왔습니다.
- 따라서 4가지 항목 중 MCP와 auto memory는 화면에 나타나지 않습니다.
- skill은
Skills 행에, 두 번째 CLAUDE.md는 Memory files 행에 표시됩니다. 이는 실행만 해도 MCP의 도구 이름이 들어가는 것은 '대화하기 전에 무엇이 포함되어 있는지?'라는 공식 설명에 따릅니다.
- 이 테스트에서 보는 행은
Memory files입니다.
실행 후, 아무 말도 걸지 않고 /context를 입력합니다.
❯ /context
⎿ Context Usage
⛀ ⛁ ⛀ ⛀ ⛶ Opus 5.5
...
28.2k/1m tokens (3%)는 사용량과 context의 크기입니다. 1m (100만 토큰)은 이 환경의 context 크기이며, 값은 환경에 따라 달라집니다. Auto-compact window는 공식 문서인 'Manage costs effectively'에 따르면, Claude Code가 오래된 기록을 요약하여 공간을 확보하는 기능입니다. 세부 항목은 다음과 같이 읽을 수 있습니다.
| 행 | 값 | 읽는 법 |
|---|
System prompt | 2.3k | system prompt (Claude Code 측의 지시) 분량. 4가지 외부 항목 중 하나 |
System tools | 23.2k | 사용된 항목 중 가장 큰 부분. 4가지 외부 항목으로, 이름상 Claude Code가 가진 도구 분량으로 읽을 수 있습니다 |
Skills | 2.7k | 4가지 항목 중 skill 설명 분량 |
Messages | 10 | 아직 아무 말도 걸지 않은 시점의 값 |
Free space | 938.8k | 남은 공간 |
Autocompact buffer | 33k | 자동 compact (상한선에 가까워지면 대화를 요약하는 움직임)와 관련된 값 |
System prompt와 System tools 행의 정의는 이 기사에서 읽은 공식 페이지에서는 찾을 수 없었습니다. 표의 이 두 행은 이름으로 유추한 것입니다.Free space는 여유 공간이며, Autocompact buffer는 자동 compact와 관련된 값이므로 사용량에는 포함되지 않습니다.
~/.claude/에서 skill을 제외해도 Skills 행은 남아 있습니다. 이는 Claude Code에 내장된 skill(공식 Commands 페이지의 bundled skills)이 있기 때문으로 보입니다. 17개 항목의 세부 내용은 이 기사에서는 다루지 않았습니다.
이 테스트에서 보는 Memory files는 첫 번째 화면에는 없습니다. project (이 폴더의 설정)는 상위 폴더의 CLAUDE.md도 읽기 때문에, ~/qiita-try/01
상위 폴더에 CLAUDE.md가 있으면 첫 번째 실행에서도 이 줄이 나타납니다. 확인 후에는 /exit로 빠져나옵시다.
예시로 같은 형태의 줄을 200줄 나열한 CLAUDE.md 파일을 만듭니다. 내용 자체에는 의미가 없고, 양만 보기 위한 파일입니다. 명령어를 읽지 못해도 그대로 붙여넣기만 하면 만들 수 있습니다. >는 동일한 이름의 파일을 덮어쓰므로, 평소 폴더에서는 사용하지 마십시오. 아직 ~/qiita-try/01이 없는 분은 먼저 '준비하기' 절차를 통해 폴더를 만들어 주십시오.
cd ~/qiita-try/01 && seq 1 200 | sed 's/.*/- 見本の決まり &：関数と変数の名前は、意味がわかる英単語にする。/' > CLAUDE.md
wc -l CLAUDE.md
wc -l이 200줄을 나타내면, 동일한 명령어로 다시 시작합니다. 실행된 후에는 역시 말을 걸지 않고 /context를 입력합니다.
claude --setting-sources project,local --strict-mcp-config
두 번째 /context 출력
❯ /context
⎿ Context Usage
⛀ ⛁ ⛀ ⛀ ⛀ Opus 5.5
...
세부 내역에 Memory files: 6.8k tokens라는 줄이 추가되었습니다. 어떤 파일이 읽혔는지까지 보려면 /context all을 입력하고 Memory files 목록을 확인합니다. fullscreen 모드(화면 전체에 표시하는 형태)에서는 /context만으로는 이 목록이 접힙니다.
전체 컨텍스트는 28.2k에서 35k로 늘어났으며, 새로 추가된 것은 Memory files의 6.8k뿐이었습니다. System prompt, System tools, Skills 값은 동일합니다.
| 항목 | 첫 번째 (CLAUDE.md 없음) | 두 번째 (200줄 있음) |
|---|
| 전체 | 28.2k | 35k |
System prompt | 2.3k | 2.3k |
System tools | 23.2k | 23.2k |
Skills | 2.7k | 2.7k |
Memory files | 없음 | 6.8k |
가장 앞의 비율 표시가 둘 다 3%이므로, 비율만 보면 차이를 알기 어렵습니다. 책상 비유로 돌아가면, 늘어난 것은 CLAUDE.md라는 자료 한 장 분입니다. 비율로 따지면 0.7%이지만, 이 분량은 매번의 요청에 계속 포함됩니다.
네 가지 항목 중 가장 양이 많은 것을 보고, '매번 필요한 것인지'로 분류합니다. 공식 설명에서는 /context가 양 외에도 컨텍스트를 많이 사용하는 도구나 메모리(CLAUDE.md 또는 auto memory)의 증가에 대한 제안도 합니다(본문 2회 화면에는 나와 있지 않습니다). 제안이 나오면 그것도 읽으면서 다음 표로 판단해 주십시오.
| 네 가지 항목 중 가장 양이 많은 것 | 공식 설명 | 다음에 할 일 |
|---|---|
CLAUDE.md (Memory files 줄) | 전체 내용이 매번 요청에 포함됨 | 매번 필요한 규칙만 남깁니다. 가끔 필요한 절차는 skill로, 일부 파일에만 적용되는 지시는 paths를 이용해 대상을 좁힌 rules(.claude/rules/에 나누어 저장하는 지시)로 옮깁니다. |
skill (Skills 줄) | 이름과 설명이 매번 요청에 포함됨 | 사용 중인 skill인지 확인합니다. 설명을 context에서 제외하는 설정도 있습니다. |
MCP | 도구명과 서버의 지시문이 들어감 | /mcp로 연결 상태를 보고, 사용하지 않는 서버는 끊습니다. |
auto memory | MEMORY.md의 맨 앞 부분이 시작 시 읽힘 | /memory로 열어서 내용을 봅니다. |
MCP와 auto memory 모두 /context에서 확인할 수 있다고 공식은 적고 있습니다. 다만, 이번 테스트에서는 제외했기 때문에 두 번째 화면에는 나와 있지 않습니다. 줄 이름은 본인의 화면에서 확인해 주십시오.
어디서부터 볼 것인지의 기준은 네 가지 항목 중 양이 가장 많은 것입니다. 몇 토큰부터 많다고 할 수 있는지에 대한 공식적인 숫자는 이 기사에서 읽은 페이지에서는 찾을 수 없었습니다. 줄 수로 따지면, CLAUDE.md의 적정 분량은 200줄 미만입니다.
CLAUDE.md, skill, MCP, auto memory는 사용하면서 항목이 늘어나는 부분입니다. 반면, System tools는 설정을 건드리지 않은 빈 폴더 상태에서도 처음부터 23.2k가 존재하며, 스스로 추가한 분은 아닙니다. 두 번의 테스트를 거쳤을 때 사용하는 항목이 최대치였지만, CLAUDE.md를 배치해도 값은 변하지 않았습니다. 따라서 네 가지 항목을 비교합니다. 이는 공식 문서가 아니며, 본 기사의 해석입니다.
파일 구분이나 skill 설정은 이 시리즈의 후속 기사에서 다룰 예정입니다. 이번 기사에서는 '매번 필요한지'를 결정하는 단계까지만 진행하겠습니다.
** /context는 전체 내역을 보는 명령어이며, /memory와 /mcp는 개별 항목을 여는 명령어입니다.** 대화 기록을 줄이는 작업은 /compact와 /clear가 담당합니다. | 명령어 | 기능 | 사용 상황 |
|---|---|---|
|/context| context의 상세 내역 보기 | 어느 부분이 양을 차지하는지 알고 싶을 때. CLAUDE.md나 skill을 추가한 후 양을 확인하고 싶을 때 |
|/memory| CLAUDE.md와 auto memory 파일을 열어 편집하기 | 로드된 파일 내용을 수정하고 싶을 때 |
|/mcp| MCP 서버의 연결 상태를 확인하거나 끊기 | 사용하지 않는 서버가 있는지 찾고 싶을 때 |
|/compact| 대화를 요약하여 대체하기 | 긴 작업을 계속 진행하고 싶을 때 |
|/clear| 새로운 대화를 빈 context로 시작하기 | 관련 없는 작업으로 넘어가고 싶을 때 |
/compact와 /clear의 사용법 차이는 이 시리즈의 후속 기사에서 다루겠습니다.
좋은 점은, 눈에 보이지 않던 양이 항목별로 분리되어 보이는 것입니다. 한편, 해석 시 다음 사항에 주의해야 합니다.
-
숫자는 환경에 따라 변함: 설정(setting), MCP, skill의 수에 따라 내역이 달라집니다. 본 기사의 6.8k 역시 예시인 200줄 길이에서의 값입니다. 공식 페이지의 그림 속 숫자도 'representative'(대표값)이라고 명시되어 있습니다. -
-
기동 직후 화면은 출발점에 불과함: 작업이 진행됨에 따라 읽은 파일 등이 context에 추가됩니다. -
-
짧게 한다고 항상 지켜지는 것은 아님: 공식 문서의 'How Claude remembers your project'는 CLAUDE.md가 강제 설정이 아니며, 엄격하게 지켜질 것이라는 보장은 없다고 명시하고 있습니다. -
-
다른 사람에게 화면을 보여줄 때는 내용을 확인하기: /context에는 로드된 파일들이 표시됩니다. 사내 자료에 붙여넣기 전에 경로(path)나 서버 이름 등을 재점검해 주세요.
-
Claude Code는 말을 걸기 전부터 CLAUDE.md, auto memory, MCP의 도구명 및 skill 설명을 context에 포함하고 있습니다.
-
내역은 /context에서 볼 수 있으며, 항목별 목록은 /context all로 확장할 수 있습니다. 확인해야 할 부분은 기동 시 들어오는 네 가지 중 양이 가장 많은 항목입니다. 이를 매번 필요한 것인지 구분하는 것이 중요합니다.
-
CLAUDE.md의 200줄은 참고치이며, auto memory의 200줄은 로딩 기준선(line)입니다.
다 읽으셨다면, 평소 사용하시는 폴더에서 /context를 입력해 보세요. 기동 시 들어오는 네 가지 중 양이 가장 많은 항목을 하나 말하고, 그 부분을 줄일지 결정할 수 있다면 이 기사의 목적은 달성된 것입니다.
- Explore the context window (Claude Code 공식 문서. 기동 시 포함되는 내용, /context)
- Extend Claude Code (context 비용표, CLAUDE.md 기준치)
- How Claude remembers your project (CLAUDE.md와 auto memory의 차이점, 200줄 처리 방식)
- Manage costs effectively (context 크기와 토큰 관계, 요청 전송 방식)
- Quickstart (Claude Code 설치 방법)
- Commands (/context 등의 명령어 설명, 번들된 skill)
- CLI reference (--setting-sources · --strict-mcp-config)
- All settings (autoMemoryEnabled · disableClaudeAiConnectors)
） -
SDK에서 Claude Code 기능을 사용합니다.
user
・project
・local
이 각각 읽는 값입니다.
