클로드 에이전트 요금 상한의 함정 여섯 가지

AI 에이전트를 혼자 돌게 두면 제일 겁나는 게 요금이 어디까지 올라갈지 모른다는 점입니다. 그래서 세션마다 지출 상한을 걸어두는 기능이 생겼는데, 문서를 끝까지 읽어 보니 상식대로 동작하지 않는 대목이 여섯 군데 있었습니다. 금액을 잘못 적으면 에이전트가 시작하자마자 멈추고, 멈춘 걸 잘못 푸는 순간 그 세션은 영영 상한 없이 돌아갑니다. 하나씩 짚어봅니다.

📌 30초 요약

• 금액 단위가 센트입니다. "125"는 125달러가 아니라 1달러 25센트입니다.
• 한 번 지운 상한은 다시 못 겁니다. 상한 없이 만든 세션에 나중에 붙이는 것도 거부됩니다.
• 세는 건 토큰만이 아닙니다 — 웹 검색은 건당, 세션이 켜져 있는 시간은 시간당으로 따로 붙습니다.
• 기준이 공개 정가라, 할인 계약이 있으면 상한에 걸려 멈춰도 실제 청구액은 그보다 적습니다.
• 배포에 건 상한은 누적이 아니라 실행 한 번당입니다. 오해하면 딱 실행 횟수만큼 곱해집니다.
• 상한을 넘겨서 멈춥니다. 진행 중이던 요청은 끝까지 가므로 50센트 상한이 53센트에서 멈출 수 있습니다.

① 단위가 달러가 아니라 센트

가장 먼저 걸릴 자리입니다. 공식 예제에 "amount": "125"라고 적혀 있어서 125달러 상한으로 읽기 쉬운데, 문서가 다른 대목에서 "50으로 잡은 세션(50센트)"이라고 못 박습니다. 즉 125는 1달러 25센트입니다.

그럼 소수점을 쓰면 되지 않느냐 하면, "25.00"처럼 적으면 400 에러로 거부됩니다. 센트 단위 정수만 받습니다. 0이나 음수도 안 되고, 통화는 USD만 됩니다.

💡 증상으로 먼저 나타납니다

100달러를 걸었다고 생각했는데 에이전트가 첫 몇 마디 만에 멈춘다면 십중팔구 이겁니다. "100"은 1달러거든요. 100달러를 걸려면 "10000"이라고 적어야 합니다.

② 한 번 지우면 다시 못 겁니다

이게 여섯 개 중 제일 무서운 대목입니다. 상한에 걸려 멈춘 세션을 다시 굴리는 방법은 두 가지입니다 — 상한을 올리거나, 상한을 지우거나. 그런데 지우는 쪽을 고르면 그 세션에는 다시 상한을 붙일 수 없습니다. 문서의 에러 표에 그대로 적혀 있습니다: "상한 없이 만든 세션에 상한을 추가하거나, 제거한 뒤 다시 추가하면 400".

즉 지출 상한은 세션을 만드는 순간에만 결정할 수 있는 일회성 선택입니다. 급해서 null로 지워 재개시켜 놓으면, 그 세션은 남은 수명 동안 아무 제동장치 없이 돕니다.

푸는 방법	결과	되돌릴 수 있나
상한 금액을 올린다	멈췄던 일이 자동으로 재개, 새 상한이 계속 작동	예 — 이후에도 계속 조절 가능
상한을 null로 지운다	재개되지만 그 세션은 무제한이 됨	아니오 — 다시 붙이면 400
아예 상한 없이 세션을 만든다	처음부터 제동장치 없음	아니오 — 나중에 못 붙임

올릴 때도 자잘한 함정이 하나 있습니다. 새 금액은 이미 쓴 금액보다 반드시 커야 하는데, 세션이 멈출 땐 대개 상한을 조금 넘긴 상태입니다(항목 ⑥). 게다가 화면에 보이는 사용액은 센트 단위로 반올림된 값이라 실제보다 살짝 낮게 나올 수 있습니다. 그래서 문서는 옛 상한이 아니라 보고된 사용액을 기준으로, 거기서 1센트 이상 올려 잡으라고 안내합니다.

