> ## 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.

# nora billing

> 워크스페이스 결제 — 상태, 사용량, 인보이스, 초과 캡, 포털, 세금.

Billing 이 워크스페이스 레벨 재무 정보를 CLI 에서 표면화. 유료 플랜 모든 워크스페이스가 이 명령 가짐; 무료 워크스페이스는 무료 티어 상태 표시.

## 명령

| 명령                        | 설명                            |
| ------------------------- | ----------------------------- |
| `billing state`           | 현재 구독 스냅샷.                    |
| `billing usage`           | 현재 기간 미터별 사용량.                |
| `billing history`         | 이력 월간 사용량.                    |
| `billing invoices`        | 발행된 모든 인보이스.                  |
| `billing portal`          | Provider 호스팅 고객 포털 URL 인쇄/열기. |
| `billing set-overage-cap` | 월간 초과 캡 또는 클리어.               |
| `billing open`            | Nora 결제 설정 URL 인쇄/열기.         |
| `billing set-tax`         | 비즈니스 세금 필드 설정.                |

## `billing state`

```bash theme={null}
nora billing state
```

인쇄:

* 플랜 (Free / Team / Enterprise).
* 구독 상태 (active / past\_due / canceled).
* 현재 기간 (시작·종료).
* 초과 캡 (설정되면).
* 이 기간 초과 사용됨.

기계 출력에 `--json` 추가.

## `billing usage`

```bash theme={null}
nora billing usage
```

미터별 분해된 현재 결제 기간 사용량:

* 모델 토큰 (provider 티어별).
* 저장 (문서, 청크, 벡터).
* 트레이스 볼륨.
* 플랜별 미터.

플랜 포함 쿼터와 비교.

## `billing history`

```bash theme={null}
nora billing history                                    # 최근 6개월 (기본)
nora billing history --from 2026-01-01 --to 2026-06-30  # 커스텀 범위
```

월간 사용량 롤업. 비용 분석과 예측에 유용.

## `billing invoices`

```bash theme={null}
nora billing invoices
```

이 워크스페이스에 발행된 모든 인보이스 나열:

* 인보이스 번호.
* 커버된 기간.
* 금액.
* 상태 (paid / open / uncollectible).
* PDF 링크.

스크립트 친화 목록에 `--json` 추가.

## `billing portal`

```bash theme={null}
nora billing portal                # URL 인쇄
nora billing portal --launch       # 기본 브라우저에서 열기
```

고객 포털 (결제 provider Polar 호스팅) 에서:

* 결제 방법 업데이트.
* 과거 인보이스 (PDF 와) 뷰.
* 결제 이메일 업데이트.
* 플랜 취소나 변경.

Nora 계정과 같은 이메일로 포털 쪽 인증.

## `billing set-overage-cap`

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

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

초과 캡이 플랜 포함 쿼터 위로 얼마 청구될지 제한. 캡 히트하면 추가 사용량 블록됨 — 대기 초과 승인 요청이 402 로 실패.

* `--cents <n>` — 센트 (US\$) 캡.
* `--clear` — 플랜 기본 사용 (플랜에 따라 다름).

Owner 만 이걸 바꿀 수 있음.

## `billing open`

```bash theme={null}
nora billing open                                       # 결제 설정 URL 인쇄
nora billing open --section usage                       # 사용량으로 딥링크
nora billing open --section invoices --launch           # 브라우저에서 인보이스 열기
```

플래그:

* `--section plans|usage|invoices` — 링크할 페이지.
* `--launch` — 인쇄 대신 기본 브라우저에서 열기.

## `billing set-tax`

```bash theme={null}
nora billing set-tax \
  --business-number "123-45-67890" \
  --tax-email billing@yourcompany.com
```

한국 워크스페이스 (와 유사 세금 체제) 는 설정:

* `--business-number` — 세금 등록 번호 (사업자등록번호). `""` 로 클리어.
* `--tax-email` — 세금 인보이스 배송 이메일.

이 필드가 인보이스에 흐름.

## 레시피

### 부트스트랩 스크립트에서 초과 캡 설정

```bash theme={null}
# $200 월간 초과 제한
nora billing set-overage-cap --cents 20000
```

### 지출 모니터

```bash theme={null}
# 이번 달 사용량이 임계값 넘으면 알림
usage_cents=$(nora billing usage --json | jq '.total_cents')
[ "$usage_cents" -gt "50000" ] && echo "경고: 이번 달 >$500 지출"
```

### 모든 인보이스 PDF 다운로드

```bash theme={null}
mkdir -p invoices
for inv in $(nora billing invoices --json | jq -c '.[]'); do
  url=$(echo "$inv" | jq -r '.pdf_url')
  num=$(echo "$inv" | jq -r '.number')
  curl -sL "$url" -o "invoices/${num}.pdf"
done
```

### 워크스페이스 간 사용량 비교

```bash theme={null}
for ws in acme-dev acme-staging acme-prod; do
  echo "$ws:"
  nora --workspace "$ws" billing usage --json | jq '.total_cents' | \
    awk '{printf "  $%.2f\n", $1/100}'
done
```

## Billing 이 커버하지 않는 것

* **Provider 비용** (OpenAI, Anthropic, Google API 요금) — BYOK (자체 키) 이면 provider 가 직접 결제. [`nora providers`](/ko/cli/providers) 참고.
* **BYO 버킷 통해 붙은 저장** — S3/R2 provider 에 직접 결제.

Nora billing 이 플랫폼 레이어 커버: 워크플로우 실행, 트레이스 저장, 리트리벌 인프라, 메모리, 관리 서비스.

## 관련

* [결제 문서](https://nora.my/pricing) — 플랜 세부와 포함 쿼터.
* [`nora providers`](/ko/cli/providers) — provider API 키 관리 (provider 가 결제).
* [감사 트레일](/ko/reliable/versions/audit) — 결제 관련 변경이 로깅.