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

Claude Code 2.1.300

Claude Platform on AWS에서 `/advisor`를 쓸 수 있게 됐고, OpenTelemetry 이벤트와 trace에 캐시 쓰기 수명별 토큰 수와 GenAI 표준 속성이 추가됐습니다. PreToolUse, PermissionRequest 훅이 돌려주는 `updatedInput`을 도구 입력처럼 검증하도록 바뀌었고, git reftable 저장소의 worktree 문제, 압축 뒤 세션 재개, MCP 도구 스키마 오류로 매 턴 실패하던 문제 등이 고쳐졌습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.300이 2026년 10월 14일 출시됐습니다. 2.1.299와 같은 날 나온 후속 릴리스로, Claude Platform on AWS의 /advisor, OpenTelemetry 관측 항목 확장, VS Code의 선택 영역 첨부 설정, Slack의 Claude(Claude Tag) 기능이 추가됐습니다. 훅이 도구 입력을 바꾸는 방식, claude remote-control의 샌드박스 플래그처럼 기존 설정이나 스크립트에 영향을 주는 변경도 들어 있습니다. 수정은 세션 재개와 압축, git reftable 저장소의 worktree, MCP, 클라우드 세션과 Remote Control, VS Code 확장에 걸쳐 있습니다. 변경 항목이 매우 많아 아래에는 사용자 영향이 큰 항목을 골라 정리했습니다.

새 기능

  • Claude Platform on AWS의 /advisor

    Claude Platform on AWS 환경에서는 /advisor를 쓸 수 없었습니다. 이제 사용할 수 있으며, 기본으로 켜져 있지 않습니다. /advisor 명령, advisorModel 설정, --advisor 플래그 중 하나로 advisor 모델을 고르기 전까지는 실행되지 않고, CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1로 완전히 끌 수 있습니다.

  • OpenTelemetry 캐시 토큰 구분

    api_request 이벤트에서 프롬프트 캐시 쓰기 토큰이 캐시 수명과 관계없이 한 값으로만 집계됐습니다. 이제 cache_creation_5m_tokens와 cache_creation_1h_tokens로 5분짜리 캐시와 1시간짜리 캐시에 쓴 토큰을 나눠 볼 수 있습니다.

  • OpenTelemetry GenAI 표준 속성

    trace span에 OpenTelemetry GenAI semantic convention(생성형 AI 관측용 표준 속성 이름) 속성이 추가됐습니다. gen_ai.provider.name, gen_ai.conversation.id, gen_ai.tool.name, error.type 등이 포함돼, 같은 표준을 따르는 관측 도구에서 별도 매핑 없이 분석하기 쉬워집니다.

  • [VSCode] claudeCode.attachSelection 설정

    에디터에서 선택한 텍스트가 메시지에 자동으로 함께 첨부됐습니다. 이 설정을 끄면 선택 영역이 메시지에 추가되지 않습니다.

  • [Claude Tag] Slack Connect 채널 지원

    다른 조직과 공유하는 Slack Connect 채널에서는 Slack의 Claude가 답하지 않았습니다. 이제 Owner나 Claude Tag 관리자가 허용하면 이런 채널에서도 답할 수 있으며, 기본값은 꺼져 있습니다.

  • [Claude Tag] 커넥터 동작 승인 카드

    승인이 필요한 커넥터 동작은 Slack의 Claude가 거부했습니다. 이제 스레드에 요청한 사람만 볼 수 있는 Allow once, Deny 카드를 띄워 승인을 묻습니다. 다른 사람에게는 승인을 기다리고 있다는 사실만 보입니다.

  • [Claude Tag] Slack 음성 클립

    Slack이 음성 클립의 transcription(음성을 텍스트로 옮긴 것)을 제공하면 Claude가 그 내용을 읽습니다.

  • mod API 확장

    mod(Claude Code의 화면과 동작을 바꾸는 확장)에 다음이 추가됐습니다.

    • 프롬프트 장식의 virtualText: 입력창에 보이지만 작성 중인 내용이나 전송되는 프롬프트에는 들어가지 않는 텍스트
    • $.ui.view({ agentId }): 요청할 때 메인 화면에 특정 에이전트의 대화 기록을 표시하고, $.ui.view({})로 되돌아감
    • Text의 dir 속성: Windows와 VS Code 터미널에서 오른쪽에서 왼쪽으로 쓰는 텍스트를 그 방향으로 읽히게 하고 오른쪽 정렬
    • agent.spawn 훅: 기존에는 workflow 에이전트를 거부만 할 수 있었는데, 이제 prompt와 model을 바꿀 수 있음
    • prompt.change 훅: 직접 입력하지 않고 입력창 내용이 바뀔 때(기록 불러오기, 지우기, 실행 취소, 플러그인의 입력) 발생

