> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 초과 캡

> 플랜의 포함 쿼터 위로 지불할 것 캡.

플랜이 고정 쿼터 포함. 초과는 사용량이 그것을 넘을 때 지불하는 것. **초과 캡** 이 여러분의 안전밸브 — 캡 히트하면 추가 사용량이 블록되어 놀라운 청구서로 깨지 않음.

## 캡 설정

**Settings → Billing → Overage cap**:

* **캡 금액** — 결제 기간당 달러. 이 위로 요청 거부.
* **Notify at** — Nora 가 결제 담당에게 이메일하는 임계값 (기본: 캡의 80%).

CLI:

```bash theme={null}
# 월 $50 초과 캡
nora billing set-overage-cap --cents 5000

# 캡 클리어 — 플랜 기본 사용
nora billing set-overage-cap --clear
```

Owner 만 이걸 바꿀 수 있음.

## 캡에서 무슨 일

누적 초과가 캡 도달하면:

* 미터링 표면 새 요청이 HTTP 402 Payment Required 반환.
* 스케줄 실행 일시정지.
* Foundry 파이프라인 일시정지.
* 기존 진행 중 실행이 정상 완료.
* 채팅 트래픽이 친근한 에러 메시지 얻음 ("이 워크스페이스가 사용량 캡 도달; 관리자에게 연락").

워크스페이스가 아카이브 안 됨; 아무것도 삭제 안 됨. 다음 즉시 사용량 재개:

* 결제 기간이 롤오버 (사용량 카운터 리셋).
* 캡 올림.
* 캡 클리어 (무제한).

## 캡 알림

알림 임계값 (기본 80%) 에서 Nora 가 이메일:

* 워크스페이스 Owner.
* 결제 담당.
* **Settings → Billing → Notification recipients** 의 주소.

두 번째 알림 95%. 세 번째 100% (캡 히트).

Slack 알림도 추가 ([알림](/ko/settings/notifications/alerts) 참고):

```
Trigger: overage_percentage > 80%
Channel: Slack (#nora-billing)
```

## 플랜 기본 vs. 커스텀 캡

* **캡 설정 없음** → 플랜의 기본 초과 제한 사용.
* **캡 설정** → 커스텀 값이 이김, 플랜 기본보다 낮거나 높아도.

Enterprise 플랜이 보통 기본으로 캡 없음 (쓴 만큼 인보이스 받음). 안전 원하면 명시 설정.

## 캡 설정할 때

* **고정 예산의 Free / Team** — 월 상한에 캡.
* **Dev / 스테이징 워크스페이스** — 폭주 스크립트가 예산 고갈 안 하도록 낮게 캡.
* **새 워크스페이스** — 한 달 사용량 관찰까지 보수적 캡.
* **고객 계약의 Enterprise** — 스코프 크리프 방지 위해 계약별 캡.

## 캡 안 할 때

* **예측 불가 트래픽의 프로덕션 워크스페이스** — 캡 히트가 장애 뜻함. 실제 트래픽 블랙홀할 캡보다 알림 + 수동 상향 선호.
* **컴플라이언스 크리티컬 워크로드** — 캡 히트가 인시던트 됨. 대신 알림 + 모니터.

## 캡과 실행당 비용 제한

초과 캡은 워크스페이스 전체. 독립:

* **Flow 전역 max cost** — Flow 별 캡 ([Flow 설정](/ko/cli/flow-settings) 참고).
* **Agent max cost** — Agent 별 캡 ([`nora agents update --set-max-cost`](/ko/cli/agents) 참고).

층 방어에 둘 다 사용:

* Agent 별 캡이 어느 단일 Agent 도 폭주 루프 못하게 방지.
* Flow 전역 캡이 어느 단일 Flow 도 불균형 비용 소비 방지.
* 초과 캡이 워크스페이스 전체 폭주 방지.

## 캡 올리기

Owner 가 언제든 올림:

**Settings → Billing → Overage cap → Update**. 즉시 효과. 블록된 트래픽이 다음 시도에 재개.

재무가 알도록 캡 상향에 알림 설정 고려 (감사 포워딩 통해, [감사](/ko/settings/security/audit) 참고).

## 비용 예측

캡 히트할지 관찰:

```bash theme={null}
# 현재 초과 퍼센트
state=$(nora billing state --json)
used=$(echo "$state" | jq '.overage_cents_used')
cap=$(echo "$state" | jq '.overage_cap_cents')
pct=$(echo "$used $cap" | awk '{ if ($2 > 0) printf "%.1f\n", $1/$2*100; else print 0 }')
echo "Overage: ${pct}%"
```

가시성 위해 일일 cron 에 추가.

## 관련

* [결제 개요](/ko/settings/billing/overview)
* [인보이스](/ko/settings/billing/invoices)
* [알림](/ko/settings/notifications/alerts) — 임계값 크로싱에 알림.
* [`nora billing set-overage-cap`](/ko/cli/billing) — CLI 레퍼런스.