https://github.com/custardcream98/better-remote-control
Your local terminal, on your phone.
https://github.com/custardcream98/better-remote-control
claude-code cloudflare-tunnel mobile terminal
Last synced: 27 days ago
JSON representation
Your local terminal, on your phone.
- Host: GitHub
- URL: https://github.com/custardcream98/better-remote-control
- Owner: custardcream98
- Created: 2026-03-21T18:42:16.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-23T03:11:42.000Z (3 months ago)
- Last Synced: 2026-03-23T06:36:55.844Z (3 months ago)
- Topics: claude-code, cloudflare-tunnel, mobile, terminal
- Language: TypeScript
- Homepage:
- Size: 1.15 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.ko.md
Awesome Lists containing this project
README
# Better Remote Control
**내 로컬 터미널을, 내 폰에서.**
Cloudflare Tunnel 기반 모바일 최적화 웹 터미널.\
[Claude Code](https://docs.anthropic.com/en/docs/claude-code)를 어디서든 쓸 수 있습니다.
---
## 왜 만들었나?
[Claude Code Remote Control](https://github.com/anthropics/claude-code)은 불안정합니다. 대체제를 찾아봤지만 불필요한 기능이 많거나 버그투성이였습니다. 그래서 **brc**를 직접 만들었습니다 — 로컬 터미널을 폰에 띄우는 것, 그 하나에만 집중한 도구입니다.
## 시작하기
### 설치 (Node.js 불필요)
```bash
curl -fsSL https://raw.githubusercontent.com/custardcream98/better-remote-control/main/install.sh | sh
```
또는 [GitHub Releases](https://github.com/custardcream98/better-remote-control/releases)에서 바이너리를 직접 다운로드할 수 있습니다.
### npm으로 설치
```bash
npx better-remote-control
```
### 소스에서 빌드
```bash
git clone https://github.com/custardcream98/better-remote-control.git
cd better-remote-control
pnpm install && cd client && pnpm install && cd ..
pnpm run build && pnpm start
```
터미널에 QR 코드가 나타나면 폰으로 스캔하고, 비밀번호를 입력하면 끝입니다.
## 기능
### Claude Code 원격 제어
로컬에서 돌아가는 Claude Code를 어디서든 — 소파에서, 침대에서, 이동 중에. 폰과 브라우저만 있으면 됩니다.
### 멀티 세션
여러 세션을 동시에 — Claude Code 하나, 개발 서버 하나, 테스트 하나. 탭 한 번으로 전환합니다.
### 모바일 특수 키
엄지 접근성을 고려한 키 배열:
- ← ↓ ↑ → Tab Esc — 하단 배치, 바로 닿는 곳
- Ctrl+C ⇧Tab Opt+↵ / — 상단 배치, 보조 키
- 화살표 키 길게 누르면 반복 입력
### 이미지 업로드
카메라나 갤러리에서 이미지를 선택하면 서버에 업로드되고, 파일 경로가 터미널에 자동 삽입됩니다. Claude Code에 이미지를 넘길 때 유용합니다.
### 슬립 방지
`caffeinate`로 맥북을 깨워둡니다. 덮개를 닫아도 터미널이 계속 실행됩니다. 전원 연결 필요.
### 자동 재연결
연결이 끊겨도 자동으로 재접속하며 터미널 히스토리를 그대로 복원합니다. 출력이 유실되지 않습니다.
### 보안
비밀번호 인증, 속도 제한 (5회 / 60초), CSRF 보호, timing-safe 비교. 인증 토큰은 `HttpOnly` + `SameSite=Strict` 쿠키로 관리됩니다.
## 사용법
```bash
brc [옵션]
```
| 옵션 | 설명 |
| --------------------- | ----------------------------------- |
| `-p, --port ` | 포트 번호 (기본: `4020`) |
| `--password ` | 비밀번호 지정 (기본: 자동 생성) |
| `-s, --shell ` | 쉘 경로 (기본: `$SHELL`) |
| `-c, --cwd ` | 기본 작업 디렉토리 (기본: `$HOME`) |
| `--command ` | 세션 시작 시 자동 실행할 명령어 |
| `--no-tunnel` | Cloudflare Tunnel 비활성화 (로컬만) |
| `--no-caffeinate` | 슬립 방지 비활성화 |
사용 예시
```bash
# Claude Code 원격 실행
brc --command "claude --dangerously-skip-permissions"
# 특정 프로젝트에서 시작
brc --cwd ~/my-project
# 로컬 네트워크만 (터널 없이)
brc --no-tunnel
# 비밀번호 직접 지정
brc --password mysecretpassword
```
## 사전 요구사항
원격 접속을 위해 **cloudflared**가 필요합니다:
```bash
brew install cloudflared # macOS
# 또는 https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/ 참고
```
cloudflared 없이도 `--no-tunnel` 옵션으로 로컬 네트워크에서 사용할 수 있습니다.
소스에서 빌드할 경우
| 요구사항 | 설치 |
| ----------------- | -------------------------------- |
| **Node.js** >= 18 | [nodejs.org](https://nodejs.org) |
| **pnpm** | `npm install -g pnpm` |
## 라이선스
MIT