Claude Code 2.1.287 한눈에 보기
Claude Code 2.1.287이 2026년 10월 1일 공개됐다.
이 글에서는 그중 사용자가 체감할 만한 변화 5가지와 업데이트 후 확인할 설정만 추려보았다.
1. Claude Mods 추가
플러그인이 Claude Code의 더 깊은 동작까지 바꿀 수 있게 하는 Claude Mods가 추가됐다. 릴리스 노트의 설명은 이 한 줄이 전부라 바꿀 수 있는 범위가 구체적으로 어디까지인지는 원문만으로는 알 수 없다. 대신 바로 다음 항목인 You should know가 "기본 제공 모드(built-in mod)"로 함께 나왔다.
플러그인 관리도 손봤다. 마켓플레이스가 플러그인을 무시하거나 거부하면 그 이유와 해야 할 일을 쉬운 말로 알려 준다. 플러그인 목록에는 의존성이 설치되지 않은 경우가 표시되고 업데이트 중 끝나지 않은 설치는 다시 시도한다.
2. You should know: 놓친 점을 짚어 주는 보조 에이전트
You should know는 기본 제공 모드다. 보조 에이전트가 작업을 옆에서 지켜보다가 사용자나 Claude가 놓칠 만한 것을 짚어 준다. Claude의 실수만이 아니라 사용자가 놓친 부분까지 대상으로 삼는다는 점이 핵심이다.
켜려면 /plugin enable cc-plugin-you-should-know@builtin을 입력한다. Anthropic이 직접 제공하는 퍼스트파티 세션이어야 하고 텔레메트리가 켜져 있어야 쓸 수 있다.
3. 위험한 명령의 확인 절차 강화
파일을 지우거나 덮어쓰는 명령에서 사람 확인을 건너뛸 수 있던 빈틈이 메워졌다.
- 위험한 삭제 명령: 루트(/)나 홈 폴더를 지우는 rm은 원래 항상 확인을 받는다. 그런데 같은 명령에서 출력을 ~나 와일드카드 경로로 보내면 이 보호가 풀렸고 이번에 고쳐졌다.
- 심볼릭 링크 우회: 저장소에 커밋된 심볼릭 링크를 거쳐 민감한 파일이나 작업 폴더 밖에 쓰려 하면, 실제로 쓰이는 위치를 밝히고 사람을 기다린다. ~ 대상이 있는 명령도 포함된다.
- 넓은 허용 규칙: Bash 전체 허용 규칙이나 허용 훅이 있어도, Claude Code 파일 도구가 아예 거부하는 파일(Anthropic 프로필 저장소, 자격 증명 파일)에 쓰는 셸 명령은 실행하지 않고 먼저 묻는다.
권한 확인 화면도 바뀌었다. "Contains simple_expansion" 같은 내부 파서 이름 대신 쉬운 설명이 나온다. 대기 중인 권한 요청은 오래된 것부터 보여 줘서 읽던 요청을 새 요청이 덮지 않는다. 카운트다운이 있는 요청만 예외로 맨 위에 뜬다.
4. 100만 토큰 컨텍스트가 기본값으로
Opus 4.7 이상 모델과 Fable은 Bedrock, Vertex, Foundry, Claude 앱 게이트웨이에서 [1m] 접미사 없이도 100만 토큰 컨텍스트를 기본으로 쓴다. 기존처럼 20만 토큰을 유지하려면 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 설정하면 된다.
모델 전환 관련 수정도 있다. claude.ai 로그인에서 /model로 고른 Fable은 이제 Opus·Sonnet처럼 최신 Fable을 따라간다. Opus 5.5와 Sonnet 5.5를 오갈 때 앞선 확장 사고가 사라질 수 있던 문제도 해결됐다.
5. 원격·클라우드 세션 안정화
Remote Control은 재연결 요청에 응답이 없으면 몇 분씩 메시지를 받지 못했는데, 이제 30초 뒤 포기하고 다시 시도한다. macOS에서는 Mac이 잠자기에 들어가면 세션이 작업 도중 멈추던 문제가 고쳐졌다.
클라우드 세션과 Remote Control에서 Claude가 파일을 보내는 과정도 안정됐다.
- 업로드가 30초 제한 직후에 끝나면 실패하던 문제를 고쳐 35초까지 기다린다.
- 시간 초과, 네트워크 오류, 502·503·504 오류로 실패하면 한 번 다시 보낸다.
- 한 변이 8,000픽셀을 넘는 PNG·JPEG·WebP 이미지는 축소본을 보낸다.
- Claude 앱에서 17~20개 파일을 첨부하면 앞의 16개만 전달되던 문제가 해결됐다. 이 밖에 압축 도중 세션이 재시작되면 클라우드 세션이 이전 대화를 잃던 문제가 고쳐졌다. VS Code 확장에는 실행 중인 명령이나 하위 에이전트를 백그라운드로 돌리는 "Run in background"가 추가됐다.
업데이트 후 확인할 점
MCP 서버 연결: 2025-11-25 프로토콜을 쓰는 MCP 서버가 로그인 등을 위한 URL 프롬프트를 띄울 수 있게 됐다. 원문은 업데이트 뒤 서버가 연결되지 않으면 해당 MCP 설정 항목에 "bareElicitationCapability": true를 넣으라고 안내한다. alwaysLoad를 false로 둔 서버는 이제 도구 전체가 도구 검색 뒤로 미뤄진다.
OpenTelemetry: user_prompt 이벤트에 prompt의 복사본인 prompt_text가 추가됐다. prompt를 지우거나 마스킹하고 있다면 prompt_text도 똑같이 처리해야 한다.
Windows: Bash 도구를 막으면 PowerShell 도구도 함께 꺼져 셸 도구가 하나도 남지 않는다. 이 경우 시작할 때 경고가 뜬다.
조작 방식: Windows·Linux의 오른쪽 클릭 붙여넣기와 Linux의 가운데 클릭 붙여넣기는 버튼을 뗄 때 실행되고 떼기 전에 포인터를 옮기면 취소된다. claude agents에서 보낸 답장은 대기열 메시지로 도착하며 작업 중 보낸 슬래시 명령은 /stop을 빼면 그 차례가 끝난 뒤 실행된다.
이 밖에 화면 낭독 모드 수정이 8건 들어갔다. 커서 위치, 변경된 줄 누락, 쓸모없는 키 안내, 스피너가 돌 때마다 반복해 읽던 문제 등이 정리됐다.
Claude Code 2.1.287 정리
Claude Code 2.1.287은 106개 항목 중 버그 수정이 60%를 넘는 정비형 업데이트다. 새 기능으로는 플러그인이 더 깊이 개입하는 Claude Mods와 그 위에서 도는 You should know가 들어왔다. 위험한 명령의 확인 절차가 단단해졌고 100만 토큰 컨텍스트가 기본값이 됐다. 원격 세션의 끊김과 파일 전송 실패도 줄었다. MCP 서버나 OpenTelemetry를 쓰고 있다면 업데이트 직후 설정부터 확인해 두는 편이 좋다.
