Claude Code 2.1.323

무엇이 바뀌었나?

Claude Code 2.1.323이 2026년 11월 12일 출시됐습니다. 새 기능으로는 Claude가 JavaScript로 도구를 호출하는 실험적 기능 Code Mode와, 플러그인이 지원하는 Claude Code 버전 범위를 선언하는 engines["claude-code"]가 추가됐습니다. 290건이 넘는 변경의 상당수는 권한 확인과 Bash 샌드박스 보강, 계정 프로필과 로그인 처리 수정입니다. Claude Code가 모르는 모델 ID의 기본 컨텍스트 창이 200K에서 1M으로 바뀌는 등 기존 설정에 영향을 주는 변경도 있습니다.

새 기능

• Code Mode (실험적 기능)

  지금까지 Claude는 도구를 한 번에 하나씩 호출했습니다. Code Mode를 켜면 Claude가 JavaScript 코드를 작성해 그 안에서 도구를 호출합니다. 기본으로 꺼져 있는 선택(opt-in) 기능이며, 릴리스 노트는 켜는 방법과 조직 단위로 끄는 방법을 Code Mode 문서에서 안내합니다.

• 플러그인의 Claude Code 버전 범위 지정(engines["claude-code"])

  지금까지는 플러그인이 특정 Claude Code 버전에서만 동작해도 이를 선언할 방법이 없었습니다. 이제 plugin.json의 engines["claude-code"]에 버전 범위를 적으면, 범위를 벗어난 Claude Code에서는 플러그인을 설치, 업데이트하거나 불러오지 않습니다. 설치와 업데이트는 범위에 맞는 가장 새로운 플러그인 버전을 고릅니다.

• claude plugin validate 검사 확장

  플러그인의 TypeScript 훅 모듈을 타입 검사합니다. 발견 항목은 경고로 표시되며, --strict를 주면 실패로 처리합니다. mod(Claude Code의 화면과 동작을 바꾸는 확장)의 engine.create 훅이 추가하거나 막거나 바꾸는 $ 명사도 검사 결과에 표시합니다.

• 긴 훅 실행 중 30초마다 진행 신호

  claude -p와 SDK 세션에서 훅이 오래 실행되면, Claude Desktop 같은 호스트 앱이 멈춘 것으로 판단해 턴을 끝낼 수 있었습니다. 이제 훅이 실행되는 동안 30초마다 진행 신호(heartbeat)를 보냅니다. 호스트 앱에 이 버전이 포함된 뒤부터 효과가 있습니다.

• 사용 크레딧이 필요할 때의 선택 메뉴

  모델이 사용 크레딧(usage credits)을 필요로 하는데 크레딧이 꺼져 있거나 모두 소진됐으면 중지, 사용 크레딧으로 전환, 업그레이드를 고르는 메뉴가 나타납니다.

• 새 환경변수

  • CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES: 1로 설정하면 서브에이전트 진행 요약과 이를 작성하는 요청을 끕니다. 2.1.318부터 동작했으며 이번에 릴리스 노트에 공개됐습니다.
  • CLAUDE_CODE_RESUME_HINT_COMMAND: Claude Code를 실행하는 다른 프로그램이 설정하면, 종료 시 안내하는 재개 명령을 그 프로그램의 명령으로 바꿔 표시합니다.

• 시작 시 경고와 안내

  다음 상황에서 경고나 안내가 표시됩니다.

  • 변수 값에 *가 들어간 Bash allow 규칙(예: Bash(PORT=* npm run dev))
  • 플러그인의 language server가 시작하지 못할 때 (서버 이름과 확인할 점 표시)
  • Perforce 설정이 있는데 CLAUDE_CODE_PERFORCE_MODE가 꺼져 있을 때 (한 번만 표시)

• 기타 추가 기능

  • Artifact 도구의 첨부 파일 업로드가 .docx를 지원합니다.
  • diff 패널에 /diff to close 안내가 표시되고, ? 단축키 안내에 패널을 선택하고 닫는 키가 추가됐습니다.
  • claude plugin install --json 결과에 아직 설정되지 않은 userConfig 옵션 수를 알려 주는 unsetOptionCount가 추가됐습니다.
  • mod의 pane이 받는 값에 대화상자나 입력란이 프롬프트를 가리고 있는지 알려 주는 isPromptCovered가 추가됐습니다.
  • 서드파티 제공자를 쓰는 Claude Desktop 세션의 관리 설정에서 CLAUDE_CODE_AUTO_MODE_MODEL을 지원합니다. Claude Desktop에 이 버전이 포함된 뒤부터 적용됩니다.

