자는 동안 요금 걱정 그만 — Claude Code에 지출 상한 거는 법

지난번에 루프를 걸 땐 멈출 조건부터 정하라고 말씀드렸어요(그 글). AI는 안 멈추니까 자는 동안 요금이 쌓인다고요.

그 걱정을 덜어주는 기능이 Claude Code에 있어요. 금액으로 상한을 거는 옵션이에요.

얼마까지만 쓰라고 못 박기

--max-budget-usd 뒤에 달러 금액을 적으면, 그만큼 쓰고 나면 알아서 멈춰요.

# 2달러까지만 쓰고 멈춰라 — 자동 작업 걸 때 필수예요
claude -p "실패한 테스트를 하나씩 고쳐줘" --max-budget-usd 2
 
# 밤새 돌릴 거면 좀 더 넉넉하게, 그래도 상한은 꼭
claude -p "문서 오탈자를 전부 찾아 고쳐줘" --max-budget-usd 5

⚠️ 여기서 많이 헤매요

이 옵션은 -p(또는 --print)와 같이 써야만 작동해요. 평소처럼 대화창을 띄우는 방식에선 안 먹혀요.

-p가 뭐냐면 대화창 없이 한 번 시키고 결과만 받고 끝내는 모드예요.

• 대화하며 작업 → 상한 옵션 ❌ (대신 내가 지켜보고 있으니 덜 위험해요)
• 자동으로 돌려놓기 → -p + 상한 ⭕ (지켜보는 사람이 없으니 꼭 필요해요)

생각해보면 자연스러워요. 위험한 건 사람이 안 보고 있을 때니까, 그쪽에 안전장치가 붙은 거죠.

자동화에 붙이면 이렇게 돼요

크론이나 루틴으로 매일 돌릴 때 이렇게 쓰면 마음이 편해요.

# 매일 새벽에 돌지만, 하루 3달러를 넘기지 않아요
claude -p "어제 올라온 이슈를 정리해서 요약해줘" --max-budget-usd 3
 
# 결과를 파일로 남기고 싶으면 이렇게
claude -p "코드 리뷰해줘" --max-budget-usd 2 > review.txt

같이 나온 기능 하나 더

최근 버전에는 내 서버에서 세션을 돌리는 기능(--environment)도 들어왔어요. 회사 서버 안에서만 작업이 돌아가야 하는 경우를 위한 거예요. 폐쇄망 환경에 관심 있으시면 이 글과 같이 보시면 좋아요.

정리

• 자동으로 돌릴 땐 금액 상한을 꼭 거세요
• 다만 -p 모드에서만 작동해요. 이거 모르면 걸어놓고 안 걸린 줄 알아요
• 대화하며 쓸 땐 내가 보고 있으니 덜 걱정해도 돼요

옵션은 버전에 따라 다를 수 있어요. claude --help를 쳐보면 내 버전에서 실제로 되는 것만 나오니 그걸로 확인하는 게 제일 정확해요.

여러분은 AI 요금 관리 어떻게 하고 계세요? 예상 못 한 금액 나온 적 있으시면 노하우 방에 풀어주세요 ⚡