Claude Code v2.1.274, MCP 타임아웃 수정, 손상된 트랜스크립트 자가 복구, 시작 대기 제어 추가

Claude Code v2.1.274가 출시되었습니다. 대부분 버그 수정 위주이고 몇 가지 새로운 설정이 추가되었습니다. MCP 수정과 트랜스크립트 자동 복구는 해당 오류를 겪어본 적이 있다면 꼭 읽어볼 만합니다.

새로운 설정 및 텔레메트리

• CLAUDE_CODE_MCP_STARTUP_WAIT_MS는 첫 비대화형 턴에서 MCP 서버 연결을 기다리는 최대 시간을 제한합니다. 0으로 설정하면 대기를 완전히 건너뜁니다.
• claude_code.llm_request OpenTelemetry 트레이스 스팬에 이제 effort 속성이 포함되어 기존 api_request 이벤트와 일치합니다.
• 새로운 OTel 이벤트 claude_code.managed_settings_resolved가 관리형 설정 소스와 정책 헬퍼 상태를 보고합니다. 삭제 처리된 설정과 다이제스트는 OTEL_LOG_MANAGED_SETTINGS=1이 필요합니다.
• 메모리 사용량이 위험 수준에 도달하면 메모리 확보 또는 안전한 재시작 단계가 포함된 경고가 표시됩니다.

MCP 수정 사항

• 레거시 HTTP+SSE만 지원하는 http로 구성된 MCP 서버가 첫 요청에 422 또는 다른 4xx로 응답할 때 더 이상 연결에 실패하지 않습니다.
• 서버별 timeout을 더 길게 설정한 경우 Streamable HTTP MCP 도구 호출이 약 5분 후 타임아웃되지 않습니다.
• 서버가 listChanged를 선언하지 않고 목록 변경 알림을 보낼 때도 프롬프트와 리소스가 새로 고쳐집니다.
• 403 insufficient_scope로 거부된 MCP 도구 호출이 더 이상 로그인 만료로 보고되지 않으며, 누락된 권한을 명시하고 /mcp 재인증을 안내합니다.

세션 및 트랜스크립트 수정 사항

• unexpected tool_use_id 400 오류를 무한히 재시도하던 세션이 가능한 경우 손상된 트랜스크립트를 자동 복구합니다. 그렇지 않으면 루프를 종료하는 /rewind 힌트와 함께 명확한 오류가 표시됩니다.
• 훅 기반 세션(예: 활성 /goal)이 반응형 컴팩션 후 컨텍스트가 다시 넘칠 때 "Prompt is too long"으로 종료되지 않고 컴팩션됩니다.
• 컴팩션된 세션 후 --continue / --resume으로 재개할 때 활성 /goal이 더 이상 손실되지 않습니다.
• CLAUDE_CODE_RESUME_INTERRUPTED_TURN으로 시작된 로컬 claude -p --resume이 이전 프로세스가 남긴 백그라운드 작업을 보고합니다.

게이트웨이 및 러너 변경 사항

• Claude 앱 게이트웨이 구성에 store.connect_timeout_seconds가 추가되어 Postgres 연결 타임아웃을 늘릴 수 있습니다(기본 5초). 데이터베이스 연결 불가 시 부팅 오류가 store.postgres_url과 구성된 타임아웃을 가리킵니다.
• Claude 앱 게이트웨이를 통해 전송되는 Claude Desktop 및 Cowork의 텔레메트리에 이제 IdP 주체인 enduser.sub가 포함됩니다.
• 게이트웨이는 복제본의 열린 요청이 한 번에 업스트림으로 보내는 256개를 초과하면 경고하고 시작 시 해당 한도를 로깅합니다.
• 자체 호스팅 러너 세션이 토큰 갱신 몇 번 실패 후 매 턴 401로 실패하지 않습니다. 계속 재시도하고 401 후 새 토큰을 가져옵니다.

기타 수정 사항

• claude agents가 자동 업데이트 재시작 후 --model, --effort, --permission-mode, --allow-dangerously-skip-permissions, --agent를 더 이상 잃지 않습니다.
• Bedrock, Vertex, Foundry에서 model: "opus"를 사용하는 서브에이전트가 모델 ID에 인식 가능한 패밀리가 없을 때 세션의 모델을 유지합니다(ANTHROPIC_DEFAULT_OPUS_MODEL이 설정되지 않은 경우).
• 언어 서버가 수천 개 파일에 대해 프로젝트 전체 진단을 게시하여 발생하는 턴별 지연이 수정되었습니다.
• file:// URI가 필요한 VS Code와 터미널에서 클릭 가능한 로컬 파일 경로 링크가 이제 작동합니다.
• 트랜스크립트가 더 이상 사용자의 순서 있는 목록 번호를 다시 매기지 않습니다(3. 2. 1.을 입력하면 3. 4. 5.가 아닌 3. 2. 1.로 표시됨).
• AskUserQuestion 미리보기 노트가 이제 강조 표시된 옵션에 첨부되고, 미리보기 모드에서 Enter로 제출할 때 강조 표시된 옵션이 더 이상 사라지지 않습니다.
• 백그라운드 에이전트 알림이 에이전트가 자체 작업을 기다리는 동안 더 이상 실행 중인 백그라운드 작업이 없다고 표시하지 않습니다.
• /schedule이 루틴의 프롬프트를 메시지 역할 없이 저장하지 않습니다.
• /status가 자체 배너에서 확인하라고 안내하는 apiKeyHelper 실패를 이제 표시합니다.
• 비대화형 모드에서 /fast on이 수정되었고, Claude Desktop 오류 힌트가 사용할 수 없는 CLI 플래그 대신 /usage-credits와 같은 슬래시 명령을 제안합니다.

이번 릴리스의 대부분은 표면적을 늘리기보다는 오래된 불편 사항을 수정하는 데 집중했습니다. Streamable HTTP로 MCP 서버를 운영하거나 /goal 기반 훅을 사용한다면 업그레이드하세요.