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

Claude Code 2.1.273

LLM 게이트웨이 운영자를 위한 요청 헤더 다섯 종이 `CLAUDE_CODE_GATEWAY_HINT_HEADERS=1`로 추가됐고, 재연결을 포기한 MCP 서버를 알려주는 알림과 Claude 앱에서 Remote Control 세션을 포크하는 기능이 새로 들어왔습니다. 개선 17건과 변경 6건은 오류 메시지를 원인 중심으로 바꾸는 데 집중합니다. GitHub IP 허용 목록, SAML 단일 로그인, 신뢰되지 않은 사내 CA 인증서, 게이트웨이 관리자 문의 등 실제 원인을 짚어 주며, 긴 대화에서 훅 진행 상황과 서브 에이전트 활동을 갱신할 때마다 대화 전체를 다시 처리하지 않아 반응 속도도 빨라졌습니다. 버그 수정 35건에는 권한 검사기가 분석하지 못한 Bash 명령이 확인 프롬프트를 건너뛰던 문제, 조직이 Skills를 끈 뒤에도 동기화된 스킬이 남던 문제, advisor 도구 턴을 실제의 두 배로 세어 자동 압축이 절반 시점에 실행되던 문제가 포함됩니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.273이 2026년 9월 15일 출시됐습니다. 이번 릴리스에서 가장 두드러지는 흐름은 오류 메시지를 원인 중심으로 다시 쓴 작업입니다. 지금까지는 GitHub 접근이 막히거나 인증이 만료되거나 사내 프록시에 걸렸을 때 “관리자 권한이 필요하다”, “/login을 실행하라” 같은 일반적인 안내만 나와서, 실제로 무엇을 고쳐야 하는지 알기 어려웠습니다. 이제 IP 허용 목록, SAML 단일 로그인, 정지된 앱 설치, 신뢰되지 않은 사내 CA 인증서처럼 구체적인 원인과 조치를 짚어 줍니다. 버그 수정은 35건으로 가장 많고, 권한 검사와 관련된 수정이 특히 중요합니다. 권한 검사기가 완전히 분석하지 못한 Bash 명령이 확인 프롬프트를 건너뛰던 문제와, bypass 모드에서 서브셸이 위험한 rm을 가릴 수 있던 문제가 함께 수정됐습니다. 동작이 바뀐 부분도 있습니다. Bedrock, Vertex, Foundry의 auto mode는 당분간 로컬 분류기를 기본으로 쓰며, 2.1.268에서 들어갔던 권한 거부 규칙 확장은 되돌려졌습니다.

새 기능

  • LLM 게이트웨이용 요청 힌트 헤더

    게이트웨이는 들어온 요청의 종류, 어떤 에이전트가 보냈는지, 직전 도구 호출에 걸린 시간, 컨텍스트가 압축됐는지를 알 수 없었습니다. 이제 x-claude-code-request-class, x-claude-code-agent-type, x-claude-code-prev-tool-durations, x-claude-code-compaction, x-claude-code-context-compacted 다섯 가지 헤더를 보낼 수 있습니다. 기본으로는 꺼져 있으며 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1로 켭니다.

  • MCP 서버 연결이 끊겼을 때의 알림

    대화 도중 MCP 서버 연결이 끊기고 자동 재연결까지 실패하면, 해당 서버의 도구가 조용히 사라진 채로 작업이 이어졌습니다. 이제 자동 재연결을 포기한 시점에 알림이 뜨고 /mcp로 안내합니다.

  • Remote Control 세션 포크

    claude --remote-control이나 /remote-control로 시작한 세션은 Claude 앱에서 갈라내어 다른 방향으로 시도해 볼 방법이 없었습니다. 이제 앱에서 이런 세션을 포크할 수 있고, 갈라낸 세션은 내 컴퓨터에서 백그라운드 세션으로 실행됩니다.

  • [Claude Code on the web] 작성 중인 루틴을 버릴 때의 확인

    New routine 페이지나 Edit routine 대화상자를 닫으면 입력해 둔 루틴 이름, 프롬프트, 수정 내용이 확인 없이 사라졌습니다. 이제 “Discard unsaved changes?” 확인이 먼저 뜹니다.

주요 개선

