[Claude] Managed Agents 세션에 달러 상한이 생겼어요

[Claude] Managed Agents 세션에 달러 상한이 생겼어요

에이전트 세션에 달러 하드 캡이 생겼어요. Anthropic이 현지시간 8월 7일 Claude Managed Agents에 세션 예산을 추가했어요. 정해둔 금액에 닿으면 세션이 새 모델 요청을 더 보내지 않고 멈춰요.

01. 센트 단위 문자열로 상한을 걸어요

세션을 만들 때 budget 필드를 같이 넘기는 방식이에요. type은 항상 limit이에요. max_list_cost의 amount는 달러가 아니라 미국 센트를 문자열로 적어요. "2500"이 25달러, "50"이 50센트예요.

"25.00" 같은 소수 표기는 400 에러로 거부돼요. 금액에 부동소수점 반올림이 끼지 않게 하려고 숫자가 아닌 문자열로 받는다고 문서에 나와 있어요. currency는 USD만 지원해요.

curl https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "agent": "AGENT_ID",
    "environment_id": "ENVIRONMENT_ID",
    "budget": {
      "type": "limit",
      "max_list_cost": {"amount": "2500", "currency": "USD"}
    }
  }'

상한은 세션을 만들 때만 붙일 수 있어요. 예산 없이 시작한 세션에 나중에 예산을 추가하는 요청은 400으로 막혀요.

02. 상한에 닿아도 세션이 죽지는 않아요

상한에 도달한 세션은 종료가 아니라 idle 상태로 멈춰요. stop_reason에는 budget_reached가 찍혀요. 대화 기록과 샌드박스는 다른 idle 세션과 똑같이 보존돼요.

예산을 올리거나 없애면 멈춰 있던 작업이 자동으로 이어져요. 클라이언트가 따로 재개를 호출할 필요는 없다고 해요.

멈춰 있는 동안에는 새 작업을 시작하는 이벤트가 400으로 거부돼요. 도구 승인·도구 결과·커스텀 도구 결과처럼 이미 진행 중이던 걸 매듭짓는 이벤트만 받아요. 인터럽트도 받기는 하지만 상한에 멈춘 세션에서는 아무 일도 하지 않는다고 문서에 나와 있어요.

한 가지 주의할 점은 예산 제거가 일방향이라는 거예요. 한 번 null로 지운 세션에는 다시 상한을 걸 방법이 없어요. 캡을 계속 두려면 제거 대신 금액 변경을 써야 해요.

03. 토큰뿐 아니라 실행 시간과 웹 검색도 계산돼요

상한과 비교하는 값은 세션의 list cost예요. 모델 토큰은 각 모델 공식 단가로, 웹 검색은 1,000회당 10달러, 세션이 떠 있는 시간은 시간당 0.08달러로 계속 더해져요.

헷갈리기 쉬운 지점도 있어요. 세션은 정가 기준 합계가 상한에 닿을 때 멈춰요. 조직에 별도 할인 계약이 있다면 그 시점의 실제 청구액은 상한에 못 미쳐요.

Messages API의 task budgets와는 다른 기능이에요. 그쪽은 모델이 스스로 참고하는 토큰 단위 권고치예요. 세션 예산은 플랫폼이 강제하는 달러 하드 캡이에요.

04. 상한을 한 요청만큼은 넘길 수 있어요

판정은 모델 요청 사이에서 이뤄져요. 요청을 보내기 전에 누적 금액을 확인해요. 이미 상한에 닿았으면 다음 요청부터 멈추는 구조예요.

그래서 캡을 넘기게 만든 그 요청 자체는 끝까지 실행돼요. 50센트 상한을 건 세션이 53센트에서 멈출 수 있다고 문서에 예시가 나와 있어요. 초과 폭은 스레드당 요청 한 번으로 제한돼요.

정확한 정지선이 아니라 새 작업을 막는 경계로 봐야 해요. 금액은 요청 한 번 분의 여유를 두고 잡는 편이 안전해요.

05. 예약 실행에도 같은 상한이 복사돼요

deployment에도 같은 budget 객체를 넘길 수 있어요. 이때 상한은 deployment의 누적 지출이 아니라 거기서 시작하는 세션 하나하나에 복사돼요. 매일 도는 잡이라면 실행 한 번마다 캡이 걸리는 셈이에요.

세션이나 배포 엔드포인트를 호출할 때는 managed-agents-2026-04-01 베타 헤더가 필요해요. 메모리 스토어 엔드포인트만 agent-memory-2026-07-22를 써요. 공식 SDK는 맞는 헤더를 자동으로 붙여준다고 해요.

같은 날 Managed Agents에는 세션 중간에 에이전트와 동급 이상인 모델에게 전략을 물어보는 advisor 설정, 추론이 도는 지역을 지정하는 inference_geo, 마운트한 GitHub 저장소 루트의 .claude/skills를 세션 시작 때 자동으로 읽어오는 기능도 함께 올라왔어요.

출처: Claude Platform release notes (2026년 8월 7일), Session budgets 문서

이 글은 공식 발표 내용을 정리한 것이고, Anthropic으로부터 어떤 형식의 협찬도 받지 않았습니다.