Claude Code v2.1.284부터 v2.1.288까지의 5개 버전 요약 노트

Claude Code v2.1.284부터 v2.1.288까지의 5개 버전을 정리했습니다. Anthropic Sonnet 5.5 추가, '기본적으로 auto mode 시작'으로 변경, 플러그인이 깊은 동작을 변경할 수 있는 Claude Mods (v2.1.287) 도입, /code-review --max-findings 및 agents view 검색 강화가 주요 하이라이트입니다.

Claude Sonnet 5.5 (v2.1.284)

claude-sonnet-5-5를 추가했습니다. Anthropic API의 기본 Sonnet 모델이 되었습니다 (1M 컨텍스트, $2/$10 per Mtok, 캐시 읽기 $0.20/Mtok)

auto mode가 기본적으로 시작됨 (v2.1.284 / v2.1.285)

• v2.1.284: 권한 모드 미설정 시, 대화 터미널과 VS Code 세션은 모든 플랜 및 모든 프로바이더에서 auto mode로 시작합니다 (permissions.defaultMode로 덮어쓸 수 있음) - v2.1.285: 서드파티 프로바이더 / 텔레메트리 비활성화 환경의 claude -p와 Python Agent SDK도 권한 모드 미설정 시 auto mode로 시작합니다 (--permission-mode로 덮어쓸 수 있음)

claude --desktop (v2.1.285)

• 현재 디렉토리에서 Claude 데스크톱 앱을 엽니다.
  --continue / --resume <id>와 병용하면 해당 세션을 엽니다.

claude purge (v2.1.288)

claude project purge를 claude purge로 변경했습니다 (구 이름도 알림과 함께 작동합니다).

Ultracode가 독립 토글이 됨 (v2.1.284)

/effort 내에서 Tab 또는 /effort ultracode [on|off]로 전환할 수 있습니다. xhigh effort를 강제하지 않으며, 모든 effort 레벨에서 유효합니다.

/code-review --max-findings (v2.1.288)

/code-review --max-findings all
/code-review --max-findings default

• 보고할 지적 사항 수의 상한을 변경합니다. 선택은 default를 지정할 때까지 유지됩니다.

/mcp reconnect all (v2.1.284)

• 연결 실패 또는 인증 대기 중인 MCP 서버를 일괄적으로 재시도합니다.

/autocompact의 모델별 저장 (v2.1.288)

• auto-compact 창을 모델별로 저장합니다. 모델 전환 시 각 설정이 유지됩니다.

백그라운드 명령어 시간 제한 (v2.1.285 → v2.1.288)

• v2.1.285: 백그라운드 Bash / PowerShell에 제한 시간을 도입했습니다 (기본 30분, 최대 2시간) - v2.1.288: 제한은 무인 세션 (-p, Agent SDK, CI, 클라우드)에만 적용됩니다. 터미널, 데스크톱, VS Code는 무제한입니다.

/resume로 백그라운드 세션을 열기 (v2.1.285)