주요 개선

  • 아티팩트 업데이트

    아티팩트를 고칠 때마다 수정과 재게시가 따로 진행됐습니다. 이제 작은 변경은 한 번의 호출로 적용하고 다시 게시하며, 큰 수정도 한 번의 응답 안에서 편집과 재게시를 마칩니다.

  • Cowork 클라우드 세션의 WebFetch

    방금 가져오지 못한 페이지를 다시 가져오려고 시도했습니다. 이제 해당 페이지가 조금 전에 실패했다고 Claude에게 알려 같은 요청을 반복하지 않습니다.

  • plugin-authoring 스킬의 mod 공유

    mod를 공유할 때 Claude가 파일을 열기 전에 키(인증 정보)가 들어 있는지 먼저 검사하고, 프로젝트 밖의 폴더를 검사할 때는 먼저 묻습니다.

  • Claude 3 모델의 PDF 멘션

    Claude 3 모델이 @로 멘션한 PDF를 읽지 않고 답하는 경우가 있었습니다. 모델에 전달하는 안내 문구를 고쳐 이런 경우를 줄였습니다.

동작이 바뀐 항목

  • 훅의 updatedInput 검증 (변경)

    PreToolUse, PermissionRequest 훅이 돌려준 updatedInput은 그대로 도구에 전달됐습니다. 이제 Claude가 직접 만든 입력과 같은 방식으로 검증해, 도구가 모르는 키는 버리고 도구가 거부하는 입력이면 호출 자체를 거부합니다.

  • claude remote-control의 --sandbox, --no-sandbox 제거 (변경)

    두 플래그는 실제로 아무 효과가 없었습니다. 이제 제거됐고, 전달하면 오류와 함께 종료됩니다. 세션을 샌드박스에서 실행하려면 설정의 sandbox.enabled를 사용합니다.

  • 종료 시 백그라운드 명령 강제 종료 (변경)

    fullscreen 모드에서 종료하면 실행 중인 백그라운드 명령이 남아 있을 수 있었습니다. 이제 중지를 요청한 뒤 1.5초가 지나도 실행 중이면 강제로 종료합니다.

  • 로컬 세션 기록에 요청 내용 저장 (변경)

    로컬 세션 기록(transcript)에 API 요청마다의 시스템 프롬프트, 도구, 파라미터도 함께 저장됩니다. 사용자가 기록을 공유하기로 했을 때 그 요청을 그대로 재현할 수 있게 하기 위해서입니다.

  • gzip 요청 압축 (변경)

    api.anthropic.com으로 가는 큰 요청은 telemetry를 꺼도 gzip으로 압축됩니다. 끄려면 CLAUDE_CODE_GZIP_REQUEST_BODIES=0을 설정합니다.

  • 호스트가 관리하는 세션의 인증서, 프록시 변수 (변경)

    CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST 세션은 설정에 들어 있는 CA 번들, 도구 프록시, git TLS, git 설정 변수(SSL_CERT_FILE 등)를 무시합니다. Claude Desktop에서는 프로젝트 설정에 있는 경우에만 무시합니다.

  • 게이트웨이와 Claude Desktop (변경)

    forceLoginGatewayUrl이 세션의 호스트 이름을 제공하는 Anthropic 운영 게이트웨이를 가리키면 Claude Desktop의 Code 탭이 관리형 설정을 적용하며, 이때 시작 시점에 게이트웨이에 연결할 수 있어야 합니다. claude gateway는 Claude Desktop이 게이트웨이를 통해 쓸 수 없는 desktop: 정책 키가 있으면 경고만 하고 시작하던 것에서, 해당 키 이름을 알리며 시작을 멈추도록 바뀌었습니다.

  • Cowork 클라우드 세션의 PermissionRequest 훅 (변경)

    훅이 허용하면서 함께 보낸 setMode 업데이트는 무시됩니다. 나머지 승인은 그대로 적용됩니다.

  • [Claude Tag] Slack Connect 채널의 접근 번들 (변경)

    관리자가 Slack 채널에 연결한 접근 번들은 채널이 Slack Connect 채널로 바뀐 뒤에도 계속 적용됩니다. 번들을 제거했다가 다시 연결할 필요가 없습니다.

  • 기타 (변경)

    claude-api 스킬은 요청하지 않으면 Managed Agents 세션을 보관하거나 삭제하지 않습니다. 백그라운드 세션이 이어받은 workflow는 인계 파일에서 바로 실행하지 않고 Workflow 도구의 승인을 거쳐 재개합니다. /sandbox 모드 옵션 이름이 “Sandbox BashTool”에서 “Sandbox commands”로 바뀌었습니다.

