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

Claude Code 2.1.282

넓은 터미널에서 Claude 답변 폭을 제한하는 `maxProseWidth` 설정과, 프로젝트 설정 파일에서 무시되거나 텔레메트리를 끈 변수를 알려 주는 시작 안내가 추가됐습니다. 버그 수정은 세션을 이어 가거나 재개할 때 이전 extended thinking이 사라지던 문제, 복호화할 수 없는 웹 검색 결과 때문에 모든 요청이 400 오류로 실패하던 문제에 집중됐습니다. 프로젝트 설정의 OpenTelemetry 변수 무시, `anthropic-skills`와 `claude-ai` 이름공간 제한 등 설정 동작도 바뀌었습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.282가 2026년 9월 24일 출시됐습니다. 새 기능은 답변 폭 제한, 텔레메트리 설정 점검, 관리형 설정과 Claude apps gateway 옵션에 모여 있습니다. 수정 사항의 중심은 이번에도 세션 재개입니다. 이어 가거나 재개한 대화, 도중에 슬래시 명령을 쓴 대화에서 이전 extended thinking(확장 사고, Claude가 답하기 전 거치는 추론 과정)이 사라지던 경우가 추가로 정리됐습니다. 보안 쪽에서는 프로젝트 설정 파일이 텔레메트리 전송 대상을 바꾸거나 anthropic-skills 이름을 빌려 쓰지 못하도록 설정 동작이 엄격해졌습니다.

새 기능

  • maxProseWidth 설정

    넓은 터미널에서는 Claude의 문장이 화면 끝까지 늘어나 한 줄이 지나치게 길어졌습니다. 이제 maxProseWidth로 설명 문장의 최대 폭을 정할 수 있습니다. 표와 코드 블록은 여전히 터미널 전체 폭을 사용합니다.

  • 무시된 텔레메트리 변수 안내

    프로젝트 설정 파일에 넣은 텔레메트리 변수가 적용되지 않거나 오히려 텔레메트리를 꺼도 알 방법이 없었습니다. 이제 시작 시 안내가 표시되고, /status와 claude doctor에서도 해당 변수 목록을 확인할 수 있습니다.

  • allowClaudeInChromeWithManagedMcp 관리형 설정

    조직이 배타적인 managed-mcp.json을 쓰면 claude --chrome을 함께 실행할 수 없었습니다. 이 설정을 켜면 둘을 함께 쓸 수 있고, Chrome이 막혔을 때 나오는 오류 메시지도 이 설정 이름을 알려 줍니다.

  • Claude apps gateway의 store.readiness_grace_seconds

    데이터베이스 장애 조치(failover)처럼 Postgres가 잠깐 끊기면 게이트웨이의 /readyz가 곧바로 준비되지 않은 상태로 바뀌었습니다. 이 값을 설정하면 짧은 중단 동안에는 준비 상태를 유지합니다.

  • /feedback 초안 목록의 스크롤바

    전체 화면 모드의 /feedback 초안 목록에 스크롤바가 생겼습니다. 마우스를 목록 위에 올리면 나타납니다.

  • [Cloud sessions] 저장소 연결 기능 추가

    • Settings › Connectors › GitHub에서 Claude GitHub App이 설치돼 있고 내 계정에서 접근 가능한지 확인하고, 연결, 설치, 재연결 방법을 안내받을 수 있습니다.
    • GitHub가 아닌 Git 서버에 호스팅된 저장소의 클라우드 세션 저장소 메뉴에 “Open repository”, “Open compare page” 링크가 추가됐습니다.
    • 이미 저장소가 연결된 실행 중인 클라우드 세션(Slack에서 시작한 세션 포함)에 포크의 원본(upstream)처럼 다른 GitHub 소유자의 저장소를 추가로 연결할 수 있습니다.

