Claude Code v2.1.285 — allowedProviders로 프로바이더까지 통제, --desktop으로 앱 연결
AI

Claude Code v2.1.285 — allowedProviders로 프로바이더까지 통제, --desktop으로 앱 연결

zaq · · 4 min read

모델 거버넌스가 모델 수준에서 프로바이더 수준으로 확장됐습니다. v2.1.285의 allowedProviders 관리 설정은 "이 머신은 어떤 API 프로바이더만 쓸 수 있다"를 조직이 강제하는 기능이고, claude --desktop으로 터미널과 Claude 데스크톱 앱이 직접 연결됩니다.

한마디로 말하면, 283의 모델 버전 통제(availableModelsMatch·deniedModels)에 프로바이더 통제를 얹고, 터미널-데스크톱 경계와 플러그인 설정 UX를 정리한 엔터프라이즈 연속 릴리스입니다.

allowedProviders — 머신 단위 프로바이더 화이트리스트

관리 설정 allowedProviders는 Anthropic API, 커스텀 엔드포인트, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform on AWS, Cloud gateway 중 어느 것을 허용할지 제한합니다. 283의 availableModelsMatch: "exact"(모델 버전 핀닝)·deniedModels(블랙리스트)와 조합하면, "이 머신은 Bedrock만, 그중 이 버전만"이라는 이중 통제가 완성됩니다. 데이터 레지던시·컴플라이언스 요건이 있는 조직의 표준 구성이 될 수 있는 조합입니다.

claude --desktop — 터미널이 데스크톱 앱을 연다

claude --desktop을 실행하면 현재 디렉터리를 기준으로 Claude 데스크톱 앱이 열리고, --continue나 --resume <id>로 기존 세션까지 그대로 이어갑니다. 터미널에서 시작한 작업을 데스크톱 앱의 GUI 환경에서 이어가는 흐름이 공식 지원된 것입니다. 아울러 CLAUDE_CODE_DISABLE_WEB_FETCH로 WebFetch tool 자체를 끌 수 있고, 비스트리밍 폴백 요청의 타임아웃 재전송 횟수도 CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES로 상한을 둘 수 있습니다.

플러그인 설정 UX — 설치 시점에 설정까지

claude plugin configure <plugin>이 추가돼 플러그인의 옵션과 미설정 항목을 보여주고, --values-stdin으로 새 값을 저장할 수 있습니다. 더 실용적인 건 claude plugin install --config에 <server>.<key>=<value> 형식 지원입니다 — 번들된 .mcpb MCP 서버의 자체 설정을 설치 시점에 지정할 수 있어, 설치 후 /plugin → Configure 화면을 거치지 않고도 바로 시작됩니다. 플러그인 disable·enable 시 name@marketplace 전체 ID를 썼을 때 대소문자가 다른 설정 항목을 건드리던 버그도 수정됐습니다.

안정성 — managed settings 읽기 거부와 원격 첨부파일

OS가 관리 설정 파일 읽기를 거부하면 Claude Code가 아예 시작을 거부하던 문제가 바뀌었습니다. 이제 경고 후 해당 파일의 정책 없이 시작하되, 다른 읽기 오류와 파싱 불가 파일은 모든 세션을 중단시킵니다 — "읽기 거부"와 "파일 손상"을 구분한 세밀한 처리입니다. Remote Control로 보낸 메시지의 첨부파일이 다운로드 한 번 실패로 빠지던 문제도 네트워크·타임아웃·서버 오류 시 최대 2회 재시도하도록 개선됐습니다.

실전에서 어떻게 쓸까?

claude plugin configure로 설치된 플러그인의 미설정 옵션을 점검하는 루틴을 추천합니다. 조직 관리자라면 allowedProviders + 283의 모델 통제로 머신 단위 정책을 문서화해두는 것이 감사 대응에도 유리합니다. 플러그인 설치 자동화 스크립트는 --config에 서버 설정을 인라인으로 넣어 재설치 멱등성을 확보하세요.

마무리로 — 이번 주 흐름은 명확합니다. **통제(283·285), 신뢰성(282), 생태계(275·276)**가 번갈아 정리되는 가운데, 엔터프라이즈 기반이 두터워지고 있습니다. 플러그인·게이트웨이 운영자라면 285까지 업데이트하는 것을 권합니다.

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

태그: AI Claude Claude Code 개발도구