주요 버그 수정

세션 재개와 압축

  • 헤드리스, Agent SDK 세션을 재개할 때, 출력 토큰 한도에서 잘린 답 다음에 이뤄진 압축이 남겨 둔 최근 메시지가 사라지던 문제 수정. 이번 버전 이후의 압축부터 적용됩니다.
  • 같은 턴에서 재시도되거나 끝나지 않은 답 다음에 압축이 이뤄졌을 때, 세션을 재개하면 압축 요약이 사라지거나 압축 이전 기록이 되살아나던 문제 수정.
  • 충돌로 세션 기록의 마지막 줄이 잘린 경우, 재개 후 처음 기록되는 항목이 사라지던 문제 수정.
  • 압축 이후 연결을 마친 MCP 서버의 도구와 지침이 다음 도구 호출 전까지 Claude에게 전달되지 않던 문제 수정.
  • 유니코드 줄, 문단 구분자(U+2028, U+2029)가 들어 있으면 /branch가 메시지를 빠뜨리고 claude purge가 하위 폴더 프로젝트를 건너뛰던 문제 수정.
  • 백그라운드 명령이 실행 중일 때 종료하면 SessionEnd 훅이 실행되지 않는 경우가 있던 문제 수정.
  • 작은 자동 압축 창을 선택했는데 /autocompact가 토큰 사용량이 높다고 경고하던 문제 수정.

worktree와 git reftable 저장소

  • git의 reftable 참조 저장 방식을 쓰는 저장소에서 브랜치가 “.invalid”로 표시되고 --worktree가 기존 worktree를 다시 열지 못하던 문제 수정.
  • 태그나 브랜치 이름이 커밋 ID처럼 생겼을 때 --worktree 세션이 잘못된 커밋에서 시작하던 문제 수정. 시작 시 git 상태에 새 worktree가 아닌 다른 브랜치 이름이 표시되던 문제도 고쳐졌습니다.
  • bare 저장소의 worktree에서 origin 기본 브랜치를 가져올 수 없으면 --worktree가 실패하던 문제 수정. 이제 메인 저장소가 아닌 현재 체크아웃의 HEAD를 기준으로 삼습니다.
  • --worktree로 시작하면 플러그인의 WorktreeCreate, WorktreeRemove 훅이 실행되지 않던 문제 수정. --tmux와 함께 쓰는 경우는 아직 해당하지 않습니다.
  • reftable 저장소에서 Claude Desktop과 Remote Control 세션의 diff 화면이 충돌 상태의 cherry-pick, revert를 감지하지 못하던 문제 수정.
  • reftable 저장소에서 git commit -q 뒤 OpenTelemetry tool_result 이벤트에 git_commit_id가 빠지던 문제 수정.

MCP와 도구

  • API가 MCP 도구의 입력 스키마를 거부하면 대화가 매 턴 400 오류로 실패하던 문제 수정. 이제 그 도구는 대화가 끝날 때까지 파라미터 없이 전달됩니다.
  • 자동 도구 검색(ENABLE_TOOL_SEARCH=auto)이 재개 후 MCP 서버가 다시 연결되는 동안처럼 대화 도중에 꺼지던 문제 수정.
  • 도구 목록이 없던 기록을 재개한 세션에서, 이미 불러온 지연 로딩 도구를 Claude가 다시 검색하던 문제 수정.
  • 백그라운드 명령이 실행되는 동안 Claude가 출력 파일을 반복해서 확인하거나 대기(sleep)하던 문제 수정.
  • 세션 scratchpad의 파일을 Claude가 전체 경로 대신 파일 이름이나 상대 경로로 가리키던 문제 수정.

