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

Claude Code 2.1.288

Ctrl+C로 지운 프롬프트를 위 화살표로 되살릴 수 있고, /code-review에 `--max-findings` 옵션이, 에이전트 화면에 Ctrl+F 세션 검색이 추가됐습니다. 응답 도중 API 시간 초과가 나도 턴이 실패하지 않고 이어지며, 수정은 세션 재개, auto mode, 플러그인, 권한 안전장치, 클라우드 세션에 집중됐습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.288이 2026년 10월 2일 출시됐습니다. 실수로 지운 프롬프트 복구, /code-review의 발견 개수 조절, 에이전트 화면의 세션 검색처럼 일상 사용을 돕는 기능이 추가됐습니다. 수정 사항은 응답 도중 시간 초과와 세션 재개(--resume)의 안정성, auto mode, 플러그인과 mod, 권한 안전장치, 클라우드 세션에 많이 모였습니다. 백그라운드 명령 시간 제한, claude project purge 명령 이름 같은 동작 변경도 있습니다.

새 기능

  • Ctrl+C로 지운 프롬프트 복구

    작성 중이던 프롬프트를 Ctrl+C로 지우면 되돌릴 방법이 없었습니다. 이제 빈 프롬프트에서 위 화살표(↑)를 누르면 지운 초안이 붙여 넣은 텍스트와 이미지까지 그대로 돌아옵니다.

  • /code-review의 --max-findings <n>|all

    /code-review는 정해진 개수까지만 발견 항목을 보고했습니다. 이제 --max-findings로 보고 개수를 늘리거나 줄일 수 있고, all을 주면 전부 보고합니다. 한 번 고른 값은 --max-findings default를 넘길 때까지 계속 사용됩니다.

  • 에이전트 화면의 Ctrl+F 검색과 Alt+↑/↓ 그룹 이동

    에이전트 화면에서 Ctrl+F로 이름을 검색해 세션을 찾고, Alt+↑/↓로 그룹 사이를 건너뛸 수 있습니다. 두 단축키와 이름 바꾸기 키는 keybindings.json에서 다른 키로 바꿀 수 있습니다.

  • MCP 서버의 추가 권한 요청 시 재인증 안내

    도구 호출 중 MCP 서버가 더 넓은 OAuth 권한 범위(scope)를 요구하면, 다시 인증하라는 안내가 표시됩니다.

  • mod용 $.ui.selection()

    mod가 사용자가 전체 화면 모드에서 마지막으로 선택한 텍스트를 읽을 수 있게 됐습니다. 선택 영역이 대화 기록의 한 행 안에 있으면 그 행 정보도 함께 돌려줍니다.

  • 클라우드 세션의 내장 gh api

    GitHub CLI가 없는 이미지로 실행한 클라우드 세션에서도 내장 gh api를 쓸 수 있습니다. 내장 gh api가 파일 이름, jq 필터, GitHub 오류에 들어 있는 제어 문자를 터미널로 그대로 보내던 문제도 함께 고쳐졌습니다.

  • 화면 낭독기 모드의 권한 모드 안내

    계획을 승인하면(Shift+Tab 포함) 바뀐 권한 모드를 화면 낭독기(screen reader)가 읽어 줍니다.