• [VSCode] 폴더 신뢰 확인과 Bash 실시간 출력

  신뢰하지 않은 폴더에서 첫 세션을 시작하기 전에 신뢰 여부를 묻습니다. 거절하면 그 폴더의 설정과 MCP 서버를 사용하지 않습니다. 실행 중인 Bash, PowerShell 명령의 출력이 채팅의 명령 카드 아래에 실시간으로 표시됩니다.

• Claude Tag와 Code Review 관리 기능

  Enterprise 플랜에서 Slack으로 시작한 Claude Tag 세션을 Compliance API로 조회하고 대화 기록을 읽을 수 있습니다(베타). 관리자가 조직의 Claude Tag를 끌 때 무엇이 멈추는지 알려 주는 확인 단계, Activity 페이지 Network events 탭의 Scope 필터, 채널 설정을 불러오지 못했을 때의 Retry 버튼도 추가됐습니다. Code Review 관리 설정에는 저장소별 리뷰 비용을 월, 주, 일 단위로 내보내는 Download CSV 버튼이 생겼습니다.

주요 개선

• 모르는 모델 ID의 컨텍스트 창이 1M으로

  Claude Code가 인식하지 못하는 모델 ID는 지금까지 컨텍스트 창이 200K라고 가정했습니다. 이제 1M으로 가정합니다. 더 일찍 압축하려면 /autocompact를, 200K를 유지하려면 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 사용합니다. 컨텍스트 창이 더 작은 다른 회사의 모델을 쓰는 세션은 창이 가득 차면 /clear할 때까지 모든 턴이 실패할 수 있으므로, 차기 전에 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 설정해야 합니다.

• 실행 전에 확인을 받는 동작 확대

  다음 동작이 바로 실행되지 않고 먼저 확인을 받습니다.

  • /security-review 실행
  • bare 저장소의 worktree 같은 폴더에서 스킬에 포함된 git 명령 실행 (auto mode, bypass 모드 제외)
  • Claude가 MCP 서버 로그인을 마무리하는 도구 호출 (bypass, auto 모드에서도 확인. dontAsk 모드처럼 물어볼 수 없는 곳에서는 /mcp 사용)
  • 조직 밖 사람이 볼 수 있거나 Claude가 공개 범위를 확인할 수 없는 artifact의 수정 (allow 규칙이 있어도 확인)

  프로젝트(.mcp.json) MCP 서버 승인은 서버 이름이 정확히 같을 때만 적용되며, 다른 표기로 저장된 승인은 다시 묻습니다. 신뢰하지 않은 폴더의 VS Code 세션과 --trust-workspace false로 실행한 셀프 호스팅 러너에서는 저장소 설정이 사용자의 훅을 끄거나 플러그인을 켜고 끌 수 없습니다.

• “don’t ask again”과 훅의 권한 판단

  비밀값처럼 보이는 allow 규칙이나 git이 추적하는 settings.local.json에 저장될 규칙은 “don’t ask again”을 골라도 저장되지 않고 이번 세션에만 적용됩니다. PreToolUse 훅이 “allow”를 반환한 뒤 도구의 권한 확인이 오류로 실패하면, 훅이 답하지 않은 것처럼 판단합니다. PermissionRequest 훅이 바꾼 입력에서 권한 확인이 실패하면 다시 묻고, 답할 사람이 없으면 호출을 거부합니다.

• Bash 샌드박스 범위 조정

  다음 동작이 샌드박스 안에서 읽기 전용으로 실패하므로 샌드박스 밖에서 실행해야 합니다.

  • --global이나 --host 없는 glab config set, glab config edit --local
  • macOS와 Linux에서 git worktree add, move, remove, 그리고 세션을 시작하지 않았거나 받지 않은 worktree에서의 커밋 (프로젝트 안에 있어도 해당)

  macOS, Linux, WSL에서는 쓰기 가능한 폴더 안의 심볼릭 링크가 다른 곳이나 없는 경로를 가리키면, 그 링크로 준 쓰기 권한을 무시합니다. 실제 경로에 권한을 주어야 합니다. --settings 파일이 올바른 JSON이 아닌데 sandbox 키가 있으면, 샌드박스를 끄는 설정이어도 시작을 멈춥니다.