주요 개선

  • 매우 큰 세션 재개 속도

    매우 큰 세션은 재개가 느렸습니다. 이제 한 번도 압축(compact)하지 않은 세션을 포함해 더 빨리 재개됩니다.

  • Windows 재개 실패 오류 안내

    대화 기록 파일을 읽지 못해(EBADF) 세션을 재개할 수 없을 때 원인을 알기 어려웠습니다. 이제 가능한 원인과 시도할 방법을 함께 보여 줍니다.

  • Claude Desktop의 알 수 없는 모델 오류

    오류 메시지가 다른 모델로 바꿔 보라고 안내합니다.

  • 권한 확인 창의 특수 유니코드 표시

    흔하지 않은 유니코드 문자가 권한 확인 창에 더 정확하게 표시됩니다.

  • /artifacts 목록 정리

    제목이 한 열로 정렬되고, 세부 정보는 단어 중간에서 잘리지 않고 통째로 생략됩니다. PgUp/PgDn, Home/End, 마우스 휠과 클릭도 지원합니다.

  • claude-api 스킬 갱신

    출력 전 거부(refusal)의 과금 설명이 How refusals are billed 문서로 연결되고, 스트리밍 도중 거부는 일반 요금으로 과금되며 출력 전 거부는 속도 제한(rate limit)에 포함된다는 내용이 반영됐습니다. Managed Agents 리소스를 버전 관리되는 파일로 유지할 때 ant apply를 쓰도록 권장합니다.

  • [Cloud sessions] Routines 페이지 로딩

    예전 세션이 확인 알림(check-in)을 많이 예약한 계정에서 Routines 페이지와 사이드바의 Scheduled 목록이 더 빨리 열립니다.

동작이 바뀐 항목

  • 텔레메트리가 꺼져 있어도 서버 측 분류기 기본 사용 (변경)

    Anthropic API에 직접 연결하고 텔레메트리를 끈 환경에서도 auto mode가 기본으로 서버 측 분류기(classifier)를 사용합니다. 쓰지 않으려면 CLAUDE_CODE_AUTO_MODE_SERVER=0을 설정합니다.

  • 프로젝트 설정의 OpenTelemetry 변수 무시 (변경)

    저장소에 들어 있는 프로젝트 설정이 텔레메트리 내보내기를 켜거나, 전송 주소(endpoint)를 바꾸거나, 내용 수집을 켤 수 있었습니다. 이제 프로젝트 설정과 로컬 설정에 있는 CLAUDE_CODE_ENABLE_TELEMETRY, OTEL_LOG_* 같은 변수는 무시됩니다.

  • sandbox.excludedCommands 적용 범위 (변경)

    관리형 설정이나 --settings에서 allowUnsandboxedCommands: false를 지정했거나, 관리형 설정에서 allowManagedDomainsOnly: true를 지정했다면 프로젝트 설정과 로컬 설정의 excludedCommands 항목은 무시됩니다.

  • Windows/WSL 관리형 설정의 우선순위 (변경)

    관리자 정책(HKLM, managed-settings.json)이 있지만 잘못됐거나 읽을 수 없으면, 사용자가 쓸 수 있는 HKCU와 WSL의 /etc/claude-code 설정이 대신 적용되지 않습니다.

  • anthropic-skills, claude-ai 이름공간 제한 (변경)

    다른 스킬이나 플러그인이 이 이름을 빌려 claude.ai에서 동기화한 스킬처럼 보일 수 있었습니다. 이제 다음과 같이 바뀝니다.

    • Skill(anthropic-skills:*), Skill(claude-ai:*) 허용 규칙은 claude.ai에서 동기화한 스킬에만 적용됩니다.
    • 이 이름공간의 스킬 폴더, 명령 파일, 워크플로 명령은 더 이상 불러오지 않습니다. 같은 이름의 플러그인은 불러오지만 이름이 겹치면 동기화된 스킬이 우선합니다.
    • 이 이름으로 설정한 MCP 서버는 도구는 그대로 동작하지만 스킬과 프롬프트 목록을 보여 주지 않습니다. 다시 보려면 MCP 설정에서 서버 이름을 바꿔야 합니다.

  • ultracode 표시 단순화 (변경)

    /effort와 입력창의 ultracode 표시에서 물결, 테두리 장식, 키워드 반짝임 효과가 빠졌고, 동적 워크플로 스피너 팁도 제거됐습니다.

  • 시작 배너의 Clawd 마스코트 (변경)

    발이 몸통 모서리 아래에 오도록 바뀌었습니다.

  • [Claude Tag] Slack 카드 폭과 기본 모델 (변경)

    Slack 답변의 계획, 표, 세부 정보 카드가 좁은 폭 대신 넓은 폭으로 표시됩니다. 새로 연결한 Slack 워크스페이스는 연결 당시의 기본 모델에 고정되지 않고 현재 기본 모델을 따릅니다.

주요 버그 수정

