# AI 사용량과 예산

프로젝트, 모델, 에이전트 전반의 토큰 사용량, 예상 비용, 활동을 확인합니다.

어시스턴트의 사용량 카운터에서 사용량 보고서를 여세요. 내장 어시스턴트와 CLI 에이전트의 활동을 한 화면에 모아 보여 주며, 완료된 작업과 토큰을 사용한 중단된 실행도 포함합니다.

## 보고서 읽기

프로젝트, 에이전트, 제공자, 모델, 세션별로 필터링하고, **시작**과 **종료**로 날짜를 정하거나 **7일**, **이번 달** 같은 빠른 범위를 사용하세요. 날짜와 시간은 UTC 기준입니다. 일별 토큰과 시간별 활동은 작업이 언제 이뤄졌는지 보여 주고, 묶어서 낸 합계는 사용량이 어디에 쓰였는지 비교하는 데 도움이 됩니다. **CSV 내보내기**는 보고서를 저장합니다.

런타임이 제공하는 경우 보고서는 입력, 출력, 캐시 읽기, 캐시 생성을 구분합니다. 측정값은 보고된 값, 추정된 값, 사용할 수 없는 값 중 하나일 수 있습니다. **알 수 없음**은 런타임이 충분한 정보를 주지 않았다는 뜻이며 0이라는 뜻이 아닙니다.

## 비용 추정 이해하기

API 비용 추정은 사용할 수 있는 모델 가격과 토큰 측정값을 바탕으로 합니다. CLI 에이전트는 구독이나 다른 과금 방식을 쓸 수 있습니다. 이들의 토큰 수는 청구서가 아니며 계정의 남은 사용 한도를 나타내지도 않습니다.

실제 청구 금액은 제공자의 결제 페이지에서 확인하세요.

## 프로젝트 예산 설정하기

프로젝트를 연 상태에서 **설정 → AI 어시스턴트 → 제공자와 키**의 **AI 예산**을 설정하세요. 금액을 미국 달러로 입력하고 **예산 저장**을 선택합니다. **예산 해제**를 선택하면 예산이 제거됩니다. 카드에는 지금까지의 예상 지출이 표시됩니다.

프로젝트 예산은 기록된 사용량이 한도의 80%에 이르면 내장 어시스턴트를 실행하기 전에 경고하고, 한도에 이르면 새 실행을 막을 수 있습니다. 작업을 시작하기 전에 확인하는 것이며, 응답이 진행되는 도중에 끊는 것은 아닙니다.

예산 확인이 모든 외부 에이전트나 연구 작업 런타임에 적용되지는 않습니다. 서비스에서 강제하는 지출 한도가 필요하다면 제공자 쪽 한도를 사용하세요.