Claude Code 2.1.321 릴리스 노트

📌 이 글은 Claude Code 2.1.321 릴리스 노트를 한국어로 번역한 것입니다.

✨ 새 기능

  • Claude Fable 5.2(claude-fable-5-2) 추가: 기본 Fable 모델로 지정됨 (1M 컨텍스트, 백만 토큰당 $8/$40, 캐시 읽기 백만 토큰당 $0.20).
  • claude remote-control에 --settings 플래그 추가: 시작하는 모든 세션에 설정 파일을 적용하며, 파일이 변경되면 claude remote-control을 다시 시작할 때까지 새 세션이 시작되지 않음.
  • [VSCode] 터미널의 시작 경고와 동일하게 auth token과 API key가 모두 설정되었을 때 프롬프트 입력창 위에 경고가 표시되도록 추가.

🔧 개선

  • /model 선택기 개선: "More models" 행이 다른 모든 항목 아래에 번호 없이 표시되며, 이전 모델들은 기존 목록의 번호를 바꾸지 않고 하위 항목으로 펼쳐짐.
  • Gateway: 사용량이 많은 복제본(replica)의 지출 한도(spend limits) 처리를 개선하여 검사 누락을 줄이고 지출 내역을 더 빠르게 기록함.
  • Claude apps gateway 개선: Claude Code 및 /device 페이지의 로그인 제한 메시지에서 게이트웨이 자체 로그에만 표시되던 설정 이름을 노출하지 않도록 정리함.
  • claude install 및 설치 스크립트 개선: 설치 완료 시간을 2~4초 단축함.
  • 프로세스가 비정상 종료된 Remote Control 세션이 새 메시지를 다시 수신하기까지 걸리는 시간 단축.
  • Windows: 헬퍼 프로세스를 실행하지 않고 PATH에서 프로그램을 탐색하여 시작 시간 및 첫 명령어 실행 속도를 개선함.
  • 헤드리스(headless) 세션, 데스크톱 앱, VS Code에서의 auto mode 개선: 터미널과 동일하게 함께 대기 중인 백그라운드 서브에이전트들의 보고를 단일 모델 호출로 처리함.
  • agent view 개선: 워크트리를 설정하지 못한 claude --bg --worktree 세션의 행에 내부 태그나 마지막 200자 대신 오류 메시지의 처음부터 표시하도록 수정함.
  • 다른 조직에 속한 아티팩트 관련 안내 메시지 개선: 본인 소유의 조직인 경우에만 /login을 제안하며, 계정 이동 후 사본이 위치할 수 있는 위치를 안내함.
  • 단일 요청 한도를 초과하는 이미지가 포함된 세션 처리 개선: 생략된 이미지를 이미 본 적이 있는지 Claude에게 전달하고, 변경되지 않은 이미지의 반복 읽기를 제한함.
  • claude remote-control에서 응답하지 않은 첫 실행 질문 메시지 개선: 다음에 수행할 작업을 명확히 안내하도록 개선함.
  • 신뢰할 수 있는 TLS 인증서를 더 빠르게 로드하여 시작 시간 단축.
  • Claude apps gateway 오류 메시지에 사용자 이름이나 비밀번호를 제외하고 게이트웨이 주소만 표시하도록 개선.
  • Claude apps gateway의 지출 한도 오류 메시지 개선: "resets 4pm (America/Los_Angeles)"와 같이 로컬 시간대로 재설정 시간을 표시함.
  • Windows: 표준 Git for Windows 환경에서 실행 시마다 git.exe를 확인하지 않도록 하여 시작 시간 단축.
  • session-feedback 메시지와 allowedProviders 설정 설명에 Pro 및 Max와 함께 Ultra를 추가하고, forceLoginMethod 설명을 모든 유료 Claude 플랜을 포함하도록 업데이트함.
  • 내장된 dataviz 스킬 업데이트: 각자 고유한 한도가 있는 여러 비율에 대해 항목당 1개 행으로 구성된 미터 목록을 제안하도록 개선.
  • "Upgrade to Max" 옵션 문구를 "Upgrade to Max or Ultra"로 업데이트함.
  • Claude가 작성한 모드가 관리형 allowUnsandboxedCommands: false 또는 allowManagedDomainsOnly 설정이 적용되어 있어도 auto 및 bypass 모드에서 확인 프롬프트 없이 활성화되도록 변경하고, dontAsk 모드에서는 로드되지 않도록 변경함.
  • 모드 자체의 도구 호출($.tool.call, $.mcp.call)이 사용자 정의 ask 규칙이나 dontAsk 및 -p 실행 모드에서도 권한 프롬프트를 띄우지 않도록 변경됨(deny 규칙 및 조직 정책은 계속 적용됨).
  • 저장된 Fable 5.1 모델 선택 변경: Pro 및 Max 플랜에서는 즉시 fable:로 전환되며, Team 및 Enterprise 플랜에서는 조직에서 허용한 후 전환됨 (/model claude-fable-5-1 명령어로 되돌릴 수 있음).
  • /fast, /config, /model의 fast mode 라벨이 현재 모델이 fast mode를 지원할 때 해당 모델명을 표시하도록 변경하고, VS Code 행에서 "(Opus only)" 문구를 제거함.
  • 중첩된 스킬 로드 방식 변경: ~/.claude/plugins 내부의 .claude/skills 폴더는 Claude가 해당 폴더 내의 파일에서 작업할 때 로드되지 않음.
  • Self-hosted runner: 세션 종료/일시 중지 또는 작업 주문 대체 등으로 인해 서버에서 필요하지 않아 거부된 온디맨드 러너가 종료 코드 1 대신 0으로 종료되도록 변경.
  • Windows: Claude Code가 자체 실행하는 프로그램(예: git)을 탐색할 때 상대 경로, UNC PATH 항목, 네트워크 공유 링크를 건너뛰고 설정에 반영된 PATH 변경사항을 적용하도록 변경.
  • 비대화형 세션의 OpenTelemetry 훅 이벤트에서 Bash 및 PowerShell 호출 후 num_hooks 및 num_success 집계 시 두 내장 훅을 제외하도록 변경.
  • Claude Desktop Code 탭 세션이 다른 세션으로 전송할 수 있는 메시지 한도를 재입력 대기 전까지 10개에서 20개로 상향.
  • claude -p 및 SDK 세션의 AskUserQuestion에서 문서화되지 않은 afkTimeoutMs 입력 필드를 설정하는 호스트의 권한 응답을 거부하도록 변경.
  • 관리형 extraKnownMarketplaces 설정 변경: 선언된 마켓플레이스 이름을 다른 소스에서 추가할 수 없으며, 다른 위치의 항목은 숨겨지고, 선언된 마켓플레이스에 나열된 플러그인은 해당 마켓플레이스를 통해 다시 설치됨.
  • Claude 데스크톱 앱의 Code 탭 등 Claude Code를 호스팅하는 앱에서 제공하는 Claude in Chrome 도구가 조직의 Claude in Chrome 정책을 준수하도록 변경.
  • Claude apps gateway의 policy_mode: layered 모드 변경: 관리형 MCP 서버가 match: {}를 포함한 모든 일치 정책에 걸쳐 누적 적용되어, 업그레이드 후 더 많은 정책을 처리하도록 개선됨.
  • Gateway: Bedrock, Vertex, Foundry 업스트림이 게이트웨이 환경의 ANTHROPIC_*_BASE_URL 환경 변수를 무시하도록 변경됨 (다른 엔드포인트를 사용하려면 업스트림의 base_url을 설정해야 함).
  • 헤드리스 세션에서 .claude/skills 내의 모드 파일이 변경될 때 자동으로 다시 로드되도록 변경됨 (CLAUDE_CODE_PLUGIN_DIR_WATCH=0 설정으로 비활성화 가능).
  • 사이버 안전장치 차단 화면의 Cyber Verification Program 안내 문구를 claude.ai와 일치하도록 변경.
  • Cowork 클라우드 세션 변경: PostToolUse 훅이 AskUserQuestion의 응답이나 ExitPlanMode 결과의 계획을 대체할 수 없도록 수정되어 Claude가 원본 내용을 읽도록 변경됨.
  • /bin/cp와 같이 전체 경로로 지정된 cp 및 mv 명령어도 일반 cp 및 mv와 동일한 경로 검사를 받도록 변경.
  • 백그라운드 명령어 알림 및 TaskStop 결과에서 컨텍스트 절약을 위해 1,000자를 초과하는 명령어의 앞부분과 뒷부분만 Claude에 표시되도록 변경.
  • 아티팩트 디자인 가이드라인에서 Inter 및 Space Grotesk를 권장 기본 글꼴로 취급하도록 변경.
  • 계정 이메일 확인 로직 변경: 사용자 이메일과 User-Agent가 모두 포함된 셸 명령어만 확인 없이 즉시 거부하도록 변경하여, 다른 명령어와 예약된 작업이 프롬프트에서 중단되지 않도록 수정됨.
  • Remote Control 세션이 처음 시작된 폴더를 유지하도록 변경: 연결된 클라이언트가 세션 작업 폴더를 임의로 변경할 수 없음.
  • 선언되지 않은 소스에서 관리형 extraKnownMarketplaces를 인계받을 때의 동작 변경: 저장된 데이터는 cleanupPeriodDays 동안 별도로 보관되며, 옵션과 시크릿은 claude plugin restore-set-aside 실행 전까지 보관됨.