오류 메시지와 원인 안내

  • GitHub 접근이 막혔을 때의 안내

    클라우드 세션에서 GitHub 접근이 거부되면 원인과 무관하게 설치 안내만 나왔습니다. 이제 IP 허용 목록, 정지된 앱 설치, SAML 단일 로그인 중 실제 원인을 보여 줍니다. /install-github-app이 SAML 단일 로그인 차단을 “관리자 권한이 필요함”으로 잘못 알리던 문제도 함께 수정됐습니다.

  • /autofix-pr의 실패 원인

    gh pr view가 실패하면 종료 코드만 나와서 로그인 문제인지 SAML 문제인지 요청 한도 문제인지 알 수 없었습니다. 이제 gh가 낸 오류를 그대로 보여 줍니다. GitHub 웹훅 전달을 설정하지 못했을 때도 연결된 GitHub 계정이 없다는 식으로 이유를 밝힙니다.

  • /web-setup의 오류

    GitHub 토큰이 거부되거나 연결이 실패하면 무엇을 고쳐야 할지 알기 어려웠습니다. 이제 토큰이 거부된 경우 가능한 원인과 조치를 나열하고, 연결 실패는 설정된 프록시나 TLS 인증서 문제를 지목합니다.

  • SSL 인증서와 프록시 연결 오류

    세션 도중 나오는 연결 오류에 원인이 드러나지 않았습니다. 이제 오류 코드와 조치를 함께 보여 주며, 신뢰되지 않은 사내 CA(사내에서 발급한 인증서)라면 NODE_EXTRA_CA_CERTS 설정을 안내합니다.

  • 만료된 로그인 안내

    클라우드 세션을 만들지 못하는 이유가 Claude 로그인 만료나 철회인 경우에도 일반 오류만 나왔습니다. 이제 /login을 실행하라고 알려 줍니다. MCP 서버의 로그인이 대화 도중 만료된 경우에도 /mcp로 다시 인증하는 방법을 안내합니다.

  • Bedrock, Vertex, Foundry의 401/403 오류

    이 환경과 Claude apps gateway를 쓰는 사용자에게도 401/403 오류가 나면 /login을 실행하라고 안내했는데, 이들은 claude.ai 로그인을 쓰지 않으므로 맞지 않는 안내였습니다. 이제 갱신해야 할 자격 증명을 이름으로 알려 주거나 게이트웨이 관리자에게 문의하라고 안내합니다.

반응 속도와 화면

  • 긴 세션의 반응 속도

    훅 진행 상황이나 서브 에이전트 활동이 갱신될 때마다 대화 전체를 다시 처리했습니다. 이제 갱신마다 전체를 다시 처리하지 않아 긴 세션에서 반응이 빨라졌습니다.

  • 압축 상태 표시의 말줄임표

    “Running PreCompact hooks…” 같은 압축 상태 줄에서 말줄임표가 두 번 겹쳐 보였습니다(”……”). 수정됐습니다.

  • 잘못 뜨던 플러그인 추천

    아티팩트를 읽거나 게시한 뒤 로딩 표시 팁이 frontend-design 플러그인을 엉뚱하게 추천했습니다. 수정됐습니다.

아티팩트

  • 지원하지 않는 파일 형식의 오류

    아티팩트가 제공하지 않는 파일 형식을 게시하려 하면 원인을 알기 어려웠습니다. 이제 Claude에게는 어떤 형식이 제공되는지와 대신 무엇을 해야 하는지 전달되고, 터미널에는 한 줄로 간단히 표시됩니다.

  • 페이지 읽기 결과

    아티팩트 페이지를 읽을 때 그 페이지에 어떤 기능과 데이터베이스 규칙이 적용되는지 드러나지 않았습니다. 이제 아티팩트 서비스가 해당 페이지에 대해 갖고 있는 기능과 데이터베이스 규칙을 함께 알려 줍니다. 그 페이지에 게시할 수 있는 사람이면 볼 수 있습니다.

  • 데이터베이스 쓰기

    값을 하나 지우려 해도 문서 전체를 다시 써야 했습니다. 이제 업데이트로 필드 하나만 제거할 수 있습니다.

  • 게시 중 연결이 끊긴 경우

    요청이 claude.ai에 도달한 뒤 연결이 끊기면 게시가 실패하거나 같은 내용이 중복 버전으로 남았습니다. 이제 안전하게 다시 보내집니다.

