> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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를 돌려줍니다.
* 스케줄 실행이 멈춥니다.
* 파운더리 파이프라인이 멈춥니다.
* 진행 중이던 실행은 정상적으로 끝냅니다.
* 채팅 트래픽이 친절한 에러 메시지를 받습니다("이 워크스페이스가 사용량 캡에 닿았습니다. 관리자에게 연락하세요").

워크스페이스가 아카이브되지 않고, 아무것도 안 지워집니다. 다음 중 하나면 바로 재개됩니다.

* 결제 기간이 넘어가서 사용량 카운터가 초기화됩니다.
* 캡을 올립니다.
* 캡을 지웁니다(무제한).

## 캡 알림

알림 임계값(기본 80%)에서 Nora가 이메일을 보냅니다.

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

두 번째 알림은 95%, 세 번째는 100%(캡에 닿음)입니다.

Slack 알림도 더할 수 있습니다([알림](/ko/settings/notifications/alerts) 참고).

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

## 플랜 기본과 커스텀 캡

* **캡을 안 정하면** 플랜의 기본 초과 한도를 씁니다.
* **캡을 정하면** 커스텀 값이 이깁니다. 플랜 기본보다 낮든 높든요.

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 레퍼런스.