Claude Code v2.1.225: 게이트웨이 지출 한도와 10개의 버그 수정
AI

Claude Code v2.1.225: 게이트웨이 지출 한도와 10개의 버그 수정

zaq · · 3 min read

Claude Code v2.1.225에서 게이트웨이 사용량 한도 기능이 추가됐습니다. 팀 관리자가 비용을 통제하고, 헤드리스 세션에서 자주 발생하던 인증 버그들이 대거 수정됐습니다.

한마디로 말하면, 비용 관리 기능 하나와 꽤 많은 버그 수정이 이번 업데이트의 핵심입니다. 특히 CI/CD나 서버 환경에서 Claude Code를 돌리는 분들에게 반가운 소식입니다.

게이트웨이 지출 한도 — 비용 통제가 드디어

이제 게이트웨이에서 사용량 한도를 설정하면, 한도에 도달했을 때 Claude Code가 명확한 메시지를 보여줍니다. 단순히 "사용량 초과"가 아니라, 설정된 한도 금액, 초기화 시점, 관리자 메시지까지 표시됩니다. 팀 단위로 Claude Code를 쓰는 환경에서 예산 관리가 한층 쉬워졌습니다. 게이트웨이도 v2.1.225 이상이어야 동작합니다.

헤드리스 & 인증 버그 대공사

이번에 수정된 버그 10개 중 절반 이상이 인증과 헤드리스 세션 관련입니다. 핵심만 짚어보면:

  • 401 인증 실패: long-lived OAuth 토큰이 short-lived 토큰으로 교체되면서 헤드리스 세션이 끊기던 문제 수정
  • macOS MCP OAuth: 키체인 읽기 타임아웃 후 401 에러가 폭발하던 현상 수정
  • 크로스 세션 메시지: 헤드리스 세션에서 메시지가 notice도 없이 묵혀있던 문제 수정
  • Remote Control 대화 복원: 대화가 너무 커서 compaction된 이후 세션을 재개하면 기록이 깨지던 현상 수정

CI/CD 파이프라인이나 self-hosted-runner 환경에서 Claude Code를 쓰고 있었다면, 아마 이 버그들 중 하나쯤은 겪어봤을 겁니다.

Remote Control & SendMessage 개선

Remote Control이 더 자연스럽게 동작합니다. Claude 앱에서 첨부한 사진을 이제 Claude가 직접 받아볼 수 있습니다. 이전엔 디스크에서 별도 tool call로 읽어왔거든요. 또 SendMessage가 다른 머신의 Remote Control 세션에 이름으로 먼저 메시지를 보낼 수 있게 됐습니다. 상대방이 먼저 연락해야만 답장할 수 있었던 제약이 사라졌습니다.

VSCode 확장도 개선됐는데, Focus 뷰에서 최신 todo 리스트와 대기 중인 질문이 갑자기 접혀버리던 문제가 수정됐습니다. "Thought for Ns" 표시와 함께 턴이 끝나면 자동으로 다시 접힙니다.

비용 관리는 팀 규모로 Claude Code를 도입하는 조직에 필수적인 기능입니다. 이제 남은 건 성능과 안정성을 다듬는 일이겠죠. v2.1.225는 그 방향으로 탄탄하게 나아간 한 걸음입니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.225