Anthropic의 8배 생산성 향상 비결: 그 이면의 컨텍스트 엔지니어링 시스템

Anthropic 엔지니어들은 1년 전보다 하루에 8배 더 많은 코드를 병합합니다. 모델은 변하지 않았습니다. 하드웨어도 변하지 않았습니다. 팀 규모도 그대로입니다. 변한 것은 Claude가 작업을 시작하기 전에 무엇을 보느냐 하는 점입니다.

대부분의 개발자는 더 나은 프롬프트를 작성하는 데 시간을 보냅니다. Anthropic 엔지니어들은 더 나은 컨텍스트(context)를 구축하는 데 시간을 씁니다. 바로 그 하나의 변화가 8배라는 격차 전체를 만들어냅니다.

Anthropic의 자체 연구는 이를 명확히 보여줍니다. AI 에이전트의 품질은 모델 자체보다 에이전트에게 제공하는 컨텍스트에 의해 더 크게 결정됩니다. Claude는 컨텍스트 윈도우 안에 있는 것만 볼 수 있습니다. 그 창 밖에 있는 모든 것은 존재하지 않는 것과 같습니다. 즉, 진지한 AI 엔지니어의 모든 업무는 기발한 프롬프트를 작성하는 것이 아니라, Claude가 단 하나의 행동을 취하기 전에 정확히 올바른 정보를 갖추도록 만드는 것입니다.

이제 그 원칙에는 이름이 생겼습니다. 바로 컨텍스트 엔지니어링(Context engineering)입니다. 그리고 이는 2년 전 프롬프트 엔지니어링이 수동 스크립팅을 대체했던 것과 같은 방식으로 프롬프트 엔지니어링을 대체하고 있습니다.

이 글을 즐겨찾기에 추가하고 팔로우하세요

저는 4년 차 개발자 Noisy입니다. 저는 AI 시스템과 자동화 파이프라인을 구축하며 기술을 실제 수익으로 전환하는 방법을 찾습니다.

AI 에이전트가 잘못된 답변을 내놓는 이유

대부분의 사람들은 AI 에이전트가 실패하면 모델을 탓합니다. 잘못된 파일을 수정했거나, 잘못된 가정을 했거나, 어떤 개발자라도 알아챘을 법한 뻔한 실수를 저지르는 경우입니다.

문제는 거의 모델에 있지 않습니다. 문제는 컨텍스트의 부재입니다.

1대부분의 사람들이 Claude에게 주는 것   |  프롬프트
2Claude에게 실제로 필요한 것             |  지식, 메모리, 파일,
3                                       |  규칙, 예시, 도구,
4                                       |  상태, 이전 작업 내역

프롬프트는 한 문장일 뿐입니다. 컨텍스트는 Claude가 작동하는 전체 정보 환경입니다. 작동하는 에이전트와 그렇지 않은 에이전트의 차이는 거의 항상 어떤 모델이 실행 중이냐가 아니라, 그 환경 안에 무엇이 들어 있느냐에 달려 있습니다.

Anthropic은 이를 다음과 같이 설명합니다. LLM은 컨텍스트 윈도우 안에 있는 것만 봅니다. 컨텍스트는 AI를 위한 운영체제입니다. 이를 잘못 구축하면 모델의 성능이 아무리 뛰어나도 아무것도 제대로 작동하지 않습니다.

컨텍스트란 실제로 무엇인가

대부분의 사람들은 컨텍스트가 질문 앞에 붙여넣는 텍스트라고 생각합니다. 그것은 한 가지 층위일 뿐입니다. 제대로 설계된 컨텍스트는 7가지 요소가 함께 작동합니다.

1메모리           |  이전 세션에서 에이전트가 알고 있는 정보
2지침             |  규칙, 제약 조건, 코딩 스타일
3예시             |  좋은 결과물이 실제로 어떤 모습인지
4파일             |  관련 코드, 문서, 아키텍처
5이전 작업 내역   |  에이전트가 이미 시도한 것
6도구 결과        |  검색 및 함수가 반환한 값
7상태             |  현재 작업이 진행 중인 단계