• 내부 명령에서 인증 정보 분리

  Claude Code가 직접 실행하는 ripgrep과 대부분의 내부 git 명령이 로그인 토큰과 API 키 대부분을 넘겨받지 않고 실행됩니다. 그래서 이런 git 명령 아래에서 실행되는 credential helper나 훅은 이 값들을 찾지 못합니다. 관리 설정의 policyHelper도 사용자 설정이나 --settings 파일의 환경변수를 받지 않으므로, 필요한 값은 관리 설정의 env나 실행하는 셸에 설정합니다. 조직 설정과 정책 요청은 ALL_PROXY로만 지정한 프록시를 쓰지 않으며, 프록시가 필요하면 HTTPS_PROXY를 설정합니다.

• 세션 간 메시지 한도 확대

  같은 컴퓨터의 세션끼리 사용자 입력 없이 주고받을 수 있는 메시지 수가 약 20개에서 100,000개로, Claude Desktop Code 탭 세션이 다른 세션에 보낼 수 있는 메시지 수가 20개에서 100,000개로 늘었습니다.

• 플러그인과 mod 규칙 변경

  • engine.create에 *, 네임스페이스, 부정 패턴으로 건 훅은 이제 관찰만 합니다. $ 명사를 추가하거나 막으려면 engine.create를 이름으로 지정해 훅을 걸어야 합니다. 허용된 한 가지 형식이 아닌 engine.create 훅은 claude plugin validate에서 실패하지만, 이미 설치된 mod는 계속 불러옵니다.
  • git 서브모듈이 저장소에 기록된 커밋에 있지 않으면 마켓플레이스와 플러그인 설치가 실패합니다.
  • tool.list 플러그인 훅이 추가하거나 뺀 도구가 모델과 모든 에이전트에 적용됩니다.
  • 플러그인 설치 명령이 stderr에 무언가를 쓰면 claude plugin install과 /plugin이 성공 대신 경고를 표시합니다.
  • claude.ai 채팅과 Cowork 작업은 플러그인 파일을 보내기 전에 비밀 키가 있는지 검사하고, 있을 수 있으면 먼저 묻습니다.
  • 플러그인의 agent 설정은 지원 중단(deprecated)됐습니다. 계속 적용되지만 시작 시, claude plugin list, claude plugin validate에서 경고합니다.
  • subagentStatusLine 설정이 제거됐습니다. 서브에이전트 행은 항상 기본 모양을 쓰며, 이 키가 남아 있는 설정 파일도 그대로 불러옵니다.

• MCP 클라이언트와 안내

  v1 MCP 클라이언트가 제거돼 MCP_SDK_GENERATION=v1은 v2 클라이언트를 호환 모드(이전 방식의 handshake, 완화된 OAuth 로그인 검사)로 실행합니다. /mcp는 입력 스키마를 API가 거부해 빠진 서버 도구의 수와 이유를 보여 줍니다. 커넥터 ID를 한두 글자 잘못 적은 MCP 도구 호출은, 호스트 앱이 등록한 서버라면 호출해야 할 도구 이름을 오류에 알려 줍니다.

• 메모리와 속도

  • 끝난 서브에이전트의 대화 기록을 뒤이은 서브에이전트가 실행되는 동안 계속 들고 있지 않고 더 빨리 메모리에서 해제합니다.
  • 설치 스크립트가 최신 버전을 두 번 내려받지 않습니다.
  • WebFetch가 깊게 중첩된 페이지에서 더 빠르고 메모리를 덜 씁니다.
  • Linux에서 /home이 autofs 맵(접근할 때 자동으로 마운트되는 폴더)일 때 시작할 때 /home 자체의 파일을 찾지 않도록 개선됐습니다. / 아래 두 단계 이상 깊은 맵 루트는 CLAUDE_CODE_AUTOMOUNT_ROOTS로 지정합니다.
  • claude.ai 계정에 플러그인이 2,000개 넘게 켜져 있을 때 Claude Desktop과 클라우드 세션의 시작 대기가 짧아지고, Claude가 빠진 플러그인의 이유를 설명할 수 있습니다.

• 권한 확인의 일관성

  느리거나 바쁜 컴퓨터에서 같은 명령이 다른 권한 판단을 받는 경우가 있었습니다. 이제 같은 명령은 더 안정적으로 같은 판단을 받습니다. 검사한 방식과 다르게 실행될 수 있는 일부 명령은 권한을 묻습니다.