에이전트와 백그라운드 작업

  • 메시지를 보낸 적 있는 서브에이전트가 작업을 마친 직후 /tasks에서 사라져 그 대화로 돌아갈 방법이 없던 문제 수정.
  • 자식 에이전트를 보고 있는 동안 완료된 부모 에이전트가 경로 표시(breadcrumb)에서 빠지던 문제 수정.
  • agents view에서 입력이 한꺼번에 들어오면 “up”, “down”, “escape” 같은 단어를 키 입력으로 받아들여, 답하는 도중 미리보기가 움직이거나 작성 중인 내용이 지워지던 문제 수정.
  • 클라우드 세션의 컨테이너가 교체된 뒤, 이미 한 번 재개된 백그라운드 에이전트를 Claude가 잃어버렸고 재개할 수 없다고 안내받던 문제 수정.
  • claude agents에서 풀 리퀘스트 하나의 정보가 불완전하게 오면 모든 풀 리퀘스트 상태가 갱신되지 않던 문제 수정.

훅과 mod

  • 에이전트 훅이 지정한 model을 무시하던 문제 수정. 이제 haiku 같은 별칭이 해석되고, 서브에이전트의 모델이 이를 덮어쓰지 않으며, 사용할 수 없는 모델이면 동작을 허용하지 않고 호출한 쪽의 모델로 대체합니다.
  • mod의 prompt.submit 훅이 바꾸거나 버린 프롬프트가 OpenTelemetry user_prompt 이벤트, interaction span, 세션 제목 요청에 입력한 그대로 기록되던 문제 수정.
  • Claude에게 보내는 mod 핫 리로드 안내가 사용자가 입력한 것처럼 대화 기록에 표시되던 문제 수정.
  • chat:newline 키 바인딩(Ctrl+J나 다시 지정한 Enter)으로 줄바꿈하면 mod의 prompt.edit 훅이 발생하지 않던 문제 수정.

로그인과 네트워크

  • forceLoginOrgUUID로 거부된 로그인의 조직 토큰이 저장된 채로 남거나 /login 뒤에도 유효하던 문제 수정.
  • OS 인증서 저장소로만 신뢰하는 인증서를 쓰는 TLS 검사 프록시(Zscaler, Netskope 등) 뒤에서 기능 플래그와 단계적 배포 설정이 갱신되지 않던 문제 수정.
  • claude remote-control 서버가 키체인 잠김 같은 짧은 로그인 오류 뒤 연결 갱신을 포기하던 문제 수정. 이제 재시도하고, claude /login이 필요하면 경고합니다.

CLI와 표시

  • telemetry가 꺼져 있으면 claude daemon stop이 아무 출력 없이 끝나고 세션이 실행 중으로 남던 문제 수정.
  • claude daemon stop --any가 멈춘 백그라운드 서비스가 계속 실행 중인데도 “stopped”를 출력하던 문제 수정. 이제 기다렸다가 강제 종료하고, 그래도 남아 있으면 그 사실을 알리며 종료 코드 1로 끝납니다.
  • dark ANSI 테마와 16색 터미널에서 보조(흐린) 텍스트가 일반 텍스트와 똑같이 보이던 문제 수정.
  • VS Code, Cursor, Devin Desktop의 통합 터미널에서 시작하면 확장 프로그램을 확인하려고 에디터 CLI를 두 번 실행하던 문제 수정.
  • Artifact 도구 호출의 입력이 들어오는 동안 Artifact("(unprintable path)")로 표시되던 문제 수정. 이제 Bash처럼 “Waiting…”, “Running…”으로 표시됩니다.
  • claude --help의 --restricted 설명이 제거된 도구 이름을 언급하던 문제 수정.

클라우드 세션과 Remote Control

  • 조직 정책을 읽을 수 없으면 클라우드 세션이 턴마다 5분씩 멈추던 문제 수정. 이제 턴이 바로 끝나고 이유를 알려 줍니다.
  • 긴 답 도중 세션이 재시작되면 클라우드 세션이 이미 답한 메시지를 다시 실행하는 경우가 있던 문제 수정.
  • 세션 자체의 네트워크 설정이 막은 호스트를 조직 정책이 막았다고 Claude에게 알리던 문제 수정.
  • Cowork 클라우드 세션에서 Write, Edit, NotebookEdit이 사용자 컴퓨터의 경로에 대해 성공했다고 보고했지만 파일은 전달되지 않던 문제 수정.
  • 한 컴퓨터에서 여러 세션을 함께 제공할 때 실행 중인 Remote Control 세션이 중지된 것으로 표시되던 문제 수정.
  • [Remote Control] claude.ai와 데스크톱 앱의 diff 화면이 삭제되거나 이름이 바뀐 파일을 수정된 파일로 표시하던 문제 수정. 사용자 컴퓨터에 Claude Code v2.1.296 이상이 필요합니다.
  • [Cloud sessions] 조직이 “Always allow”를 끈 커넥터 도구의 Cowork 승인 창에서 “Allow for this task”가 빠지던 문제 수정. 2.1.292에서 생긴 문제입니다.
  • [Cloud sessions] 두 번째 메시지를 보낸 뒤 / 메뉴의 명령 대부분이 설명을 잃던 문제 수정.
  • [Self-hosted runner] 아무도 출력을 읽지 않으면 runner와 orchestrator가 멈추던 문제(polling, /healthz, SIGTERM 종료가 모두 동작하지 않음) 수정. 로그는 최근 256 KiB만 유지하고 버린 양을 셉니다(Windows 제외).

