Cmd. /remote-env
claude --remote로 시작하는 Claude Code on the web 클라우드 세션의 기본 원격 환경을 선택·확인하는 명령. 환경마다 네트워크 접근·환경 변수·셋업 스크립트를 제어하며, 생성·편집은 웹 인터페이스에서 한다
핵심 요약
- cloud agent 기본 environment 선택
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
cloud agent 기본 environment 선택
/remote-env사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 조건부 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
클라우드 세션 또는 루틴 접근 권한과 필요한 계정 연결을 확인합니다.
사용 예
/remote-env# 현재 기본 원격 환경 확인 / 다른 환경으로 기본값 변경
/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와 무관) | 로컬 세션 원격 모니터링 |
실행 결과와 유지 범위
CLI에서 새로 시작하는 클라우드 세션의 기본 환경을 선택합니다.
공식 문서의 정의는 다음과 같습니다.
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 스크립트로 의존성 설치나 도구 구성에 씁니다(결과는 캐시됨).
주의사항
/remote-env는 기본값 선택 전용입니다. 환경의 생성·수정·보관은 웹 인터페이스에서 해야 합니다.- 별도의 시크릿 저장소가 아직 없습니다. 환경 변수와 셋업 스크립트는 해당 환경을 편집할 수 있는 사람 누구에게나 보입니다. 민감 정보를 환경 변수로 넣을 때 가시성에 유의하세요.
--remote-control(/rc)은 이름이 비슷하지만--remote클라우드 세션과 무관합니다. 혼동하지 마세요.- 네트워크 접근이
None이면 셋업 스크립트/훅의 패키지 설치가 실패합니다(레지스트리에 접근 불가).
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록