③ 토큰만 세는 게 아닙니다

상한이 세는 대상은 세 가지입니다. 토큰만 생각하고 금액을 잡으면 예상보다 빨리 멈춥니다.

항목	계산 방식	놓치기 쉬운 점
모델 토큰	쓰인 모델의 공개 정가	여러 모델을 섞으면 각자 요율로 계산
웹 검색	1,000건당 10달러	검색은 건당 붙지만, 웹 페치는 건당 요금이 없어 0으로 찍힘
세션이 켜져 있는 시간	시간당 0.08달러	모델을 안 부르는 구간도 시간이 흐르면 붙음

세 번째가 특히 중요합니다. 길게 살아 있는 세션은 아무 일을 안 해도 요금이 올라갑니다. 시간당 0.08달러면 하루 종일 켜둘 때 2달러 남짓이라 큰돈은 아니지만, 상한을 몇십 센트로 잡고 테스트하는 상황이라면 이 항목만으로 상한에 닿을 수 있습니다. 토큰 자체를 줄이는 요령은 토큰 아끼는 실전 10가지에 따로 정리해 뒀는데, 여기서 세는 대상은 그보다 넓다는 걸 같이 기억해두면 좋습니다.

④ 기준이 정가라 실제 청구와 다릅니다

상한이 비교하는 값은 공개 정가로 환산한 금액이지, 내가 실제로 낼 금액이 아닙니다. 문서가 직접 씁니다 — "정가 기준 총액이 상한에 닿으면 세션이 멈추고, 청구되는 금액은 상한보다 적을 수 있다."

할인 계약을 맺은 조직이라면 상한 100달러짜리 세션이 실제로는 70달러쯤 쓰고 멈추는 셈입니다. 안전한 방향의 오차이긴 하지만, "상한 = 예산 소진"으로 회계를 붙여 놓으면 숫자가 계속 안 맞습니다. 반대로 정가가 공개되지 않은 모델을 쓰면 아예 상한을 걸 수 없고, 세션 도중에 그런 모델이 끼어들면 상한 변경마저 거부돼 지우는 것 말고는 재개할 방법이 없습니다. 항목 ②와 겹쳐서, 그 순간 그 세션은 무제한이 됩니다.

🔒 안전장치가 스스로를 막는 자리

상한을 걸어둔 목적은 모르는 사이에 돈이 새는 걸 막는 것입니다. 그런데 정가 없는 모델이 끼면 상한을 올릴 수도 없고 지우기 전엔 재개도 안 됩니다. 결국 급한 사람은 지우게 되고, 지우는 순간 그 세션은 처음 걱정하던 상태로 되돌아갑니다. 상한을 걸 거면 세션이 쓸 모델을 미리 고정해두는 편이 안전합니다.

⑤ 배포에 건 상한은 실행 한 번당

정해진 일정마다 에이전트를 돌리는 배포(deployment)에도 같은 상한을 걸 수 있습니다. 여기서 오해가 나기 쉬운데, 그 금액은 배포가 시작하는 세션마다 하나씩 복사됩니다. 누적 총액이 아닙니다.

20달러를 걸어놓고 하루 한 번씩 30일을 돌리면 상한은 20달러가 아니라 실질적으로 600달러가 됩니다. 게다가 배포의 상한을 나중에 바꿔도 이미 돌고 있는 세션에는 적용되지 않고, 그 뒤에 시작하는 세션부터 반영됩니다. 다만 세션과 달리 배포의 상한은 지웠다가 다시 걸 수 있습니다. 항목 ②의 제약은 세션에만 해당합니다.

