# 어디서나 사용하는 터미널

Termbridge를 사용하면 브라우저가 있는 모든 기기에서 로컬 터미널에 접속할 수 있습니다. 명령어 하나를 실행하고 QR 코드를 스캔하면 연결됩니다.

```bash
npx termbridge
```

이제 끝입니다. 휴대폰에서 터미널에 접속할 수 있습니다.

## Termbridge를 사용하는 이유

**소파에서 빌드를 확인하세요.** 오래 걸리는 빌드를 시작했나요? 커피를 마시는 동안 휴대폰으로 완료되는 모습을 확인하세요.

**이동 중에도 서버를 모니터링하세요.** 프로세스가 실행 중인 서버에 SSH로 접속했나요? 어디서나 상태를 살펴보세요.

**AI 코딩 도구를 원격으로 실행하세요.** Claude Code, Codex 등의 도구를 사용하나요? 자리를 비운 동안 태블릿으로 작업 상황을 확인하세요.

**설정 없이 빠르게 접속하세요.** 포트 포워딩이나 VPN, 복잡한 설정이 필요 없습니다. 명령어를 실행하고 스캔하기만 하면 됩니다.

## 작동 방식

1. 컴퓨터에서 `npx termbridge`를 실행합니다
2. Termbridge이 터미널에 보안 터널을 만들거나 직접 모드에서 샌드박스 링크를 사용합니다
3. QR 코드를 스캔하거나 URL를 복사합니다
4. 터미널이 브라우저에 표시되며 모든 기능을 사용할 수 있습니다

기본적으로 모든 작업은 컴퓨터에서 로컬로 실행됩니다. 선택 사항인 샌드박스 모드는 Daytona 계정에서 실행되며, Termbridge이 운영하는 백엔드는 없습니다.

## 핵심 설계

**로컬 우선.** 기본적으로 서버, WebSocket, 터미널 레지스트리는 컴퓨터에서 실행됩니다. 샌드박스 모드는 Daytona 계정에서 실행되지만, Termbridge은 여전히 백엔드를 운영하거나 데이터를 저장하지 않습니다.

**안전한 연결 전달.** Termbridge이 일회용 토큰을 발급하고 이를 쿠키 세션으로 교환합니다. 휴대폰으로 스캔하는 것은 토큰 URL입니다.

**모바일 친화적.** UI는 전체 높이 터미널, 간결한 제어 막대, 터미널 전환 시트로 구성된 최소한의 인터페이스입니다.

## 할 수 있는 작업

- **터미널 전체 기능** - 색상, htop 및 vim 같은 TUI, 적절한 키 입력 처리를 모두 지원합니다
- **여러 세션** - 여러 터미널을 실행하고 앱에서 전환할 수 있습니다
- **모바일 제어** - Ctrl+C, 화살표, Tab 및 기타 키를 위한 화면 버튼
- **기본 보안** - 일회용 토큰으로 본인만 연결할 수 있습니다

## 빠른 시작

기본 로컬 터널 방식에서는 [Node.js](https://nodejs.org) 20 이상, [tmux](https://github.com/tmux/tmux) 및 [cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)을 설치한 다음 다음을 실행하세요:

```bash
npx termbridge
```

휴대폰으로 QR 코드를 스캔하면 바로 접속됩니다. 샌드박스 모드는 샌드박스 안내서를 참조하세요.

### [시작하기](https://termbridge.inline0.dev/ko/docs/getting-started)

설치 단계가 포함된 전체 설정 안내서

### [사용 안내서](https://termbridge.inline0.dev/ko/docs/usage)

모바일 제어, 여러 터미널 등

### [개발 서버 미리보기](https://termbridge.inline0.dev/ko/docs/usage/dev-server-preview)

터미널과 함께 앱을 미리 보세요

### [샌드박스](https://termbridge.inline0.dev/ko/docs/sandboxes)

Daytona 클라우드 샌드박스에서 터미널 실행