Claude Code v2.1.285, 데스크톱 핸드오프, 플러그인 구성 CLI 및 공급자 제한 추가

Claude Code v2.1.285가 세 가지 새로운 CLI 기능과 함께 서브에이전트, 플러그인, MCP에 집중된 여러 수정 사항을 담고 출시되었습니다. CI에서 claude -p를 실행하거나 Claude Code를 SSH 중심 워크플로에 연결해 사용한다면, 이 중 몇 가지는 그 자체로 업그레이드할 가치가 있습니다.

새로운 환경 변수

• CLAUDE_CODE_DISABLE_WEB_FETCH — WebFetch 도구를 완전히 비활성화합니다. 신뢰할 수 없는 입력을 처리할 때 에이전트가 저장소에서 스크랩한 URL에 접근하는 것을 원하지 않는 경우 유용합니다.
• CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES — 타임아웃 후 비스트리밍 대체 요청이 재전송되는 최대 횟수를 제한합니다. 제한이 없으면 불안정한 엔드포인트가 상한 없이 반복 재전송을 유발할 수 있습니다.

플러그인 및 데스크톱 명령

claude --desktop은 현재 디렉터리에서 Claude 데스크톱 앱을 열거나, --continue / --resume <id>로 기존 세션에 연결합니다. 컨텍스트를 다시 설정하지 않고 터미널에서 GUI로 전환하는 경로입니다.

claude plugin configure <plugin>는 플러그인의 옵션을 출력하고 설정되지 않은 옵션을 표시합니다. --values-stdin을 추가하면 stdin에서 새 값을 읽어 저장하므로 플러그인 설정을 스크립트로 자동화할 수 있습니다.

claude plugin install --config는 이제 <server>.<key>=<value> 쌍을 받아들여, 번들로 제공되는 .mcpb MCP 서버의 자체 설정을 설치 시점에 지정할 수 있습니다. 설치 후 /plugin → Configure로 들어갈 필요 없이 해당 값으로 서버가 시작됩니다.

allowedProviders 관리형 설정

새로운 관리형 설정인 allowedProviders는 머신이 사용할 수 있는 API 제공자를 제한합니다: Anthropic API, 사용자 정의 엔드포인트, Bedrock, Mantle, Vertex AI, Foundry, AWS의 Claude Platform 또는 Cloud 게이트웨이입니다. 이는 플릿 정책을 위한 조정 장치로, 사용자별 설정에 의존하지 않고 빌드 머신이나 규제 환경을 하나의 제공자로 고정할 수 있습니다.

주요 수정 사항

• CLAUDE_CODE_FORK_SUBAGENT=1과 함께 claude -p 사용 시: 서브에이전트 자체의 Agent 호출이 이제 포그라운드에서 실행되어, 서브에이전트가 실제로 하위 결과를 받습니다.
• SSH를 통한 플러그인 및 마켓플레이스 설치가 이제 GIT_SSH 또는 core.sshCommand에 설정된 ssh 프로그램을 무시하지 않고 존중합니다.
• Claude Code는 이제 OS가 관리형 설정 파일 읽기를 거부해도 시작을 거부하지 않습니다. 경고하고 해당 정책 없이 시작합니다. 다른 읽기 오류와 파싱할 수 없는 파일은 여전히 모든 세션을 중단합니다.
• set_model 요청(예: Agent SDK의 setModel)을 통한 세션 중 모델 전환이 더 이상 새 모델을 재시작할 때까지 내장 출력 토큰 한도와 자동 압축 창에 고정시키지 않습니다.
• 수정된 로그와 트랜스크립트가 더 이상 @를 포함한 URL 비밀번호의 일부 또는 URL이 @를 %40으로 표기한 경우 전체를 유출하지 않습니다.
• 워크트리 및 /teleport 페치의 SSH 패스프레이즈 및 새 호스트 프롬프트가 이제 터미널을 탈취하지 않고 빠르게 실패합니다.
• SDK 및 -p 세션에서 세션 중 추가된 MCP 서버를 비활성화하면 이제 실제로 해당 도구가 제거됩니다.
• claude -p --permission-prompt-tool: 백그라운드 서브에이전트의 권한 요청이 자동 거부되지 않고 프롬프트 도구로 라우팅됩니다.
• claude mcp list, claude mcp get 및 mcp remove, login, logout의 찾을 수 없음 오류가 더 이상 MCP 서버 이름과 값에 포함된 줄 바꿈과 터미널 이스케이프 시퀀스를 출력하지 않습니다.
• Sandbox auto-allow가 python3 -c나 node -e 같은 인라인 스크립트에 =가 포함되어 있다는 이유만으로 매 실행마다 승인을 요청하지 않습니다.
• Fork 서브에이전트가 이제 dontAsk와 플랜 모드를 포함한 부모의 권한 모드를 상속하며, 플랜 모드를 종료할 수 없습니다.
• 자동 모드의 백그라운드 서브에이전트가 각 보고 후 더 이상 중복된 두 번째 응답을 요구하지 않습니다.
• 클라우드 세션 생성 및 /remote-env가 더 이상 계정의 최신 환경 20개만 읽지 않습니다.
• Remote Control은 메시지가 도착할 때가 아니라 Claude가 해당 메시지에서 시작할 때 읽음으로 표시하며, 터미널 종료 시 큐에 들어간 메시지가 이제 다음 재개 시 도착합니다.
• ID가 ., -, @ 또는 대문자만 다른 경우(macOS, Windows) 플러그인 설치가 거부되는데, 이전에는 다른 설치된 플러그인의 캐시나 데이터 폴더에 플러그인이 들어갈 수 있었습니다.
• ExitPlanMode의 훅 및 SDK 권한 콜백이 동일 응답에서 작성된 플랜을 더 이상 누락되거나 오래된 것으로 보지 않습니다.

2.1.283에서 도입된 회귀인 클라우드 세션의 첫 응답이 수십 밀리초 늦게 도착하는 문제도 수정되었습니다.