AI 코딩 도구
Termbridge는 AI 코딩 어시스턴트를 모니터링하는 데 적합합니다. 터미널에서 에이전트를 시작한 뒤 자리를 비운 동안 휴대폰으로 작업 상황을 확인하세요.
AI 도구와 함께 Termbridge를 사용하는 이유
- 원격 모니터링: 소파에서 Claude Code 또는 Codex의 작업을 확인하세요
- 상태 파악: 에이전트가 입력을 요청하거나 오류를 만나는 시점을 확인하세요
- 빠른 개입: 휴대폰에서 명령을 보내거나 프로세스를 취소하세요
- VPN 불필요: 어디서나 안전하게 접속하세요
지원되는 도구
Termbridge는 tmux 세션에서 실행되는 내용을 그대로 스트리밍하므로 도구를 알 필요가 없습니다. 이 페이지의 예시에서는 다음을 사용합니다:
- Claude Code (
claude) - Codex (
codex) - OpenCode (
opencode)
이 세 가지 에이전트는 샌드박스 모드에서 자동으로 설치하고 로그인할 수 있는 에이전트이기도 합니다. 터미널 기반의 다른 에이전트도 같은 방식으로 실행되지만 테스트되지는 않았습니다.
로컬 워크플로우
휴대폰에서 Claude Code 보기
셸
# Start Termbridge with a named session
termbridge --session claude
# In the terminal (via UI or locally), start Claude
claude
QR 코드를 스캔하고 어디서든 Claude의 작업을 확인하세요.
에이전트를 먼저 시작하기
Termbridge보다 먼저 에이전트를 시작하려면:
셸
# Create a tmux session and start the agent
tmux new-session -d -s claude "claude"
# Then attach Termbridge to it
termbridge --session claude
Codex 워크플로우
셸
tmux new-session -d -s codex
tmux send-keys -t codex "codex" Enter
termbridge --session codex
샌드박스 워크플로우
격리된 환경에서 에이전트를 실행하려면 Daytona 샌드박스를 사용하세요. Termbridge은 에이전트 CLI를 설치하고 인증 정보를 자동으로 동기화할 수 있습니다.
빠른 설정
셸
export TERMBRIDGE_BACKEND=sandbox-daytona
export TERMBRIDGE_SANDBOX_AGENTS=claude-code,codex
termbridge
다음 작업이 수행됩니다:
- Daytona 샌드박스 만들기
- 에이전트 CLI 설치하기
- 로컬 인증 파일을 동기화해 에이전트를 바로 사용할 수 있도록 준비하기
전체 내용은 코딩 에이전트 안내서를 참조하세요.
팁
세션 이름 지정
실행 중인 항목을 알아보기 쉽도록 의미 있는 세션 이름을 사용하세요:
셸
termbridge --session claude-refactor
termbridge --session codex-tests
여러 에이전트
각 터미널에서 서로 다른 에이전트를 실행하세요:
셸
TERMBRIDGE_SESSIONS=2 termbridge
한 터미널에서 Claude을 시작하고 다른 터미널에서 Codex을 시작한 다음, 두 터미널을 오가세요.
장시간 실행 작업
AI 에이전트는 오랫동안 실행될 수 있습니다. Termbridge은 이런 작업을 잘 처리합니다:
- 브라우저를 닫아도 세션이 유지됩니다
- 언제든 페이지를 새로고침해 다시 연결할 수 있습니다
- Termbridge이 재시작해도 tmux이 에이전트를 계속 실행합니다
개입하기
에이전트를 중지하거나 다른 방향으로 이끌어야 하나요?
Ctrl+C버튼을 눌러 작업을 중단합니다- 입력란에 새 지침을 입력합니다
- 에이전트는 로컬 터미널에서처럼 입력 내용을 받습니다
샌드박스와 로컬 모드 비교
| 기능 | 로컬(tmux) | 샌드박스(Daytona) |
|---|---|---|
| 설정 | tmux만 있으면 됨 | Daytona 계정 + API 키 |
| 환경 | 내 컴퓨터 | 격리된 컨테이너 |
| 지속성 | 재시작 후에도 유지 | 직접 모드에서는 노트북이 절전 상태여도 유지 |
| 인증 | 이미 설정됨 | Termbridge이 자동으로 동기화 |
| 적합한 용도 | 빠른 모니터링 | 격리된 실험 |
대부분의 사용자에게는 로컬 모드가 더 간편합니다. 다음과 같은 경우 샌드박스 모드를 사용하세요:
- 깨끗하고 필요할 때 버릴 수 있는 환경이 필요한 경우
- 에이전트가 작업하는 동안 노트북을 비워두고 싶은 경우
- 로컬 설정에 영향을 주지 않고 실험을 실행하려는 경우