동작이 바뀐 항목

  • 2.1.268의 권한 거부 규칙 확장 되돌림 (되돌림)

    2.1.268은 권한 검사기가 분석하지 못하는 Bash 줄(eval, env -C 등)에 대해서도 Read, Edit 거부 규칙을 검사했습니다. 이 때문에 time -p make build 같은 평범한 명령까지 거부됐습니다. 이 변경이 되돌려져 해당 명령은 다시 확인 프롬프트를 띄웁니다.

  • Bedrock, Vertex, Foundry의 auto mode 분류기 (변경)

    이 환경들의 auto mode는 당분간 로컬 분류기를 기본으로 사용합니다. 플랫폼의 서버 측 분류기를 쓰려면 CLAUDE_CODE_AUTO_MODE_SERVER=1을 설정합니다.

  • OTEL_LOG_TOOL_DETAILS=1의 범위 (변경)

    비용과 토큰 지표에 실제 에이전트, 스킬, 플러그인, MCP 서버 이름이 함께 포함됩니다.

  • Claude 계정 로그인의 요청 범위 (변경)

    Claude 계정으로 로그인할 때 claude.ai 플러그인 접근 권한도 함께 요청합니다.

  • /bug, /feedback이 보내는 정보 (변경)

    이전에는 마지막 API 요청의 정보가 폭넓게 포함됐습니다. 이제 모델 동작과 관련된 항목(모델, 시스템 프롬프트, 도구)만 포함하고, 요청 메타데이터와 CLAUDE_CODE_EXTRA_BODY 필드는 빼고 보냅니다.

[VSCode], Windows

  • [VSCode] 조직 설정 반영

    제품 피드백을 꺼 둔 조직에서도 “Report a problem”이 그대로 보이고 /bug, /feedback이 보고 양식을 열었습니다. 수정됐습니다.

  • [VSCode] Windows의 빨간 배너

    턴이 정상적으로 끝난 뒤에도 “Claude Code process exited with code 4294967295” 배너가 떴습니다. 수정됐습니다.

  • Windows: UNC 경로의 네트워크 경로 권한 검사

    --add-dir로 매핑된 네트워크 드라이브를 추가했을 때 UNC 경로(\\서버\공유 형식) 검사가 개선됐습니다.

[Claude Code on the web], [Claude Tag], [Code Review]

  • [Claude Code on the web] 루틴 상세 페이지

    메뉴와 이름 변경이 상단 경로 표시로 옮겨졌고, 켜기/끄기 스위치와 Run now가 맨 위에 놓였으며, 실행 기록이 루틴 설정 옆에 표시됩니다.

  • [Claude Code on the web] 데스크톱 앱 다운로드 화면 (제거)

    클라우드 환경이 없는 신규 사용자에게 Mac, Windows에서 전체 화면 다운로드 안내가 먼저 떴습니다. 이 화면이 없어져 바로 설정으로 넘어갑니다.

  • [Claude Code on the web] Share cloud sessions 설정 위치 (변경)

    관리자 설정의 이 항목이 Claude Code 페이지에서 Data and privacy로 옮겨졌습니다. Data and privacy 관리자도 이 설정을 관리할 수 있습니다.

  • [Claude Tag] AWS 연결 실패 안내

    요청에 서명하지 못하면 아무 설명 없는 오류만 나왔습니다. 이제 지역 정보가 없는 호스트 이름처럼 서명할 수 없는 이유와 해결 방법이 Claude에게 전달됩니다.

  • [Claude Tag] 관련 공개 채널 감시 (변경)

    Claude는 요청받았을 때만 다른 채널을 살폈습니다. 이제 진행 중인 대화가 의존하는 장애 대응 채널처럼 관련 있는 공개 채널은 스스로 살피기 시작합니다.

  • [Code Review] 수정 제안

    제안한 수정이 다른 코드에 어떤 영향을 주는지 드러나지 않았습니다. 이제 바뀌는 동작에 의존하는 코드가 있으면 그 수정이 무엇을 계속 동작하게 해야 하는지 함께 설명합니다.

  • [Code Review] 두 번째 위치를 가리키는 코멘트

    영향을 받는 다른 위치를 가리키는 리뷰 코멘트가 문장이 잘린 채로 끝났습니다. 이제 그 위치의 문제를 완전한 문장으로 설명합니다.

주요 버그 수정