VSCode

  • 사용량 크레딧이 떨어진 뒤에도 fast mode가 켜진 채로 남아, 요청마다 거부되고 다시 전송되던 문제 수정. 이제 오류 알림과 함께 fast mode가 꺼지고, 사용자가 다시 켤 때까지 유지됩니다.
  • 항상 thinking을 사용하는 모델에서 Thinking 토글이 Off로 바뀌던 문제 수정. 이런 모델에서는 토글이 표시되지 않습니다.
  • 다시 불러온 슬래시 명령을 ↑, Enter로 실행하면 인자 없이 실행되던 문제 수정.
  • “Resume session”이나 다시 불러온 탭이 git worktree로 옮겨 간 대화 대신 빈 새 대화를 열던 문제 수정.
  • Windows에서 Shift+드래그로 파일을 프롬프트에 놓으면 읽을 수 없는 /c:/… 경로가 들어가던 문제와, WSL, SSH, Dev Container 창에서는 아무것도 들어가지 않던 문제 수정.
  • 채팅 글꼴 크기 설정을 바꾸면 창을 다시 불러와야 적용되거나 테마 변경 시 되돌아가던 문제 수정. diff와 계획 미리보기도 이 설정을 따릅니다.
  • Windows, Linux에서 Ctrl+Alt+F가 Explorer, 다른 트리 뷰, Debug Console의 찾기 대신 Focus view를 전환하던 문제 수정.
  • macOS에서 다른 창이나 터미널에 열린 세션을 확인할 때마다 추가 프로세스가 생기던 문제 수정. 이제 PATH에서 ps를 찾지 않고 /bin/ps를 직접 실행합니다.
  • Windows에서 충돌이나 전원 차단 후 재시작하면, 이전 프로세스 ID를 다른 프로그램이 받아 대화가 “still open somewhere else”로 표시되던 문제 수정.

Claude Tag, Code Review

  • [Claude Tag] Claude가 채널에 올린 메시지의 스레드에서 다른 앱이 Claude를 태그하면 답하지 않던 문제 수정.
  • [Code Review] GitHub 조직 멤버십을 비공개로 둔 쓰기 권한 사용자의 @claude review 댓글을 무시하던 문제 수정.
  • [Code Review] “paused for this repository” 댓글이 관리자를 Code Review 설정으로 안내하던 문제 수정. 이제 해결할 수 있는 사람을 알려 주고 Git providers 페이지로 연결합니다.

알아두면 좋은 점

  • PreToolUse, PermissionRequest 훅에서 updatedInput으로 입력을 바꾼다면 이제 도구가 모르는 키는 버려지고, 도구가 받아들이지 않는 입력은 호출 거부로 이어집니다. 훅이 만드는 입력이 도구의 입력 형식과 맞는지 확인합니다.
  • 스크립트에서 claude remote-control --sandbox나 --no-sandbox를 쓰고 있다면 이번 버전부터 오류로 종료됩니다. 플래그를 지우고 설정의 sandbox.enabled를 사용합니다.
  • 로컬 세션 기록에 시스템 프롬프트, 도구, 파라미터가 함께 저장됩니다. 기록 파일을 다른 사람과 공유할 때는 이 내용도 함께 전달된다는 점을 염두에 둡니다.
  • Claude Platform on AWS 사용자는 /advisor를 직접 고르기 전까지 advisor가 실행되지 않습니다. 조직에서 쓰지 않으려면 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1을 설정합니다.
  • git reftable 저장소에서 --worktree나 diff 화면이 이상하게 동작했다면 이번 버전에서 관련 문제가 여러 건 고쳐졌습니다.
  • 2.1.292 이후 Cowork 커넥터 승인 창에서 “Allow for this task”가 보이지 않았다면 이번 버전에서 고쳐졌습니다.