Claude Code v2.1.280, Opus 5.5를 기본으로 탑재하고 1M 컨텍스트 지원

Claude Code v2.1.280이 출시되었으며, 가장 큰 변화는 모델 교체입니다: claude-opus-5-5가 이제 기본 Opus 모델입니다. Anthropic은 이를 1M 컨텍스트, Mtok당 $4/$20, 캐시 읽기 $0.20/Mtok으로 명시하고 있습니다.

MCP 설명을 위한 새로운 환경 변수

MCP 도구 설명과 서버 지침은 이전에 서버당 2,048자로 제한되었습니다. 이제 CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH로 이를 재정의할 수 있으며, 세션의 모든 MCP 서버에 적용됩니다.

심볼릭 링크 쓰기 처리

심볼릭 링크 경로를 통한 쓰기는 트리 내 표기법으로 판단되고 있었습니다. 이 문제가 수정되었습니다: 이제 프롬프트에 쓰기가 실제로 어디에 적용되는지 명시되며, acceptEdits, 허용 규칙, 자동 모드가 트리 외부에 적용되는 쓰기를 더 이상 승인하지 않습니다.

자동 모드 반복 중단

• 안전 검사가 작업 검토를 거부했을 때 자동 모드가 반복적으로 재시도했습니다. 이제 작업은 한 번 거부되며, 재시도해도 도움이 되지 않는다는 안내가 표시됩니다.
• 안전 검사가 응답하지 않았을 때 자동 모드가 일시 중지 없이 작업을 반복적으로 거부했습니다. 이제 재시도 간격이 늘어나며, 연속 10회 거부 후 턴이 메시지와 함께 중지됩니다.

도구 호출 유효성 검사

모델이 file_path와 content 대신 path, file_text, file_content 또는 잘못된 description을 보내도 쓰기 호출이 더 이상 유효성 검사에 실패하지 않습니다.

키 바인딩 및 터미널 수정

• 대부분의 대화 상자(/model, /effort, /config, /status, /usage, /plugin, /sandbox, /permissions, /artifacts, /mobile, /login, /upgrade, /usage-credits, /install-github-app, /setup-bedrock, /setup-vertex)에서 Ctrl+C 또는 Ctrl+D를 두 번 누르면 대화 상자를 닫는 대신 Claude Code가 종료되었습니다.
• 잘못된 n은 더 이상 대화 상자를 닫지 않으며 잘못된 y는 더 이상 대화 상자를 확인하지 않습니다. Enter와 Esc가 각각 확인 및 취소를 수행합니다. 이전 동작을 복원하려면 keybindings.json에서 y/n을 confirm:yes/confirm:no에 바인딩하십시오.
• 대화 상자의 텍스트 필드가 해당 키의 키 바인딩으로 인해 입력한 문자, 숫자 또는 Space를 잃고 있었습니다.
• Windows 터미널에서 Enter로 보이지 않는 문자를 제거한 후 프롬프트 줄이 뒤죽박죽으로 남았습니다. 이제 화면이 다시 그려져 전송되는 정확한 텍스트를 검토할 수 있습니다.
• 보이지 않는 문자 정리 기능이 페르시아어와 아랍어에서 라틴 문자나 숫자에 접미사를 붙이는 데 사용하는 제로 너비 비결합자를 제거하고 있었습니다.

음성 받아쓰기 및 캐싱

• Ctrl+C가 이제 음성 받아쓰기를 중지합니다(이전에는 프롬프트가 지워졌지만 마이크는 계속 녹음됨). Esc는 전사본 처리 중 취소합니다. Space를 길게 눌러도 더 이상 전사본 보기나 vim NORMAL 모드에서 받아쓰기가 시작되지 않습니다.
• 호스트 앱(Claude Desktop, VS Code, SDK)에서 Claude가 작업 중일 때 모델을 전환해도 다음 프롬프트에서 프롬프트 캐시 미스가 발생하지 않습니다.
• 재개된 포크 하위 에이전트가 원래 도구 목록을 재구성하는 대신 다시 전송하도록 변경되었습니다. 이전에는 해당 에이전트의 프롬프트 캐싱이 깨졌습니다.
• 하위 에이전트 반환 메시지가 상세 모드 외부에서 확장될 때 더 이상 내부 출처 서문을 표시하지 않습니다.

플러그인 및 스킬 수정

• GitHub 저장소 또는 브랜치나 태그를 추적하는 git URL에서 플러그인을 업데이트할 때 installed_plugins.json이 더 이상 설치 시점의 커밋을 유지하지 않습니다.
• ~/.claude/skills/의 스킬이 해당 폴더의 manifest.json에 이름이 나열되면 ~/.claude/skills/.trash/로 이동되고 있었습니다.
• 비활성화한 스킬이 이제 /plugin 및 /skills에서 로드에 실패한 플러그인에 사용되는 동일한 빨간색 ✘ 대신 흐린 ◯로 표시됩니다.

관찰 가능성 및 UI

hook_execution_complete OpenTelemetry 이벤트에 이제 후크 출력 크기와 파일에 저장된 초과 크기 출력 수가 포함됩니다. 마우스 지원이 전체 화면 모드에서 더 확장되었습니다: 휠이 /skills 목록을 스크롤하며 /plugin의 스킬 상태 옵션을 클릭할 수 있습니다. Home/End가 이제 /config 설정 목록과 /model, /memory 및 권한 프롬프트와 같은 선택 목록에서 작동합니다. /mcp, /plugin, /workflows의 다양한 테두리, 하이라이트 및 아이콘 일관성 버그도 패치되었습니다.

CI에서 또는 MCP 서버와 함께 Claude Code를 실행하는 경우, 자동 모드 재시도 변경 사항과 MCP 설명 재정의가 두 번 읽어볼 만한 두 가지 항목입니다.