권한 검사와 보안

  • 권한 검사기가 완전히 분석하지 못하는 Bash 명령이 확인 프롬프트를 건너뛰던 문제 수정. permissions.blockReadsOutsideWorkingDirectories를 켠 상태에서 발생했으며, bypass 모드에서 서브셸이 위험한 rm을 가릴 수 있던 문제도 함께 해결됐습니다.
  • permissions.blockReadsOutsideWorkingDirectories를 켜도 저장소 설정이 지정한 메모리 디렉터리는 그대로 쓰이던 문제 수정. 이제 이런 디렉터리는 프롬프트에 불려오지 않고 회상, 색인, 메모리 추출에도 쓰이지 않습니다.
  • 조직이 Skills를 끈 뒤에도 claude.ai에서 동기화한 스킬이 계속 쓸 수 있던 문제 수정. 이제 복구 가능한 휴지통으로 옮겨집니다.
  • MDM이나 managed-settings.json으로 설정한 allowManagedMcpServersOnly, deniedMcpServers, disableClaudeAiConnectors가 서버 관리 설정이 함께 있으면 무시되던 문제 수정.

세션과 컨텍스트

  • /login, /upgrade, /extra-usage가 앞선 대화의 thinking 내용을 버리던 문제 수정. 이 때문에 다음 요청에서 프롬프트 캐시를 처음부터 다시 쓰게 됐습니다.
  • 컨텍스트 표시기와 자동 압축이 advisor 도구 턴을 실제 크기의 약 두 배로 세던 문제 수정. 자동 압축이 실제 컨텍스트 창의 절반쯤에서 실행되던 원인이었습니다.
  • 오래 이어진 세션이 저장소의 .git 디렉터리를 지우거나 옮긴 뒤에도 빈 .git/info/exclude를 다시 만들던 문제 수정.
  • .claude/scheduled_tasks.json을 새 worktree 같은 다른 폴더로 복사하면 저장된 예약 작업이 엉뚱한 세션에서 실행되던 문제 수정.
  • /tui가 이미 작업을 마치고 에이전트 패널에서 사라진 팀원 때문에 다시 시작되지 않던 문제 수정.

에이전트와 SDK

  • 마지막 스트리밍 응답에 토큰 사용량이 없거나 모델 ID가 없으면 서브 에이전트와 백그라운드 에이전트가 실패로 보고되고 결과가 전달되지 않던 문제 수정.
  • 실행 도중 백그라운드로 옮겨진 서브 에이전트의 남은 메시지와 최종 보고가 SDK와 --output-format stream-json 출력에서 빠지던 문제 수정(CLAUDE_AUTO_BACKGROUND_TASKS 등으로 옮겨진 경우).
  • 클라우드나 Remote Control 세션에서 대화에 첨부한 파일을 Artifact 도구가 올릴 때 auto mode가 승인을 받으려고 멈추던 문제 수정.
  • Claude Desktop, VS Code, JetBrains 세션에 연결한 Remote Control 클라이언트가 세션의 컨텍스트 창 사용량을 요청하면 거부되던 문제 수정.

입력과 파일 읽기

  • 셸 모드에서 프롬프트 맨 앞에 입력한 !가 사라지던 문제 수정. 이제 ! grep …처럼 부정 명령을 입력할 수 있습니다.
  • macOS에서 끌어다 놓은 스크린샷을 Read가 “symlink resolution changed after permission was checked”로 거부하던 문제 수정. 시스템이 두 번째 경로로도 보고하는 파일 전반에 해당합니다.

[Claude Code on the web]

  • 관리자가 조직 커넥터를 지웠다가 다시 추가하면 루틴이 그 커넥터에 접근하지 못하고 예전 커넥터를 계속 호출하던 문제 수정.
  • 조직 설정에서 자체 호스팅 환경을 만들 때 가끔 서버 오류로 실패하고 반쯤 만들어진 환경이 남던 문제 수정.