• 오류 메시지와 한도 안내

  /login과 claude setup-token의 로그인 오류는 요청이 거부, 연결 실패, 시간 초과 중 무엇이었는지와 확인할 점을 알려 줍니다. -p, SDK, IDE, 클라우드 세션의 Fable 한도 메시지는 한도가 언제 초기화되는지와 계속하는 방법을 알려 줍니다. ToolSearch는 짧은 이름으로 찾은 도구가 이미 사용 가능하면 그렇다고 알려 줍니다. CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS의 최댓값이 64000에서 300000으로 늘었습니다.

• 기타 변경

  • 데스크톱 앱 Code 탭의 워크플로는 사용량 한도에 도달하면 일시 중지했다가 한도가 초기화되면 이어서 실행합니다.
  • 백그라운드 세션의 /logout은 지금까지 효과가 없었지만, 이제 터미널처럼 컴퓨터의 모든 세션에서 로그아웃하고 저장된 MCP 로그인과 플러그인 비밀값을 지운 뒤 세션을 끝냅니다.
  • claude rm과 agents 화면은 세션이 삭제된 것이 아니라 목록에서 제거됐다고 안내합니다. 대화는 남아 있고 claude --resume에서 볼 수 있습니다.
  • 분할 창(split-pane) 에이전트 팀원은 요청이 팀 리더에게서 왔는지 확인합니다. 리더보다 오래 남은 팀원의 요청은 거부되고, /clear나 /resume 뒤에는 계획 승인을 다시 보내야 합니다.
  • .git 폴더가 링크이거나 하드 링크를 포함한 체크아웃(git-new-workdir 구성, cp -al 복사본 등)에서는 worktree를 만들지 않습니다. 일반 clone을 사용해야 합니다.
  • 안전장치가 포크된 스킬이나 워크플로 에이전트를 멈추면 Claude는 직접 작업하지 않고 범위를 좁혀 다시 시도하거나 사용자에게 알립니다.
  • macOS computer use는 Space를 Control이나 Option과 함께 누르는 키 조합과, 사용자 허락이 필요한 시스템 단축키를 더 많이 거부합니다.
  • Terminal.app 첫 설정은 동의하기 전에 “Use Option as Meta key” 설정 이름, Option 키로 입력할 수 없게 되는 문자, 되돌리는 방법을 알려 줍니다.

주요 버그 수정

권한과 보안

• auto mode를 쓸 수 없을 때 --permission-mode auto나 설정의 defaultMode: auto가 더 많은 것을 허용할 수 있는 모드로 시작하던 문제 수정. 이제 먼저 묻는 Manual 모드로 시작합니다.
• sudo, env 같은 래퍼로 실행한 일부 명령에 Bash deny, ask 규칙이 적용되지 않던 문제 수정.
• sudo 플래그를 합쳐 쓴 Bash allow 규칙이 권한 확인을 건너뛰던 경우 수정.
• Bash(ls*)처럼 와일드카드를 붙인 Bash allow 규칙이 일부 경우 권한 확인을 건너뛰던 문제 수정. Bash(NODE_ENV*)처럼 변수를 지정한 규칙은 이제 묻습니다.
• Bash 권한 검사가 rm을 엉뚱한 폴더 기준으로 판단해, bypass 모드나 Bash allow 규칙에서 위험한 삭제 확인을 건너뛰던 경우 수정.
• Write, Edit 도구가 Read deny 규칙이 걸린 경로에 쓸 수 있던 경우 수정.
• Bash 권한 검사가 명령의 일부를 놓치던 경우, 일부 lsof 명령이 권한 확인 없이 실행되던 경우, 특정 비기본 셸 옵션을 쓰는 zsh 사용자의 Bash 명령이 권한 확인 없이 실행되던 경우 수정.
• 세션 도중 Bash 샌드박스가 꺼질 수 있던 경우와 sandbox.excludedCommands가 지정하지 않은 명령을 샌드박스 밖에서 실행하게 하던 경우 수정.
• 샌드박스를 켜는 --settings나 SDK 설정이 검증에 실패하면 claude -p와 Agent SDK가 Bash를 샌드박스 없이 실행하던 문제 수정. 이제 시작 단계에서 멈추고 잘못된 설정 이름을 알려 줍니다.
• 샌드박스 안의 명령이 설정 디렉터리 아래 Claude Code의 파일 체크포인트 사본을 읽을 수 있던 문제와 기존 방식의 설정 파일을 쓰는 설치에서 샌드박스가 Claude Code 자체 설정을 완전히 보호하지 못하던 문제 수정.
• plansDirectory를 설정했을 때 계획 파일이 프로젝트 밖에 쓰이던 경우 수정. 프로젝트 안에 머무는지 확인할 수 없는 쓰기는 거부합니다.
• gateway 이름에 “haiku”가 들어간 모델로 ANTHROPIC_BASE_URL gateway 뒤에서 auto mode가 실행되던 문제 수정. claude-haiku-5-5가 아닌 이런 모델은 Haiku 4.5처럼 거부됩니다.
• 프로젝트 설정을 Claude Code가 확인한 폴더와 다른 곳으로 이어지는 심볼릭 링크로 읽던 경우 수정.
• .git, .claude 같은 민감한 경로에 쓰는 명령에 “don’t ask again”을 제안했지만 저장된 규칙이 다음 확인을 막지 못하던 문제 수정.
• mod가 Claude Code 자체의 확인 질문 문구를 바꿀 수 있던 문제 수정.
• cat > file <<EOF로 파일을 쓰는 Bash 명령이 “Read 1 file”로 표시되던 문제 수정.
• Windows에서 와일드카드나 파일 목록을 준 일부 파일 읽기 Bash 명령이 권한 확인 없이 실행되던 문제 수정.

