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

# 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) 결제 관련 변경이 기록됨.