🐛 버그 수정

  • 서버 리디렉션 시 MCP OAuth 요청이 리프레시 토큰 등의 기밀 정보를 다른 호스트로 전송하던 문제 수정.
  • 읽기 전용 Bash 명령어가 권한 확인 프롬프트 없이 샌드박스 외부에서 실행되던 문제 수정.
  • Bash 권한 검사 시 잘못된 폴더 기준으로 파일 쓰기 여부를 판단하여 프롬프트를 띄우지 않던 문제 수정.
  • 디렉터리 내부로 파일을 복사하거나 이동하는 cp 및 mv 명령어에 deny 규칙과 보호 파일 프롬프트가 적용되지 않던 문제 수정.
  • Fable이 포함된 Enterprise 플랜 사용자에게 Fable로 전환한 후 "Draws from usage credits(사용 크레딧에서 차감됨)" 안내가 표시되던 문제 수정.
  • 첫 번째 모델이 응답 전 차단되었을 때 대체(fallback) 모델이 요청을 거부하거나 중단된 응답을 언급하던 문제 수정.
  • Claude Code에 등록된 서버에 다시 로그인할 때마다 claude mcp login이 SEP-2352 발급자 경고를 출력하던 문제 수정.
  • 네트워크 경로(UNC 공유, WSL 폴더, /net 마운트)에서 셀을 지정하지 않고 호출할 때 NotebookEdit이 노트북의 첫 번째 셀을 삭제하거나 덮어쓰던 문제 수정.
  • 네트워크 경로에서 Edit 도구가 일치하는 여러 항목 중 첫 번째 항목만 수정하거나, 빈 old_string 전달 시 파일 전체를 교체하거나, 노트북을 일반 텍스트로 편집하던 문제 수정.
  • 새 세션이 auto 모드로 시작될 때 /config에 기본 권한 모드가 Manual로 표시되던 문제 수정 ("Auto (default)"에서 스페이스바를 누르면 이제 Plan이 아닌 Don't Ask로 저장됨).
  • Windows: 세션 작업 디렉터리의 드라이브 문자가 소문자일 때 첫 셸 명령어 실행 후 watchPaths로 설정된 경로의 FileChanged 훅이 중단되던 문제 수정.
  • --plugin-dir . 및 --plugin-dir ./builtin 옵션 사용 시 내장 플러그인의 생성된 타입 파일이 builtin 폴더에 작성되던 문제 수정.
  • 정확한 토큰 수를 확인할 수 없을 때 도구 정의의 컨텍스트 사용량이 과다 계산되던 문제 수정.
  • 웹 및 모바일의 Remote Control에서 /compact 명령어가 중복 표시되던 문제 수정.
  • 플러그인 자동 업데이트 및 /plugin marketplace 업데이트 시 리포지토리의 워크트리나 폴더마다 플러그인을 중복 다운로드하던 문제 수정.
  • auto mode에서 Claude가 응답하기 전 대화가 압축(compact)되었을 때 턴을 시작한 백그라운드 서브에이전트의 보고가 유실되던 문제 수정.
  • git stash 등으로 인해 세션 도중 폴더가 제거되었다가 복원되었을 때(워크트리 진입 포함), 프로젝트 스킬, 명령어, 에이전트가 누락된 상태로 유지되던 문제 수정.
  • claude -p 실행 시 백그라운드 명령어가 10분 후 중단됨에도 불구하고 30분이 부여된다고 Claude에 잘못 안내되던 문제 수정.
  • 클라우드 세션의 pkill, pgrep, pidwait 명령어가 세션 자체의 상위 프로세스와 일치하던 문제 수정.
  • 연결을 지연시키는 프록시 환경에서 상위 프로세스가 종료된 후에도 Chrome 내 Claude 및 컴퓨터 사용 서버 프로세스가 계속 남아있던 문제 수정.
  • 훅 출력이 클 때 동일한 도구 호출에서 생성된 다른 훅의 출력이 담긴 파일을 가리키던 문제 수정.
  • Claude Code를 임베드한 앱에서 두 개의 PreToolUse 훅이 확인을 요청할 때 다른 훅 대신 자체 훅의 ask 사유를 가져오던 문제 수정.
  • 다른 훅의 지연(defer) 처리가 먼저 완료되어 처리되지 못했을 때 PreToolUse 훅의 ask 요청이 유실되던 문제 수정.
  • 권한 프롬프트 및 백그라운드 작업 시 간헐적으로 발생하던 비정상 종료 문제 수정.
  • Claude가 워크트리에 진입한 후 SDK 및 데스크톱 세션 메뉴에서 프로젝트 스킬, 명령어, 에이전트가 사라지던 문제 수정.
  • macOS: Claude Desktop이 ~/Applications에 설치되어 있을 때 /desktop 명령어가 설치되지 않았다고 표시하던 문제 수정.
  • 사전 시작된 프로세스에서 실행된 Claude Desktop 세션에서 OpenTelemetry 리포지토리 속성(vcs.*)이 누락되던 문제 수정.
  • WebFetch 실행 시 페이지를 읽는 모델이 텍스트를 반환하지 않았을 때 "No response from model" 문구가 페이지 내용으로 Claude에 전달되던 문제 수정 (이제 명확한 오류와 함께 호출이 실패함).
  • Claude Code 시작 중 시스템 시계가 뒤로 이동했을 때 스크린 리더 모드가 프롬프트 표시를 지연시키던 문제 수정.
  • 대화 상자가 닫힌 후 명령어 패널이 복원되지 않아 다음 화면 갱신 전까지 화면에 패널이나 프롬프트가 표시되지 않던 문제 수정.
  • 데스크톱 앱에 동일한 이름의 MCP 서버나 확장 프로그램이 있을 때, Claude Desktop Code 탭 세션의 첫 메시지 이후 프로젝트의 MCP 서버 연결이 끊어지던 문제 수정.
  • 응답 수신 도중 연결이 끊어졌을 때 "API Error: EPROTO: The TLS handshake failed" 오류로 턴이 종료되던 문제 수정 (2.1.302 이전과 동일하게 부분 응답을 유지하거나 요청을 재시도함).
  • 대용량 파일에서 단일 줄을 반복해서 읽는 장기 세션에서의 높은 메모리 사용 문제 수정.
  • fast mode 사용 시 속도 제한, 과부하 또는 오류 발생 시 응답이 유실되거나 모델이 전환되거나 몇 분 동안 재시도하던 문제 수정 (동일한 모델의 표준 속도를 먼저 시도하도록 변경됨).
  • Claude가 중단되었을 때 대기 중이던 여러 백그라운드 에이전트의 보고서가 한 요청에 의도보다 과도하게 포함되던 문제 수정.
  • Claude가 작업 중일 때 메시지를 입력하면 Claude Desktop Code 탭 세션에서 다른 세션으로 보내는 메시지가 일시 중지 상태로 유지되던 문제 수정.
  • --verbose 등의 플래그가 함께 지정되었을 때 claude agents 명령어에서 agents 앞에 입력된 --permission-mode, --dangerously-skip-permissions, --model, --effort, --agent 플래그가 무시되던 문제 수정.
  • 데스크톱 앱에서 로그인 토큰을 일시적으로 전달하지 못해 연결이 유지된 상태에서도 Remote Control이 "login expired" 상태와 함께 꺼짐으로 표시되던 문제 수정.
  • "Queue for later"로 전송된 Remote Control 메시지가 현재 진행 중인 턴 중간에 Claude에게 전달되던 문제 수정.
  • 세션 시작 시 git status가 실패했을 때 깨끗한(clean) 상태로 표시되던 문제 수정 (이제 사용할 수 없음으로 표시됨).
  • 세션 시작 시 Claude에게 제공되는 git status에서 첫 번째 파일의 변경사항이 스테이징되지 않았음에도 스테이징된 것으로 표시되던 문제 수정.
  • 클라우드 세션의 커넥터가 매우 긴 이름의 리소스를 나열할 때 멈추거나 메모리 부족(OOM)으로 비정상 종료되던 문제 수정.
  • 세션 기록이 업로드되는 동안 연결이 완전히 종료되었음에도 Remote Control이 연결됨 상태로 표시되던 문제 수정.
  • agent view에서 대화로 돌아올 때 스크린 리더 모드가 꺼지던 문제 수정.
  • 스크린 리더 모드의 y/n 질문에서 질문 창이 열릴 때 입력된 텍스트 끝의 불필요한 "y"를 예(yes)로 처리하던 문제 수정.
  • 허용된 호스트임에도 네트워크 프록시가 연결하지 못했을 때 클라우드 세션에서 해당 호스트가 허용되지 않았을 가능성이 높다고 Claude에 잘못 알리던 문제 수정.
  • 도구를 로드하는 동안 MCP 서버가 다시 연결되거나 세션 디렉터리가 변경되었을 때 도구 없이 연결됨으로 표시되던 문제 수정.
  • Claude가 여러 명령어를 한 번에 보낼 때 이전 명령어가 폴더를 변경하여 후속 Bash 명령어가 잘못된 폴더에서 실행되던 문제 수정.
  • 클라우드 및 Remote Control 세션에서 Claude가 전송한 파일 업로드 시 프록시로부터 HTTP 507을 받으면 즉시 실패하던 문제 수정 (이제 재시도를 수행함).
  • 트랜스크립트를 읽는 도중 메모리가 부족해지면 새 메시지가 저장되지 않고 claude -p, SDK, VS Code 세션이 멈추던 문제 수정.
  • 네트워크가 연결을 수락하지만 TLS 핸드셰이크에 응답하지 않을 때 로그인, 토큰 갱신, 로그아웃이 무한 대기하던 문제 수정.
  • 텍스트 방향 제어 문자나 제어 문자가 포함된 파일이 Claude 앱에서 다른 이름으로 표시되던 문제 수정 (이제 Claude가 해당 파일 전송을 거부함).
  • 서브에이전트 진행 요약에서 모델이 도구 호출로 응답한 후에도 요청이 끝까지 실행되던 문제 수정.
  • grep -r foo "$PWD/src"와 같은 Bash 읽기 명령어가 경로를 직접 입력했을 때와 달리 권한 확인을 요청하던 문제 수정.
  • 관리형 MCP 서버의 oauth.omitResource 등 데스크톱 설정에 게이트웨이보다 최신 필드가 포함되어 있을 때 Claude apps gateway 실행이 거부되던 문제 수정 (경고를 출력하고 정상 실행되도록 수정됨).
  • .zshrc에 KSH_OPTION_PRINT를 설정한 zsh 사용자에게 Bash 명령어 결과가 빈 값으로 반환되던 문제 수정.
  • macOS: 올바른 MDM 프로필을 읽는 속도가 느릴 때 시작 시 "Unable to read managed policy settings" 오류가 발생하던 문제 수정 (읽기를 1회 재시도하며, 타임아웃 발생 시 타임아웃 오류로 보고됨).
  • agent view가 입력 내용 없이 업데이트를 위해 재시작될 때 다른 agent view에 저장된 입력 텍스트를 지우던 문제 수정.
  • 원격 세션 재시작 시 UserPromptSubmit 훅이 재생된 권한 응답을 차단하여 응답이 없던 문제 수정 (해당 재생 시에는 훅이 실행되지 않음).
  • claude remote-control의 첫 실행 질문에서 터미널 입력이 끝났을 때 Enter 없이 입력된 y를 수락하던 문제 수정.
  • 정책에 code: 규칙이 없는 Claude apps gateway 뒤에서 Claude Desktop에 지출 한도 경고가 표시되지 않던 문제 수정.
  • 일부 플러그인이 포함된 전체 화면 세션에서 길이가 짧아진 도구 결과가 화면 상단 밖으로 스크롤될 때 오류와 함께 종료되던 문제 수정.
  • 모델이 도구 호출로 응답했을 때 프롬프트 추천(prompt suggestions)이 추가 API 요청을 발생시키던 문제 수정.
  • 응답 크기가 16 MiB를 초과할 때 stdio 및 HTTP MCP 서버의 PreToolUse mcp_tool 훅이 건너뛰어지던 문제 수정 (이제 도구 호출이 거부됨).
  • 일부 글꼴에서 공백으로 렌더링되는 바뭄(Bamum) 문자가 포함된 스킬 및 명령어 이름이 거부되도록 수정.
  • Linux 환경의 claude -p에서 NFS 내보내기가 가득 차거나 할당량이 초과되어 트랜스크립트 라인이 유실되었을 때 오류 없이 종료 코드 0으로 끝나던 문제 수정 (이제 오류를 출력하고 텍스트 및 JSON 출력에서 종료 코드 1로 종료됨).
  • 서비스 장애로 클라우드 세션이 중단되었을 때 중지 버튼을 누르지 않았음에도 백그라운드 에이전트가 사용자에 의해 중지된 것으로 보고되고 재개가 거부되던 문제 수정.
  • 권한 프롬프트가 열려 있는 동안 노트북이 변경되는 등의 이유로 편집이 실패했음에도 NotebookEdit이 훅과 텔레메트리에 성공으로 보고하던 문제 수정.
  • 저장된 MCP 로그인 레코드가 null일 때 시작 시 빈 화면이 나타나거나 응답이 없고 claude mcp list 출력이 비어 있던 문제 수정.
  • 아티팩트의 데이터베이스 컬렉션 크기가 너무 커서 정렬할 수 없을 때 Artifact 도구가 필터를 추가하라고 안내하던 문제 수정 (컬렉션을 페이지별로 읽고 결과를 정렬하도록 안내함).
  • Claude의 첫 응답 전에 재시작되었을 때 재시작된 클라우드 세션에서 대용량 이미지가 포함된 메시지가 유실되던 문제 수정.
  • 재시작된 클라우드 세션에서 메인 대화로 전달되는 서브에이전트의 메시지가 응답 없이 방치되던 문제 수정.
  • 실행 중인 워크플로를 중지하거나 일시 중지했을 때 Claude에게 전달되지 않아 워크플로가 여전히 실행 중이라고 답변하던 문제 수정.
  • [VSCode] 플러그인의 권한 요청에 숨김 문자가 포함된 이름이 표시되던 문제를 수정하여 "a plugin"으로 표시되도록 함.