[Claude Tag]

  • Enterprise Grid 연결이 끊겼는데 소속 워크스페이스 하나가 연결된 상태로 남으면, 앱을 다시 설치한 뒤 몇 분 만에 Claude가 응답을 멈추던 문제 수정.
  • 조직 공유 비공개 Slack 채널에서 만든 예약 작업이 아무 알림 없이 한 번도 게시되지 않던 문제 수정. 이제 만들어진 스레드에서 계속 실행됩니다.
  • Claude가 작업하는 중에 오래된 스레드에 답글을 달면 작업이 처음부터 다시 시작되면서 아직 푸시하지 않은 결과가 사라지던 문제 수정.
  • 계정 토큰이 갱신된 직후 Claude가 메시지를 흘리면서 “couldn’t find a Claude Code environment”라는 잘못된 안내를 내보내던 문제 수정.
  • Budgets, Savings Plans, WAF Classic, Import/Export처럼 지역 정보가 없는 AWS 엔드포인트 연결이 거부되던 문제 수정. Global Accelerator 요청도 이제 올바르게 서명됩니다.
  • 소문자 토큰 유형을 돌려주는 제공자에서 OAuth client credentials, JWT bearer 연결이 실패하던 문제 수정. 이제 표준 Bearer 방식으로 요청합니다.
  • Enterprise Grid 공유 채널, Claude를 아직 써 본 적 없는 채널, 예전 방식의 비공개 채널에서 채널 관리자 추가가 거부되던 문제 수정.
  • Claude가 스스로 설정한 Slack 채널이 저장된 메모리가 있는데도 관리자 Memory 페이지에 나오지 않던 문제 수정. 이제 관리자가 그 메모리를 열고 수정하고 지울 수 있습니다.

[Code Review]

  • 앞선 리뷰에 “Additional findings”가 있던 PR에 기준 브랜치를 병합하면 전체 리뷰가 다시 돌던 문제 수정. 이제 가벼운 후속 리뷰만 실행됩니다.
  • @ 멘션, 여러 줄로 감싸인 코드 조각, 백틱으로 감싼 HTML 태그 하나 때문에 REVIEW.md 전체가 무시되던 문제 수정. 이제 변경된 파일로 연결되는 줄만 제외됩니다.
  • /ultrareview --post가 GitHub 오류 뒤 다시 시도할 때 지적 사항 코멘트를 아예 올리지 않거나 두 번 올리던 문제 수정. 이제 정확히 한 번 올라가며 코멘트에 리뷰한 커밋이 표시됩니다.
  • 저장소 소유자나 이름에 대문자가 있으면 내용이 같거나 빈 푸시도 다시 리뷰되던 문제 수정. 이제 건너뜁니다.

알아두면 좋은 점

  • time -p make build 같은 명령이 다시 확인 프롬프트를 띄웁니다 — 2.1.268에서 eval, env -C처럼 권한 검사기가 분석하지 못하는 Bash 줄에도 Read, Edit 거부 규칙을 적용하던 변경이 되돌려졌습니다. 이 변경에 맞춰 규칙을 조정했다면 다시 점검이 필요합니다.
  • Bedrock, Vertex, Foundry의 auto mode는 당분간 로컬 분류기를 씁니다 — 플랫폼의 서버 측 분류기로 돌아가려면 CLAUDE_CODE_AUTO_MODE_SERVER=1을 설정합니다.
  • OTEL_LOG_TOOL_DETAILS=1이 실제 이름을 내보냅니다 — 비용과 토큰 지표에 에이전트, 스킬, 플러그인, MCP 서버의 실제 이름이 포함되므로, 지표 수집 대상과 지표 라벨의 개수 증가를 함께 확인합니다.
  • Claude 계정 로그인 시 요청 범위가 넓어졌습니다 — claude.ai 플러그인 접근 권한도 함께 요청합니다.
  • /bug, /feedback이 보내는 정보가 줄었습니다 — 모델, 시스템 프롬프트, 도구 등 모델 동작과 관련된 항목만 포함되고 요청 메타데이터와 CLAUDE_CODE_EXTRA_BODY 필드는 빠집니다.
  • 조직이 Skills를 끄면 동기화된 스킬이 휴지통으로 옮겨집니다 — 계속 쓸 수 있던 문제가 수정됐으며, 옮겨진 사본은 휴지통에서 복구할 수 있습니다.
  • 저장소 설정이 지정한 메모리 디렉터리는 쓰이지 않습니다 — permissions.blockReadsOutsideWorkingDirectories를 켠 환경에서 이 디렉터리는 프롬프트에 불려오지 않고 회상, 색인, 메모리 추출에도 쓰이지 않습니다. 저장소 설정으로 메모리 위치를 지정해 두었다면 동작이 달라질 수 있습니다.
  • 게이트웨이 힌트 헤더는 직접 켜야 합니다 — 다섯 가지 헤더는 기본으로 꺼져 있으며, 게이트웨이 운영자가 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1로 켭니다.
  • [Claude Tag] Claude가 관련 공개 채널을 스스로 살핍니다 — 진행 중인 대화가 의존하는 장애 대응 채널 등을 요청 없이도 살피기 시작합니다.