Claude Code 5월 업데이트, 게이트웨이 연동부터 프로젝트 초기화까지

2026년 5월 1일, Anthropic이 Claude Code에 대규모 업데이트를 배포했다. /model picker가 게이트웨이의 /v1/models 엔드포인트를 동적으로 조회해 사용 가능한 모델 목록을 자동으로 표시하는 기능, 프로젝트의 모든 Claude Code 상태(전사·태스크·파일 이력·설정 항목)를 삭제하는 claude project purge 명령어, ANTHROPIC_BEDROCK_SERVICE_TIER 환경변수로 Amazon Bedrock 서비스 티어를 선택적으로 지정하는 기능이 이번 릴리스의 핵심이다. 세 기능은 Claude Code를 엔터프라이즈 환경과 자체 호스팅 인프라에서 더욱 유연하게 활용할 수 있게 하는 아키텍처적 진전을 의미한다.

5월 1일 배포된 변경들

이번 업데이트는 단순한 버그 수정을 넘어 CLI 아키텍처의 확장성과 운영 유연성을 크게 향상시키는 변경들을 포함한다. 커스텀 게이트웨이 지원, 프로젝트 초기화 도구, Bedrock 통합 심화 등 실무 엔지니어들이 오랫동안 요청해온 기능들이 한꺼번에 반영됐다.

⤢✕

게이트웨이 /v1/models를 자동으로 찾아오다

이번 업데이트 이전에는 /model picker가 Anthropic 공식 API에서 제공하는 모델 목록만을 정적으로 표시했다. 자체 호스팅 Anthropic 호환 게이트웨이(LiteLLM, Portkey, OpenRouter 등)를 쓰는 팀이 자신들의 게이트웨이에서 제공하는 모델을 Claude Code UI에서 직접 선택할 수 없다는 불편함이 있었다. 업데이트 이후에는 ANTHROPIC_BASE_URL 환경변수가 Anthropic 호환 게이트웨이 주소를 가리킬 경우, /model picker가 해당 게이트웨이의 /v1/models 엔드포인트를 실시간으로 조회해 사용 가능한 모델 목록을 동적으로 표시한다. OpenAI API 호환 사양에서 표준화된 모델 열거 방식을 따른 것이다.

이 기능은 Claude Code를 폐쇄된 Anthropic 전용 도구에서 개방형 에이전틱 코딩 플랫폼으로 전환시키는 아키텍처적 결정이다. 팀 내 허용 모델을 게이트웨이에서 통제하고 개발자 도구는 게이트웨이가 허용하는 모델만 표시하는 모델 사용 정책 중앙화, 특정 모델만 사용하도록 게이트웨이에서 라우팅을 제어하는 비용 관리, 여러 모델을 동일 게이트웨이에 연결해 Claude Code UI에서 손쉽게 전환하며 비교 테스트하는 다중 모델 실험이 엔터프라이즈 환경에서 필요로 하는 시나리오다.

⤢✕

게이트웨이 모델 동적 탐색을 활성화하려면 셸 환경에 ANTHROPIC_BASE_URL 환경변수를 게이트웨이 주소로 설정하면 된다. LiteLLM 게이트웨이를 로컬에서 운용하는 경우 ANTHROPIC_BASE_URL=http://localhost:4000으로 설정하면 Claude Code가 해당 게이트웨이의 /v1/models를 자동으로 조회한다. 게이트웨이가 Anthropic API 호환 형식으로 모델 목록을 반환한다면 별도의 추가 설정 없이 동적 탐색이 작동한다.

claude project purge, 되돌릴 수 없는 초기화

claude project purge [path] 명령어는 지정된 경로(또는 현재 디렉토리)와 연관된 모든 Claude Code 상태를 삭제한다. 삭제 대상에는 대화 전사(transcripts), 태스크 기록(tasks), 파일 이력(file history), 설정 항목(config entry)이 포함된다. 실제 삭제 없이 어떤 항목이 삭제될지 미리 확인하는 --dry-run, 확인 프롬프트를 건너뛰고 즉시 실행하는 -y/--yes, 삭제할 항목을 대화형으로 선택하는 -i/--interactive, 모든 프로젝트의 상태를 일괄 삭제하는 --all 플래그를 지원한다.

⤢✕

새 프로젝트 시작 시 이전 대화 이력을 완전히 초기화하는 클린 슬레이트 확보, 비공개 저장소·기밀 프로젝트에서 사용 후 로컬에 남은 전사 데이터를 삭제하는 민감한 코드베이스 보안, 파이프라인 실행 전후로 상태를 초기화해 일관된 환경을 보장하는 CI/CD 환경 초기화, 장기간 축적된 전사 데이터를 일괄 정리하는 디스크 공간 관리가 활용 시나리오로 꼽힌다. 다만 claude project purge의 실행은 되돌릴 수 없다. --dry-run 플래그를 먼저 써서 삭제 대상을 확인하는 습관이 권장되며, 특히 --all 플래그는 모든 프로젝트의 이력을 일괄 삭제하므로 운영 환경에서는 신중하게 써야 한다.

Bedrock 서비스 티어를 헤더로 넘기다

