🤯 Claude Code, 쓸수록 멍청해진다? '컨텍스트 로트'의 정체와 해결법

 

처음엔 천재, 나중엔 건망증 환자?

Claude Code를 써보신 분들이라면 한 번쯤 이런 경험 있으시죠.

처음엔 파일 구조도 척척 파악하고, 코드도 잘 짜고, 테스트까지 알아서 돌려주더니... 어느 순간부터 아까 만들었던 파일을 까먹고, 분명히 정해뒀던 규칙을 무시하고, 심지어 자기가 짠 코드 위에 그냥 덮어써버리는 황당한 상황이 벌어집니다.

"내가 뭘 잘못한 거지?" 하고 자책하셨다면, 사실 여러분 잘못이 아니에요. 이건 Claude Code의 구조적인 한계, 바로 컨텍스트 로트(Context Rot) 때문입니다.

오늘은 이 현상의 정체가 뭔지, 그리고 이걸 구조적으로 어떻게 극복하는지까지 제대로 정리해드릴게요.

컨텍스트 로트, 왜 생기는 걸까요?

Claude Code는 작업 기억, 즉 컨텍스트 윈도우를 사용합니다. 쉽게 말하면 AI에게 주어진 메모장이라고 생각하시면 돼요.

처음엔 메모장이 깨끗하니까 지시 사항도 잘 기억하고 판단도 정확합니다. 그런데 대화가 길어지고 작업이 쌓이면? 메모장이 꽉 차기 시작해요. 앞에서 정한 코드 스타일을 까먹고, 같은 실수를 반복하고, 이전에 만든 파일의 존재 자체를 모르게 됩니다.

이게 바로 컨텍스트 로트예요. 작업할수록 AI가 점점 멍청해지는 것처럼 느껴지는 건 기분 탓이 아니라 실제로 그렇게 되는 겁니다.

이 문제 때문에 그동안 "AI 코딩은 프로토타입에만 쓸 수 있다"는 인식이 생겼고, 프로젝트가 커질수록 컨텍스트가 터져서 버그가 쏟아지고, 수정하려 할수록 더 꼬이는 악순환이 반복되어 왔어요.

GSD 시스템, 컨텍스트 로트를 정면으로 때려잡다

이 문제를 정면으로 해결하기 위해 나온 도구가 GSD(Get Shit Done)입니다.

GSD는 Claude Code 위에 얹는 메타프롬프팅 시스템이에요. 코드를 직접 짜주는 도구가 아니라, Claude Code가 코드를 더 잘 짜도록 컨텍스트를 관리해주는 역할을 합니다. 아마존, 구글, 쇼피파이 엔지니어들이 사용할 정도로 빠르게 퍼지고 있는 도구예요.

GSD는 크게 5단계로 작동합니다. 첫째, /gsd new project 명령어를 치면 기술 스택, 제약 조건, 엣지 케이스를 질문하면서 프로젝트 MD, 요구사항 MD, 로드맵 MD를 자동 생성해줍니다. 둘째, /gsd discuss page로 모호한 부분을 미리 구체화합니다. 이 단계를 건너뛰면 나중에 수정하는 데 훨씬 더 많은 시간이 걸리게 되더라고요. 셋째, /gsd plan page로 적합한 라이브러리나 패턴을 조사하고 XML 형식의 계획서를 생성합니다. 여기에는 태스크 이름, 수정할 파일, 구체적 행동, 검증 방법까지 다 포함되어 있어요. 넷째, /gsd execute page로 계획서들을 웨이브(Wave) 단위로 묶어 실행합니다. 각 계획서 실행마다 새로운 서브 에이전트가 생성되면서 20만 토큰의 신선한 컨텍스트가 그 계획서에만 집중되어 사용됩니다. 다섯째, /gsd verify work로 자동 검증을 돌리고 문제가 발견되면 디버그 에이전트가 원인 분석 후 수정 계획서를 만들어 재실행합니다.

GSD가 컨텍스트 로트를 막는 3가지 핵심 원리

GSD의 작동 방식을 보면 세 가지 원칙이 핵심입니다.

첫 번째는 서브 에이전트 격리예요. 팀장(오케스트레이터)이 여러 팀원(서브 에이전트)에게 업무를 분담하는 구조입니다. 각 팀원은 자신의 담당 부분만 알면 되기 때문에 컨텍스트가 신선하게 유지돼요. 오케스트레이터는 교통 정리만 하기 때문에 메인 컨텍스트가 30~40%만 차 있어서 컨텍스트 로트를 구조적으로 막아냅니다.

두 번째는 구조화된 컨텍스트 전달입니다. 기존 방식은 채팅 히스토리가 컨텍스트에 계속 쌓이면서 품질이 낮아져요. GSD는 각 단계의 산출물을 마크다운 파일로 구조화해서 저장하고 전달합니다. 잡다한 채팅 히스토리보다 핵심만 정리된 파일이 훨씬 나은 컨텍스트 품질을 만들어냅니다.

세 번째는 원자적 계획과 자체 검증이에요. GSD는 하나의 계획서가 하나의 서브 에이전트 컨텍스트 안에서 완결될 수 있는 크기로 쪼개고, 각 계획서 안에 검증 단계를 포함시켜서 실행하는 에이전트 스스로 확인하게 합니다.

컨텍스트 엔지니어링, 이게 진짜 핵심입니다

GSD가 해결하는 건 컨텍스트 로트만이 아닙니다. 더 근본적으로는 AI와 인간 사이의 커뮤니케이션 문제를 해결해요.

