Claude Code v2.1.283 — 모델 거버넌스와 MCP 안정화, 그리고 구형 프롬프트 감사 기능

MCP 관련 픽스가 이번에도 네 건입니다. v2.1.283은 모델 접근 거버넌스, MCP 신뢰성, 그리고 **구형 모델용으로 작성된 프롬프트를 감사하는 /doctor prompt-audit**이 핵심인 정비 릴리스입니다.

한마디로 말하면, "어떤 모델 버전까지 허용할지"를 정밀 통제하는 관리 설정과, MCP 서버의 네 가지 끊김·유실 시나리오를 잡은 업데이트입니다.

모델 거버넌스 — exact 매칭과 블랙리스트

관리 설정 두 개가 추가됐습니다. **availableModelsMatch: "exact"**는 availableModels 항목이 이름에 적힌 모델 버전만 허용합니다 — 새 릴리스가 나와도 목록에 명시될 때까지는 차단됩니다. 보수적인 컴플라이언스 환경에서 "검증된 버전만 쓰게 하겠다"는 요구를 정확히 충족합니다. 반대로 **deniedModels**는 availableModels가 허용해도 특정 모델을 차단하는 블랙리스트입니다. 화이트리스트에 블랙리스트를 얹는 이중 통제가 가능해진 셈입니다.

MCP 안정성 4연타

이번에도 MCP가 다수입니다. 장시간 tool 호출이 백그라운드로 넘어간 뒤 progress 알림이 폐기되던 문제 — 이제 백그라운드 태스크가 최신 진행 상황을 보여줍니다. 세션이 종료될 때 아직 시작 중이던 stdio MCP 서버가 방치되던 좀비 프로세스 문제. 재배포 중인 프록시 같은 stateless 원격 MCP 서버가 일시적 404를 한 번 반환하면 세션 내내 사용 불가 처리되던 문제도 고쳐졌습니다. MCP를 붙였다 뗐다 하는 팀이라면 이 세 가지가 실사용 신뢰성을 바꿉니다.

/doctor prompt-audit — 구형 모델용 프롬프팅 감사

이번 릴리스의 이색 기능입니다. /doctor prompt-audit(/checkup prompt-audit 동일)은 CLAUDE.md, 스킬, 에이전트, 커맨드를 훑어 구형 모델을 위해 작성된 프롬프팅 패턴을 찾아냅니다. 모델이 빠르게 바뀌면서 예전에는 필요했던 지시("단계별로 생각해라" 같은)가 이제는 불필요하거나 역효과인 경우가 생기는데, 이 감사가 그런 낡은 패턴을 짚어줍니다. 지난주 제가 다룬 AGENTS.md 표준 지원(269-era~)과 맞물려, 지침 파일을 표준화하고 오래된 프롬프트 관행을 청소하는 흐름이 이번 주에 한꺼번에 정리된 셈입니다.

실전에서 어떻게 쓸까?

게이트웨이 운영자에게는 세 가지가 눈에 띕니다. load_test_mode 블록은 요청을 빌드·서명만 하고 업스트림으로 보내지 않는 캔드 리플라이 모드라, 프로바이더 호출 없이 배포 부하 테스트가 가능합니다. mantle 업스트림 프로바이더로 Amazon Bedrock의 Mantle 엔드포인트도 지원됩니다. 그리고 게이트웨이 힌트 헤더에 **x-claude-code-prompt-id**가 추가돼 하나의 사용자 프롬프트를 서빙하는 요청들을 그룹핑할 수 있습니다 — 힌트 헤더는 기존과 같이 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1로 옵트인합니다.

마무리로 — 모델 거버넌스(누가 무엇을 쓰는가)와 MCP 신뢰성(붙인 서버가 버티는가), 프롬프트 품질(지침이 낡지 않았는가). 에이전트 운영의 세 축을 한 릴리스에서 정리한 것이라, 조직 단위 Claude Code 운영자에게는 이번 주 최우선 업데이트입니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.283

태그: AI Claude Claude Code 개발도구