AI 코딩 에이전트의 컨텍스트 창이 가득 차지 않게 관리하는 법

모든 AI 코딩 에이전트는 컨텍스트 창 안에서 작동한다 — 한 번에 "볼" 수 있는 텍스트의 유한한 양을 말한다: 당신의 메시지, 에이전트의 답변, 에이전트가 읽는 파일, 실행한 명령의 출력. 그 창이 가득 차면 품질이 알 수 없는 방식으로 떨어진다. 에이전트는 20분 전에 내린 결정을 잊어버리고, 이미 편집한 파일을 다시 읽으며, 조용히 스스로 모순되는 말을 한다. 몇 분보다 긴 작업이라면, 컨텍스트를 관리하는 것이 출력 품질을 좌우하는 단 하나의 가장 큰 지렛대다. 이제 그것을 의도적으로 다루는 방법을 소개한다.

가득 찬 창이 왜 해로운가

모델은 창이 붐빌 때 우아하게 성능이 낮아지지 않는다. 두 가지 일이 벌어진다. 첫째, 오래된 메시지가 가장자리 쪽으로 밀려나는데, 모델은 그곳에 있는 내용에 덜 안정적으로 주의를 기울인다 — 이것이 고전적인 "중간에서 길을 잃는(lost in the middle)" 문제다. 둘째, 대부분의 에이전트는 공간이 부족해지면 자동으로 요약하는데, 압박 속에서 자동으로 만들어진 요약은 손실이 크다: 당신이 신경 쓰던 바로 그 제약 조건을 빠뜨릴 수 있다. 해법은 창이 가득 차서 즉흥적으로 대응하게 내버려 두는 대신, 에이전트가 무엇을 붙들고 있는지 스스로 통제하는 것이다.

창이 얼마나 찼는지 지켜보라

볼 수 없는 것은 관리할 수 없다. Claude Code에서는 /context를 실행해 현재 사용량을 백분율로 출력할 수 있다. 실무자들이 권하는 좋은 경험칙은 복잡한 작업에서 60% 사용률 부근에서 조치를 취하는 것이다 — 자동 압축(compaction)이 작동하는 약 80% 지점보다 훨씬 앞선 시점이다. Cursor와 Codex도 각자의 UI에서 비슷한 표시를 보여준다. 그 숫자를 이따금 흘끗 보는 것만으로도 컨텍스트 관리는 막연한 걱정에서 구체적인 신호로 바뀐다.

체크포인트에서 압축하라 — 그냥 계속 밀고 나가지 말라

자연스러운 체크포인트에 도달했을 때(기능이 작동하거나, 테스트가 통과하거나, 버그가 고쳐졌을 때), 기록이 계속 늘어나게 두지 말고 압축하라. Claude Code에서 /compact는 전체 대화 기록을 모델이 생성한 요약으로 대체한다 — 70,000 토큰짜리 대화가 대략 4,000 토큰으로 줄어들 수 있다. 결정적으로, 무엇을 남길지 당신이 조종할 수 있다:

/compact "Keep the API contract and the DB schema we agreed on. Summarize the debugging session — I only need the root cause, not every step."

여유 공간이 아직 남아 있을 때 선제적으로 압축하면, 마지막 순간에 자동으로 촉발된 요약보다 더 나은 요약이 나온다. 요약을 작성할 때 모델이 여전히 대화 전체를 또렷이 기억하고 있기 때문이다.

작업을 전환할 때는 지워라

/compact는 같은 흐름의 작업을 이어가기 위한 것이다. /clear는 그것을 버리기 위한 것이다. 관련 없는 무언가로 방향을 틀 때 — 백엔드 수정을 끝내고 프론트엔드 기능으로 넘어갈 때 — 새롭게 시작하라. 이전 컨텍스트를 계속 끌고 가는 것은 도움이 되지 않는다; 토큰만 낭비하고 에이전트가 이전 작업에 패턴을 잘못 매칭할 위험을 만든다. 컨텍스트가 "오염"되었을 때에도 지우는 것이 해법이다: 모델이 잘못된 가정에 붙들려서, 아무리 바로잡아도 계속 그리로 되돌아가는 경우 말이다.

안정적인 지식은 대화가 아니라 파일에 담아라

같은 것을 반복해서 설명하고 있다면 — 테스트 명령, 명명 규칙, API가 어느 디렉터리에 있는지 — 그 정보는 애초에 대화 안에 있어서는 안 된다. 에이전트가 자동으로 읽는 프로젝트 파일에 담아라: Claude Code는 CLAUDE.md, Codex 등은 AGENTS.md, Cursor는 .cursorrules. 이 파일은 모든 세션 시작 시에 로드되므로 에이전트는 첫 메시지부터 그것을 가지고 있으며, 모든 /clear와 /compact에서 살아남는다. 다만 간결하게 유지하라 — 이 파일은 매 요청마다 토큰을 소모하므로, 비대해진 CLAUDE.md는 그 자체로 일종의 컨텍스트 낭비다.

에이전트에게 더 적게 주어라, 더 많이가 아니라

"모든 걸 갖도록" 파일 열 개를 쏟아붓고 싶은 본능은 역효과를 낸다. 붙여넣거나 @-멘션하는 파일마다 예산을 소모하고 모델의 주의를 희석시킨다. 잘 고른 파일 하나가 대개 열 개보다 낫다. 최소한으로 시작하고, 에이전트가 실제로 필요로 할 때에만 컨텍스트를 추가하라. 어느 파일이 중요한지 확신이 서지 않는다면, 디렉터리 전체를 미리 실어두기보다 에이전트에게 먼저 그것을 찾아달라고 요청하라.

지저분한 탐색은 서브에이전트에게 위임하라

어떤 작업은 본질적으로 장황하다 — "우리가 결제 API를 호출하는 모든 곳을 코드베이스에서 검색하라" 같은 것 말이다. 이것을 메인 세션에서 실행하면, 검색의 원시 출력이 당신의 창을 뒤덮는다. 대신, 그것을 서브에이전트(Claude Code의 Task 도구, 또는 별도의 Cursor 에이전트)에게 위임하라. 서브에이전트는 그 시끄러운 탐색을 자기 자신의 격리된 창에서 수행하고, 결론만 — 중요한 세 개의 파일만 — 돌려주어, 당신의 메인 컨텍스트를 깨끗하게 유지한다.

실전 리듬

종합하면, 건강한 긴 세션은 이렇게 생겼다:

1. 에이전트가 당신의 프로젝트를 알 수 있도록 간결한 CLAUDE.md로 시작한다.
2. 각 작업의 범위를 좁게 잡고, 그것이 건드리는 파일만 참조한다.
3. 30~45분마다, 혹은 각 이정표 이후에 /context를 흘끗 확인한다.
4. 각 체크포인트에서 맞춤 지시와 함께 /compact한다.
5. 관련 없는 작업으로 전환하는 그 순간 /clear한다.

이 중 어느 것도 대단한 비법이 아니다. 그러나 이것이 두 시간짜리 세션 내내 예리함을 유지하는 에이전트와, 강하게 출발했다가 서서히 맥락을 잃어가는 에이전트의 차이를 만든다 — 그리고 그것은 에이전트의 혼란을 디버깅하며 알 수 없이 흘려보내는 오후 대신, 몇 초의 주의를 들이는 것으로 충분하다.