우리 머릿속에 있는 생각을 AI에게 정확하게 전달하지 못하는 것, 이게 AI 작업의 진짜 어려움이에요. GSD는 이 전달 과정을 시스템화합니다.

바로 이게 컨텍스트 엔지니어링(Context Engineering)입니다. 프롬프트 엔지니어링이 AI에게 '무엇을 말할지'를 설계하는 것이라면, 컨텍스트 엔지니어링은 AI가 '무엇을 보고 이해할지' 전체를 설계하는 것이에요.

'바이브 코딩'이라는 용어를 만든 안드레이 카르파시도 이 개념을 강조하며, 기존 프롬프트 엔지니어링을 뛰어넘는 접근법으로 주목받고 있습니다. 실제로 관련 연구가 1,400편 이상 쏟아질 정도로 업계 전반에서 뜨거운 주제가 되고 있어요.

앤트로픽 역시 공식 블로그를 통해 "LLM을 효과적으로 다루려면 컨텍스트 내 사고(Thinking in Context)가 필요하다"고 밝히며, 이 접근법이 왜 AI 에이전트 운영의 핵심이 되는지를 설명하고 업계 논쟁을 촉발시켰습니다.

사람들이 흔히 놓치는 것: "AI가 멍청한 게 아니다"

많은 분들이 AI 코딩 결과가 나쁠 때 "역시 AI는 한계가 있어"라고 결론 내리는 경우가 많더라고요. 그런데 실제로 문제는 AI의 능력이 아니라 컨텍스트 설계에 있는 경우가 훨씬 많습니다.

한 가지 흥미로운 연구 결과가 있어요. Claude Code에게 특정 도구나 스택을 지정하지 않고 개방형 질문만 던졌을 때, AI는 자신이 학습한 데이터 기반의 기본 선호도대로 아키텍처 결정을 내린다는 거예요. 즉, CLAUDE.md나 AGENTS.md 같은 프로젝트 컨텍스트 파일이 없으면, AI가 여러분의 인프라와 맞지 않는 방향으로 알아서 결정을 내려버린다는 뜻입니다.

결국 AI 에이전트의 컨텍스트를 엔지니어링하지 않으면, AI 에이전트의 학습 데이터가 여러분의 아키텍처를 엔지니어링하게 됩니다. 컨텍스트 파일은 선택이 아니라, AI 지원 개발에서 통제권을 유지하는 핵심 메커니즘이에요.

GSD 없어도 당장 쓸 수 있는 컨텍스트 엔지니어링 3원칙

GSD를 당장 도입하기 어렵더라도 이 세 가지 원칙은 지금 바로 적용할 수 있어요.

대화를 줄이고 문서를 늘리세요. 채팅으로 이것저것 시키는 대신, MD 파일로 프로젝트 구조를 정리하고 반복되는 지시는 별도 파일에 적어두세요. 컨텍스트의 질이 올라가면 결과물의 질도 올라갑니다.

큰 작업은 반드시 쪼개세요. 앱 전체를 한 번에 만들어달라고 하면 컨텍스트가 터져요. 로그인 API부터 시작해서 원자적 단위로 완결되는 작업을 하나씩 시키세요. 한 번에 하나씩, 이게 핵심입니다.

검증을 자동화하세요. 테스트 코드를 먼저 작성하고 구현을 맡기면, AI에게 훨씬 더 과감하게 맡길 수 있어요. 안전망이 있으면 더 빠르게 달릴 수 있거든요.

앞으로 어떻게 바뀔까요?

AI 도구의 성능과 컨텍스트 윈도우는 계속 커지고 있습니다. 그렇다고 컨텍스트 엔지니어링이 필요 없어지지는 않아요. 아무리 메모장이 커져도 어떻게 채우느냐가 항상 핵심이거든요.

2026년 현재, 바이브 코딩을 넘어 에이전틱 엔지니어링(Agentic Engineering)이라는 개념이 등장했습니다. AI 에이전트가 구조화된 인간의 감독 하에 코드를 계획, 작성, 테스트, 배포하는 시스템 전체를 설계하는 학문이에요. 단순히 프롬프트를 잘 쓰는 게 아니라, AI가 제대로 일할 수 있는 환경 전체를 설계하는 역량이 경쟁력이 되는 시대가 온 겁니다.

앞으로 AI를 다루는 사람의 핵심 경쟁력은 올바른 컨텍스트를 올바른 타이밍에 올바른 형태로 전달하는 능력이 될 거예요. 프롬프트 엔지니어링이 어떻게 말하느냐의 기술이었다면, 컨텍스트 엔지니어링은 무엇을 언제 얼마나 보여주느냐의 기술입니다.

마무리

Claude Code가 쓸수록 멍청해지는 건 AI의 문제가 아닙니다. 컨텍스트를 관리하지 않은 채로 쓰는 방식의 문제예요.

GSD 시스템은 서브 에이전트 격리, 구조화된 문서 전달, 원자적 계획 실행이라는 세 가지 원칙으로 이 문제를 구조적으로 해결합니다. GSD를 쓰지 않더라도 대화를 줄이고 문서를 늘리고, 작업을 쪼개고, 검증을 자동화하는 것만으로도 결과물의 질은 크게 달라져요.

AI 코딩의 진짜 경쟁력은 더 좋은 AI를 쓰는 게 아니라, AI에게 더 좋은 컨텍스트를 주는 데 있습니다. 오늘부터 컨텍스트 설계를 시작해보세요.