03-실전

03 — 실전: 4가지 가드레일

가드레일 1 — 사전 예산(Budget)

세션 시작 전 목표 토큰 수를 정한다. 예: “이 디버그는 100K 입력 토큰 안에 끝낸다.” 초과하면 멈춘다. 새 세션을 연다.

도구: Claude Code의 /cost 명령(있는 환경에서) 또는 ccusage 류 외부 추적기.

가드레일 2 — 관련성 선택 우선

기본 모드: 전체 가 아니라 관련 부분만. 다음 순서로 진행.

1. 파일 이름·구조만 먼저 보여 준다(tree, ls).
2. 모델이 특정 파일을 지목하면 그때 읽는다.
3. 전체 디렉토리 dump는 최후의 수단.

CLAUDE.md/README는 작게 유지. 50KB가 넘으면 분리.

가드레일 3 — 1M 모드 ON/OFF 의식적 사용

• 기본은 200K(또는 표준 컨텍스트).
• 큰 monorepo 전수 분석 등 명시적으로 큰 작업에만 1M.
• 작업 끝나면 즉시 끈다.

가드레일 4 — Sub-agent 컨텍스트 다이어트

부모 → 자식 호출 시 다음 원칙.

• 자식에게 부모의 전체 히스토리를 넘기지 않는다.
• 자식에게는 그 작업의 입력만. 결과만 받아 부모가 통합.
• 자식이 외부 정보를 직접 가져오게 한다(자식이 grep/read).

이는 본 위키 빌드 파이프라인이 따르는 원칙이다 — writer 에이전트는 자기 챕터만, verifier는 자기 검증 항목만.

마켓플레이스 점검(별도 가드)

Claude를 Azure/Bedrock으로 쓴다면, 트래픽 시작 전 다음을 확인.

1. 사용 모델이 마켓플레이스 제3자 상품인가?
2. 가지고 있는 크레딧/스폰서십이 마켓플레이스에 적용되는가? (공식 약관 문서 확인. 포럼 글 신뢰 금지.)
3. UI상 “크레딧 차감” / “신용카드 차감”의 시각적 구분이 없을 수 있다 — Azure가 그렇다.

비용 폭주가 이미 발생했을 때

1. 즉시 트래픽 차단(키 회전 또는 사용량 한도).
2. 어떤 호출이 청구를 만들었는지 로그 grep — 가장 큰 입력 호출 1개가 보통 80%를 차지.
3. 재발 방지 — 위 4가드레일 중 빠진 것을 식별해 추가.
4. 환불은 거의 받지 못한다. 마켓플레이스 경유는 더더욱.

다음

• examples/, cases/