`claude --resume <id>

• Elicitation / ElicitationResult 훅이 반환하는 {"decision":"block"}가 유효해져, exit code 2와 동일하게 MCP elicitation을 거부

Claude Mods (v2.1.287)

• 플러그인이 더 깊은 동작 변경이 가능한 'Claude Mods'를 도입했습니다.
• 내장 mod: You should know: 사이드 에이전트가 놓친 부분을 지적합니다. /plugin enable cc-plugin-you-should-know@builtin으로 활성화 가능 (퍼스트 파티 세션 텔레메트리 사용 시) - v2.1.288: mod용으로 $.ui.selection()을 추가했습니다 (전체 화면에서 마지막으로 선택한 텍스트를 반환).

claude plugin configure (v2.1.285)

claude plugin configure <plugin>
claude plugin configure <plugin> --values-stdin

• 옵션과 미설정 항목 표시, stdin으로부터의 값 저장에 대응합니다.
• claude plugin install --config로 <server>.<key>=<value> 형식이 사용 가능하며, 포함된 .mcpb MCP 서버를 /plugin을 열지 않고도 설정할 수 있습니다.

allowedProviders (v2.1.285)

• 기기에서 사용할 API 프로바이더(Anthropic API, 커스텀 엔드포인트, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform on AWS, Cloud gateway)를 제한하는 관리형 설정입니다.

샌드박스 설정 강화 (v2.1.285)

• 프로젝트 설정에서 관리자 필수인 샌드박스의 완화 및 비활성화, 관리자의 거부 목록 뒤의 프록시 대체 등이 불가능해졌습니다.

Claude apps gateway (v2.1.284)

• /usage와 상태 라인에 금액 표시 (rate_limits.spend_limit에 used_usd / limit_usd / period 추가) - telemetry.forward_to의 auth: { google: {} }, IdP와의 private_key_jwt 인증을 지원합니다.

• CLAUDE_CODE_DISABLE_WEB_FETCH (v2.1.285): WebFetch 도구를 비활성화합니다.

• CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES (v2.1.285): 비스트리밍 폴백의 재전송 횟수를 제한합니다.

• CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS (v2.1.288): structured outputs를 비활성화합니다 (Mantle 및 게이트웨이 대응). Opus 4.7+와 Fable은 Bedrock / Vertex / Foundry / Claude apps gateway에서 기본적으로 1M 컨텍스트가 제공됩니다, [1m]
  (불필요: v2.1.287. CLAUDE_CODE_DISABLE_1M_CONTEXT=1로 200K)

• 커스텀 ANTHROPIC_BASE_URL 하에서도 1M 컨텍스트 모델은 1M을 사용합니다 (v2.1.285. 게이트웨이가 200K까지라면 /autocompact 200k).

• effortSlider:decreaseEffort / increaseEffort / toggleUltracode 추가 (v2.1.284) - agents view에서 Ctrl+F를 이용한 세션 이름 검색, Alt+↑/↓로 그룹 간 이동이 가능합니다. 이 기능들과 rename은 keybindings.json에서 재할당할 수 있습니다 (v2.1.288).

• agents view에 n:<text> 필터 (v2.1.287). v2.1.288에서는 Enter를 눌러 가장 일치하는 세션을 엽니다 - claude agents로부터의 응답은 큐 메시지로 도착하며, /stop

다른 슬래시 명령어는 턴 종료 후에 실행 (v2.1.287) - 서브 에이전트 뷰에서 Ctrl+Enter로 실행 중인 명령어를 백그라운드로 이동 (v2.1.286)

• 권한 프롬프트가 여러 개 중첩될 경우 '2 of 5'와 같이 개수 표시 (v2.1.286)

• Ctrl+C로 지운 프롬프트를 빈 상태에서 ↑를 눌러 복원 (붙여넣기 텍스트/이미지 포함) (v2.1.288)

• Ctrl+G의 외부 에디터에서 프롬프트 커서 라인 열기 (v2.1.286)

• 대기 중인 권한 프롬프트는 오래된 것부터 순서대로 표시 (v2.1.287)

• auto mode의 클라이언트 측 분류기가 대화가 너무 길어질 때 실패하지 않고 compact 처리 (v2.1.288)

• /hooks은 설정된 훅을 이벤트별로 목록 하나에 열기 (v2.1.286) -
  commit 전에 verify 스킬 실행을 Claude에게 지시 (프로젝트/사용자 스킬에 존재하는 경우) (v2.1.286) - 스크린 리더 모드 개선 (v2.1.287 / v2.1.288)

• 북마크 기능, 질문 카드 선택지 미리보기 (v2.1.286)

• 실행 중인 명령어 / 서브 에이전트를 'Run in background'로 백그라운드화 (v2.1.287)

• 메시지에 타임스탬프 표시 설정 (기본값 off), Ultracode의 온/오프 스위치 (v2.1.284)

• Manage plugins 다이얼로그에 옵션 폼, 진단 도구 추가 (Problems 패널 참조) (v2.1.285)

• v2.1.288: API의 중간 타임아웃으로 인해 턴이 실패하는 문제 수정 (비대화 세션과 서브 에이전트는 부분 응답부터 계속 진행) -
  v2.1.288: 마지막 응답의 토큰 사용량이 0일 때 'Prompt is too long'이 되는 문제 수정

• v2.1.288:--resume으로 compact 직후 복원된 파일이 누락되거나, 마지막 응답이 저장되지 않는 문제 수정 -
  v2.1.286:--resume/--continue가 병렬 도구 호출 후에 턴을 잃는 문제 수정 -
  v2.1.284: compact 후에도 'Prompt is too long'이 계속되는 경우, 추가로 compact하는 동작으로 수정 -
  v2.1.285: 출력 콘텐츠 필터에 의해 차단된 응답이 장시간 재시도되는 문제 수정 -
  v2.1.285: 실패하는 API 요청이 최대 21회 재시도되는 문제 수정 (v2.1.286에서 호출당 최대 14회로)

• v2.1.286: API가 기본 모델을 거부한 경우, 같은 계층의 이전 모델로 재시도

• v2.1.285: 동기 훅이 백그라운드 프로세스의 출력 유지로 인해 멈추는 문제 수정

• v2.1.288: 서버 결과가 16MB를 초과하거나 파싱할 수 없을 때, 도구 호출이 두 번 실행되는 문제 수정 -
  v2.1.287: 프로토콜 버전 변경 시 커넥터의 도구가 두 번 실행되는 문제 수정 -
  v2.1.286: MCP 에러 메시지가

와일드카드(wildcard) 리디렉션과 함께 사용될 때 always-ask가 해제되는 문제 수정 -
v2.1.285: PowerShell 도구의 권한 검사가 파서 실행 실패 시 deny/ask 규칙을 건너뛰는 문제 수정 -
v2.1.285 / v2.1.286: 로그 및 트랜스크립트에서 URL 비밀번호나 민감 정보 마스킹 누출 문제 수정 -
v2.1.284: allowManagedPermissionRulesOnly 하에서 플러그인이 allowed-tools를 통해 자신의 도구를 사전 승인할 수 있는 문제 수정 -
v2.1.285: Artifact의 allow 규칙이 작업 디렉터리 외부 파일을 확인 없이 공개할 수 있는 문제 수정

v2.1.288: 플러그인이나 mod가 실행 중 화면에 전체 화면 배경 작업 대화 상자를 열 때 'unrecoverable interface error'가 발생하는 문제 수정 -
v2.1.288: 경로 제한의 .claude/rules와 중첩된 CLAUDE.md가 Write / Edit에서도 로드되도록 수정 (이전에는 Read만 가능) -
v2.1.287: 스크롤 키 누름 중 저사양 기기에서 전체 화면이 비정상 종료되는 문제 수정 -
v2.1.284: vim 모드의 . 반복이나 dd / yy 이후 커서 위치 문제 수정 -
v2.1.284: 전체 화면으로 스트리밍 완료 시 스크롤 위치가 건너뛰는 문제 수정

v2.1.288: 플러그인 LSP 서버에 ${user_config.*} / ${CLAUDE_PLUGIN_ROOT}가 미치환되어 전달되는 문제 수정 -
v2.1.288: LSP 도구 호출이 무기한으로 멈추는 문제 수정 (60초로 타임아웃)
v2.1.288: git 2.39 미만에서 git-subdir 플러그인 설치가 실패하는 문제 수정 -
v2.1.288: SSH 키가 없는 환경에서 GitHub 플러그인 설치가 HTTPS로 폴백(fallback)하도록 수정 -
v2.1.285:GIT_SSH / core.sshCommand가 플러그인 설치 및 업데이트에서 무시되는 문제 수정

v2.1.288: 자체 재부팅 후 키보드가 작동하지 않는 문제 수정 -
v2.1.287: 입력이 파이프된 상태에서 대화형 claude가 멈추거나 충돌하는 문제 수정 (이유를 표시하고 종료)
v2.1.284: 플러그인이 다수 활성화되었을 때 Bash 도구가 실패하는 문제 수정

v2.1.288: claude.ai 커넥터가 인증 후에도 'Needs authentication' 상태로 남아있는 문제 수정 (Check connection 추가)
v2.1.287: 배경 에이전트 실행 중 명령어가 실패로 표시되는 문제 수정 -
v2.1.286: 동일한 대화가 사이드바와 탭에서 이중으로 열리는 문제 수정 -
v2.1.285: 슬래시 명령어(slash command)가 무관한 메뉴 항목에 fuzzy match되어 실행되는 문제 수정

이번 릴리스에서는 Sonnet 5.5 추가와 auto mode의 기본화로 일상적인 사용성이 크게 바뀌었습니다. 권한 모드를 명시하지 않은 환경에서는 동작이 달라지므로, 고정하고 싶다면 permissions.defaultMode을 설정해 주세요. 또한, Claude Mods 덕분에 플러그인 확장 범위가 넓어졌고, claude plugin configure나 allowedProviders 등 운영 측면의 정비도 진행되고 있습니다.