⑥ 상한을 넘겨서 멈추고, 멈춘 뒤엔 대화가 막힙니다

검사는 요청과 요청 사이에 이뤄집니다. 요청을 보내기 직전에 지금까지 쓴 금액을 확인하고, 상한에 닿았으면 멈춥니다. 그런데 상한을 넘기게 만든 그 요청은 이미 통과된 뒤라 끝까지 실행됩니다. 그래서 50센트로 잡은 세션이 53센트에서 멈출 수 있습니다. 문서는 이걸 "청구 오류가 아니라 예상된 동작"이라고 못 박고, 요청 한 건만큼의 여유를 미리 계산해서 금액을 잡으라고 안내합니다.

멈춘 세션은 종료가 아니라 유휴 상태입니다. 대화 기록과 작업 공간이 그대로 보존되니 상한만 올리면 하던 일을 이어서 합니다. 다만 그 사이에 새 일을 시작시키는 메시지는 400으로 거부됩니다. 받아주는 건 이미 진행 중이던 일을 마무리하는 네 가지뿐입니다.

# 상한에 걸린 세션이 받아주는 이벤트 — 진행 중인 일의 마무리만
user.tool_confirmation    # 도구 실행 승인
user.tool_result          # 도구 결과 전달
user.custom_tool_result   # 사용자 정의 도구 결과
user.interrupt            # 중단 (단, 이미 멈춰 있으면 아무 일도 안 함)

# 거부되는 것 — 새 일을 시작시키는 이벤트
user.message              -> 400

# 재개하려면 (센트 단위, 이미 쓴 금액보다 커야 함)
$ ant beta:sessions update --session-id "$SESSION_ID" \
    --budget '{type: limit, max_list_cost: {amount: "500", currency: USD}}'
#   "500" = 5달러

여러 에이전트를 동시에 굴리는 경우엔 예산이 하나로 공유됩니다. 에이전트별 상한은 없어서, 하나가 많이 쓰면 나머지가 그만큼 못 씁니다. 다만 승인 대기 중인 요청이 있으면 그쪽이 우선이라, 답을 주는 일은 상한에 걸려도 막히지 않습니다. 이런 구조를 내 손으로 직접 짜는 쪽과 비교해보고 싶다면 개인 AI 인프라 조립 가이드가 반대편 그림입니다.

💤 값이 나가는 자리가 하나 더 있습니다 (8월 27일 추가)

같은 제품군에 기억을 정리해주는 기능이 붙었는데, 이름이 재미있게도 '꿈'입니다. 오래 일할수록 에이전트 기억에 중복·모순·낡은 항목이 쌓이는데, 지난 대화들을 되짚어 새 기억 저장소를 하나 만들어냅니다. 값 관점에서 알아둘 게 둘인데 — 넣은 대화의 수와 길이에 거의 비례해 과금되고, 몇 분에서 몇 시간까지 걸립니다. 그래서 문서도 작은 묶음으로 시작하라고 권합니다. 다행히 원본은 안 건드려서 결과가 별로면 버리면 됩니다. 정리는 AI가 꾸는 꿈에 담았습니다.

🔁 같은 일도 어디서 돌리느냐로 값이 갈립니다

상한을 걸어 두는 것과 별개로 어디서 돌리느냐도 값에 영향을 줍니다. 대화를 통째로 물려받는 갈래는 시스템 지침과 도구 구성이 본 세션과 같아서 첫 요청이 부모의 캐시를 그대로 재사용합니다. 같은 배경이 필요한 일이라면 새 하위 작업을 띄우는 것보다 쌉니다. 반대로 일반 하위 작업은 캐시가 따로라 처음부터 데워야 하고요. 확인만 하면 되는 질문은 아예 기록에 안 남는 곁가지 질문으로 돌리면 답값 말고는 거의 안 듭니다.

🔁 상한에 걸린 뒤의 동작도 함정이 있습니다