세션 재개와 thinking 보존

  • API가 복호화할 수 없는 웹 검색 결과(예: 서드파티 게이트웨이로 응답한 턴)가 기록에 있으면 모든 요청이 400 오류로 실패하던 문제 수정.
  • --continue, --resume으로 이어 가거나 재개한 세션이 이전 메시지를 다른 형태로 다시 보내 API가 이전 추론을 버리던 경우 추가 수정.
  • Claude가 작업하는 동안 /model, /rename, /artifacts 같은 즉시 실행 슬래시 명령을 쓰면 이전 extended thinking이 사라지던 문제 수정.
  • 대화 앞부분에서 제공된 기본 도구를 빼고 --tools 목록을 지정해 다시 실행하면 이어 가거나 재개한 대화의 이전 extended thinking이 사라지던 문제 수정.
  • 매 턴 “Invalid data in redacted_thinking block” API 오류로 실패하던 문제 수정. 이제 대화의 thinking 블록을 제거하고 한 번 다시 시도합니다.
  • 요약 요청이 거부되면 압축(compaction)이 실패하던 문제 수정. 이제 대체 모델로 다시 시도합니다.
  • thinking을 끄고 effort를 high보다 높게 둔 세션에서 안전 관련 모델 전환 후 “Effort ‘xhigh’ isn’t available with thinking turned off”로 턴이 실패하던 문제 수정.

모델과 사용 크레딧

  • Claude Desktop 같은 SDK 기반 세션에서 Fable 사용 크레딧(usage credits) 안내에 답하지 않아도 모델이 전환되던 문제 수정. 이제 턴이 끝나고, Remote Control 클라이언트에도 모델 전환 안내가 표시됩니다.
  • 사용 크레딧이 필요한데 아직 켜지 않은 플랜에서 /model에 Fable 전체 모델 ID를 입력하면 크레딧 안내 대신 API 오류로 멈추던 문제 수정.

로그인과 조직 정책

  • 토큰을 갱신하던 다른 Claude Code 프로세스가 도중에 닫히거나 종료되면 최대 1분 동안 “another Claude Code process is refreshing it” 로그인 오류로 요청이 실패하던 문제 수정.
  • 다른 Claude Code 창이 로그인을 갱신하는 중에 시작한 세션(VS Code 창을 여러 개 열 때 흔함)이 조직 정책을 다시 불러오지 않던 문제 수정.

권한과 관리형 설정

  • 저장소 심볼릭 링크가 ..이나 /.vol 형태의 커널 경로를 거쳐 macOS의 /Network에 닿을 때 시작 시 CLAUDE.md와 규칙 파일을 그 경로로 읽던 문제, macOS /home을 가리키는 규칙 링크가 목록에 나오던 문제 수정.
  • 패턴 중간에 :*가 있는 Bash 권한 규칙이 --allowedTools에서는 적용되지만 설정 파일에서는 건너뛰어지던 문제 수정. 이제 어디에서 지정해도 적용되며, 어떻게 일치하는지 시작 시 경고로 알려 줍니다.
  • 원격 세션의 작업 프로세스가 재시작된 뒤 복원된 권한 확인 창에서 승인한 명령이 두 번 실행되던 문제 수정.
  • disableClaudeAiConnectors, allowManagedPermissionRulesOnly 같은 불리언 잠금 키에 값을 잘못 입력하면 관리형 설정이 이를 무시하던 문제 수정. 이제 잠금이 적용되고 시작 시 해당 키 이름을 알려 줍니다.
  • 관리형 permissions, autoMode, worktree, attribution 설정에서 중첩된 값 하나만 잘못돼도 블록 전체가 무시되던 문제 수정. 이제 나머지 값은 적용됩니다.
  • 관리형 allowManagedPermissionRulesOnly가 켜져 있어도 저장소, 사용자, --add-dir의 스킬, 명령, 스킬 디렉터리 플러그인 매니페스트가 allowed-tools로 자기 도구를 미리 승인하던 문제 수정.

서드파티 제공자

  • Amazon Bedrock과 Bedrock Mantle의 안전 장치(safeguard) 차단 메시지에 요청 ID가 표시되지 않던 문제 수정. 이제 메시지 ID도 함께 표시됩니다.
  • Vertex AI에서 새로 출시된 모델처럼 Claude Code가 아직 인식하지 못하는 모델에 웹 검색이 제공되지 않던 문제 수정.

도구 실행

  • Bash와 PowerShell이 디스크 할당량 초과를 “Exit code 1”로만 보여 주고 큰 출력 파일을 임시 폴더에 남기던 문제 수정.
  • 도구 입력 검증 오류가 알 수 없거나 빠졌거나 형식이 틀린 매개변수 하나만 알려 주던 문제 수정. 같은 호출의 다른 잘못된 매개변수도 함께 표시됩니다.
  • PDF 페이지 읽기 오류 메시지 수정. 악센트나 라틴 문자가 아닌 글자가 든 경로가 읽을 수 있게 표시되고, “password”나 “invalid” 같은 이름의 폴더 때문에 오류 원인이 잘못 안내되지 않습니다.

