[Claude Code #17] /remote-control·--cloud 원격 확장

Claude Code Remote Control은 로컬 세션을 폰·브라우저에서 이어받게 합니다. QR 연결, 로컬 실행 유지 구조, --cloud 웹 세션과 --teleport, GitHub·Slack 앱 설치까지 정리했습니다.

퇴근길에 문득 생각납니다. 아까 시켜 둔 리팩터링, 어디까지 됐을까.

Claude Code의 Remote Control을 쓰면 책상의 세션을 폰이나 다른 브라우저에서 그대로 이어받을 수 있습니다. 시리즈 마지막 편은 이 원격·통합 기능들입니다.

Claude Code 16편까지 쌓은 로컬 사용법을, 이제 기기 밖으로 확장할 차례예요.

Remote Control: 내 세션을 폰에서

공식 문서 기준으로 시작은 간단합니다. 작업 중 세션에서 /remote-control을 입력하거나 터미널에서 서버 모드로 띄웁니다.

claude remote-control --name "결제 리팩터링"

세션 URL이 표시되고 스페이스바를 누르면 QR 코드가 떠요. 폰의 Claude 앱으로 스캔하면 바로 그 세션에 연결됩니다.

claude.ai/code나 모바일 앱의 세션 목록에서 이름으로 찾아 들어가도 됩니다.

중요한 설계가 하나 있습니다. 원격으로 연결해도 실행은 계속 로컬 머신에서 이뤄집니다.

그래서 내 파일시스템, 로컬 MCP 서버, 프로젝트 설정이 폰에서도 전부 살아 있어요. @를 치면 로컬 파일 경로가 자동완성될 정도입니다.

통신은 아웃바운드 HTTPS만 사용하고 내 컴퓨터에 인바운드 포트를 열지 않습니다. 다만 연결 중에는 기기 간 동기화를 위해 대화 기록이 Anthropic 서버에 저장돼요. 이 점은 알아 두세요.

Remote Control은 연구 프리뷰이고 Pro·Max·Team·Enterprise 플랜에서 쓸 수 있습니다(API 키 인증은 미지원). Team·Enterprise는 소유자(Owner)가 먼저 켜야 해요.

Remote Control이 “로컬 실행 + 원격 조종”이라면, 반대 조합도 있습니다.

공식 CLI 레퍼런스 기준으로 claude --cloud "작업 설명"은 claude.ai 클라우드에 새 웹 세션을 만듭니다. 내 컴퓨터가 꺼져 있어도 돌아가고, 클론 안 한 저장소 작업이나 병렬 작업에 어울려요.

거꾸로 웹에서 하던 세션을 터미널로 가져오려면 claude --teleport를 씁니다.

쓰임새는 이렇게 갈립니다. 로컬 환경이 필요한 진행 중 작업은 Remote Control, 환경 세팅 없이 새로 던지는 작업은 클라우드.

세션 밖 통합도 두 가지 있습니다.

/install-github-app은 저장소에 Claude GitHub 앱을 설치하고 GitHub Actions 워크플로 파일과 시크릿까지 준비해 줍니다. 그 워크플로 PR을 병합하고 나면 PR·이슈에서 @claude를 멘션해 작업을 시킬 수 있어요.

/install-slack-app은 브라우저에서 OAuth 인증을 거쳐 Slack 워크스페이스에 Claude를 설치합니다. 팀 채널에서 바로 Claude를 불러 쓰는 구성이죠.

17편에 걸쳐 Claude Code의 명령어를 훑었습니다. 흐름은 이랬습니다.

명령어는 계속 늘어납니다. /release-notes로 변경을 따라잡고, 필요할 때 이 시리즈로 돌아와 주세요.