요금 상한을 거는 쪽의 함정을 봤으니, 걸린 뒤도 적어 둡니다. 한도에 걸리면 기다렸다 이어 가는 기능은 기본으로 켜져 있지만 컴퓨터가 30분 남짓 넘게 자면 자동으로 안 이어지고 엔터를 기다립니다. 이어가다 또 걸리면 연달아 두 번까지만 재시도하고 멈추고요. 게다가 세션을 옮기거나 다른 지시를 보내는 것만으로도 대기가 끝납니다. 「밤새 알아서 다 돌아 있겠지」가 어긋나는 지점이 여럿이니 큰 작업일수록 여유를 먼저 재 보세요.

자주 묻는 질문

Q. 이게 챗봇 API에도 적용되나요?

아니요. 지금 얘기한 건 관리형 에이전트(Managed Agents)의 세션 상한이고, 플랫폼이 강제하는 달러 단위 하드캡입니다. 일반 메시지 API에도 예산 개념이 있지만 그쪽은 토큰 단위의 권고값이라, 모델이 스스로 조절하는 데 쓰일 뿐 강제로 멈추지 않습니다. 이름이 비슷해서 헷갈리기 쉬운데 성격이 아예 다릅니다.

Q. 얼마로 잡는 게 적당한가요?

정답은 없지만 계산 순서는 있습니다. ①예상 토큰 비용에 ②웹 검색 건수 곱하기 0.01달러, ③예상 실행 시간 곱하기 0.08달러를 더하고, 거기에 요청 한 건만큼의 여유를 얹으세요. 그리고 센트로 환산해서 적습니다. 저라면 처음엔 넉넉히 잡고 실제 사용액을 본 뒤 줄이겠습니다 — 너무 짜게 잡아 멈추면 푸는 과정에서 실수로 지워버릴 위험이 생기니까요.

Q. 실제로 얼마 나갔는지는 어디서 보나요?

세션 정보에 정가 환산 사용액과 실행 시간(초)이 같이 들어옵니다. 유휴 상태로 들어가기 직전에 사용량 스냅샷이 한 번 날아오니, 그걸 받아 기록해두면 됩니다. 다만 에이전트별 수치는 각각 반올림되고 세션 실행 시간 요금이 빠져 있어서, 다 더해도 세션 총액과 정확히 맞지 않습니다. 상한이 비교하는 건 세션 쪽 숫자입니다.

🧾 정직하게 밝혀둡니다

• 제가 직접 돌려보고 쓴 글이 아닙니다. 공식 문서를 읽고 정리한 내용이라, 실제 동작이 문서와 다를 여지가 있습니다.
• 이 기능은 베타 헤더가 필요한 단계입니다. 필드 이름이나 동작이 바뀔 수 있습니다.
• 본문의 요율(웹 검색 1,000건당 10달러, 시간당 0.08달러)은 문서 확인 시점 기준이고 변동될 수 있습니다.
• "125가 1달러 25센트"는 문서의 두 대목(예제와 설명)을 대조해 얻은 결론입니다. 실제로 걸기 전에 아주 작은 금액으로 한 번 확인해보시길 권합니다.
• 비용 관련 판단은 각자 계약 조건에 따라 달라집니다. 여기 숫자를 그대로 회계에 쓰지 마세요.

✨ 정리하면

지출 상한은 세션을 만드는 그 순간에만 걸 수 있는 일회성 결정입니다. 금액은 센트로 적고, 막혔을 때는 지우지 말고 올리세요. 한 번 지우면 그 세션에는 두 번 다시 못 겁니다. AI 비용을 넓게 훑어보려면 AI 지출 정리 허브도 같이 보세요.

출처: Anthropic 공식 문서 Session budgets · Claude Managed Agents overview (2026-08-22 확인). 요율과 필드명은 베타 단계라 변경될 수 있습니다. 이 글은 정보 제공용이며 특정 서비스의 구매를 권유하지 않습니다.