화면과 입력

  • 세션 도중 터미널의 bracketed paste mode(붙여넣기를 한 덩어리로 인식하는 모드)가 초기화되면 여러 줄 붙여넣기가 한 줄씩 제출되던 문제 수정.
  • SessionStart 훅이 있는 프로젝트에서 시작 시 입력창 예시 문구가 깜빡이고 사라지던 문제, 전체 화면 모드로 시작할 때 첫 화면 전에 빈 화면이 깜빡이던 문제 수정.
  • 전체 화면이 아닌 렌더러에서 화면이 짧아졌지만 여전히 터미널보다 길 때(셸 명령 출력이 흐르는 중 프롬프트 줄을 지울 때 등) 행이 뒤섞이던 문제 수정.
  • 다시 그린 줄의 한중일 문자나 이모지가 다음 행으로 넘어갈 때 diff 마지막 열에 이전 글자가 남던 문제 수정.
  • 탭 문자가 든 프롬프트를 기록에서 불러오면 커서가 끝보다 앞에 놓이던 문제 수정.
  • ctrl+enter를 줄바꿈으로 보내는 터미널(1.25 이전 Windows Terminal)에서 send now 안내가 ctrl+enter로 표시되던 문제 수정. 이제 ctrl+x ctrl+s로 표시됩니다.
  • 코드 블록이 목록 항목을 여는 경우(인용 안 포함) 화면 읽기 모드, 인용된 목록, 매우 긴 목록에서 코드 블록 맨 위 빈 줄이 사라지던 문제 수정.

명령과 플러그인

  • Remote Control 자격 오류가 --debug로 실행하라고 안내하는데도 claude remote-control --debug가 “Unknown argument: —debug”로 실패하던 문제 수정.
  • /install-github-app이 “cancelled”라고 표시한 뒤에도 브랜치를 push하고 API 키 시크릿을 저장하던 문제 수정. 이제 나가면 남은 단계를 멈추고 이미 끝난 작업을 알려 줍니다.
  • Bedrock, Vertex 등 서드파티 제공자에서 /feedback, /bug, /share 저장 중에 취소해도 보고서 파일이 저장되던 문제 수정.
  • 설정 파일이 아직 플러그인을 켜 두고 있거나 읽을 수 없는데도 플러그인 제거가 성공으로 표시되고 저장된 옵션을 지우던 문제 수정. 이제 중단하고 해당 파일을 알려 줍니다.
  • 제거 후 설치된 플러그인 목록을 읽지 못하면 플러그인의 저장된 옵션과 시크릿을 지우던 문제 수정. 이제 보존하고 그 사실을 알려 줍니다.
  • /skills에서 / 바로 뒤에 입력한 키가 검색창 대신 스킬 목록을 움직이던 문제, 입력 중 커서가 검색창에서 스킬 목록으로 튀어 캐럿이 가려지고 IME 입력이 엉뚱한 곳에 들어가던 문제 수정.
  • 스크롤바가 나타날 수 없는 전체 화면이 아닌 모드에서 /skills, /mcp 같은 목록이 두 칸 좁게 표시되던 문제 수정.
  • 이름이 긴 키로 단축키를 다시 지정하면 에이전트 패널 하단이 두 줄로 넘어가고, “Esc to collapse” 안내가 바꾼 접기 키를 반영하지 않던 문제 수정.
  • keybindings.json에서 전체 에이전트 중지 단축키를 해제하면 /tasks 대화상자 하단에 구분자 ·가 두 번 표시되던 문제 수정.
  • Claude가 60자를 넘는 버전 라벨을 붙이면 아티팩트 게시가 실패하던 문제 수정. 이제 라벨을 줄여서 게시합니다.

vim 모드

  • >>가 빈 줄까지 들여쓰던 문제, 줄보다 긴 횟수를 붙인 r이 텍스트를 바꾸던 문제, 2J가 한 줄을 더 합치던 문제, 마지막 줄에서 횟수를 붙인 2dd, 2>>가 줄을 옮기거나 지우던 문제 수정.
  • 커서 위치 오류 수정. dd, dj, dG, 줄 단위 p/P 뒤에는 첫 비공백 문자에 놓이고, yy는 커서를 움직이지 않으며, 이모지 뒤에서 Esc를 눌러도 커서가 이모지 안에 남지 않습니다.
  • x, s, p, d, c를 .으로 반복할 때 앞에 입력한 횟수를 무시하던 문제, 윗줄이 자동 줄바꿈되면 줄 단위 p/P, o, O, J, >>, <<가 엉뚱한 줄에 적용되던 문제 수정.
  • 기록에서 불러오거나 대기열에서 되돌린 프롬프트에서 normal 모드 커서가 끝을 넘어가 x가 동작하지 않던 문제 수정.

