컨텍스트는 AI가 지금 답하거나 작업할 때 참고하는 정보입니다. 이번 요청, 이어지는 대화, 실제로 읽은 파일, 적용되는 규칙, 도구가 돌려준 결과 등이 포함됩니다. ‘작업 기억’이라고 생각하면 이해하기 쉽습니다.
1. 지금 펼쳐 놓은 자료
작업 폴더를 ‘자료 보관함’, 컨텍스트를 ‘지금 책상 위에 펼쳐 놓은 자료’에 비유할 수 있습니다. 보관함에 파일이 있다고 해서 내용을 모두 읽고 있는 것은 아닙니다. AI가 파일을 찾거나 읽으면 필요한 내용이 현재 작업에 들어옵니다.
| 중요도 | 정보 | 홈페이지 수정 예 |
|---|---|---|
| 핵심 | 이번 요청과 대화 | “첫 화면의 제목만 바꾸고 버튼은 유지합니다”라는 지시입니다. |
| 핵심 | 읽은 파일 | AI가 확인한 index.html의 내용입니다. 폴더의 모든 파일을 자동으로 읽는 것은 아닙니다. |
| 핵심 | 적용되는 규칙 | 프로젝트 규칙 파일에서 불러온 작성 방식·작업 조건입니다. |
| 핵심 | 도구 결과 | 파일 검색 결과, 실행 결과, 오류 메시지 등입니다. |
프로젝트 전체가 자동으로 영구 기억되는 것은 아닙니다. 필요한 자료가 빠졌다면 파일 경로를 알려 주고 읽도록 요청합니다. 긴 대화를 이어 온 경우에는 과거의 말이 모두 원문 그대로 남아 있다고 가정하지 않습니다.
파일 읽기·도구 사용 참고: Claude Code의 작업 방식 설명.
2. 크기에는 한도가 있습니다
컨텍스트 윈도우는 한 번의 요청에서 다룰 수 있는 문맥 크기의 상한입니다. 이 크기는 보통 토큰으로 셉니다. 토큰은 모델이 글 등을 나눠 처리하는 단위이며, 한 글자와 항상 같은 크기는 아닙니다.
대화·파일·도구 결과가 길어지면 문맥 공간을 더 사용합니다. 한도와 압축 시점은 모델과 설정에 따라 달라지므로, 모든 사람이 같은 비율에서 정리해야 하는 것은 아닙니다. 문맥의 크기 한도와 구독의 시간대별 사용량 한도도 서로 다릅니다.
Claude Code는 문맥이 길어지면 자동으로 대화를 압축할 수 있습니다. 압축은 대화를 요약하는 과정이므로, 세부 지시나 근거가 요약에서 빠질 수 있습니다. 중요한 조건은 짧은 파일로 남기고, 필요할 때 원본을 다시 읽도록 합니다.
문맥 구성·압축 참고: Claude Code의 컨텍스트 윈도우 설명.
3. 파일에 남긴 규칙과는 다릅니다
| 중요도 | 구분 | 담는 것 | 다음 대화에서 |
|---|---|---|---|
| 핵심 | 현재 컨텍스트 | 이번 작업에서 참고하는 대화·자료입니다. | 새 대화가 이전 대화 전체를 자동으로 이어받는 것은 아닙니다. |
| 핵심 | CLAUDE.md | 파일에 저장한 지속적인 작업 규칙입니다. | 적용 범위에 맞는 규칙을 불러옵니다. 파일이 남아 있는 것과 프로젝트의 모든 내용을 아는 것은 다릅니다. |
| 중요 | 자동 메모리 | 기능이 켜져 있을 때 Claude가 남기는 선호·교훈 등의 메모입니다. | 일부 메모가 다시 불러와질 수 있지만, 모든 대화와 모든 파일을 통째로 저장하는 기능은 아닙니다. |
파일로 저장한 규칙이나 메모도 실제로 불러오면 현재 컨텍스트의 일부가 됩니다. 반대로, 대화에서 한 번 말한 내용을 반드시 자동 메모리에 저장했다고 가정하면 안 됩니다. 다음 작업에 꼭 필요한 조건은 직접 확인할 수 있는 파일에 정리합니다.
규칙·자동 메모리 참고: Claude Code의 지침과 메모리 안내.
4. 확인·요약·새 대화를 구분합니다
아래 명령은 실행 중인 Claude Code의 대화 입력창에 입력합니다. 설치 명령이나 일반 터미널의 셸 명령이 아니며, !로 시작하는 셸 모드에도 입력하지 않습니다.
| 중요도 | 환경 | 입력 위치 |
|---|---|---|
| 핵심 | Mac | Claude Code에서 평소 요청문을 쓰는 입력창에 명령을 입력하고 Enter로 보냅니다. |
| 핵심 | Windows | Claude Code에서 평소 요청문을 쓰는 입력창에 같은 명령을 입력하고 Enter로 보냅니다. |
| 중요도 | 명령 | 하는 일 | 사용할 때 |
|---|---|---|---|
| 핵심 | /context | 현재 문맥 사용량과 구성 항목을 확인합니다. | 무엇이 문맥 공간을 차지하는지 확인할 때 사용합니다. |
| 중요 | /compact | 지금까지의 대화를 요약해 문맥 공간을 줄입니다. | 같은 작업을 계속하되 긴 대화를 정리할 때 사용합니다. 뒤에 보존할 내용에 대한 지시를 덧붙일 수 있습니다. |
| 핵심 | /clear | 기존 대화 문맥을 비우고 새 대화를 시작합니다. | 다른 작업으로 넘어가거나 필요한 인수인계 내용을 저장한 뒤 새로 시작할 때 사용합니다. |
/clear는 프로젝트 파일을 삭제하는 명령이 아닙니다. 이전 작업에서 저장한 파일을 되돌리거나 지우는 기능도 아닙니다. 저장된 규칙·메모리는 적용 조건에 따라 다시 불러와질 수 있으므로 ‘아무 규칙도 없는 상태’와는 다릅니다. 화면의 글만 지우는 셸의 clear와도 구별합니다.
명령 동작 참고: Claude Code 명령 목록. 입력 방식 참고: 대화형 모드 안내.
5. 홈페이지 수정에 적용하기
“전에 말한 대로 고쳐 줘”라고만 하면 어떤 조건을 뜻하는지 불분명할 수 있습니다. 수정할 파일과 유지할 조건을 함께 지정하면 필요한 문맥을 다시 마련할 수 있습니다.
프로젝트의 index.html을 먼저 읽어 줘.
첫 화면 제목을 '나의 작업실'로 바꿔 줘.
기존 소개 문단과 버튼 문구는 유지해 줘.
관련된 부분만 수정하고, 바꾼 내용을 짧게 알려 줘.대화가 길어져 같은 작업을 계속하기 어렵다면, 필요한 파일을 저장한 뒤 다음과 같이 요약의 초점을 지정할 수 있습니다.
/compact 홈페이지 수정 목표, 유지할 조건, 수정한 파일 경로, 아직 확인하지 못한 항목을 보존해 줘.요약은 원본 파일의 대체물이 아닙니다. 이어지는 작업에 정확한 코드나 수치가 필요하면 해당 파일을 다시 읽고 확인하도록 요청합니다.
6. 다음 대화로 잇기
새 대화에서 계속할 예정이라면 먼저 작업 상태를 파일에 남깁니다. 다음은 직접 정한 인수인계 파일 이름의 예이며, 이 이름만으로 자동으로 읽히는 것은 아닙니다.
새 대화에서 이어갈 수 있도록 handoff-homepage.md에 정리해 줘.
목표, 유지할 조건, 수정한 파일 경로, 완료한 확인,
미완료 항목과 다음 할 일을 구분해 줘.
저장 뒤 파일 경로와 내용을 확인해 줘.새 대화에서는 다음처럼 인수인계 파일과 작업 대상 파일을 명시합니다.
handoff-homepage.md를 먼저 읽어 줘.
이어 현재 index.html을 읽고 기록과 실제 파일이 일치하는지 확인해 줘.
다음 할 일을 짧게 정리한 뒤 홈페이지 수정을 이어가 줘.인수인계 기록에 없는 조건은 새 요청에 덧붙이고, 기록과 현재 파일이 다르면 실제 상태를 확인합니다. 이렇게 하면 과거 대화를 전부 기억한다고 기대하지 않고도 작업을 이어갈 수 있습니다.