컨텍스트 엔지니어링

LLM이 답하기 전에 보는 지시문, 도구 정의, 검색 결과, 대화 이력, 작업 상태까지 무엇을, 얼마나, 언제 넣을지 설계하는 방법이다. 프롬프트 한 줄을 다듬는 데서 그치지 않고 컨텍스트 윈도우 전체를 다루며, 여러 단계를 스스로 처리하는 에이전트를 만들 때 특히 중요하다.

이 용어는 Shopify CEO 토비 뤼트케(Tobi Lütke)와 안드레이 카파시(Andrej Karpathy)가 쓰면서 널리 퍼졌다.

컨텍스트에 들어가는 건 모두 설계 대상

모델은 컨텍스트에 들어온 정보만 보고 판단한다. 그래서 요소마다 무엇을 넣고 무엇을 뺄지 정해야 한다.

Claude Code에서는 파일과 설정으로 짠다

Claude Code를 쓴다면 프롬프트를 손보기보다 아래 구조를 정리하는 쪽이 에이전트 품질에 더 큰 영향을 준다.

많이 넣는다고 좋아지지 않는다

컨텍스트가 길어지면 모델이 중간에 있는 정보를 놓치거나 지난 내용에 끌려가기 쉽다. 토큰이 늘면 비용도 늘고 응답도 느려진다. 그래서 목표는 꼭 필요한 정보만 최소한으로 넣는 것이다.

에이전트가 헤맬 때 먼저 점검한다

한 번 묻고 끝나는 질문이라면 프롬프트만 잘 써도 충분하다. 반대로 에이전트가 엉뚱한 파일을 고치거나 같은 실수를 되풀이한다면, 프롬프트보다 컨텍스트에 무엇이 들어 있는지부터 확인한다. 흔한 원인은 CLAUDE.md에 남은 오래된 규칙, 너무 많아 헷갈리는 도구, 관련 없는 작업 이력이다. 작업 주제가 바뀌면 /clear로 새로 시작하는 것도 방법이다.

대화가 길고 도구가 많을수록 쓸 일이 많다

가장 흔하게 쓰는 곳은 코딩 에이전트다. 규칙 파일과 메모로 꼭 필요한 정보만 넣어 두고, 긴 탐색은 따로 맡겨 메인 대화를 가볍게 유지한다.