Claude가 행동을 취할 때마다 컨텍스트는 커집니다. 도구 결과가 돌아오고, 새로운 파일을 읽고, 상태가 업데이트됩니다. Claude는 새로운 컨텍스트를 보고 다음 행동을 결정합니다. 이 순환 과정이 에이전트의 실제 메커니즘입니다. 프롬프트나 모델이 아니라, 매 단계마다 진화하는 컨텍스트가 핵심입니다.

1사용자 요청
2↓
37가지 모든 요소로 구축된 컨텍스트
4↓
5Claude가 행동 결정
6↓
7도구 실행
8↓
9결과가 컨텍스트에 추가됨
10↓
11Claude가 새로운 컨텍스트 확인
12↓
13다음 행동
14↓
15완료될 때까지 반복

나쁜 에이전트는 두 번째 단계에서 이 순환을 깨뜨립니다. 컨텍스트가 불완전하기 때문에 Claude는 가정을 하게 됩니다. 가정이 틀리면 결과물도 틀리게 됩니다. 대부분의 개발자는 프롬프트를 다시 작성하여 이를 해결하려 합니다. 실제 해결책은 컨텍스트를 올바르게 구축하는 것입니다.

3계층 컨텍스트 스택

Anthropic은 컨텍스트를 3개의 계층으로 생각할 것을 권장합니다. 각 계층은 서로 다른 목적을 수행하며 에이전트의 작업 중 서로 다른 시점에 로드됩니다.

1글로벌 컨텍스트  |  항상 존재, 모든 세션에 적용
2프로젝트 컨텍스트 |  프로젝트 시작 시 로드
3작업 컨텍스트    |  특정 작업을 위해 로드

글로벌 컨텍스트는 영구적인 계층입니다. 정체성, 핵심 규칙, 코딩 스타일, 에이전트가 절대 해서는 안 될 행동 등이 포함됩니다. 이는 세션 간에 절대 변하지 않으며 다시 설명할 필요도 없습니다.

1글로벌 컨텍스트 포함 내용:
2- 에이전트 정체성 및 역할
3- 코딩 표준 및 스타일 규칙
4- 보안 제약 조건
5- 절대 건드리거나 수정해서는 안 될 부분
6- 불확실성 처리 방법

프로젝트 컨텍스트는 지식 계층입니다. 아키텍처, 사용된 패턴, 결정된 이유, 이전에 잘못되었던 점 등 Claude가 이 특정 코드베이스를 이해하는 데 필요한 모든 것입니다.

1프로젝트 컨텍스트 포함 내용:
2- README 및 아키텍처 개요
3- 프로젝트별 규칙이 담긴 AGENTS.md
4- 폴더 구조 및 명명 규칙
5- 테스트 요구 사항 및 패턴
6- 주요 의존성 및 선택 이유

작업 컨텍스트는 실행 계층입니다. 작업 중인 특정 파일, 현재 티켓, 즉각적인 목표, 이 작업에만 적용되는 제약 조건 등이 포함됩니다.

1작업 컨텍스트 포함 내용:
2- 현재 파일 및 관련 파일
3- 이번 세션의 구체적인 목표
4- 최근 변경 사항 및 결과
5- 현재 테스트 결과
6- 이 작업에 특화된 제약 조건

대부분의 개발자는 Claude에게 작업 컨텍스트만 제공합니다. 에이전트는 매 세션마다 글로벌 컨텍스트나 프로젝트 컨텍스트 없이 시작하며, 모르는 모든 것을 추측해야 합니다. 바로 그 추측에서 실수가 발생합니다.

AGENTS.md - 모든 것을 바꾸는 파일

https://docs.claude.com/en/docs/claude-code/memory