Amazon Bedrock은 Anthropic Claude 모델을 세 가지 서비스 티어로 제공한다. default 티어는 표준 온디맨드 처리량을 제공하는 기본 설정이고, flex 티어는 배치 처리나 비실시간 워크로드에 최적화된 유연한 처리량 옵션이며, priority 티어는 보장된 처리량과 낮은 지연 시간을 제공하는 프리미엄 옵션으로 프로덕션 실시간 서비스에 적합하다. ANTHROPIC_BEDROCK_SERVICE_TIER 환경변수는 설정된 티어 값을 X-Amzn-Bedrock-Service-Tier HTTP 헤더로 변환해 Bedrock API 요청에 포함시킨다.

⤢✕

이 설계는 환경변수 기반 설정 분리(Environment-based configuration separation) 원칙을 따른다. Bedrock 티어 선택이 코드 변경 없이 배포 환경에 따라 달라질 수 있어, 개발 환경에서는 default 티어로, 스테이징에서는 flex 티어로, 프로덕션에서는 priority 티어로 운영할 수 있다. CI/CD 파이프라인에서 Claude Code를 활용하는 팀은 배치 코드 리뷰나 문서 생성 작업은 flex 티어로, 개발자가 실시간으로 쓰는 대화형 세션은 default 또는 priority 티어로 구성하면 비용과 경험 품질 모두를 최적화할 수 있다.

모델 선택 UX가 따라야 할 원칙

이번 업데이트는 에이전틱 코딩 도구에서 모델 선택 UX를 어떻게 설계해야 하는지에 대한 패턴을 보여준다. 정적 목록 대신 동적 탐색을 채택함으로써 Claude Code는 플랫폼 의존성을 줄이고 사용자의 인프라 선택을 존중하는 방향으로 진화했다. 사용자가 수동으로 모델 ID를 입력하는 대신 도구가 연결된 서비스에서 가용 모델을 자동으로 가져오는 자동 발견(Auto-discovery), 프로젝트 유형·태스크 복잡도·비용 설정에 따라 적절한 모델을 기본으로 선택하는 컨텍스트에 맞는 기본값(Context-aware defaults), 설정 변경이 코드 수정 없이 환경변수로 가능해야 한다는 환경 기반 설정(Environment-driven configuration)이 좋은 에이전틱 도구의 모델 선택 UX가 따라야 할 원칙이다.

프로젝트 상태 관리가 성숙했다는 신호

claude project purge의 도입은 Claude Code가 프로젝트별 상태를 어떻게 관리하는지 보여준다. Claude Code는 각 프로젝트(저장소)마다 독립적인 상태 저장소를 유지하며, 이 상태에는 대화 전사, 파일 수정 이력, 태스크 실행 기록, 프로젝트별 설정이 포함된다.

⤢✕

이 아키텍처는 멀티 프로젝트 환경에서 컨텍스트 분리를 보장하는 동시에 긴 세션에 걸친 작업 연속성을 지원한다. project purge 명령어의 추가는 이 상태 관리 시스템이 충분히 성숙해 개발자 도구 차원에서 관리 인터페이스를 노출할 수 있는 단계에 이르렀음을 의미한다.

배포 전략에서 읽히는 설계 원칙

게이트웨이 /v1/models 연동은 ANTHROPIC_BASE_URL을 설정한 사용자에게만 새 동작을 활성화하고 기존 설정을 유지하는 사용자에게는 변경이 없는 옵트인(opt-in) 방식으로 새 기능을 도입해 기존 사용자 경험을 보호하는 하위 호환성 유지가 첫 번째 원칙이다. ANTHROPIC_BEDROCK_SERVICE_TIER처럼 새로운 동작을 코드가 아닌 환경변수로 제어하면 운영팀이 재배포 없이 설정을 변경할 수 있는 환경변수 기반 설정 분리가 두 번째 원칙이다. project purge는 되돌릴 수 없는 작업임에도 --dry-run, 확인 프롬프트, -y 강제 실행 플래그를 계층적으로 설계해 실수를 방지하는 동시에 자동화 스크립트에서도 활용 가능하게 한 파괴적 작업의 명시적 설계가 세 번째 원칙이다.

그 밖의 개선사항

이번 5월 업데이트에는 핵심 기능 외에도 다양한 개선사항이 포함됐다. OAuth 로그인 개선으로 SSH 세션에서도 인증이 원활하게 작동하게 됐고, Mac 슬립(sleep) 이후 세션이 끊기는 문제가 수정됐다. Windows PowerShell 환경에서의 여러 호환성 문제가 수정돼 Windows 사용자 경험이 개선됐고, 권한 처리(permission handling)가 강화돼 파일 접근 정책이 더욱 일관되게 적용된다. 텔레메트리 개선으로 사용 패턴 분석이 정밀해져 향후 기능 우선순위 결정에 활용될 예정이다.

2026년 5월 1일 Claude Code 업데이트는 에이전틱 코딩 도구가 엔터프라이즈 환경에서 어떻게 설계되어야 하는지에 대한 방향성을 제시한다. 게이트웨이 /v1/models 동적 탐색은 폐쇄된 플랫폼에서 개방형 생태계로의 전환을 의미하고, claude project purge는 도구가 자신의 상태를 투명하게 관리하고 개발자에게 제어권을 부여해야 한다는 철학을 반영하며, ANTHROPIC_BEDROCK_SERVICE_TIER 환경변수는 코드와 설정의 분리라는 DevOps 원칙을 AI 도구 차원에서 구현한 사례다.