로그인과 계정 프로필

• 이름 있는 Anthropic 프로필로 연 세션을 /fork, 왼쪽 화살표, --bg로 백그라운드에서 이어 가면 다른 로그인으로 바뀌던 문제 수정. 업데이트 중 열려 있던 세션은 다시 열어야 합니다.
• 이름 있는 프로필이 없거나 바뀌었거나 덮어써진 백그라운드 세션이 다른 로그인으로 대화를 보내던 문제와 셸의 API 키, auth token, workload identity로 연 세션이 백그라운드에서 다른 로그인으로 바뀌던 문제 수정. 이제 멈추고 그 사실을 알립니다.
• 백그라운드 세션의 로그인이 이전 계정의 로그인과 인증 정보를 남기던 문제 수정. 이제 컴퓨터의 모든 세션에서 지웁니다.
• 토큰 갱신 중에 끝난 claude plugin 명령과 claude mcp list가 Console 프로필에서 로그아웃시키던 문제 수정.
• MCP 도구 호출이 다시 로그인하라고 묻지 않고 TOKEN_EXPIRED 같은 로그인 서버 오류로 끝나던 문제 수정.
• macOS에서 키체인 응답이 느리면 /login이나 토큰 갱신에 성공한 직후 Not logged in · Please run /login이 다시 나타나던 문제 수정.
• 조직의 gateway가 만료된 토큰에 403으로 답하면 Claude Desktop에서 턴이 실패하던 문제 수정. 이제 Desktop에 새 토큰을 받아 다시 시도합니다.
• Claude apps gateway 로그인이 만료된 뒤 세션이 계속 실패하던 문제 수정. 다른 터미널에서 /login으로 다시 로그인하면 다음 메시지부터 이어집니다.
• Amazon Bedrock이 모델 사용을 거부할 때 AWS 인증 정보를 새로 고치라고 안내하던 문제 수정. 이제 모델을 활성화하라고 안내합니다.
• 만료된 claude.ai 로그인이 크레딧 없는 Console 키나 ant auth login 프로필로 대체될 때 “Credit balance too low”가 표시되던 문제 수정.

대화, 파일, 세션 저장

• /compact를 다시 실행하거나 /context 같은 명령 뒤에 실행하면 Claude가 아직 답하지 않은 메시지가 요약으로 사라지던 문제 수정.
• 재개한 세션이 다음 메시지를 재개하지 않은 예전 중단 메시지에 이어 붙이던 문제 수정.
• 실행 중인 세션이 저장한 설정이 직전에 손으로 고친 settings.json 내용을 되돌리던 문제 수정. 세션 중에 지운 설정 파일은 지운 상태로 남습니다.
• Edit과 Bash가 일부 /proc 파일에서 메모리가 부족해지고, Edit이 장치 파일과 named pipe에서 멈추던 문제와 Claude가 아주 큰 파일을 바꾼 뒤 다음 프롬프트에서 메모리 사용량이 급증하던 문제 수정.
• 스트리밍 없이 보낸 요청이 거부된 이미지, thinking 블록, beta 헤더처럼 스트리밍 요청이라면 복구하는 오류에서 실패하던 문제 수정.
• worktree에 들어가기 전 셸이 있던 폴더가 삭제됐으면 ExitWorktree, worktree 종료 대화상자, /resume이 세션을 엉뚱한 폴더에 두던 문제 수정.
• WorktreeCreate 훅이 만든 worktree나 중첩 저장소의 worktree에 들어간 뒤 서브에이전트 대화 기록과 큰 도구 결과가 세션 기록과 따로 저장되던 문제 수정.
• NFS나 FUSE 파일 시스템에서 Claude Code가 응답을 버릴 때 저장된 세션 일부가 사라질 수 있던 경우 수정.
• WebFetch가 빈 표 칸을 빼고 뒤의 값을 한 칸씩 왼쪽으로 밀던 문제와 WebFetch가 호출할 때마다 조직 정책과 CLAUDE_CODE_DISABLE_WEB_FETCH를 다시 확인하지 않던 문제 수정.
• 다른 프로그램이 관리 설정 파일(managed-settings.json, managed-settings.d)을 다시 쓰는 중이면 시작 시 이를 놓치던 문제 수정. 이제 한 번 더 읽습니다.
• --no-session-persistence로 실행한 세션의 긴 도구 결과가 디스크에 남던 문제 수정. 정상 종료, Ctrl+C, SIGTERM 시 지웁니다.

