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

Claude Code 2.1.265

`--plugin-dir`를 플러그인이 여러 개 들어 있는 폴더에 지정할 수 있게 되고, 실행 중에 그 폴더에 플러그인을 넣거나 빼도 반영됩니다. 디스크에 저장되는 도구 결과에는 1GB 상한이 생겼고, 잘린 경우 대화 안 미리보기가 그 사실을 알려줍니다. Claude Desktop과 Cowork가 Claude apps gateway로 보내는 텔레메트리에는 `user.email`과 `user.groups`가 추가돼 터미널 세션과 같아졌습니다. 개선 12건은 큰 저장소에서 `--worktree` 시작 속도, `/workflows`의 에이전트 상세 표시, 프롬프트 중간에 입력한 슬래시 명령 목록 등을 다룹니다. 버그 수정 34건은 서브에이전트를 재개하면 요청 앞부분이 달라져 프롬프트 캐시에 적중하지 못하던 문제, 도구가 실행 중일 때 프로세스가 죽은 뒤의 재개, `-p`와 SDK 세션에서 `cd`가 다음 턴까지 유지되지 않던 문제, 레거시 HTTP+SSE만 지원하는 MCP 서버가 연결되지 않던 문제 등을 포함합니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.265가 2026년 9월 8일 출시됐습니다. 이번 릴리스는 수정이 대부분(34건)이고, 그중 눈에 띄는 흐름은 요청 앞부분을 매번 같게 유지하는 문제입니다. 서브에이전트를 재개할 때와 에이전트 팀 구성원의 이후 턴에서 프롬프트 캐시 재사용이 깨지고 있었고, advisor 도구를 쓸지도 요청마다 다시 정해지고 있었습니다. 나머지는 플러그인을 불러오는 경로 검사와 오류 보고를 다듬는 쪽, 그리고 기업 환경에서 텔레메트리를 어디로 보낼지 정리하는 쪽에 몰려 있습니다. 새로 추가된 것은 네 가지로, --plugin-dir의 폴더 지정과 저장되는 도구 결과의 1GB 상한이 여기에 해당합니다.

새 기능

  • --plugin-dir에 플러그인 폴더 지정

    --plugin-dir는 플러그인 하나만 가리킬 수 있었습니다. 이제 플러그인들이 담긴 폴더를 지정하면 매니페스트가 있는 하위 폴더가 각각 불러와지고, 실행 중에 하위 폴더를 추가하거나 지워도 반영됩니다.

  • 디스크에 저장되는 도구 결과의 1GB 상한

    도구 결과가 아주 크면 그대로 파일로 저장돼 디스크를 얼마든지 쓸 수 있었습니다. 이제 1GB에서 잘리며, 대화 안 미리보기에 저장된 파일이 잘렸다는 사실이 표시됩니다.

  • Claude Desktop과 Cowork 텔레메트리의 user.email, user.groups

    Claude apps gateway를 거치는 Claude Desktop과 Cowork의 텔레메트리에는 이 두 항목이 없어, 터미널 세션과 같은 기준으로 볼 수 없었습니다. 이제 두 항목이 함께 전송돼 터미널 세션과 같아집니다.

  • [VSCode] 오래 쓰지 않은 세션 자동 보관

    세션 목록에 손대지 않은 세션이 계속 쌓였습니다. 이제 일정 기간 사용하지 않은 세션이 자동으로 보관됩니다. “Archive inactive sessions” 설정으로 기간을 정하며 기본값은 14일입니다.