주요 개선

  • auto mode의 긴 대화 처리

    대화가 너무 길어지면 클라이언트 쪽 안전 분류기(classifier)가 검토하지 못해, 도구를 호출할 때마다 확인을 요청하거나 호출이 실패했습니다. 이제 이 경우 대화를 압축(compaction)한 뒤 계속 진행합니다.

  • Remote Control의 서버 인증 정보 만료 복구

    서버 인증 정보가 만료되면 갱신하는 동안 세션 연결이 끊길 수 있었습니다. 이제 갱신 중에도 연결이 유지되고, 서버 장애로 갱신을 포기하더라도 세션은 남아 있습니다.

  • 클라우드 세션의 첫 턴 속도

    새 대화의 첫 턴이 stdio MCP 서버의 연결을 기다렸습니다. 이제 설정에 alwaysLoad: false가 있는 stdio MCP 서버는 기다리지 않습니다.

  • 화면 낭독기 모드

    • 지운 단어처럼 짧은 안내가 금방 사라졌습니다. 이제 다음 키를 누르거나 그 위쪽 화면이 바뀔 때까지 표시됩니다.
    • 질문 창에서 답한 질문의 상자 옆에 “answered”라고 읽어 줍니다.

  • self-hosted runner의 내장 gh api

    거부된 gh 명령은 같은 동작을 하는 gh api 명령을 함께 보여 줍니다. --paginate가 저장소 목록의 모든 페이지를 따라가며, 안에서 다시 실행한 claude가 내장 gh api를 지우지 않습니다.

  • 기타 개선

    • You should know 노트가 결정의 책임 주체에 따라 “we”, “the main agent”, “you”로 구분해 말합니다.
    • 아티팩트 데이터베이스 쓰기가 크기 한도로 거부되면 한도 값과 공간을 확보하는 방법을 알려 줍니다.
    • 명령 일부를 실행 전에 확인할 수 없을 때 Bash 권한 확인 창이 더 짧은 이유를 표시합니다.
    • 조직이 사용 크레딧 요청을 꺼 둔 Team, Enterprise 멤버에게 표시되는 /usage-credits 메시지가 개선됐습니다.
    • [Claude Tag] Claude가 다른 채널의 관련 Slack 스레드를 읽기만 했더라도 계속 따라가, 그쪽 업데이트가 해당 스레드에 의존하는 대화로 전달됩니다.
    • [Claude Tag] 채널 Configure 페이지의 저장 오류가 개선됐습니다. 채널 지침이 너무 길면 줄이라고 안내하고, 접근 권한을 잃어 거부된 저장은 더 이상 다시 시도하라고 하지 않습니다.

동작이 바뀐 항목

  • 백그라운드 명령 시간 제한 (변경)

    백그라운드 명령의 시간 제한이 이제 무인 세션(-p, Agent SDK, CI, 클라우드)에만 적용됩니다. 터미널, 데스크톱 앱, VS Code 세션에는 제한이 없습니다.

  • auto mode 분류기의 모델 고정 무시 (변경)

    ANTHROPIC_DEFAULT_SONNET_MODEL이 Claude Sonnet 5.5나 Opus 5.5로 고정돼 있으면, 클라이언트 쪽 auto mode 분류기는 이 값을 무시하고 Claude Sonnet 5를 사용합니다.

  • claude project purge → claude purge (변경)

    명령 이름이 claude purge로 바뀌었습니다. 이전 이름도 동작하며 안내를 출력합니다.

  • 에이전트 화면 검색의 Enter 동작 (변경)

    n: 필터와 Ctrl+F 검색에서 Enter를 누르면 맨 위 행 대신 이름이 가장 잘 맞는 세션이 열립니다.

  • /autocompact 설정을 모델별로 저장 (변경)

    자동 압축 창(auto-compact window) 설정이 모델마다 따로 저장돼, 모델을 바꿔도 각 모델의 설정이 유지됩니다.

  • MCP URL 요청의 대기 방식 (변경)

    작업 완료 시점을 알려 줄 수 없는 서버의 URL 요청은 “I’m done, continue”를 누를 때까지 도구 호출을 멈춥니다. 브라우저에서 작업을 먼저 끝낼 수 있습니다.

주요 버그 수정

응답, 압축, 세션 재개

  • 응답 도중 API 시간 초과가 나면 턴 전체가 실패하던 문제 수정. 비대화형 세션과 서브에이전트는 받은 부분 응답에서 이어 가고, thinking만 있는 응답은 다시 시도합니다.
  • 마지막 답변의 토큰 사용량이 0으로 보고되면 긴 대화가 자동 압축 대신 “Prompt is too long”으로 실패하던 문제 수정.
  • 압축이 방금 복원한 파일과 다른 컨텍스트를 --resume이 가끔 빠뜨리던 문제 수정.
  • 재개한 세션이 턴의 마지막 응답을 저장하지 않아, 다음 --resume에서 프롬프트가 답 없이 표시되던 문제 수정.
  • 같은 세션이 불러오는 도중 파일을 다시 쓰면 잘린 대화 기록을 불러오던 문제 수정.
  • 2.1.286 이하에서 시작한 대화를 재개하면 이전 thinking이 빠지던 문제 수정.
  • 새 환경이나 모델 전환 직후 첫 요청이 서버 값 대신 내장 출력 한도와 자동 압축 창을 쓰던 문제 수정. 이 요청은 최대 1.5초 기다릴 수 있습니다.
  • 무인 세션(CLAUDE_CODE_RETRY_WATCHDOG)이 매우 긴 응답 스트림 실패 뒤 몇 시간씩 재시도하던 문제 수정. 이제 다시 스트리밍하고, 시간 초과가 세 번 나면 포기합니다.