MCP, 플러그인, mod

• Agent SDK 앱이나 claude -p 호출자가 MCP 서버를 뺐다가 다시 추가한 사이에 도구 호출이 있었으면, 그 서버가 도구 없이 연결이 끊긴 채 남던 문제 수정.
• 서버가 늦게 연결되면 재개한 대화에서 이전 MCP 도구 호출이 빠지고 스크롤 기록에 줄이 반복되던 문제 수정.
• SDK 호스트가 MCP 서버 도구 목록에 null 항목을 보내면 headless 세션(화면 없이 실행되는 세션)이 끝나던 문제 수정.
• /mcp와 /plugins가 인증이 필요하지만 로그인 정보를 가진 MCP 서버 페이지를 “Disable”에 커서를 둔 채 열던 문제 수정. 이제 “Reconnect”를 제안하고 그 위에서 열립니다.
• enabledPlugins에 버전 목록이 있는 플러그인이 아무 메시지 없이 꺼져 있던 문제 수정. /plugin과 claude plugin list가 이유를 알려 줍니다.
• 저장소 설정으로만 켠 플러그인에 “not cached”라는 오해를 부르는 오류가 나던 문제 수정. 이제 설치되지 않았다고 알리고 설치 명령을 보여 줍니다.
• Windows에서 복제한 파일 경로가 260자에 이르면 플러그인과 마켓플레이스 설치가 실패하던 문제 수정.
• npm, pip, uv, cargo, github, gh라는 이름의 마켓플레이스가 예약어로 거부되던 문제와 마켓플레이스 renames 맵의 잘못된 항목 하나 때문에 다른 이름 변경이 모두 무시되던 문제 수정.
• 관리 설정으로 켠 플러그인의 불러오기 오류가 SDK와 Desktop 세션에서 디버그 로그에만 남던 문제 수정. 이제 init.plugin_errors에 나열됩니다.
• claude.ai에서 켠 defaultEnabled: false 플러그인이 claude.ai 채팅의 클라우드 세션에서 계속 꺼져 있던 문제 수정.
• claude --bg --safe-mode 세션이 safe mode에서는 시작하지도 않는 프로젝트 MCP 서버에 대해 묻느라 시작 단계에서 멈추던 문제 수정.
• mod의 tool.check 훅이 띄운 권한 확인이 실제로 요청한 플러그인이 아니라 그 도구에 훅을 건 모든 플러그인을 나열하던 문제 수정.

화면, 입력, 사용량 표시

• 줄바꿈될 때 악센트 같은 결합 문자가 글자 왼쪽에 놓이거나, 화면에 이전 사본이 남거나, 사라지던 문제 수정.
• ctrl+x enter처럼 키 조합의 마지막 키가 그 조합의 동작을 쓸 수 없는 대화상자 입력란에 입력되던 문제와 ctl+k처럼 잘못 쓴 키 바인딩 수식키가 수식키 없는 키에 바인딩되던 문제 수정. 잘못 쓴 바인딩은 무시됩니다.
• claude update가 끝나는 순간 Ctrl+C를 누르면 claude 명령이 사라지던 경우 수정.
• CLAUDE_CODE_EFFORT_LEVEL이 덮어쓰는데도 모델 선택기와 /model이 선택한 effort 수준을 표시하던 문제와 /model 선택기에서 최신 모델 강조가 빠지던 문제 수정.
• 주간 Fable 한도에 초기화 시각과 선택 메뉴가 표시되지 않던 문제, “Now using usage credits” 안내가 반복되거나 표시되지 않던 문제 수정.
• /usage가 setup token과 CLAUDE_CODE_OAUTH_TOKEN에서 한도 막대를 숨기던 문제와 서브에이전트 유형 옆에 세션 전체 비율을 표시하던 문제 수정.
• 스크린 리더 모드(screen reader mode)에서 질문이나 권한 확인에 답할 때 받아쓰기나 붙여 넣은 텍스트, 이모지가 빠지던 문제 수정.
• 전체 화면 렌더러에서 긴 프롬프트가 여러 줄 상태 표시줄을 화면 밖으로 밀어내던 문제 수정.
• 덴마크어, 노르웨이어, 페로어, 그리스어 자판에서 단어 안에 ø나 π를 입력하면 Option 키 안내가 나타나던 문제 수정.

