Cmd. /remote-env
claude --remote로 시작하는 Claude Code on the web 클라우드 세션의 기본 원격 환경을 선택·확인하는 명령. 환경마다 네트워크 접근·환경 변수·셋업 스크립트를 제어하며, 생성·편집은 웹 인터페이스에서 한다
핵심 요약
/remote-env는claude --remote로 시작하는 클라우드 웹 세션이 사용할 기본 원격 환경을 선택·확인하는 명령이며, 환경이 하나뿐이면 현재 구성만 보여 준다.- 환경의 추가·편집·보관(archive)은 이 명령이 아니라 claude.ai 웹 인터페이스에서 수행한다.
- 각 환경은 네트워크 접근(None/Trusted/Custom),
.env형식 환경 변수, 세션 시작 전 한 번 실행되는 셋업 스크립트를 제어한다. - 별도 시크릿 저장소가 없어 환경 변수·셋업 스크립트는 환경을 편집할 수 있는 누구에게나 보이므로 민감 정보 주입에 유의한다.
- 이름이 비슷한
--remote-control(/rc)은--remote클라우드 세션과 무관한 로컬 세션 원격 제어 기능이다.
명령어 원본 선언
/remote-env공식 설명 요약
공식 문서의 정의는 다음과 같습니다.
Configure the default remote environment for web sessions started with
--remote. (--remote로 시작하는 웹 세션의 기본 원격 환경을 설정한다.)
/remote-env는 Claude Code on the web 클라우드 세션이
사용할 기본 환경(default environment)을 선택하는 명령입니다. 클라우드 세션은
claude --remote "..." 명령으로 시작되며, Anthropic이 관리하는 클라우드 인프라에서 실행됩니다.
핵심 동작은 다음과 같습니다.
- 터미널에서
/remote-env를 실행하면 현재 기본으로 지정된 원격 환경을 확인하고, 다른 환경으로 기본값을 바꿀 수 있습니다. - 환경이 하나뿐이라면, 이 명령은 현재 환경 구성을 보여 주는 역할만 합니다.
/remote-env는 기본값 선택만 담당합니다. 환경의 추가·편집·보관(archive) 은 웹 인터페이스(claude.ai)에서 수행합니다.
각 원격 환경은 다음 세 가지를 제어합니다.
- 네트워크 접근(Network access):
None/Trusted(기본) /Custom. 기본값인Trusted는 npm, PyPI, RubyGems, crates.io 등 허용 목록(allowlist) 도메인과 GitHub, 클라우드 SDK만 허용합니다. - 환경 변수(Environment variables):
.env형식으로 한 줄에KEY=value한 쌍. 값을 따옴표로 감싸지 않습니다(따옴표가 값에 포함됨). - 셋업 스크립트(Setup script): 세션 시작 전 한 번 실행되는 Bash 스크립트로 의존성 설치나 도구 구성에 씁니다(결과는 캐시됨).
최소 지원 버전
- 공식 명령 레퍼런스에 별도의 최소 버전(min-version) 표기가 없습니다.
--remote기반 웹 세션 기능과 함께 제공됩니다. - Claude Code on the web은 Pro·Max·Team 사용자 및 일부 Enterprise 좌석을 대상으로 한 리서치 프리뷰 단계입니다.
사용법
# 현재 기본 원격 환경 확인 / 다른 환경으로 기본값 변경
/remote-env# /remote-env로 지정한 기본 환경을 사용해 새 클라우드 세션 시작
claude --remote "Fix the authentication bug in src/auth/login.ts"좋은 사용 예
--remote세션을 자주 쓰기 전, 기본으로 쓸 환경을 미리 지정- 여러 환경(네트워크 레벨·환경 변수·셋업 스크립트가 다른)을 만들어 두고, 그중 기본값을 전환
- 환경이 하나뿐일 때 현재 구성(네트워크 레벨, 셋업 스크립트 등)을 빠르게 확인
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/remote-env | --remote 웹 세션의 기본 환경 선택·확인 | 클라우드 세션 환경 설정 |
/teleport (/tp) | 웹(Claude Code on the web) 세션을 현재 터미널로 가져오기 | 웹→터미널 세션 회수 |
/remote-control (/rc) | 로컬 세션을 claude.ai에서 원격 제어할 수 있게 노출(--remote와 무관) | 로컬 세션 원격 모니터링 |
활용 사례
- 재현 가능한 클라우드 개발 환경 표준화(네트워크 정책 + 셋업 스크립트 고정)
--remote로 병렬 작업을 돌리기 전, 공통 기본 환경 지정- 환경 변수·네트워크 허용 도메인을 환경별로 분리해 운영
주의사항
/remote-env는 기본값 선택 전용입니다. 환경의 생성·수정·보관은 웹 인터페이스에서 해야 합니다.- 별도의 시크릿 저장소가 아직 없습니다. 환경 변수와 셋업 스크립트는 해당 환경을 편집할 수 있는 사람 누구에게나 보입니다. 민감 정보를 환경 변수로 넣을 때 가시성에 유의하세요.
--remote-control(/rc)은 이름이 비슷하지만--remote클라우드 세션과 무관합니다. 혼동하지 마세요.- 네트워크 접근이
None이면 셋업 스크립트/훅의 패키지 설치가 실패합니다(레지스트리에 접근 불가).
출처
- Commands reference: https://code.claude.com/docs/en/commands
- Claude Code on the web (Configure your environment /
--remote): https://code.claude.com/docs/en/claude-code-on-the-web