모델과 프로바이더

  • Mantle이나 구조화된 출력(structured outputs)을 거부하는 게이트웨이 뒤에서 세션 제목, 메모리 불러오기, 프롬프트 훅이 실패하던 문제 수정. 구조화된 출력을 끄는 CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS가 추가됐습니다.
  • Bedrock 인증 정보 조회 중 Stop을 누르면 요청을 끝내지 않고 대체 모델로 세션을 옮기던 문제 수정.
  • 다른 Claude Code 프로세스가 로그인하는 중 노트북이 잠자기에서 깨어나면 gcpAuthRefresh/awsAuthRefresh 브라우저 로그인이 하나 더 열리던 문제 수정.
  • Claude 3 Opus, Claude 3 Sonnet 세션에서 PDF 전체가 대화에 들어간 뒤 모든 턴이 실패하던 문제 수정.

auto mode와 권한

  • bypassPermissions 모드나 셸 허용 규칙 아래에서 bash -c, sh -c 스크립트 안의 위험한 rm(/나 홈 디렉터리 대상 등)이 확인 없이 실행되던 문제 수정 (#96300).
  • 셸이 산술식으로 계산할 값을 BASHPID에 대입하는 명령을 확인 없이 허용하던 문제 수정. 이제 확인을 요청합니다.
  • PreToolUse, PermissionRequest 훅의 일치 확인이 실패하거나 도구 입력을 JSON으로 바꿀 수 없으면 훅을 건너뛰던 문제 수정. 이제 호출을 막습니다.
  • 샌드박스 자동 허용에서 따옴표 없는 구분자를 쓴 heredoc(python3 <<EOF)이, 본문이 일반 텍스트와 단순한 $VAR 참조뿐인데도 매번 승인을 요청하던 문제 수정.
  • 차단된 도구가 Bash가 아닌데도 auto mode 거부 안내가 Bash 권한 규칙을 가리키던 문제 수정.
  • Bedrock, Mantle에서 이전 모델(WebFetch 요약, sonnet 서브에이전트 등)로 요청한 뒤 auto mode가 남은 세션 동안 로컬 분류기로 바뀌던 문제 수정.
  • auto mode를 쓸 수 없을 때(disableAutoMode, 이전 모델 등) Claude in Chrome이 허용한 사이트에서도 스크린샷과 페이지 읽기마다 확인하던 문제 수정. 입력, 이동, JavaScript는 여전히 확인합니다.
  • permissions.blockReadsOutsideWorkingDirectories가 켜져 있으면 git 설정 파일에 대한 sandbox.credentials.files 항목이 적용되지 않던 문제 수정.
  • /login이 보안 저장소에 인증 정보를 저장하지 못했는데도 “Login successful”을 표시하던 문제 수정. 이제 실패를 보여 주고, 새 로그인이 적용되지 않았으면 재시도를 제안합니다 (#73861).
  • --bare 세션에서 /login이 세션이 읽지도 않는 로그인을 진행해 저장된 로그인을 덮어쓸 수 있던 문제 수정. 어떤 인증 정보가 동작하는지 알려 줍니다.

플러그인과 mod

  • Claude Code를 다시 시작하기 전에 그려진 화면에서 mod 버튼을 누르면 다른 버튼의 동작이 실행되던 문제 수정.
  • Code 요소 하나에 해석할 수 없는 diff가 있으면 플러그인 창이 아무것도 표시하지 않던 문제 수정. 이제 일반 코드로 표시합니다.
  • 플러그인 LSP 서버가 initializationOptions, settings에서 ${user_config.*}, ${CLAUDE_PLUGIN_ROOT} 자리 표시자를 값으로 바꾸지 않은 채 받던 문제 수정.
  • worktree에서 실행되는 서브에이전트에서 플러그인의 tool.call 훅 때문에 Bash가 실패하고 파일 검색이 엉뚱한 폴더를 읽던 문제 수정.
  • 2.39 이전 git(Ubuntu 22.04의 2.34 등)에서 git-subdir 플러그인 설치가 실패하거나 불완전한 플러그인을 캐시하던 문제 수정.
  • GitHub SSH 키가 없는 macOS, Linux에서 GitHub 소스 플러그인의 claude plugin install이 실패하던 문제 수정. 이제 HTTPS로 대신 복제하고 안내를 출력합니다.
  • owner/repo 마켓플레이스에서 SSH, HTTPS 가져오기가 모두 실패하면 두 번째 시도의 오류만 보이던 문제 수정. 두 오류를 모두 보여 줍니다.
  • --plugin-dir로 불러온 플러그인이 /plugin에서 “Configure options”를 표시하지 않던 문제 수정.
  • 플러그인의 타이머나 읽기 작업이 실행 중일 때 플러그인을 다시 불러오거나 끄면 백그라운드 세션이 끝나던 문제 수정.
  • 에이전트 팀에서 이름으로 실행한 플러그인 정의 에이전트가 자신의 프롬프트, 도구, disallowedTools, effort 대신 기본값으로 실행되던 문제 수정.
  • claude plugin test가 오래된 저장 설정만 읽고 mod가 원격으로 꺼졌다고 보고하던 문제 수정.

MCP, LSP, 훅

  • 원격 서버의 결과가 16MB를 넘거나 해석할 수 없으면 MCP 도구 호출이 가끔 두 번 실행되던 문제 수정.
  • Claude Desktop의 Code 탭에서 서브에이전트가 memory라는 이름의 사용자 MCP 서버 도구를 하나도 받지 못하던 문제 수정.
  • claude mcp serve의 Agent 도구가 사용 가능한 에이전트가 없다고 보고하고 모든 subagent_type을 거부하던 문제 수정.
  • 언어 서버가 동적 기능 등록을 쓰거나 응답을 멈추면 LSP 도구 호출이 끝없이 멈추던 문제 수정. 이제 60초 뒤 시간 초과됩니다(서버별 requestTimeout).
  • Write나 Edit로 범위 안의 파일을 만들거나 바꿀 때 경로 지정 .claude/rules와 하위 폴더 CLAUDE.md가 불러와지지 않던 문제 수정. 이전에는 Read만 불러왔습니다.
  • 백그라운드 에이전트가 실행 중인데 idle_prompt 알림 훅이 실행되던 문제 수정 (#93672).
  • 서브에이전트의 파일 접근으로 규칙이나 하위 CLAUDE.md가 불러와질 때 InstructionsLoaded 훅에 agent_id, agent_type이 빠지던 문제 수정. 이제 effort도 보고합니다.
  • OpenTelemetry claude_code.tool.blocked_on_user 스팬이 -p, SDK 세션과 PreToolUse 훅 승인에서 source나 decision을 unknown으로 보고하던 문제 수정.
  • -p나 중단된 턴에서 답이 없이 끝난 권한 요청이 tool_decision 이벤트를 남기지 않던 문제 수정.

클라우드 세션과 Remote Control

  • 새로 고른 모델로 다시 시작한 클라우드 세션이, 서버가 그 모델을 거부한 뒤에도 그 모델로 답하던 문제 수정.
  • 다시 시작한 클라우드 세션이 조직의 강제 모델 목록이 거부하는 모델을 복원하던 문제 수정.
  • 승인되지 않은 URL에 대한 WebFetch 권한 확인이 5분간 답이 없으면 Cowork 클라우드 세션이 계속 입력 대기 상태로 남던 문제 수정.
  • 다른 기기에서 시작한 Cowork 클라우드 세션에 휴대폰으로 참여하면 프롬프트 제안이 나타나지 않던 문제 수정.
  • Cowork 클라우드 세션의 Edit, Retry가 기록이 남아 있는데도 /compact 전에 보낸 메시지를 거부하던 문제 수정.
  • 아직 연결돼 있거나 다른 Claude Code 프로세스가 방금 다시 연결한 세션을 Remote Control 정리 작업이 보관 처리하던 문제 수정.
  • 다른 세션이 메시지를 보류했는데도 Claude가 전달됐다고 보고하던 문제 수정. 전달되지 않았다고 알리며 세션 이름을 밝히고, SDK 세션에서는 턴 도중에도 이를 알 수 있습니다.
  • [Cloud sessions] 관련 없는 보안 설정을 불러오는 중이거나 불러오기에 실패하면 Claude Code 관리자 설정의 Cloud sessions 스위치가 꺼진 채 잠기던 문제 수정.
  • [Cloud sessions] self-hosted runner가 시작 중일 때 Stop을 눌러도 대기 중인 메시지가 취소되지 않아, runner가 뜬 뒤 실행될 수 있던 문제 수정.

터미널과 접근성

  • 플러그인이나 mod가 프롬프트 위에 행을 표시하는 중 백그라운드 작업 창을 열면 전체 화면 세션이 “unrecoverable interface error”로 종료되던 문제 수정.
  • Claude Code가 스스로 다시 시작한 뒤(Claude apps 게이트웨이 첫 로그인, 프로바이더 설정, /tui) Windows에서 키보드가 동작하지 않던 문제 수정.
  • ctrl+enter로 대기 중인 메시지를 보낸 뒤 Interrupted 행에 “What should Claude do instead?” 안내가 표시되던 문제 수정.
  • 전체 화면 대화 기록 보기의 검색과 /theme 사용자 색상 검색에서 커서가 입력한 글자를 따라가지 않던 문제 수정.
  • 화면 낭독기 모드의 /permissions에서 규칙 번호를 입력하면 규칙이 선택되지 않고 검색 상자가 열리던 문제 수정.

기타

  • -p, SDK 같은 headless 세션이 timeout, systemd 같은 감독 프로세스가 SIGTERM과 SIGCONT를 함께 보내면 SIGTERM을 가끔 무시하던 문제 수정.
  • tools:에 Agent(...) 항목이 아주 많은 에이전트를 실행할 때 멈추던 문제 수정.
  • 플랫폼 전용 실행 파일 다운로드에 실패해 자리 표시용 claude만 설치됐는데도 npm 자동 업데이트가 성공으로 보고하던 문제 수정.
  • Team, Enterprise 요금제나 관리 설정이 있는 머신에서 Artifact 도구로 슬라이드나 디자인을 시작할 때 조직의 디자인 시스템이 빠지던 문제 수정.

[VSCode]

  • claude.ai 커넥터를 승인한 뒤에도 “Needs authentication” 상태로 남던 문제 수정. MCP 서버 창에 Check connection이 추가됐습니다.
  • 선택 기능인 New Conversation 단축키(Cmd/Ctrl+N)가 지금 있는 창이 아니라 보이는 모든 Claude 창에서 대화를 시작하던 문제 수정.
  • 채팅 창이 보여 주던 세션을 보관하면 다음 저장 세션을 재개하던 문제 수정. 이제 새 대화를 시작합니다.

[Claude Tag]

  • 자동으로 만들어진 채널 설정에서 항상 실패하는 “Remove this scope” 옵션을 관리자 설정이 보여 주던 문제 수정.

알아두면 좋은 점

  • Ctrl+C로 프롬프트를 지웠다면 빈 프롬프트에서 위 화살표(↑)를 눌러 되살릴 수 있습니다.
  • 백그라운드 명령 시간 제한은 이제 무인 세션(-p, Agent SDK, CI, 클라우드)에만 적용됩니다. 터미널, 데스크톱 앱, VS Code 세션에는 제한이 없습니다.
  • claude project purge는 claude purge로 바뀌었습니다 — 이전 이름도 동작하지만 실행할 때마다 안내가 출력되므로, 스크립트에서 쓰고 있다면 새 이름으로 바꿔 둡니다.
  • Mantle이나 게이트웨이에서 구조화된 출력이 거부된다면 CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS로 끌 수 있습니다.
  • ANTHROPIC_DEFAULT_SONNET_MODEL을 Sonnet 5.5나 Opus 5.5로 고정해 둬도 클라이언트 쪽 auto mode 분류기는 Claude Sonnet 5를 사용합니다.
  • /autocompact 설정은 이제 모델별로 저장됩니다 — 모델을 바꾼 뒤에는 해당 모델의 설정을 따로 확인합니다.