Remote Control과 클라우드 세션

• Wi-Fi 전환이나 VPN 재연결 같은 네트워크 변경 뒤 Remote Control 세션이 1분 넘게 연결 끊김으로 표시되던 문제 수정.
• claude remote-control을 멈춘 지 4시간이 지나 같은 폴더에서 다시 시작하면 새 컴퓨터로 연결되던 문제 수정. 이제 최대 30일 동안 같은 컴퓨터로 유지됩니다.
• DISABLE_TELEMETRY나 DO_NOT_TRACK을 설정하면 다른 기기와 휴대폰 알림에 Claude가 무엇을 허락받으려는지 표시되지 않던 문제 수정.
• 터미널에서만 답할 수 있는 권한 확인을 기다리는 세션이 Remote Control에서 실행 중으로 표시되던 문제와 사용 크레딧 사용 여부를 묻는 동안 Remote Control에 아무것도 표시되지 않던 문제 수정. 이 질문은 이제 Claude 앱에도 표시됩니다.
• 긴 대화의 클라우드 세션이 재시작된 뒤 Claude의 질문에 대한 답이 사라지던 문제, Claude가 답하기 전에 재시작되면 메시지가 대화에서 빠지던 문제 수정.
• 세션 프로세스가 재시작된 뒤 도착한 계획 승인에 “You are not in plan mode”라고 답하던 문제 수정 (클라우드, 셀프 호스팅 러너, SDK 세션).
• 세션 컨테이너가 응답 도중 종료되면 클라우드 세션의 스트리밍 응답 중간 텍스트가 빠지던 문제 수정.
• 다른 세션이 같은 메시지를 두 번 보내거나 많은 메시지를 한꺼번에 보내면 Claude Desktop 세션이 계속 바쁨 상태에 머물던 문제 수정.

백그라운드 세션, claude -p, OpenTelemetry

• 설정이 요청한 모델을 막으면 텍스트 출력의 claude -p가 알림 없이 다른 모델을 쓰던 문제 수정. 이제 stderr에 경고합니다.
• --plugin-dir mod의 훅이 멈추거나 훅 작업 프로세스를 충돌시켜도 텍스트 출력 claude -p가 stderr에 아무것도 출력하지 않던 문제 수정.
• Linux에서 CLAUDE_CODE_SUBPROCESS_ENV_SCRUB을 설정하면 읽기 전용 git 명령이 승인을 요구하거나 claude -p에서 거부되던 문제 수정.
• claude agents가 입력한 프롬프트를 잃던 문제 수정. 이제 Esc를 두 번 눌러야 지워지고, ctrl+y로 되살릴 수 있습니다.
• claude attach와 claude agents 세션에서 백그라운드로 보내는 키가 동작하지 않던 문제 수정. Ctrl+B d로 분리하려면 Ctrl+B 뒤 800ms 안에 d를 누릅니다.
• otlp exporter에 endpoint만 있고 OTEL_EXPORTER_OTLP_PROTOCOL이 없으면 OpenTelemetry 내보내기가 알림 없이 실패하던 문제 수정. 이제 기본값 http/protobuf를 씁니다.
• 기본 localhost:4318 endpoint로 보내는 OpenTelemetry 내보내기가 설정된 프록시를 거치던 문제와 OTEL_RESOURCE_ATTRIBUTES 항목 하나가 잘못되면 그 변수의 속성이 모두 빠지던 문제 수정.
• OTEL_LOG_ASSISTANT_RESPONSES=0인데도 OpenTelemetry user_prompt 이벤트에 백그라운드 에이전트의 응답이 기록되던 문제 수정.
• 프록시가 수집기에 연결하는 데 10초 넘게 걸리면 OpenTelemetry 내보내기가 실패하던 문제 수정. 이제 25초까지 기다리며, OTEL_EXPORTER_OTLP_TIMEOUT의 최댓값도 30초에서 25초로 바뀌었습니다.

