컨텍스트 엔지니어링 실패모드 위키

08 실전 — Claude Code·Codex 공식문서로 보는 컨텍스트 관리 (MOC)

6 min read

볼트 홈: README

08 실전 — Claude Code·Codex 공식문서로 보는 컨텍스트 관리

개관

앞선 챕터들이 정의한 다섯 가지 컨텍스트 실패모드(오염·산만·혼란·충돌·부패)를 Anthropic Claude Code와 OpenAI Codex의 공식 문서에 명시된 기능과 하나씩 짝지어, “컨텍스트 위생(context hygiene)“을 실무 작업으로 옮기는 챕터다.

독자는 AI 전문강사·AX 컨설턴트를 전제로 한다. 이론은 앞 챕터에서 다뤘으니, 여기서는 버튼·플래그·파일 경로 수준의 실무 동작을 공식 문서로 확인한다.

TL;DR

  • CLAUDE.md는 “부탁”이고 Hook은 “강제”다. 공식 문서는 “Claude treats them as context, not enforced configuration.”라고 적는다. 반드시 지켜야 할 규칙은 PreToolUse 훅이나 permissions.deny로 구현한다.
  • CLAUDE.md를 세션 중에 편집해도 곧바로 반영되지 않는다. /clear·/compact·재시작을 거쳐야 적용된다.
  • /compact 생존 규칙: 프로젝트 루트 CLAUDE.md와 Auto Memory는 다시 주입되지만, path-scoped 규칙·중첩 CLAUDE.md·skill 설명 목록은 사라진다.
  • 서브에이전트는 컨텍스트 격리의 핵심 수단이다. 다만 에이전트 팀은 플랜 모드에서 표준 세션의 약 7배 토큰을 쓴다.
  • Codex AGENTS.md는 매 실행마다 재구성되므로 캐시 부패(decay)가 구조적으로 없다. 기본 한도는 32KiB이고, 설정으로 최대 64KiB까지 늘린다.
  • 비용은 컨텍스트 크기에 비례한다. 엔터프라이즈 평균은 하루 약 $13, 월 $150–250 수준이다.

실패모드 → 공식기능 매핑 (개관)

flowchart LR
    subgraph FM["5대 실패모드"]
        P["오염 Pollution"]
        D["산만 Distraction"]
        C["혼란 Confusion"]
        CF["충돌 Conflict"]
        DK["부패 Decay"]
    end
    subgraph CC["Claude Code 공식 기능"]
        CC1["서브에이전트 격리<br/>/clear"]
        CC2["/compact<br/>Auto Memory 재주입"]
        CC3["Hooks additionalContext<br/>전처리 필터링"]
        CC4["Path-scoped Rules<br/>Skills 온디맨드"]
        CC5["claudeMdExcludes<br/>permissions.deny"]
        CC6["/memory 감사<br/>CLAUDE.md 유효성"]
    end
    subgraph CX["Codex 공식 기능"]
        CX1["서버사이드 컴팩션"]
        CX2["AGENTS.md 계층 우선순위"]
        CX3["Memories 비동기 업데이트<br/>매 실행 재구성"]
    end
    P --> CC1 & CC3 & CX1
    D --> CC4
    C --> CX2
    CF --> CC5 & CX2
    DK --> CC2 & CC6 & CX3

학습 순서

#노트핵심 내용
108_01-CLAUDE.md-메모리계층파일 위치 4계층, “context not config”, 200줄 원칙, @import, claudeMdExcludes
208_02-compact와-자동컴팩션/compact 생존표, 자동 컴팩션, Skill 설명 목록 소실, 수동 포커스 지시
308_03-Auto-Memory-세션간학습MEMORY.md 200줄/25KB 한도, 토픽 파일 온디맨드, /memory 감사, 비활성화
408_04-서브에이전트-컨텍스트격리격리 수준, memory 3스코프, 빌트인 에이전트, 7배 토큰 비용, worktree isolation
508_05-Hooks-컨텍스트전처리라이프사이클 이벤트, additionalContext, updatedToolOutput, stdout vs JSON, 10K 한도
608_06-프롬프트캐싱-비용레버3 캐시 레이어, TTL(1시간 구독), 무효화 트리거, CLAUDE.md 편집 캐시 유지
708_07-Codex-AGENTS.md-설정계층 구조, 32KiB 한도, 매 실행 재구성, Memories 비동기, Chronicle 주의사항
808_08-실패모드-공식기능-매핑표5대 실패모드 × 두 제품 기능 매핑 종합표 + mermaid
908_09-실전레시피-스니펫모음CLAUDE.md 템플릿, Hook 필터 스크립트, 서브에이전트 설정, 비용 절감 체크리스트
1008_10-2026-컨텍스트관리-신기능2026 신기능 매핑: 서버 Compaction(beta)·Context editing(thinking clearing)·Memory tool·Codex Memories/Chronicle/Compaction·AGENTS.md 로딩

타 챕터 연결

참고문헌 (챕터 전체)

그래프 뷰

백링크