claudekit / updates / claude-code-2-1-225
[ PATCH · ]

Claude Code 2.1.225

게이트웨이 지출 한도가 Claude Code의 사용량 경고에 반영돼, 한도에 도달했을 때 한도 값과 초기화 시각, 운영자가 설정한 안내 문구가 함께 표시됩니다(게이트웨이도 2.1.225 필요). claude agents에도 신뢰하지 않는 디렉토리에 대한 워크스페이스 신뢰 확인이 추가됐고, SendMessage로 다른 기기의 원격 제어 세션에 이름을 지정해 먼저 대화를 시작할 수 있게 됐습니다. 일시적인 401 오류가 장기 사용 토큰인 CLAUDE_CODE_OAUTH_TOKEN을 저장된 로그인의 짧은 수명 토큰으로 바꿔 재시작 전까지 헤드리스 세션이 동작하지 않던 문제, macOS에서 키체인 읽기가 시간 초과된 뒤 MCP OAuth 서버가 401 오류를 연달아 내던 문제, 아주 긴 대화가 압축된 뒤 원격 제어 세션을 재개하면 대화 기록이 깨지던 문제도 함께 수정됐습니다.

Claude Code
공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.225가 2026년 8월 8일 출시됐습니다. 인증 토큰과 세션 상태가 어긋나면서 헤드리스 세션(화면 없이 명령으로만 실행되는 세션)과 원격 제어 세션이 조용히 멈추던 경로를 정리한 릴리스입니다. 여기에 게이트웨이의 지출 한도를 사용량 경고에 반영하는 기능, claude agents의 워크스페이스 신뢰 확인, SendMessage로 다른 기기의 세션에 먼저 말을 거는 방법이 추가됐습니다.

새 기능

  • 사용량 경고의 게이트웨이 지출 한도 표시

    게이트웨이(조직이 Claude API 요청을 중개하도록 직접 운영하는 서버)에 지출 한도가 걸려 있어도, 한도에 도달했을 때 나오는 메시지만으로는 무엇이 얼마에서 막혔는지 알 수 없었습니다. 이제 Claude Code의 사용량 경고가 게이트웨이 지출 한도를 함께 다루며, 한도에 도달한 메시지에 한도 값, 초기화 시각, 운영자가 설정한 안내 문구가 표시됩니다. 게이트웨이 쪽도 2.1.225여야 동작합니다.

  • claude agents의 워크스페이스 신뢰 확인

    claude로 실행할 때는 신뢰하지 않는 디렉토리에서 이 워크스페이스를 신뢰할지 묻는 확인이 표시됐지만, claude agents에는 이 단계가 없었습니다. 이제 claude agents도 신뢰하지 않는 디렉토리에서 claude와 같은 확인을 표시합니다.

  • SendMessage로 원격 제어 세션에 먼저 대화 시작

    다른 기기에서 돌아가는 원격 제어(Remote Control) 세션에는 상대가 먼저 메시지를 보낸 뒤에만 답할 수 있었습니다. 이제 SendMessage로 이름을 지정해 이쪽에서 먼저 대화를 시작할 수 있고, ListAgents가 이런 세션을 name [ref] 형태로 보여줍니다.

주요 개선

  • 원격 제어에서 첨부한 사진을 바로 전달

    Claude 앱에서 사진을 첨부하면 Claude가 보기 전에 별도의 도구 호출로 디스크에서 다시 읽어야 했습니다. 이제 첨부한 사진이 Claude에게 직접 전달되어, 사진 하나를 보는 데 도구 호출이 한 번 더 들어가지 않습니다.

  • 자동 모드에서 안전 필터가 거부한 권한 검사 처리

    자동 모드는 스스로 실행한 권한 검사가 안전 필터에 거부되면 이를 연속 차단 횟수에 포함했고, 실제로 막힌 작업이 아닌데도 한도에 가까워졌습니다. 이제 해당 동작은 그대로 거부되지만 연속 차단 횟수에는 반영되지 않고, 모델에게는 재시도 대신 다음으로 넘어가라고 알립니다.

  • claude self-hosted-runner의 시작 시점 오류 안내

    --base-dir로 지정한 경로를 만들거나 쓸 수 없어도 러너는 일단 등록됐고, 이후 모든 세션이 실패했습니다. 이제 시작 시점에 원인을 알리는 오류를 표시하고 종료합니다.

주요 버그 수정

인증

  • 일시적인 401 오류가 장기 사용 토큰인 CLAUDE_CODE_OAUTH_TOKEN을 저장된 로그인의 짧은 수명 토큰으로 바꿔, 재시작 전까지 헤드리스 세션이 동작하지 않던 문제 수정.
  • macOS에서 키체인 읽기가 시간 초과된 뒤, MCP OAuth 서버가 한 번도 인증한 적 없는 것처럼 401 오류를 연달아 내던 문제 수정.

세션과 메시지

  • 헤드리스 세션과 시작 단계에서 세션 간 메시지가 안내도 만료도 없이 대기 상태로 남아 있던 문제 수정.
  • 아주 긴 대화가 압축된 뒤 원격 제어 세션을 재개하면 대화 기록이 깨지던 문제 수정.
  • Claude Code on the web 세션이 멈춘 것으로 잘못 보고되면서, 재연결할 때마다 쌓인 이벤트를 점점 더 많이 다시 보내던 문제 수정.
  • SendMessage에서 이미 확인한 원격 제어 수신자가, 그 세션의 목록을 확인하지 못했을 때 같은 이름의 로컬 세션으로 바뀌던 문제 수정.

에이전트 목록과 편집기

  • 에이전트 목록에서 다른 프로젝트의 세션 위에 마우스를 올리면, 다음 에이전트가 시작될 디렉토리가 바뀌던 문제 수정.
  • [VSCode] Focus 뷰가 최신 할 일 목록, 대기 중인 질문의 맥락, 확정된 답변까지 접어버리던 문제 수정 — 생각만 담긴 항목은 “Thought for Ns”로 표시되고 해당 턴이 끝나면 다시 접힙니다.

알아두면 좋은 점

  • 지출 한도 표시는 양쪽 버전이 맞아야 동작 — Claude Code만 2.1.225로 올려서는 표시되지 않습니다. 게이트웨이 쪽도 2.1.225여야 합니다.
  • 헤드리스 환경에 특히 의미 있는 릴리스 — CLAUDE_CODE_OAUTH_TOKEN이 바뀌던 문제와 세션 간 메시지가 대기 상태로 남던 문제 모두 헤드리스 세션에서 드러났습니다. CI나 자동화로 Claude Code를 실행한다면 업데이트할 이유가 있습니다.
  • claude agents에서 확인 창이 새로 뜰 수 있음 — 신뢰하지 않는 디렉토리에서 실행하면 이전에 없던 워크스페이스 신뢰 확인이 표시됩니다. 스크립트로 자동 실행하는 환경이라면 이 단계를 고려해야 합니다.
  • 자동 모드의 연속 차단 한도 자체는 그대로 — 안전 필터가 거부한 자체 권한 검사만 횟수에서 빠집니다. 거부된 동작이 실행되는 것은 아닙니다.