Claude Code 세션, 이제 자체 인프라에서 직접 실행 가능

현재 퍼블릭 베타로 공개된 자체 호스팅 환경을 통해 Claude Code 세션을 직접 구축한 인프라 위에서 실행할 수 있습니다. 웹, 모바일, 데스크톱, 또는 루틴에서 세션을 시작하면, Anthropic 호스팅 인프라가 아닌 내부 네트워크 안에서 사내 서비스, 툴체인, 보안 통제 환경과 함께 실행됩니다.

대부분의 기업에는 별도의 인프라 구축·운영 없이 바로 사용할 수 있는 호스팅 서비스를 강력히 권장합니다. 자체 호스팅 환경은 네트워크 정책, 툴링 요건, 또는 컴플라이언스 요건상 에이전트 실행을 자체 통제 인프라 내에 두어야 하는 팀을 위한 옵션입니다. 이 방식을 선택한다면, 초기 셋업과 지속적인 유지보수를 담당할 엔지니어링 인력을 확보하는 것을 미리 계획하세요.

자체 호스팅을 선택하는 이유

프리뷰 프로그램에 참여한 조직들이 자체 호스팅 환경을 도입한 주요 이유는 다음과 같습니다.

• 네트워크 접근: 세션이 내부 네트워크 안에서 실행되므로, 내부 서비스·데이터베이스·레지스트리를 퍼블릭 인터넷에 노출하지 않고도 접근할 수 있습니다
• 커스터마이징: 컴파일러, SDK, 사내 CLI 등을 환경에 미리 설치해두면 모든 세션이 바로 개발에 돌입할 수 있는 상태로 시작됩니다
• 컴플라이언스: 소스 코드와 빌드 아티팩트가 자체 통제 인프라 안에 머뭅니다

데이터는 자체 인프라에 보관됩니다

저장소 체크아웃, 빌드 아티팩트, 시크릿, 세션 중 생성되거나 수정된 파일은 모두 직접 프로비저닝한 인프라에 보관됩니다.

대화 내용 자체—프롬프트, 응답, 툴 실행 결과(Claude가 읽는 코드 포함)—는 추론을 위해 Anthropic으로 전송되며, 어느 인터페이스에서든 세션을 이어서 진행할 수 있도록 세션 기록이 저장됩니다.

동작 방식

자체 호스팅 환경에서는 러너(runner) 집합을 직접 배포합니다. 러너는 상시 실행되는 프로세스로, 세션 요청을 받아 각 세션마다 Claude Code 프로세스를 시작합니다. 러너는 두 가지 모드로 운영됩니다.

1. 고정(Fixed): 지정한 수의 러너를 상시 유지하고, 세션을 러너들에 분산 배정합니다.
2. 온디맨드(On-demand): 오케스트레이터가 대기 중인 세션을 감지해 세션이 들어오면 러너를 시작하고, 작업이 끝나면 중단합니다. 이를 통해 처리 용량이 실제 수요에 맞게 유연하게 조정됩니다.

러너 하나가 여러 세션을 처리할 수 있지만, 각 세션은 별도의 체크아웃 환경에서 실행되므로 개발자 간, 계정 간 작업이 격리됩니다. 지원하는 모든 인터페이스에서 시작된 세션이 동일한 환경으로 라우팅되므로, 한 번만 설정해두면 팀이 어디서 세션을 시작하든 동일하게 동작합니다.

참고: 자체 호스팅 환경은 원격 제어(Remote Control)와는 다릅니다. 원격 제어는 개발자가 자신의 머신에서 실행 중인 세션을 휴대폰이나 브라우저에서 이어서 진행하는 기능입니다. 원격 제어 세션은 해당 머신에서 세션이 종료되면 함께 종료되며 claude을 실행한 사용자에게 종속됩니다. 반면 자체 호스팅 환경은 플랫폼 팀이 운영하는 공유 인프라 위에서 세션을 실행하며, 모든 사용자가 이용할 수 있습니다.

시작하기

자체 호스팅 환경은 Claude Team 및 Enterprise 플랜 조직을 대상으로 퍼블릭 베타로 제공됩니다. 기본적으로 비활성화되어 있으며, ZDR을 사용하는 조직에는 제공되지 않습니다.

러너 이미지 빌드 및 유지보수, 러너 업데이트, 온디맨드 모드 사용 시 오케스트레이터 운영 등 초기 셋업과 지속적인 운영은 플랫폼 팀, 개발자 경험(DX) 팀, 또는 개발자 생산성 팀이 전담하도록 계획하세요.

자세한 내용은 공식 문서를 참고하세요. 피드백은 GitHub 또는 Anthropic 담당 팀을 통해 공유해 주세요.