[Claude Code] 2.1.310, Bedrock·Vertex도 Monitor가 돼요

[Claude Code] 2.1.310, Bedrock·Vertex도 Monitor가 돼요

Claude Code 2.1.310부터 Amazon Bedrock, Google Vertex, Microsoft Foundry로 쓰는 환경에서도 Monitor 도구가 열렸어요. 텔레메트리나 비필수 트래픽을 꺼둔 환경도 마찬가지예요. 회사 정책 때문에 클라우드 제공사로만 Claude Code를 쓰던 사람은 그동안 이 기능이 아예 없었어요.

01. 지금까지는 클라우드 제공사에서 Monitor가 빠져 있었어요

공식 도구 문서에는 Monitor가 Bedrock, Google Cloud Agent Platform, Microsoft Foundry에서는 제공되지 않는다고 적혀 있어요. DISABLE_TELEMETRY나 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC를 설정한 경우도 제외 대상이었어요. 문서의 Google Cloud Agent Platform이 changelog의 Vertex와 같은 제공사예요.

2.1.310 changelog는 이 환경들에 Monitor 도구와 플러그인 모니터를 추가했다고 적고 있어요. 이 글을 쓰는 시점에 도구 문서는 아직 이전 설명 그대로라, 문서만 보고 판단하면 헷갈릴 수 있어요.

보안 때문에 아래 변수 중 하나라도 켜둔 사내 환경이 여기에 해당해요.

export DISABLE_TELEMETRY=1
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

현재 버전은 claude --version으로 확인하고, claude update로 올리면 돼요.

02. Monitor는 기다리는 동안 대화를 멈추지 않아요

Monitor는 명령을 백그라운드로 돌리면서 출력 한 줄 한 줄을 Claude에게 넘겨주는 도구예요. 문서에 나온 용도는 로그 tail로 에러 잡기, PR이나 CI 상태 변화 알림, 디렉터리 변경 감시 같은 것들이에요.

그동안 대화는 계속 이어지고, 이벤트가 오면 Claude가 중간에 끼어드는 방식이에요. WebSocket 주소를 바로 구독하는 것도 된다고 해요.

문서 기준으로 감시마다 마감 시간이 있어요. 기본 5분, 최대 30분이고 claude -p 같은 비대화형 실행에서는 최대 10분이에요.

명령 실행 권한은 Bash와 같은 allow·deny 규칙을 따라요. 다만 auto mode에서는 Monitor를 직접 지정한 allow 규칙이 빠지고, WebSocket 연결은 따로 승인을 받아요.

changelog에는 이 환경들에서 긴 foreground sleep도 함께 막힌다고 적혀 있어요.

03. 플러그인 모니터도 같이 켜져요

플러그인은 monitors/monitors.json에 모니터를 선언해두면 세션 시작과 함께 자동으로 띄울 수 있어요. when 필드를 쓰면 특정 스킬이 처음 실행될 때 띄우는 것도 돼요. 문서 예시는 이런 모양이에요.

[
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log"
  }
]

이 명령은 사용자 권한 그대로, sandbox 밖에서 실행된다고 문서에 나와 있어요. 대화형 세션에서만 시작되고 -p 모드에서는 뜨지 않아요.

changelog대로라면 이런 플러그인을 설치해 둔 클라우드 제공사 환경에서는 업데이트 후 대화형 세션부터 모니터가 실제로 돌기 시작해요. 플러그인 폴더의 monitors.json에 적힌 command를 먼저 열어보면 돼요.

04. 붙여넣은 이미지가 지워지던 문제도 고쳐졌어요

changelog에 따르면 cleanupPeriodDays를 아주 큰 값으로 잡으면 백그라운드 정리가 붙여넣은 이미지 같은 최근 파일까지 지우던 버그가 고쳐졌어요. 세션 기록을 오래 남기려고 이 값을 크게 잡아둔 경우라면 해당돼요.

effort-2025-11-24 베타 값이나 대화 중간 system 메시지를 거부하는 게이트웨이 뒤에서 요청이 실패하던 문제도 수정됐어요. 이제는 그 값이나 system 메시지를 빼고 다시 시도한다고 해요.

출처: Claude Code CHANGELOG (2.1.310), Tools reference — Monitor tool, Add components to a plugin — Monitors

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