주요 개선

  • 큰 저장소에서 --worktree 시작 속도

    저장소가 크면 새 worktree를 만들 때 시작이 눈에 띄게 느렸습니다. 이제 체크아웃이 병렬로 진행됩니다(git 2.32 이상).

  • /workflows의 에이전트 상세

    워크플로 안에서 에이전트가 무엇을 하고 있는지 알기 어려웠습니다. 이제 도구 호출에 실행 중, 실패, 완료 표시가 붙고, 서브에이전트에 작업 목록이 있으면 함께 나옵니다. Enter를 누르면 나열된 호출이 펼쳐지며 입력과 결과를 볼 수 있습니다.

  • 프롬프트 중간에 입력한 슬래시 명령

    프롬프트를 쓰다가 중간에 슬래시 명령을 입력하면 후보가 하나만 제시돼 다른 선택지를 볼 수 없었고, 플러그인 스킬은 이름만으로는 찾아지지 않았습니다. 이제 일치하는 명령이 목록으로 표시되고(전체 화면이 아닐 때는 Tab으로 엽니다), 플러그인 스킬도 이름만으로 찾을 수 있습니다.

  • 로그인이 필요한 원격 MCP 서버

    서버 목록에 올려두기만 해도 Claude Code가 해당 서버에 OAuth 클라이언트를 등록했습니다. 이제 실제로 인증할 때까지 등록하지 않습니다.

  • 파일을 많이 읽은 긴 세션의 재개 속도

    파일을 많이 읽은 세션은 재개하는 데 시간이 오래 걸렸습니다. 이제 더 빠르게 재개됩니다.

  • 크기 제한을 넘은 이미지의 오류 메시지

    이미지를 읽지 못했을 때 제한값만 알려줘, 무엇 때문에 실패했고 어떻게 해야 하는지 알 수 없었습니다. 이제 원인과 해결 방법이 함께 표시됩니다.

  • 다른 사람이 쓴 아티팩트를 읽을 때의 Artifact 도구

    아티팩트 안에 들어 있는 지시문이 요약에 그대로 옮겨질 수 있었습니다. 이제 요약이 해당 페이지를 신뢰할 수 없는 내용으로 취급하고, 안에 지시문이 있으면 그대로 전달하는 대신 그 사실을 알립니다.

  • .claude 폴더 권한 항목의 설명

    이 권한을 허용하면 정확히 무엇이 가능해지는지 문구만으로는 알기 어려웠습니다. 이제 해당 세션 동안 프로젝트의 .claude 폴더(또는 ~/.claude) 안 파일을 편집할 수 있다는 뜻임을 그대로 적습니다.

  • forceLoginGatewayUrl이 설정된 기기는 시작부터 게이트웨이 세션

    관리형 설정에 게이트웨이 주소를 지정해 두어도, 기기에 남아 있는 claude.ai 로그인이나 API 키가 쓰일 수 있었습니다. 이제 forceLoginMethod: "gateway"와 마찬가지로 시작부터 Claude apps gateway 세션이 되며, 남아 있는 자격 증명은 사용되지 않습니다.

  • 이미지 처리에 런타임 내장 기능 사용

    CLI가 실행될 때 네이티브 이미지 모듈을 임시 디렉터리에 풀어놓았습니다. 이제 런타임에 내장된 이미지 지원을 사용하므로 이 과정이 없어집니다.

  • 플러그인 표시 정보는 마켓플레이스 항목을 우선

    Installed 탭과 claude plugin details에서 마켓플레이스에 등록된 이름, 설명과 다른 값이 나올 수 있었습니다. 이제 마켓플레이스 항목을 먼저 쓰고, 거기 없는 값만 plugin.json에서 채웁니다.

  • Claude apps gateway 세션의 OpenTelemetry 전송 경로

    게이트웨이 세션의 텔레메트리는 항상 게이트웨이 중계를 거쳤습니다. 이제 게이트웨이의 관리형 설정에 OTEL_EXPORTER_OTLP_ENDPOINT로 수집기가 지정돼 있으면 그 수집기로 바로 보냅니다. 수집기가 지정되지 않은 세션은 지금처럼 중계를 사용합니다.

주요 버그 수정

