핵심 요약
self-hosted environments는 Claude Code 세션을 조직이 직접 마련한 인프라에서 실행하는 기능으로, 공개 베타로 제공됩니다. 웹, 모바일, 데스크톱, 예약 작업 등 어느 경로에서 세션을 시작하든 같은 환경으로 연결되므로 한 번만 설정해 두면 됩니다.
주요 기능
-
세션을 실행하는 runner를 직접 운영
기존에는 Claude Code 세션이 Anthropic이 관리하는 인프라에서 실행됐습니다. self-hosted environments에서는 조직이 runner를 직접 띄우고, 그 위에서 세션이 돌아갑니다. 네트워크, 도구, 컴플라이언스 요건 때문에 에이전트 실행을 직접 통제하는 인프라에 두어야 하는 팀을 위한 기능입니다.
-
사내 네트워크와 사전 설치된 도구
세션이 조직 네트워크 안에서 실행되므로, 내부 서비스, 데이터베이스, 레지스트리를 공개 인터넷에 노출하지 않고도 접근할 수 있습니다. 컴파일러, SDK, 사내 CLI를 환경에 미리 설치해 두면 모든 세션이 바로 빌드 가능한 상태로 시작합니다.
-
고정과 온디맨드, 두 가지 운영 방식
runner 운영 방식은 두 가지입니다. 고정(fixed) 방식은 정해진 수의 runner를 계속 띄워 두고 세션을 그 위에 분배합니다. 온디맨드(on-demand) 방식은 오케스트레이터가 대기 중인 세션을 감시해 세션이 도착하면 runner를 시작하고 작업이 끝나면 종료해, 용량이 수요에 맞춰 움직입니다.
-
세션별 체크아웃 격리
runner 하나가 여러 세션을 처리할 수 있지만, 각 세션은 자체 체크아웃에서 실행됩니다. 개발자와 계정 사이에 작업이 섞이지 않습니다.
-
데이터가 어디에 남는가
저장소 체크아웃, 빌드 산출물, 비밀 정보, 세션이 만들거나 수정한 파일은 모두 조직이 마련한 인프라에 남습니다. 프롬프트, 응답, 도구 실행 결과(Claude가 읽은 코드가 포함될 수 있음)를 포함한 대화 자체는 추론을 위해 Anthropic으로 전송되며, 세션 기록은 어느 환경에서든 세션을 이어받을 수 있도록 저장됩니다.
-
모든 시작 경로가 같은 환경으로
지원되는 모든 경로에서 시작한 세션이 같은 환경으로 연결됩니다. 한 번 설정해 두면 팀원이 어디에서 세션을 시작하든 동일하게 동작합니다.
알아두면 좋은 점
- 제공 범위 — Claude Team, Enterprise 플랜 조직을 대상으로 공개 베타로 제공됩니다. 기본은 꺼져 있으며, ZDR(Zero Data Retention)을 사용하는 조직에는 제공되지 않습니다.
- 운영 주체가 필요 — 플랫폼, 개발자 경험, 개발 생산성 중 한 팀이 설정과 상시 운영을 맡는 것을 전제로 합니다. runner 이미지를 만들고 유지하는 일, runner를 업데이트하는 일, 온디맨드 방식을 쓴다면 오케스트레이터를 운영하는 일이 여기 포함됩니다.
- Remote Control과의 차이 — Remote Control 세션은 해당 머신이 세션 실행을 멈추면 끝나고
claude를 실행한 사용자에게 묶입니다. self-hosted environments는 플랫폼 팀이 운영하는 공용 인프라에서 세션을 실행하며 어느 사용자든 사용할 수 있습니다. - 자세한 설정 방법 — 공식 문서에서 확인할 수 있습니다.