jeon
5a96a696b1
- 펌웨어(program), C# 대시보드(TestProgram), 시뮬레이터(Simulator), 프로토콜/문서(Protocol, doc) 전체를 단일 저장소로 통합 - program 폴더의 별도 git 저장소를 제거하고 통합 저장소에 흡수 - 빌드 산출물(program/build, bin/obj, *.o/.elf/.bin/.hex 등) .gitignore 처리 - 사내 Synology NAS Git 원격 연결 예정 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
113 lines
4.9 KiB
Markdown
113 lines
4.9 KiB
Markdown
# 스마트폰에서 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 확장에서 (지금 쓰는 방식 — 가장 간단)
|
|
1. Claude 채팅 입력창에 **`/remote-control`** (또는 `/rc`) 입력
|
|
2. 입력창 위 배너 → **"Open in browser"** 클릭하면 claude.ai/code로 연결
|
|
3. ⚠️ VS Code에서는 QR 미표시·이름 지정 미지원
|
|
|
|
### B. 터미널 CLI에서 (QR·이름 지원, 권장)
|
|
```powershell
|
|
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. 스마트폰에서 연결
|
|
|
|
1. **Claude 앱** 설치(데스크톱에서 `/mobile` 치면 다운로드 QR 표시) → 데스크톱과 **같은 계정** 로그인
|
|
2. 연결 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. 권장 사용 흐름 (이 프로젝트)
|
|
|
|
1. 평소엔 데스크톱 VS Code 확장에서 작업
|
|
2. 자리 비울 때 **`/rc` → Open in browser**(또는 터미널 `claude remote-control --name "HERV"` + QR)로 폰 연결
|
|
3. 폰에서 진행 확인·권한 승인·간단 지시(예: "다음 단계 진행해", "빌드 결과 보여줘")
|
|
4. 실보드/COM 검증은 데스크톱을 켜둔 상태로 폰에서 원격 지시
|
|
|
|
> 공식 문서: https://code.claude.com/docs/en/remote-control
|