jeon/HECO2

Files

T

jeon a502322188 chore: HERV 통합 저장소 재초기화 커밋

손상된 .git 히스토리(missing tree)로 재초기화 후 작업트리 전체 커밋.
.claude/ 만 제외(로컬 에이전트 설정). 구 저장소 백업(.git_corrupt_backup/) 포함.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-16 09:32:17 +09:00

4.9 KiB

Raw Blame History

스마트폰에서 Claude Code 작업하기 — Remote Control 가이드

작성일: 2026-06-14

데스크톱(Windows + VS Code 확장)에서 진행 중인 Claude Code 세션을 스마트폰에서 그대로 조종하는 방법. 빌드·COM 포트·실보드 플래시 등 실제 작업은 데스크톱에서 실행되고, 폰은 지시·확인·승인 역할.

0. 준비물

항목	내용
버전	Claude Code v2.1.51 이상 (모바일 푸시 알림은 v2.1.110+). 확인: 터미널 `claude --version`
플랜	Pro / Max / Team / Enterprise (API 키 인증 불가, claude.ai 계정 로그인 필요). 로그인/확인: `claude /login`
OS	Windows 지원. 터미널 CLI·VS Code 확장 둘 다 가능
팀/기업	관리자가 관리설정에서 "Remote Control" 토글을 켜둬야 함
폰 앱	Claude by Anthropic (iOS App Store / Android Play) — 데스크톱과 같은 계정 로그인

1. 데스크톱에서 Remote Control 시작 (택1)

A. VS Code 확장에서 (지금 쓰는 방식 — 가장 간단)

Claude 채팅 입력창에 /remote-control (또는 /rc) 입력
입력창 위 배너 → "Open in browser" 클릭하면 claude.ai/code로 연결
⚠️ VS Code에서는 QR 미표시·이름 지정 미지원

B. 터미널 CLI에서 (QR·이름 지원, 권장)

cd D:\project\nuvoton\HERV
claude remote-control --name "HERV"

세션 URL 출력 + 스페이스바를 누르면 QR 코드 표시
터미널은 켜둔 채 유지(Ctrl+C 금지). 네트워크 끊겨도 ≤10분이면 자동 재연결

선택 플래그

--name "HERV" : 세션 제목(목록에 표시)
--spawn worktree : 기기별 독립 git worktree(파일 충돌 방지, git 저장소 필요)
--spawn session : 정확히 1기기만 연결 허용
--verbose : 연결/도구 상세 로그
--sandbox : 파일시스템/네트워크 격리

C. 이미 진행 중인 세션을 전환

실행 중인 세션 입력창에 /remote-control HERV → 기존 대화 유지하며 활성화

2. 스마트폰에서 연결

Claude 앱 설치(데스크톱에서 /mobile 치면 다운로드 QR 표시) → 데스크톱과 같은 계정 로그인
연결 3가지:
- QR 스캔: 터미널 스페이스바로 띄운 QR을 앱으로 스캔
- 세션 URL: 터미널/배너의 URL 복사 → 폰 브라우저 붙여넣기
- 세션 목록: 앱 하단 "Code" 탭 → 목록에서 "HERV"(녹색 점 컴퓨터 아이콘) 선택

3. 폰에서 할 수 있는 것

가능

메시지 전송 / 답변·변경(diff) 확인
도구 권한 승인·거부 (Allow / Deny / Allow always) — 데스크톱과 실시간 동기화
@로 로컬 파일경로 자동완성
/clear /compact /context /usage /exit 등

불가(로컬 전용)

/plugin(플러그인 선택기), /resume(세션 복구 대화)

푸시 알림(선택, v2.1.110+)

폰 앱 로그인 → OS 알림 허용 → 데스크톱 /config → "Push when Claude decides" 켜기
긴 작업 완료/결정 필요 시 알림. "notify me when X finishes" 식 요청도 알림

4. 핵심 제약 (이 프로젝트 기준 중요)

데스크톱이 계속 켜져 있어야 함 — 절전/잠금 금지, 터미널·VS Code 종료 금지, 네트워크 유지
빌드(dotnet, bash build.sh), COM 포트 통신, 실보드 플래시(bash build.sh flash) 는 전부 데스크톱 실행 → 폰은 지시·확인 역할
기본은 한 번에 한 기기 입력. 단절 >10분이면 세션 종료 → 재시작 필요
보안: 아웃바운드 443(HTTPS)만 사용(인바운드 포트 안 염), TLS 암호화·단기 자격증명

5. 연결 종료

VS Code: 배너 X 버튼
터미널: Ctrl+C
어디서나: /exit

6. 문제 해결

증상/메시지	해결
"claude.ai subscription / full-scope token 필요"	`claude /login` 재로그인
"organization 정책으로 비활성"	관리자가 claude.ai 관리설정에서 Remote Control 토글 켜기
"Remote Control not yet enabled"	`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`·`DISABLE_TELEMETRY`·`CLAUDE_CODE_USE_BEDROCK` 등 환경변수 제거
QR 안 보임	터미널 창 넓히고 스페이스바 다시
세션 목록에 없음	데스크톱에서 `claude remote-control` 다시 실행, 터미널 실행 중인지 확인
상세 디버깅	`claude remote-control --verbose`

7. 권장 사용 흐름 (이 프로젝트)

평소엔 데스크톱 VS Code 확장에서 작업
자리 비울 때 /rc → Open in browser(또는 터미널 claude remote-control --name "HERV" + QR)로 폰 연결
폰에서 진행 확인·권한 승인·간단 지시(예: "다음 단계 진행해", "빌드 결과 보여줘")
실보드/COM 검증은 데스크톱을 켜둔 상태로 폰에서 원격 지시

공식 문서: https://code.claude.com/docs/en/remote-control

4.9 KiB Raw Blame History