Claude Code 2.1.98 업데이트

💡

Google Vertex AI 설정 마법사, Perforce 모드, Monitor 도구, 서브프로세스 샌드박싱 등 보안 강화 및 신규 기능

🔗 공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.98이 2026년 4월 9일에 릴리스되었습니다. 보안 강화와 Bash 도구 권한 체계 개선, 그리고 Google Vertex AI·Perforce 등 다양한 개발 환경 지원에 초점을 맞춘 업데이트입니다.

새 기능

  • Google Vertex AI 설정 마법사

    Anthropic API 대신 Google Cloud의 Vertex AI를 통해 Claude를 사용하려면 GCP 인증, 프로젝트 설정, 리전 선택 등 여러 단계의 설정이 필요했습니다. 이제 로그인 화면에서 “3rd-party platform”을 선택하면 대화형 마법사가 GCP 인증 → 프로젝트/리전 설정 → 자격증명 검증 → 모델 고정까지 단계별로 안내합니다.

  • Perforce 모드

    Perforce(P4)는 파일을 수정하기 전에 반드시 p4 edit으로 체크아웃해야 하는 버전 관리 시스템입니다. 기존에는 Claude Code가 읽기 전용 파일도 그냥 덮어쓸 수 있어 P4 워크플로우가 깨질 수 있었습니다. CLAUDE_CODE_PERFORCE_MODE 환경 변수를 설정하면 읽기 전용 파일에서 Edit/Write 시 실패하면서 p4 edit 힌트를 제공합니다.

  • Monitor 도구

    백그라운드에서 실행 중인 스크립트나 프로세스의 출력을 실시간으로 스트리밍하는 도구입니다. 장시간 빌드나 테스트 등 백그라운드 작업의 진행 상황을 별도 터미널 없이 Claude Code 안에서 확인할 수 있습니다.

  • 서브프로세스 샌드박싱

    Linux 환경에서 Claude Code가 실행하는 서브프로세스의 보안이 강화되었습니다. PID 네임스페이스 격리로 서브프로세스가 시스템의 다른 프로세스를 볼 수 없고, CLAUDE_CODE_SCRIPT_CAPS 설정으로 세션당 스크립트 실행 횟수를 제한하여 악의적인 스크립트의 영향 범위를 줄입니다.

주요 버그 수정

보안

  • Bash 권한 우회 수정 — 백슬래시 이스케이프 플래그가 읽기 전용으로 자동 허용되거나, 복합 명령어가 강제 권한 프롬프트를 우회하던 문제가 수정되었습니다. Bash 도구의 권한 체계가 전반적으로 강화되었습니다.
  • 네트워크 리다이렉트 보안/dev/tcp//dev/udp/로의 리다이렉트 시 권한 프롬프트가 표시되지 않아, 네트워크 접근이 무단으로 이루어질 수 있던 문제가 해결되었습니다.

호환성

  • MCP OAuth 수정 — ADFS 등 IdP에서 토큰 갱신 시 oauth.authServerMetadataUrl 설정이 무시되던 문제가 수정되었습니다. 기업용 IdP 환경에서의 MCP 연결 안정성이 개선됩니다.
  • Kitty 키보드 프로토콜 — xterm과 VS Code 터미널에서 대문자 입력이 소문자로 변환되던 문제가 해결되었습니다.
  • macOS 텍스트 대체 — macOS 시스템 설정의 텍스트 대체 기능이 Claude Code에서 동작하지 않던 문제가 수정되었습니다.

알아두면 좋은 점

  • 이번 업데이트는 보안 강화에 비중이 큽니다. Bash 도구 권한 관련 여러 우회 경로가 차단되었으므로, 기존에 커스텀 권한 설정을 사용하던 경우 동작이 달라질 수 있습니다.
  • 스트리밍 응답 시간 초과 시 비스트리밍 모드로 자동 폴백되는 안정성 개선도 포함되어 있습니다.
  • Perforce를 사용하는 팀이라면 CLAUDE_CODE_PERFORCE_MODE 환경 변수 설정을 권장합니다.