[VSCode]

  • 긴 답변이 스트리밍 속도를 따라가지 못하던 문제 수정. 패널이 업데이트마다 답변 전체를 다시 파싱하지 않습니다.
  • 입력창이 스크롤될 만큼 길어지면 받아쓰기 마이크 버튼이 입력창 스크롤바를 가리던 문제 수정.
  • 이 컴퓨터에서 시작한 Remote Control 세션이 세션 목록의 Web 항목에서 열리지 않던 문제 수정. 다른 곳에서 실행 중이 아니면 로컬 대화를 엽니다.
  • 확장 호스트가 재시작되면 편집기 탭의 로그인 화면이 조용히 멈추던 문제 수정. 이제 “stopped responding” 안내를 표시합니다.

[Cloud sessions]

  • 인도처럼 30분 단위 시차가 있는 시간대에서 매시간 루틴의 다음 실행 시각이 30분 어긋나 표시되던 문제 수정.

[Claude Tag]

  • Enterprise Grid 조직 전체 설치에서 워크스페이스별로 저장한 자동 참여 채널 패턴이 무시되던 문제 수정. 이제 패턴에 맞는 새 채널에 참여합니다.
  • 같은 조직의 두 워크스페이스가 공유하는 Enterprise Grid 채널에서, 채널의 Claude Tag 버전이 다른 워크스페이스에서 저장된 경우 Claude가 응답하지 않던 문제 수정.
  • GitHub Enterprise Server 저장소 세션에서 이전 Claude in Slack 앱의 진행 카드가 저장소 이름을 보여 주지 않고 Create PR 버튼이 동작하지 않던 문제 수정.
  • 모델이 지원 종료된 Slack 스레드가 답변마다 다른 모델로 대체되며 느려지고 대체 안내가 붙던 문제 수정. 이제 스레드가 동작하는 모델로 옮겨집니다.
  • Claude가 Slack에 올리는 파일의 캡션에 표를 넣을 수 없던 문제 수정. 캡션도 답변과 같은 서식으로 표시됩니다.
  • Slack의 Agents & tools 보기에서 Claude 스레드가 이름 대신 첫 메시지로 표시되던 문제 수정. 나중에 이름을 바꿔도 목록에 반영됩니다.
  • 연결이 끊긴 GitHub 조직의 권한을 액세스 번들의 Repositories 탭에서 제거하면 저장에 실패하던 문제 수정.
  • Claude가 추가되지 않은 Grid 워크스페이스와 공유된 채널에서 항상 “Couldn’t check this channel just now”라고 답하던 문제 수정. 이제 어느 워크스페이스에 앱이 필요한지 알려 줍니다.
  • 세션의 클라우드 작업 프로세스가 재시작된 뒤 답변 하단의 비용, 토큰 합계가 실제보다 몇 배 높게 표시되던 문제 수정.

알아두면 좋은 점

  • 프로젝트 설정의 텔레메트리 변수는 더 이상 적용되지 않습니다 — 저장소의 .claude/settings.json이나 로컬 설정에 CLAUDE_CODE_ENABLE_TELEMETRY, OTEL_LOG_* 등을 넣어 두었다면 이제 적용되지 않습니다. 무시된 변수는 시작 안내, /status, claude doctor에서 확인할 수 있습니다.
  • anthropic-skills, claude-ai 이름을 쓰는 스킬과 MCP 서버는 이름을 바꿔야 합니다 — 이 이름공간의 스킬 폴더와 명령 파일은 더 이상 불러오지 않고, 같은 이름의 MCP 서버는 스킬과 프롬프트 목록을 보여 주지 않습니다.
  • 패턴 중간에 :*가 있는 Bash 권한 규칙이 이제 설정 파일에서도 적용됩니다 — 그동안 건너뛰던 규칙이 새로 적용되므로, 시작 시 경고를 보고 의도한 범위인지 확인합니다.
  • 텔레메트리를 끈 직접 API 연결에서도 auto mode가 서버 측 분류기를 씁니다 — 원하지 않으면 CLAUDE_CODE_AUTO_MODE_SERVER=0을 설정합니다.
  • Windows 관리자 정책 파일이 잘못되면 사용자 설정이 대신 적용되지 않습니다 — HKLM이나 managed-settings.json이 손상된 경우 HKCU, WSL /etc/claude-code 설정도 무시되므로 정책 파일을 먼저 확인합니다.