진지한 Claude Code 설정에서 가장 중요한 단 하나의 파일입니다. 연구자들은 AGENTS.md를 AI 코딩 에이전트 컨텍스트의 새로운 표준으로 정의했습니다. 실제로 효과가 있기 때문에 수천 개의 프로덕션 저장소에서 이미 사용되고 있습니다.

AGENTS.md는 프로젝트 컨텍스트가 영구적으로 머무는 곳입니다. Claude는 모든 세션 시작 시 이를 자동으로 읽습니다. 그 후에는 같은 내용을 다시 말해줄 필요가 없습니다.

1# AGENTS.md
2
3## 아키텍처
4Next.js 프론트엔드와 Express 백엔드로 구성된 모노레포.
5모든 API 라우트는 /api에 위치함. /legacy는 절대 직접 수정하지 말 것.
6
7## 코딩 규칙
8axios는 절대 사용하지 말 것. 항상 fetch를 사용할 것.
9모든 컴포넌트: TypeScript, Tailwind, Server Actions 사용.
10페이지를 제외하고는 default export를 사용하지 말 것.
11
12## 테스트
13단위 테스트는 Vitest, E2E 테스트는 Playwright 사용.
14모든 커밋 전에 npm test를 실행할 것.
15실패하는 테스트를 비활성화하지 말고, 수정하거나 에스컬레이션할 것.
16
17## Git
18main 브랜치에 직접 커밋하지 말 것.
19항상 명확한 설명과 함께 PR을 열 것.
20모든 PR은 Linear 티켓과 연결할 것.
21
22## 절대 건드리지 말 것
23src/payments/ - 모든 변경 사항은 사람의 승인이 필요함
24src/auth/tokens/ - 보안 검토 필수
25.env 파일 - 읽거나 수정하지 말 것

이 파일에 있는 모든 규칙은 Claude가 다시는 저지르지 않을 실수를 방지합니다. 프로젝트가 오래 지속될수록 AGENTS.md는 더욱 구체적이고 가치 있게 변합니다. 이는 에이전트가 저지른 모든 오류와 팀이 확립한 모든 관례가 축적된 지식입니다.

진지한 에이전트를 구동하는 컨텍스트 스택

최고의 AI 엔지니어들은 프롬프트를 작성하며 작업을 시작하지 않습니다. 그들은 컨텍스트 스택을 구축합니다. 이는 Claude가 단 하나의 행동을 취하기 전에 로드되는 구조화된 정보의 시퀀스입니다.

11단계  |  글로벌 컨텍스트 로드 - 정체성, 규칙, 스타일
22단계  |  프로젝트 컨텍스트 로드 - AGENTS.md, 아키텍처, 문서
33단계  |  관련 과거 경험을 위해 메모리 검색
44단계  |  이 특정 작업을 위한 관련 파일 로드
55단계  |  현재 상태 로드 - 테스트 결과, 최근 변경 사항
66단계  |  명확한 성공 기준과 함께 작업 목표 정의
77단계  |  Claude가 완전한 정보를 바탕으로 행동

컨텍스트 엔지니어링이 잘 된 에이전트와 기본 에이전트를 비교해 보세요.

1나쁜 에이전트:
2질문 → Claude → 답변
3Claude는 모르는 모든 것을 추측함
4
5좋은 에이전트:
6질문
7↓ 문서 검색
8↓ 메모리 검색
9↓ AGENTS.md 읽기
10↓ 관련 파일 읽기
11↓ 현재 상태 확인
12↓ Claude
13↓ 완전한 정보를 바탕으로 구축된 답변

두 번째 에이전트가 더 똑똑한 것은 아닙니다. 더 많은 정보를 알고 있을 뿐입니다. 모델은 동일합니다. 컨텍스트만 다를 뿐입니다.

메모리 - 세션 간에 유지되는 컨텍스트