세션 재개와 프롬프트 캐시

  • 포그라운드로 실행된(결과를 기다리며 실행된) 서브에이전트를 재개하면 도구 목록과 시스템 프롬프트 앞부분이 달라져, 해당 에이전트가 프롬프트 캐시를 다시 쓰지 못하던 문제 수정.
  • 에이전트 팀 구성원과 재개된 서브에이전트가 이후 턴에서 SubagentStart 훅의 내용과 미리 불러온 스킬을 요청 앞부분 밖으로 옮기던 문제 수정. 요청 앞부분이 달라져 프롬프트 캐시에 적중하지 못했습니다.
  • advisor 도구와 그 안내를 요청마다 그 요청의 모델을 기준으로 다시 정하던 문제 수정. 이제 한 번만 정하고, 결정이 바뀌면 대화에 알립니다.
  • 도구가 실행 중일 때 이전 프로세스가 죽은 뒤 재개하면 마지막 프롬프트가 다시 쓰이던 문제 수정. 이제 마지막 프롬프트는 그대로 두고, 중단된 도구 호출은 중단됨으로 표시해 남깁니다.
  • 재개된 세션의 “백그라운드 작업이 끝나지 않음” 알림에 모델용 복구 지시문이 길게 표시되던 문제 수정. 이제 짧은 상태 줄로 나옵니다.
  • 컨테이너가 다시 시작된 뒤 워크플로 실행을 재개하던 문제 수정. 실행 기록이 없는 상태에서 재개하면 모든 에이전트를 다시 돌리는 대신 명확한 오류로 끝납니다.

Remote Control과 원격, 클라우드 세션

  • Remote Control 세션이 답변의 마지막 메시지보다 먼저 턴 종료 신호를 보내던 문제 수정. Claude 앱에서 마지막 부분이 도착하기 전에 답변이 끝난 것처럼 보일 수 있었습니다.
  • Remote Control에서 보낸 /clear가 SessionStart 훅과 열려 있는 터미널 대화상자를 기다린 뒤에야 끝나던 문제 수정.
  • 백그라운드(--bg) 세션이 유휴 시간 제한 직전에 메시지가 도착하면 턴 도중에 종료되던 문제 수정.
  • 원격 세션이 커넥터 승인이나 로그인 링크를 기다리는 동안 샌드박스 컨테이너를 계속 띄워두던 문제 수정.
  • claude.ai에서는 연결돼 있는데도 클라우드 세션의 일부 claude.ai 커넥터가 인증이 필요한 것으로 표시되던 문제 수정. 지원하지 않는 요청에 HTTP 401로 답하는 서버가 원인이었습니다.
  • 비대화형 세션(스트림 JSON 입력을 쓰는 -p, Agent SDK, 클라우드 세션)이 새 사용자 메시지마다 셸 작업 디렉터리를 되돌리던 문제 수정. 이제 cd가 다음 턴에도 유지됩니다.
  • 토큰을 갱신하는 중에 세션이 닫히면 VS Code와 SDK 세션에서 다시 로그인을 요구하던 문제 수정.

플러그인

  • 경로에 역슬래시가 들어간 플러그인이 macOS와 Linux에서 심볼릭 링크 격리 검사를 통과하던 문제 수정.
  • 이름이 점 두 개로 시작하는 플러그인 디렉터리가 플러그인 루트 밖에 있는 것으로 잘못 거부되던 문제 수정.
  • 운영체제가 확인할 수 없는 플러그인 기본 구성 요소 폴더(예: 심볼릭 링크가 서로를 가리켜 순환하는 경우)가 조용히 넘어가던 문제 수정. 이제 /plugin에 오류 코드와 함께 표시됩니다.
  • plugin.json에만 정보가 있는 마켓플레이스 플러그인이 /plugin의 Discover, Browse와 claude plugin list --json --available에서 설명과 표시 이름 없이 나오던 문제 수정.
  • 관리형 설정이 스킬만 플러그인으로 제한했는데도 /add-dir <subdirectory>가 하위 디렉터리의 에이전트를 불러오지 않고, 반대로 에이전트만 제한된 경우에는 불러오겠다고 하던 문제 수정.

입력과 화면

  • 권한 프롬프트와 메시지의 구문 강조된 코드에서 Ruby의 ?, Erlang의 $, Perl의 $ 기호 뒤 한 글자가 빠지던 문제 수정.
  • 전체 화면 대화 기록이 슬래시 명령이나 @ 파일 제안 목록이 열리고 닫힐 때마다 한 줄씩 움직이던 문제 수정.
  • 두 번째 키가 1초보다 늦게 들어오면 두 키 조합 단축키가 아무 표시 없이 취소되던 문제 수정. tmux 안에서 자주 나타나던 현상으로, 이제 3초까지 기다리고 시간이 지나면 알림을 보여줍니다.
  • /config 대화상자가 탭을 옮길 때마다 높이가 달라지던 문제 수정.

