본문으로 건너뛰기

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

다음 작업이 수행됩니다:

  1. Daytona 샌드박스 만들기
  2. 에이전트 CLI 설치하기
  3. 로컬 인증 파일을 동기화해 에이전트를 바로 사용할 수 있도록 준비하기

전체 내용은 코딩 에이전트 안내서를 참조하세요.

팁

세션 이름 지정

실행 중인 항목을 알아보기 쉽도록 의미 있는 세션 이름을 사용하세요:

셸
termbridge --session claude-refactor
termbridge --session codex-tests

여러 에이전트

각 터미널에서 서로 다른 에이전트를 실행하세요:

셸
TERMBRIDGE_SESSIONS=2 termbridge

한 터미널에서 Claude을 시작하고 다른 터미널에서 Codex을 시작한 다음, 두 터미널을 오가세요.

장시간 실행 작업

AI 에이전트는 오랫동안 실행될 수 있습니다. Termbridge은 이런 작업을 잘 처리합니다:

  • 브라우저를 닫아도 세션이 유지됩니다
  • 언제든 페이지를 새로고침해 다시 연결할 수 있습니다
  • Termbridge이 재시작해도 tmux이 에이전트를 계속 실행합니다

개입하기

에이전트를 중지하거나 다른 방향으로 이끌어야 하나요?

  1. Ctrl+C 버튼을 눌러 작업을 중단합니다
  2. 입력란에 새 지침을 입력합니다
  3. 에이전트는 로컬 터미널에서처럼 입력 내용을 받습니다

샌드박스와 로컬 모드 비교

기능 로컬(tmux) 샌드박스(Daytona)
설정 tmux만 있으면 됨 Daytona 계정 + API 키
환경 내 컴퓨터 격리된 컨테이너
지속성 재시작 후에도 유지 직접 모드에서는 노트북이 절전 상태여도 유지
인증 이미 설정됨 Termbridge이 자동으로 동기화
적합한 용도 빠른 모니터링 격리된 실험

대부분의 사용자에게는 로컬 모드가 더 간편합니다. 다음과 같은 경우 샌드박스 모드를 사용하세요:

  • 깨끗하고 필요할 때 버릴 수 있는 환경이 필요한 경우
  • 에이전트가 작업하는 동안 노트북을 비워두고 싶은 경우
  • 로컬 설정에 영향을 주지 않고 실험을 실행하려는 경우