Anthropic은 컨텍스트를 공급하는 메모리 유형을 명확히 구분합니다. 대부분의 에이전트는 현재 대화라는 단 하나의 메모리만 가지고 있습니다. 그래서 매 세션을 제로 상태에서 시작하는 것입니다.

1장기 메모리   |  과거의 모든 세션에서 학습한 내용
2단기 메모리   |  이번 대화의 앞부분에서 일어난 일
3작업 메모리   |  지금 컨텍스트 윈도우에 있는 내용

장기 메모리는 에이전트의 가치를 시간이 지남에 따라 복리로 증가하게 만듭니다. 모든 세션이 메모리에 추가됩니다. 모든 실수가 기록됩니다. 모든 성공적인 패턴이 저장됩니다. 6개월 동안 코드베이스에서 실행된 에이전트는 어떤 프롬프트로도 복제할 수 없는 프로젝트 관련 지식을 갖게 됩니다.

실제 구현 방식은 메모리 파일입니다. 이는 대화 외부의 마크다운 문서로, 에이전트가 세션 시작 시 읽고 종료 시 업데이트합니다.

1# 프로젝트 메모리
2
3## 아키텍처 결정 사항
4- Firebase 대신 Supabase 선택: 실시간성보다 SQL 쿼리가 더 중요함, 2026년 6월
5- REST에서 tRPC로 전환: 전체 스택에 걸친 타입 안정성 확보
6
7## 효과적이었던 것
8- 리팩토링 전 높은 테스트 커버리지 확보로 회귀 오류 방지
9- 큰 PR을 기능 플래그 릴리스로 나누어 리뷰 시간 단축
10
11## 효과적이지 않았던 것
12- 마이그레이션 자동 생성: 스키마 드리프트로 인한 프로덕션 장애 발생
13- 동일 파일에 대한 에이전트의 병렬 쓰기: 항상 worktrees를 사용할 것
14
15## 반복되는 패턴
16- 인증 문제는 거의 항상 미들웨어 순서에서 발생함
17- 성능 문제는 대개 데이터베이스 쿼리 계층에서 시작됨

매 세션마다 이 파일이 읽히고 업데이트됩니다. 에이전트는 절대 잊지 않습니다.

MCP - 어디서나 가져오는 컨텍스트

컨텍스트는 저장소 내의 파일에서만 오는 것이 아닙니다. 프로덕션 에이전트는 팀이 작업하는 모든 시스템(이슈 트래커, 오류 모니터, 문서, 데이터베이스, 커뮤니케이션 도구)에서 컨텍스트를 가져와야 합니다.

Model Context Protocol(MCP)은 Claude가 각각의 시스템에 대한 커스텀 통합 없이도 외부 시스템에서 컨텍스트를 가져오는 방법입니다.

1파일 시스템   |  로컬 파일, 설정, 코드베이스
2GitHub       |  이슈, PR, 커밋 기록, CI 결과
3Linear / Jira |  티켓, 우선순위, 프로젝트 상태
4Slack        |  결정 사항, 논의를 통한 컨텍스트
5Postgres     |  실시간 데이터, 스키마, 쿼리 결과
6Google Drive |  문서, 사양, 회의록
7Sentry       |  실시간 오류, 빈도, 영향을 받는 사용자

MCP가 설정된 에이전트는 코드만 보는 것이 아닙니다. 이 기능이 왜 필요한지 설명하는 티켓, 아키텍처가 결정된 Slack 대화, 사용자가 버그를 겪는 방식을 보여주는 Sentry 오류, 그리고 수정 사항이 준수해야 할 데이터베이스 스키마까지 모두 봅니다.

이것이 완전한 컨텍스트입니다. Claude가 추측할 필요 없이 올바른 결정을 내리는 데 필요한 모든 것입니다.

컨텍스트 엔지니어링 워크플로우

제대로 컨텍스트 엔지니어링된 작업은 처음부터 끝까지 이런 모습입니다.

기존 방식:

1내보내기 기능을 만들어줘.