명령과 설정

  • /model opusplan[1m]이 “Model not found”로 거부되던 문제 수정.
  • 설정 파일에 쓰지 못했는데도 /model이 기본 모델로 저장했다고 알리던 문제 수정. 이제 저장에 실패했다는 사실과 그 이유를 알려줍니다.
  • Claude Code가 직접 실행하는 git 상태와 diff 확인이, 작업 트리 안에 있는 다른 저장소가 설정한 clean 필터를 실행하던 문제 수정.
  • 아티팩트 게시가 커넥터가 실제로 제공하지 않는 도구 이름을 그대로 받아들이던 문제 수정. 이제 선언한 도구가 하나도 없으면 게시를 거부하고, 일부만 없으면 경고합니다.
  • http로 설정했지만 레거시 HTTP+SSE만 지원하는 MCP 서버가 연결되지 않던 문제 수정. 이제 MCP 명세대로 SSE로 되돌아갑니다.
  • context: fork로 분기된 스킬이 시작 프롬프트를, --forward-subagent-text를 쓸 때는 텍스트 턴까지 스트림 JSON의 진행 이벤트로 내보내지 않던 문제 수정.
  • claude-api 스킬의 오류 코드 설명이 잘못돼 있던 문제 수정. 모델 접근 실패는 404, 지원하지 않는 베타 헤더는 400이며 403이 아닙니다.

기업 환경과 게이트웨이

  • Claude apps gateway의 OTLP 텔레메트리 중계가, 수집기가 형식이 잘못됐거나 너무 크다며 몇 건을 거부하면 30초 동안 모든 전달을 멈추던 문제 수정.
  • 관리형 설정으로 지정된 Claude apps gateway에 로그인한 세션에서 /login을 다시 실행하면 게이트웨이 주소가 설정되지 않았다고 표시되던 문제 수정.

Windows

  • AppContainer나 제한된 토큰 샌드박스 안에서 실행하면 Read, Write, Edit이 모든 파일을 “symlink resolution changed after permission was checked” 오류로 거부하던 문제 수정.

[VSCode]

  • 대화를 10분 넘게 열어둔 상태에서 Reload Window를 하거나 재시작하면 사이드바 대화가 빈 화면으로 돌아오던 문제 수정.
  • “Remote Control is active” 메시지의 타임라인 점이 글자보다 아래에 놓이던 문제 수정.

알아두면 좋은 점

  • forceLoginGatewayUrl이 설정된 기기는 남아 있는 claude.ai 로그인이나 API 키를 쓰지 않습니다 — 시작부터 Claude apps gateway 세션이 되므로, 업그레이드 후 로그인을 다시 해야 할 수 있습니다.
  • Claude apps gateway 세션의 텔레메트리 경로가 바뀔 수 있습니다 — 게이트웨이의 관리형 설정에 OTEL_EXPORTER_OTLP_ENDPOINT로 수집기가 지정돼 있으면 중계를 거치지 않고 그 수집기로 바로 전송됩니다. 지정돼 있지 않으면 지금처럼 중계를 사용합니다.
  • 저장되는 도구 결과는 1GB에서 잘립니다 — 그보다 큰 결과는 뒷부분이 저장되지 않으며, 대화 안 미리보기가 잘렸다는 사실을 알려줍니다.
  • --worktree의 병렬 체크아웃에는 git 2.32 이상이 필요합니다 — 그보다 낮은 버전에서는 기존 방식으로 동작합니다.
  • 두 키 조합 단축키의 대기 시간이 1초에서 3초로 늘었습니다 — tmux처럼 두 번째 키가 늦게 전달되는 환경에서 조용히 취소되던 문제를 줄이기 위한 변경입니다. 시간이 지나 취소되면 알림이 표시됩니다.
  • --plugin-dir에 폴더를 지정하면 매니페스트가 있는 하위 폴더가 각각 불러와집니다 — 플러그인 하나를 가리키던 기존 사용법도 그대로 동작하며, 실행 중에 하위 폴더를 넣거나 빼도 반영됩니다.