"Claude Code 2.1.292가 2026년 10월 6일에 나왔습니다. 눈에 띄는 변경은 두 가지예요. Agent 도구에 effort 매개변수가 생겼고, 로컬 MCP 서버와 맺는 프로토콜 버전의 기본값이 바뀌었습니다. 직접 MCP 서버를 만들어 붙여 쓰는 개발자라면 한 번 확인해 볼 내용이라 공식 변경 로그 기준으로 정리했습니다.
이번 업데이트에서 바뀐 것
공식 변경 로그에 따르면 2.1.292의 주요 항목은 이렇습니다.
- Agent 도구에 effort 매개변수가 추가되어, 서브에이전트를 요청한 effort 수준으로 실행할 수 있습니다.
- 로컬(stdio) MCP 서버는 이제 프로토콜 버전 2026-07-28을 기본으로 협상합니다. 예전 방식이 필요하면 환경 변수 MCP_PROTOCOL_NEGOTIATION=legacy로 끌 수 있습니다.
- claude plugin install에 --marketplace 옵션이 생겼습니다. 마켓플레이스가 없으면 추가한 뒤 플러그인을 설치합니다.
- 과부하(529) 응답에 대한 재시도 대기 시간의 기준값을 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS로 정할 수 있습니다.
- HTTPS_PROXY를 설정했을 때 NO_PROXY가 Claude Code 자체 API 요청에서 무시되던 문제가 고쳐졌습니다.
변경 로그에는 이 밖에도 백그라운드 명령 처리와 관련된 수정이 함께 적혀 있습니다.
로컬 MCP 서버를 쓴다면 확인할 것
프로토콜 협상 기본값이 바뀐 만큼, 직접 만든 stdio MCP 서버가 있다면 새 버전으로 올린 뒤 도구 목록이 그대로 보이는지부터 확인하는 편이 안전합니다. 협상 때문에 문제가 생기면 MCP_PROTOCOL_NEGOTIATION=legacy로 기존 방식으로 돌려놓고 서버 쪽 SDK 버전을 올리는 순서로 접근할 수 있어요.
2026-07-28은 MCP 규격의 버전 날짜입니다. 서버를 만든 SDK가 이 규격을 지원하는지는 해당 SDK의 릴리스 노트에서 확인하세요.
환경 변수는 터미널에서 이렇게 한 번 지정해 두고 실행하면 됩니다.
export MCP_PROTOCOL_NEGOTIATION=legacy
변경 로그는 이 값을 기본 동작에서 빠져나오는 옵트아웃으로 소개합니다. 문제가 없다면 굳이 지정하지 않아도 됩니다.
Agent 도구의 effort 매개변수
서브에이전트마다 필요한 추론 강도가 다릅니다. 단순한 파일 검색에는 낮은 수준이면 충분하고, 설계 검토에는 높은 수준이 어울리죠. 2.1.292에서 Agent 도구가 effort 값을 받게 되면서 서브에이전트를 부르는 쪽이 이 수준을 정할 수 있게 되었습니다. 어떤 값을 줄 수 있는지는 공식 문서에서 모델별로 확인해야 합니다. 기본값이 어떻게 달라지는지는 변경 로그에 적혀 있지 않으므로, 이 글에서는 추측하지 않겠습니다.
그 앞뒤 버전에서 같이 알아 둘 것
2.1.292 직전과 직후에도 변경이 이어졌습니다.
- 2.1.293(10월 7일): Claude Haiku 5.5(claude-haiku-5-5)가 추가되어 Anthropic API의 기본 Haiku 모델이 되었고, HTTP MCP 연결이 보낸 요청을 닫을 때까지 계속 쥐고 있던 메모리 누수가 고쳐졌습니다.
- 2.1.290(10월 5일): claude attach와 claude logs가 세션 이름 일부만 입력해도 동작하고, WebFetch가 10만 자를 넘는 페이지 텍스트를 말없이 버리지 않고 읽지 못한 분량을 알려 줍니다.
- 2.1.288(10월 2일): /code-review에 --max-findings 옵션이 생겼습니다.
버전이 며칠 간격으로 올라가므로 업그레이드 전에는 변경 로그에서 자신이 쓰는 기능이 걸려 있는지 먼저 훑어보는 습관이 도움이 됩니다.
정리
로컬 MCP 서버를 쓰지 않고 서브에이전트도 직접 호출하지 않는다면 이번 업데이트가 작업 방식을 크게 바꾸지는 않습니다. 반대로 stdio MCP 서버를 운영 중이라면 프로토콜 협상 기본값이 바뀐 점이 이번 릴리스의 핵심입니다.
참고한 자료
- Claude Code 공식 변경 로그(2.1.288~2.1.293) https://code.claude.com/docs/en/changelog (확인일 2026-10-08)
- anthropics/claude-code, GitHub 릴리스 https://github.com/anthropics/claude-code/releases (확인일 2026-10-08)"