# 계측은 실행 시점에, 한도는 실행 이전에

> 호출당 비용, usage credits 한도, 최소 버전과 채널 정책

- Canonical: https://learning.reopt.ai/courses/claude-code-team-operations/lessons/ccto-m4-concept
- Language: ko-KR
- HTML: https://learning.reopt.ai/courses/claude-code-team-operations/lessons/ccto-m4-concept

---

[헤드리스와 팀 운영](/courses/claude-code-team-operations) 4. 비용과 버전 거버넌스 7 / 9

# 계측은 실행 시점에, 한도는 실행 이전에

호출당 비용, usage credits 한도, 최소 버전과 채널 정책
개념 학습 45 XP 9분

헤드리스 자동화가 늘어나면 지출은 대시보드에서 뒤늦게 발견됩니다. 그러나 호출당 비용은 이미 응답 안에 있습니다. --output-format json 의 total_cost_usd 와 모델별 비용 분석을 기록하면 잡별·PR별 지출이 실행 시점에 계측됩니다. 반대로 Claude Code Review와 ultrareview는 플랜 기본 사용량이 아니라 usage credits로 별도 청구되므로 계측만으로는 부족하고, admin settings의 월간 지출 한도와 팀 합의로 사전에 묶어야 합니다. 여기에 주 단위로 움직이는 버전을 어떻게 따라갈지까지 정해야 운영 루틴이 완성됩니다.
최신이 아니라 필요한 최소 기준으로 고정한다 러너 버전은 어떤 수정이 필요해서 그 버전인지 근거를 적을 수 있을 때만 올린다. 긴 초기화 hook을 쓰는 headless 러너가 v2.1.204를 최소 기준으로 두는 것처럼, 근거 없는 업그레이드와 공개 changelog가 없는 next 채널은 운영 기준에서 제외한다.

| 지출·변경 경로 | 계측·기준 | 사전 통제 수단 |
| claude -p 호출 | 응답의 total_cost_usd | 잡별 예산과 호출 빈도 규칙 |
| 구독 플랜 Agent SDK· -p | 2026-06-15부터 별도 월간 크레딧 | 대화형 한도와 분리해 계획 |
| Claude Code Review | usage credits, 리뷰당 평균 $15~$25 | admin settings의 월간 지출 한도 |
| ultrareview | Pro·Max 무료 3회 뒤 회당 약 $5~$20 | 고위험 변경으로 실행 범위 한정 |
| 러너 버전 | claude --version 검증 단계 | 최소 버전 고정과 채널 분리 |

usage credits가 꺼져 있으면 유료 리뷰는 실행 자체가 차단됩니다.

- 1 지출 지도 그리기 호출·구독 크레딧·Code Review·ultrareview 네 경로의 과금 방식을 표로 적습니다.

- 2 한도 걸기 admin settings의 usage에서 월간 지출 한도를 정하고 /usage-credits 정책을 문서화합니다.

- 3 최소 버전 고정 필요한 수정을 근거로 러너 최소 버전을 정하고 claude --version 검증 단계를 넣습니다.

- 4 반영 기록 남기기 changelog를 확인한 뒤 무엇을 왜 반영했고 어떤 문서·자동화에 영향을 줬는지 적습니다.

실무에 남길 기준

- 2026-06-15부터 구독 플랜의 Agent SDK· claude -p 사용량은 대화형 한도와 분리된 월간 크레딧에서 차감된다
- ultrareview는 원격 세션이 시작되는 순간 1회로 카운트되어 중단해도 무료 횟수가 소모된다
- /team-onboarding 산출물은 로컬 사용 이력에 기대므로 공유 전에 개인 흔적을 걷어낸다

[이전](/courses/claude-code-team-operations/lessons/ccto-m3-checklist) 이해했어요 · 계속

---

에이전트용 사이트 안내: https://learning.reopt.ai/llms.txt · 사이트맵: https://learning.reopt.ai/sitemap.xml · 문의: https://learning.reopt.ai/contact