Claude에게 제공하는 방식:

1목표
2내보내기 기능이 무료 사용자에서 유료 사용자로의 전환을 가로막고 있음.
3신호 확인: /signals/export-too-hidden.md
4
5관련 파일
6src/features/export/ - 현재 구현 내용
7src/components/ui/Button.md - 따라야 할 버튼 패턴
8tests/features/export.test.ts - 기존 테스트 커버리지
9
10아키텍처 제약 조건
11AGENTS.md의 'Export Rules' 섹션 읽기
12결제 통합 부분은 직접 수정하지 말 것
13
14성공 기준
15기존의 모든 테스트 통과
16새로운 테스트가 3가지 내보내기 형식을 모두 커버함
17Linear 티켓 EXP-47이 연결된 PR 생성
18src/payments/에 변경 사항 없음

같은 작업이지만 컨텍스트는 완전히 다릅니다. 결과물은 단순히 조금 더 나아진 수준이 아닙니다. Claude가 지레짐작하는 대신 완전한 정보를 바탕으로 결정을 내리기 때문에 결과 자체가 완전히 달라집니다.

이번 주말에 할 실무 설정

1일 차 - 3계층 컨텍스트 스택 구축. 정체성과 핵심 규칙이 담긴 글로벌 컨텍스트 파일을 작성하세요. 프로젝트 아키텍처, 코딩 관례, 절대 건드리지 말아야 할 목록이 담긴 AGENTS.md를 만드세요. 세션 시작 시 로드되고 종료 시 업데이트되는 메모리 파일을 설정하세요.

2일 차 - MCP를 통해 외부 컨텍스트 연결. GitHub 커넥터를 설치하여 Claude가 이슈 트래커와 PR 기록을 볼 수 있게 하세요. 파일 시스템 커넥터를 설치하여 코드베이스를 효율적으로 탐색하게 하세요. 팀에서 의사결정에 Slack이나 Linear를 사용한다면 추가하세요.

3일 차 - 차이점 테스트. 기존의 프롬프트만 사용하는 방식과 전체 컨텍스트 스택을 사용하여 같은 작업을 수행해 보세요. 그 결과물의 격차가 바로 8배 생산성의 원천입니다.

이미 일어난 변화

프롬프트 엔지니어링은 올바른 단어를 찾는 것이었습니다. 컨텍스트 엔지니어링은 올바른 정보 환경을 구축하는 것입니다.

Anthropic의 최고 AI 엔지니어들은 기발한 프롬프트를 만드는 데 시간을 쓰지 않습니다. 그들은 Claude가 단 하나의 행동을 취하기 전에 정확히 올바른 지식, 메모리, 파일, 규칙, 상태를 갖추도록 만드는 데 시간을 보냅니다. 프롬프트는 작업의 마지막 1%일 뿐입니다. 컨텍스트가 나머지 99%입니다.

완벽한 프롬프트와 부족한 컨텍스트를 가진 에이전트는 지적인 실수를 저지릅니다. 평범한 프롬프트와 완전한 컨텍스트를 가진 에이전트는 올바른 결정을 내립니다. 모델은 같습니다. 정보 환경이 다를 뿐입니다.

컨텍스트는 AI를 위한 운영체제입니다. 이를 제대로 구축하면 8배의 생산성 격차는 Anthropic에서만 일어나는 일이 아니라 여러분의 코드베이스에서 일어나는 일이 될 것입니다.

대부분의 개발자는 계속해서 프롬프트를 다시 작성하며 왜 결과가 개선되지 않는지 의아해할 것입니다. 소수의 개발자는 주말을 투자해 제대로 된 컨텍스트 스택을 구축하고 다시는 예전 방식으로 돌아가지 않을 것입니다.

여러분의 인생은 여러분이 만드는 것입니다. 그러니 올바른 길을 선택하세요.

/ 이 글이 유용했다면 팔로우하세요 /