# 컨텍스트 진단 (0.18.0)

긴 프론트엔드 작업에서 무엇이 입력 토큰을 차지하는지 확인합니다. 0.18.0에 포함된 기능입니다.

- `/context inspect`: 마지막 AI 요청의 입력 구성, 큰 도구 결과 상위 5개, 기존 중복 제거의 절감 추정치와 조언을 표시합니다.
- `/context`: 선택한 파일 목록과 함께 같은 진단을 표시합니다.
- 명령어 메뉴 `/`에서 **토큰 구성 진단과 절감 안내**를 선택할 수도 있습니다.
- 최적화 후, 기존 자동 압축 전 입력 추정치가 한도의 80% 이상이면 턴당 한 번 안내합니다. 100%를 넘으면 기존 압축·예산 검사가 계속 적용됩니다.

추정치는 제공자의 실제 토큰 계산이나 요금 절감을 보장하지 않습니다. 진단은 마지막 요청의 스냅샷이며, 다음 요청이나 입력 중인 초안의 예측이 아닙니다. 새 요청 기록이 없으면 그 사실을 표시합니다.

진단 자체는 모델 API나 파일 도구를 호출하지 않고 대화·설정·승인 정책을 변경하지 않습니다. 요청 기록에는 숫자와 도구 이름만 추가하며, 원문·도구 인자·API 키를 복사하지 않습니다. 기존 세션의 원문 보관 정책은 바뀌지 않습니다.

## 조언 적용

- 큰 도구 결과: 파일 전체보다 필요한 줄·컴포넌트를 요청하세요.
- 많은 첨부: `/context remove 경로`는 다음 요청의 고정 첨부만 해제합니다. 이미 대화에 들어간 파일 내용은 삭제하지 않습니다.
- 긴 대화: `/compact`는 오래된 턴을 로컬 보관하고 모델 입력에서 제외합니다. `/context history off`는 후속 요청에서 이전 대화를 제외하며 필요한 맥락을 다시 제공해야 합니다.
- MCP 정의: `/mcp off`로 선택한 도구를 해제할 수 있습니다.

## 설계 참고

2026-09-29에 확인한 공식 자료:

- [Anthropic: Effective context engineering](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents): 맥락을 제한된 자원으로 관리하고 필요한 정보만 유지하는 설계.
- [OpenCode: Compaction](https://dev.opencode.ai/v2/docs/compaction/): 자동 맥락 관리 설정.
- [Pydantic AI: Retries](https://pydantic.dev/docs/ai/core-concepts/retries/): 재시도와 요청 한도의 구분.

OSCODE에는 중복 제거, 도구 정의 예산, 반복 호출 차단이 이미 있어 새 압축기를 중복 추가하지 않았습니다. 이번 변경은 비용 원인을 사용자가 확인하고 대응할 수 있도록 하는 진단 기능입니다.