무엇이 바뀌었나?
Claude Code 2.1.284가 2026년 9월 28일 출시됐습니다. 가장 큰 변화는 Claude Sonnet 5.5 추가입니다. Anthropic API에서는 이 모델이 기본 Sonnet 모델이 됩니다. 기본 권한 모드도 바뀌어, 권한 모드를 설정하지 않은 대화형 터미널과 VS Code 세션은 플랜, 제공자와 관계없이 auto mode로 시작합니다. Ultracode는 effort 단계에서 떨어져 나와 어떤 effort 수준에서도 켤 수 있는 별도 토글이 됐습니다. 수정 사항은 손상된 응답 스트림, 압축 후에도 남던 “Prompt is too long” 오류, MCP 서버 연결, 관리형 설정 아래의 플러그인 권한에 많이 모였습니다.
새 기능
-
Claude Sonnet 5.5 (
claude-sonnet-5-5)Anthropic API의 기본 Sonnet 모델이 Sonnet 5.5로 바뀝니다. 컨텍스트 창은 1M 토큰이고, 가격은 100만 토큰당 입력 $2, 출력 $10, 캐시 읽기 $0.20입니다.
-
auto mode의 “Yes, but ask again next time” 선택지
auto mode에서 작업 디렉터리 밖의 파일을 읽으려 할 때 나오는 확인 창에서는, 한 번 허용하면 이후 읽기도 계속 허용되는지 신경 써야 했습니다. 새 선택지를 고르면 이번 읽기만 허용하고 다음 읽기는 다시 묻습니다.
-
/mcp reconnect all연결에 실패했거나 인증이 필요한 MCP 서버가 여러 개면 하나씩 다시 연결해야 했습니다. 대화형 터미널에서 이 명령 하나로 모두 다시 시도합니다.
-
/effort슬라이더 단축키 재지정/effort슬라이더의 화살표 키와 Tab 키는 바꿀 수 없었습니다.effortSlider:decreaseEffort,increaseEffort,toggleUltracode동작이 추가되어keybindings.json에서 재지정할 수 있습니다. -
/rate-limit-options를/help와 명령 메뉴에 표시사용량 한도 안내가
/rate-limit-options를 언급해도 명령 목록에서 찾을 수 없었습니다. 이제 claude.ai 구독자에게는/help와 명령 메뉴에 나타납니다. -
Claude apps gateway 기능 추가
- 지출 한도 금액 표시: 게이트웨이가 이 버전 이상이면
/usage와 상태 표시줄에 “$271.40 / $500.00 spent this month”처럼 금액이 나옵니다. 상태 표시줄의rate_limits.spend_limit에도used_usd,limit_usd,period가 추가됩니다. - 시작 경고: 관리형 정책의
availableModels가 비어 있거나,model이나enforceAvailableModels를 지정하지 않은 채 Claude Code가 시작하는 모델을 목록에서 빼 두면 시작할 때 경고합니다. - Google Cloud로 텔레메트리 전송:
telemetry.forward_to대상에auth: { google: {} }를 지정하면 게이트웨이의 Google Cloud 자격 증명으로 Google Cloud의 OTLP 엔드포인트에 바로 보냅니다. - 인증서 기반 클라이언트 인증(
private_key_jwt): 클라이언트 시크릿 대신 인증서 자격 증명을 발급하는 ID 제공자(IdP)와도 연결할 수 있습니다.
- 지출 한도 금액 표시: 게이트웨이가 이 버전 이상이면
-
[VSCode] 기능 추가
- 각 프롬프트와 응답 위에 시각을, 날짜가 바뀌는 곳에 날짜 줄을 표시할 수 있습니다(Claude Code: Show Message Timestamps 설정, 기본값 꺼짐).
- Manage plugins 목록에 플러그인 로드 오류와 안내가 표시되고, 팝업에서 비활성화, 제거, 오류 복사를 할 수 있습니다.
- Effort 슬라이더 아래에 Ultracode 켜기/끄기 스위치가 생겨 슬라이더의 Ultracode 단계를 대신합니다. 모델 표시에는 effort 수준과 관계없이 ”· Ultracode”가 붙습니다.
-
[Claude Tag] 기능 추가
- 스레드, 채널 기본값, DM에서 “Opus (latest)” 같은 모델 계열을 고를 수 있습니다. 해당 계열의 최신 모델을 자동으로 따라갑니다.
- 분석 화면의 지출 예측 차트에 조직 전체 한도에 포함되는 지출과 한도 사용량이 표시됩니다.
주요 개선
-
사용량 한도 대기 화면 정리
한도 상태와 카운트다운이 여러 곳에 반복해서 표시됐습니다. 이제 한도 상태, 카운트다운, usage credits 선택지가 입력창 아래 한 블록으로 모이고 한도 메시지에서는 카운트다운이 빠집니다.
-
시작 시간과 메모리 사용량
설정 스키마 전체를 만들던 방식에서, 사용자의 설정 파일이 실제로 쓰는 부분만 만들도록 바뀌어 시작이 빨라지고 메모리 사용이 줄었습니다.
-
auto-memory 불러오기 보호
MEMORY.md와 불러온 메모에 보이지 않는 문자나 Claude Code 자체 마크업을 흉내 낸 태그가 섞여 있으면 Claude에 그대로 전달될 수 있었습니다. 이제 Claude에 전달되기 전에 무력화됩니다. -
관리형 로그인 요구 시 시작 거부 안내
관리형 설정이 로그인을 요구하는데(
forceLoginMethod,forceLoginOrgUUID) API 키, 토큰,apiKeyHelper가 설정돼 있으면 시작이 거부되지만 원인을 찾기 어려웠습니다. 이제 사용 중인 자격 증명, 설정된 위치, 제거 방법을 알려 줍니다. -
claude remote-control의 작업 공간 신뢰 확인아직 신뢰하지 않은 폴더에서 실행하면 바로 종료됐습니다. 이제 터미널에서 작업 공간 신뢰 여부를 묻습니다.
-
claude plugin marketplace add의 교체 안내같은 이름의 마켓플레이스가 다른 출처로 이미 추가돼 있으면 조용히 교체됐습니다. 이제 교체 사실과 되돌리는 방법을 알려 줍니다.
-
/claude-api개선hillclimb이 평가(eval)로 차이를 측정할 수 없을 만큼 작은 프롬프트 문구 수정에 반복 회차를 쓰지 않습니다.report.html외에 추가로 요청한 페이지는 네트워크에서 아무것도 불러오지 않는 로컬 파일 하나로 만들어집니다. -
아티팩트 관련 개선
- Claude가 디자인 계획을 답변이 아니라 페이지 안에 쓰고, 사용자가 이미 붙인 이름을 페이지 제목으로 사용합니다.
- claude.ai 채팅이나 프로젝트 링크, 채팅의 아티팩트, 아티팩트 ID만 받았을 때 Artifact 도구가 멈추지 않고 올바른 링크나 내용을 요청합니다.
-
기타 개선
- 접두어 없이 호출한 Claude in Chrome 도구의 “No such tool available” 오류가 호출해야 할 도구 이름을 알려 줍니다.
- Monitor 이벤트 행에 설명 반복 대신 각 이벤트가 출력한 내용이 표시되고, 바뀌지 않은 “Waiting for N … to finish” 줄이 이벤트마다 반복되지 않습니다.
/tasks,/copy,/hooks같은 목록에서 이름 뒤 세부 정보가 공간이 되면 한 열로 정렬되고, 공간이 부족하면 오른쪽 끝에 붙습니다.- Workflow 도구에서 비동기 스크립트 훅이 던진 오류에 대한 샌드박스 보호가 강화됐습니다.
- [Claude Tag] 관리자 설정의 “Notify members now”가 Enterprise Grid에서 조직이 등록한 모든 워크스페이스와 큰 워크스페이스의 더 많은 멤버에게 전달됩니다.
- [Claude Tag] 필요할 때 러너를 띄우는 self-hosted 환경에서 대기 안내가 러너가 시작 중인지, 다시 시도할지, 시작되지 않을지를 알려 줍니다.
- [Claude Tag] 채널 관리자 추가 실패 시 오류가 채널의 Slack 워크스페이스가 조직에 연결됐는지 확인할 수 없다는 원인을 알려 줍니다.
- [Claude Tag] 채널 액세스 목록에 자동 참여 패턴(auto-join pattern)이 붙이는 커넥터, 저장소, 플러그인과 그 출처가 표시됩니다.
- [Claude Tag] GitHub 로그인으로 저장소 관리자임을 확인할 수 없으면 페이지가 GitHub 로그인을 요청합니다.
동작이 바뀐 항목
-
모든 플랜, 제공자에서 기본 권한 모드가 auto mode (변경)
2.1.283에서 서드파티 제공자와 텔레메트리를 끈 환경에 적용됐던 auto mode 기본값이 모든 플랜과 제공자로 넓어졌습니다. 권한 모드를 설정하지 않은 대화형 터미널, VS Code 세션은 auto mode로 시작하며,
permissions.defaultMode를 지정하면 그 값이 우선합니다. -
Ultracode가
/effort의 별도 토글로 분리 (변경)Ultracode를 켜면 effort가 xhigh로 고정됐습니다. 이제
/effort에서 Tab 키나/effort ultracode [on|off]로 따로 켜고 끄며, 어떤 effort 수준에서도 켜진 상태를 유지합니다. -
연결 끊김 재시도 횟수 통합 (변경)
응답 도중 연결이 끊겨 다시 시도하는 횟수가 요청의 다른 재시도와 하나의 한도를 공유합니다. 계속 실패하는 요청은 더 빨리 포기합니다.
-
Sonnet 안전장치 알림 (변경)
Sonnet 모델의 안전장치(safeguards)가 메시지를 걸러 냈을 때 알림이 그 이유를 설명하고, 메시지를 고쳐 다시 시도할 수 있게 안내합니다.
-
Opus 고정 세션의 안전 관련 모델 전환 (변경)
ANTHROPIC_DEFAULT_OPUS_MODEL이나modelOverrides로 Opus 모델을 고정한 세션에서 안전 관련 이유로 모델이 전환될 때, Anthropic API에서는 고정한 모델로 전환하지 않고, 걸러 낸 유형마다 API가 전환할 모델을 고릅니다. -
비대화형 첫 턴의 MCP 연결 대기 (변경)
CLAUDE_CODE_MCP_STARTUP_WAIT_MS가0이어도,--allowedTools나mcp_tool훅이 지정한 MCP 서버가 연결 중이면 첫 턴이 최대 2초 기다립니다. -
전달된
/recap거절 (변경)채팅 스레드(본인 스레드 포함), 루틴, 웹훅에서 전달된
/recap은 짧은 안내와 함께 거절됩니다. 터미널, Claude 앱, Remote Control,-p, SDK 호스트에서 입력하면 이전처럼 실행됩니다. -
/artifacts필터 탭 (변경)필터 탭이 제목 옆에 한 단어 이름(All, Mine, Shared)으로 표시되며,
/config,/plugin과 같은 탭 표시줄을 씁니다. -
네트워크 공유 파일의 아티팩트 게시 거부 (변경)
\\host\share경로나/net자동 마운트처럼 네트워크 공유에 있는 파일은--add-dir로 추가한 네트워크 드라이브에 있지 않으면 게시가 거부됩니다. -
[VSCode]
CLAUDE_CONFIG_DIR적용 조건 (변경)claudeCode.environmentVariables설정의CLAUDE_CONFIG_DIR는 절대 경로일 때만 적용되고, 대화를 이어 가는 터미널에도 전달됩니다. -
[Claude Tag] 로그인 안내 반복 (변경)
Claude 계정을 연결하지 않은 사용자가 @멘션하면 첫 번째 이후에도 매번 비공개 로그인 안내를 올립니다.
주요 버그 수정
응답 스트림과 재시도
- 손상된 응답 스트림이 다시 시도되거나 중단된 응답으로 보고되지 않고, “JSON Parse error”, “undefined is not an object” 같은 원시 오류를 보여 주거나 답변에 “undefined”라는 단어를 쓰던 문제 수정.
- thinking 블록 직후 과부하 오류나 서버 오류가 오면 다시 시도하지 않고 턴이 오류로 끝나던 문제 수정.
- 압축 후에도 “Prompt is too long” 오류가 계속되던 문제 수정. 압축한 요청이 여전히 길면 최근 대화를 더 적게 남기고 한 번 더 압축합니다.
- 모델을 쓸 수 없고 대체 모델도 남지 않은 세션이 모델 사용 불가 안내와 Learn more 링크 대신 “is currently unavailable”(클라우드 세션에서는 “Something went wrong”)만 보여 주던 문제 수정.
- Agent SDK 세션에서 사용자 메시지의 이미지
source가 잘못되면 세션이 멈추고, 잘못된 문서 블록 이후 모든 턴이 실패하던 문제 수정. 잘못된 이미지는 설명 메모로 바뀝니다.
MCP 서버
- 재개한 세션에서 MCP 서버가 아직 연결 중일 때 도구 호출이 “No such tool available”로 실패하던 문제 수정. 서버를 최대 10초 기다립니다.
- 관리형 설정이 MCP 서버를 플러그인으로 제한할 때
claude mcp add가 성공으로 표시하고 절대 로드되지 않을 서버를 저장하던 문제 수정. 이제 거부하고 해야 할 일을 안내합니다. - Elicitation, ElicitationResult 훅이 돌려준
{"decision":"block"}이 무시되던 문제 수정. 종료 코드 2처럼 MCP elicitation(서버가 사용자 입력을 요청하는 기능)을 거절합니다.
플러그인과 마켓플레이스
- 관리형
allowManagedPermissionRulesOnly아래에서 마켓플레이스, claude.ai, npm 플러그인이allowed-tools로 자신의 도구를 미리 승인하던 문제 수정. 공식 Anthropic 출처나 관리형 설정이 보증한 출처의 플러그인만 미리 승인이 유지됩니다. - 의존성 버전 범위를 맞출 수 없어 첫
claude plugin install이 실패해도 플러그인이 활성화, 기록된 상태로 남던 문제 수정. /plugin설정 화면에서 불리언 옵션이 자유 입력이던 문제, 숫자 옵션이 잘못된 값을 받던 문제, ←/→ 키가 옵션 값을 바꾸지 않고 탭을 전환하던 문제 수정.- git 2.39 미만에서
sparsePaths마켓플레이스가 빈 상태로 복제되어 정상 로컬 사본을 대체하고, 새로 고칠 때마다 “marketplace.json file is no longer present”로 실패하던 문제 수정. - [Windows] 플러그인을 많이 켜면 Bash 도구가 실패하던 문제 수정. 없는 플러그인
bin/디렉터리는 PATH에 추가되지 않고, 상속된 항목도 두 번 추가되지 않습니다.
사용량과 모델
- plan-usage 엔드포인트가 속도 제한을 걸거나 로그인을 거부한 뒤에도 반복해서 호출되던 문제 수정.
/usage,/extra-usage, IDE 사용량 화면이 재요청 간격을 늘립니다. - 자동 사용량 한도 대기 중 메시지를 입력하면, 그 턴이 다시 한도에 걸렸을 때 대기가 “Continue automatically at usage limit” 설정의 제어를 벗어나던 문제 수정.
- 이미 최상위 Max 플랜인 사용자에게 사용량 한도 경고가
/upgrade를 권하던 문제 수정. 사용 가능하면 경고와/upgrade가/usage-credits를 안내합니다. - 프록시 뒤의 사용자 지정 모델처럼 Claude Code가 모르는 모델 ID로 세션을 실행하면 Explore 서브에이전트가 Claude API에서 Opus로 바뀌던 문제 수정. 이제 그 모델을 그대로 이어받습니다.
보안과 권한
ANTHROPIC_FOUNDRY_RESOURCE값이 검증 없이 Foundry 엔드포인트 호스트에 삽입되던 문제 수정. 단순한 리소스 이름이 아니면 거부됩니다.- 프로젝트 밖에서
.claude/rules로 심볼릭 링크한 규칙이 외부 가져오기 승인 창 없이 건너뛰어지던 문제 수정. 프로젝트 밖에서 심볼릭 링크한.claude디렉터리도 같은 승인을 요청합니다. - 홈 디렉터리에서 Claude Code를 시작한 경우 렌더러 전환이나 업데이트 후 작업 공간 신뢰 창이 다시 나타나던 문제 수정.
- [Linux] 작업 디렉터리가 쓰기 거부이고 그 안에 읽기 거부 디렉터리가 있으면 샌드박스 Bash 명령이 시작되지 않던 문제 수정.
- 아티팩트 데이터베이스 쓰기 결과가 사용자 개인 영역(
data/users/)에 쓴 내용도 모든 사용자에게 보인다고 Claude에 알리던 문제 수정.as_level에 “view” 수준도 추가됐습니다.
화면과 입력
- (macOS, Linux) 전체 화면에서 transcript 모드의
[로 대화를 스크롤백에 쓰면 세션 위쪽의 터미널 출력이 지워지던 문제 수정. - 전체 화면에서 위로 스크롤한 상태로 답변 스트리밍이 끝나면 스크롤 위치가 이전 메시지나 맨 아래로 튀던 문제 수정.
- 좁은 터미널에서
/config,/plugin같은 창의 탭 표시줄이 제목과 탭 이름을 단어 중간에서 자르던 문제 수정. 들어가지 않는 탭은 통째로 다음 줄로 넘어갑니다. /model선택기에서 마지막 모델까지 스크롤해도 목록 아래에 “+1 model”이 표시되던 문제 수정.- 셸 모드에서 ↓ 키가 숨겨진 백그라운드 작업 표시를 선택해 Backspace, Ctrl+U로 프롬프트를 편집할 수 없던 문제 수정.
/keybindings가 아무 동작도 하지 않는 하단 동작의 Backspace, Delete 바인딩을keybindings.json에 쓰던 문제 수정.- 재지정한 에이전트 패널 닫기 키(
footer:close)가 보고 있는 에이전트 행에서 그 키 대신 “x”를 입력하던 문제 수정. - 터미널이 포커스를 되찾는 순간 누른 키가 짧은 안전 지연이 다시 시작되기 전에 Remote Control 활성화 확인에 답하던 문제 수정.
vim 모드
- ssh, tmux처럼 매우 빠르게 입력하거나 bracketed paste 없이 붙여넣은 텍스트를
.가 반복하지 않던 문제, 입력 없는 변경(cw후 Esc 등)을 반복하면 프롬프트가 INSERT 모드에 남던 문제 수정. - 마지막 줄에서
dd, 프롬프트 끝에서yy후 커서가 이미지 자리표시자의 여는 괄호에 놓여r이나x로 이미지를 깨뜨리거나 지울 수 있던 문제 수정.
세션, 훅, Remote Control
- 훅이 stdout에도 출력하면 실패한 훅의 stderr가 디버그 로그에서 빠지고, 출력 없는 실패 훅은 아무것도 기록되지 않던 문제 수정. 실패한 훅은 상태 코드도 기록합니다.
- Claude Desktop처럼
SendMessage도구 없이 시작한 세션이 여전히 그 도구로 다른 세션에 메시지를 보내라는 안내를 받던 문제 수정. - Claude 앱에서 Remote Control로 보낸 사진이, 대기 중인 메시지를 편집하려고 터미널 프롬프트로 되가져오면 사라지던 문제와 캡션 없는 사진에서 커서가 한 글자 움직이던 문제 수정.
- self-paced 모드의
/loop상태 업데이트가 Claude의 추론 안에만 쓰여 화면에 보이지 않던 문제 수정. 각 업데이트와 루프 종료 결과를 보이는 텍스트로 씁니다. - (macOS, Linux) Claude 데스크톱 앱이 만든 git worktree에서 시작하면
/ultrareview가 작업 트리를 업로드하지 못하던 문제 수정. - Claude Desktop이 Claude apps gateway 뒤에 있으면 1M 컨텍스트 선택지가 없던 문제 수정. 게이트웨이가 1M을 지원하는 모델을 Desktop용으로 자동 표시합니다.
- ID 제공자가 많은 그룹을 나열하는 로그인에서 Claude apps gateway가 모든 요청에
431 Request Header Fields Too Large를 돌려주던 문제 수정. 요청 헤더를 256 KiB까지 받습니다.
[VSCode]
- Memory 창의 Reload Claude가 편집한 파일이 저장되기 전에 다시 시작하던 문제 수정.
- 복원된 탭이 다른 Claude 프로세스가 열어 둔 대화를 열던 문제 수정. 먼저 확인을 요청합니다.
- 서브에이전트가 작업 중이거나 섹션의 첫 단계가 화면에서 잘리면 펼쳐 둔 Focus view 섹션이 저절로 닫히던 문제 수정.
/model입력 후 Enter를 누르면 모델 선택기 대신 사용법 텍스트가 채팅에 출력되던 문제 수정.- Vertex, Bedrock, Foundry에서
/feedback을 보내면 거부되던 문제 수정. 터미널처럼 보고서를 이 컴퓨터에 저장합니다. - 창을 다시 불러온 뒤 로그인이 Python 확장을 최대 1분 기다리던 문제 수정.
- Restart Extensions 후 응답하지 않던 Claude Code 탭 수정. 이제 해당 대화로 다시 열립니다.
- 보낸 사람이 기록되지 않은 다른 에이전트의 메시지가 채팅에 원시 XML로 표시되던 문제, 다른 에이전트, 세션, 채널의 메시지가 다시 불러온 뒤 사라지던 문제 수정.
- 사용자가 직접 만든
/mcp,/config,/settings명령이 확장의 창에 가려지던 문제 수정. - 실행 중인 턴이 없을 때 Escape가 모든 백그라운드 에이전트를 멈추던 문제 수정.
- 플러그인 설치 링크가 이미 있는 같은 이름의 마켓플레이스를 대체하던 문제 수정.
- 메시지에 큰 텍스트 파일을 첨부하면 압축 후 “Prompt is too long” 오류가 나던 문제 수정.
- 경로에 ASCII가 아닌 문자, 공백, 괄호가 있는 파일의 채팅 링크가 열리지 않던 문제 수정.
[Cloud sessions]
- 오프라인 상태에서 루틴의 Edit, Duplicate 버튼이 아직 로딩 중이라고 표시되던 문제 수정. 이제 오프라인이라고 알려 줍니다.
[Claude Tag]
- GitHub Enterprise 호스트 이름에 밑줄이 있으면 이전 Claude in Slack 앱의 진행 카드와 링크 미리보기에서 저장소와 Create PR 버튼이 빠지던 문제 수정.
- 환경이 Claude 시작을 거부하는 채널에서 Claude가 아무 말도 하지 않던 문제 수정. 관리자에게 문의하라는 안내를 한 번 올리고, @멘션되면 다시 시도합니다.
[Code Review]
- 풀 리퀘스트에 GitHub App 이름으로 제출하지 않은 리뷰가 열려 있으면 Code Review가 완성된 리뷰를 올리지 못하고 포기하던 문제 수정. 먼저 게시를 다시 시도합니다.
알아두면 좋은 점
- Anthropic API의 기본 Sonnet 모델이 Sonnet 5.5로 바뀝니다 — 1M 컨텍스트, 100만 토큰당 입력 $2, 출력 $10, 캐시 읽기 $0.20입니다.
- 권한 모드를 지정하지 않은 대화형 터미널, VS Code 세션은 이제 모든 플랜과 제공자에서 auto mode로 시작합니다 — 이전 동작을 원하면
permissions.defaultMode를 명시합니다. - Ultracode는 더 이상 effort를 xhigh로 고정하지 않습니다 —
/effort ultracode on으로 켠 뒤 effort 수준을 따로 고를 수 있습니다. - 관리형
allowManagedPermissionRulesOnly를 쓰는 조직은 플러그인 도구 승인 방식이 달라집니다 — 공식 Anthropic 출처나 관리형 설정이 보증한 출처가 아닌 플러그인의allowed-tools미리 승인은 더 이상 적용되지 않습니다. - 연결에 실패한 MCP 서버가 여러 개라면
/mcp reconnect all을 사용합니다 — 연결 실패, 인증 필요 상태의 서버를 한 번에 다시 시도합니다.