Windows

• 같은 PATH 폴더에 .exe와 함께 있는 .cmd, .bat 래퍼(예: git.exe 옆의 git.cmd)를 실행하던 문제 수정. 이제 cmd.exe처럼 .exe를 실행합니다.
• 폴더의 실제 경로를 확인할 수 없는 드라이브에서 셸 명령이 “Working directory was deleted”로 실패하던 문제 수정.

VS Code

• 도구 호출을 해석하지 못해 버려진 응답이 Claude가 다시 시도한 뒤에도 표시되던 문제 수정.
• 사용 크레딧이 꺼져 있을 때 “Buy usage credits on claude.ai” 버튼을 누르면 Fable 요금 지불에 동의한 것으로 처리되던 문제 수정.
• CRLF 줄바꿈 파일의 여러 줄 편집에서 diff 탭이 열리지 않던 문제와 세션을 바꾼 뒤에도 받아쓰기 녹음이 계속되던 문제 수정.

Claude Code on the web과 Claude Tag

• GitHub Enterprise Server의 pull request 업데이트가 클라우드 세션에서 github.com으로 연결되던 문제 수정. 새 업데이트는 사용자 서버로 연결됩니다.
• 아주 큰 GitHub Actions 작업 로그와 실행 로그 압축 파일을 내려받지 못하거나 잘리던 문제와 10분 넘게 걸리는 git clone, fetch가 마지막에 끊기던 문제 수정.
• 연결이 끊긴 카드의 Try again을 누르면 “Try again”이 메시지로 전송되던 문제 수정. 이제 다시 연결을 시도합니다.
• 예약 작업에서 저장소를 빼면 GitHub 트리거가 알림 없이 다른 저장소로 옮겨 가던 문제 수정.
• iOS 앱에서 저장소와 함께 시작한 새 클라우드 세션에 전용 브랜치가 생기지 않던 문제 수정.
• [Claude Tag] DM의 Approve and post 카드가 Claude가 게시할 수 없는 비공개 채널이나 Slack Connect 채널에서 표시되던 문제 수정.

알아두면 좋은 점

• Claude Code가 모르는 모델 ID를 쓴다면 이제 컨텍스트 창을 1M으로 가정합니다. 창이 더 작은 다른 회사의 모델은 가득 찬 뒤 모든 턴이 실패할 수 있으므로 미리 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 설정하세요.
• auto mode를 쓸 수 없는 환경에서 --permission-mode auto나 defaultMode: auto를 쓴다면 이제 Manual 모드로 시작해 먼저 묻습니다.
• Bash(NODE_ENV*)처럼 변수를 지정한 Bash allow 규칙은 이제 권한을 묻습니다. 샌드박스의 쓰기 권한을 심볼릭 링크로 주었다면 실제 경로로 바꾸고, 샌드박스 안의 git worktree add, move, remove는 실패하므로 밖에서 실행하세요.
• 프록시를 ALL_PROXY로만 지정했다면 조직 설정과 정책 요청에는 적용되지 않습니다. HTTPS_PROXY를 설정하세요.
• 내부 git 명령 아래에서 실행되는 credential helper나 훅이 Claude Code의 로그인 토큰, API 키에 의존했다면 더 이상 이 값을 받지 못합니다.
• subagentStatusLine 설정은 제거됐고, 플러그인의 agent 설정은 지원 중단됐습니다. mod의 engine.create에 *, 네임스페이스, 부정 패턴으로 건 훅은 이제 관찰만 하므로, $ 명사를 추가하거나 막으려면 이름으로 지정하세요.
• 셀프 호스팅 러너의 종료 코드를 확인하는 스크립트가 있다면 작업 지시가 교체돼 거부된 on-demand 러너의 종료 코드가 다시 1로 돌아갔습니다. 2.1.321과 2.1.322에서는 0이었습니다.
• 백그라운드 세션에서 /logout을 실행하면 컴퓨터의 모든 세션에서 로그아웃되고 저장된 MCP 로그인과 플러그인 비밀값이 지워집니다.
• Code Mode는 실험적 기능이며 기본으로 꺼져 있습니다.
• 이 글은 주요 항목만 정리했습니다. 전체 변경 목록은 GitHub 릴리스 노트에서 볼 수 있습니다.