# AI 코딩 도구

Termbridge는 AI 코딩 어시스턴트를 모니터링하는 데 적합합니다. 터미널에서 에이전트를 시작한 뒤 자리를 비운 동안 휴대폰으로 작업 상황을 확인하세요.

## AI 도구와 함께 Termbridge를 사용하는 이유

- **원격 모니터링**: 소파에서 Claude Code 또는 Codex의 작업을 확인하세요
- **상태 파악**: 에이전트가 입력을 요청하거나 오류를 만나는 시점을 확인하세요
- **빠른 개입**: 휴대폰에서 명령을 보내거나 프로세스를 취소하세요
- **VPN 불필요**: 어디서나 안전하게 접속하세요

## 지원되는 도구

Termbridge는 tmux 세션에서 실행되는 내용을 그대로 스트리밍하므로 도구를 알 필요가 없습니다. 이 페이지의 예시에서는 다음을 사용합니다:

- **Claude Code** (`claude`)
- **Codex** (`codex`)
- **OpenCode** (`opencode`)

이 세 가지 에이전트는 샌드박스 모드에서 자동으로 설치하고 로그인할 수 있는 에이전트이기도 합니다. 터미널 기반의 다른 에이전트도 같은 방식으로 실행되지만 테스트되지는 않았습니다.

## 로컬 워크플로우

### 휴대폰에서 Claude Code 보기

```bash
# Start Termbridge with a named session
termbridge --session claude

# In the terminal (via UI or locally), start Claude
claude
```

QR 코드를 스캔하고 어디서든 Claude의 작업을 확인하세요.

### 에이전트를 먼저 시작하기

Termbridge보다 먼저 에이전트를 시작하려면:

```bash
# Create a tmux session and start the agent
tmux new-session -d -s claude "claude"

# Then attach Termbridge to it
termbridge --session claude
```

### Codex 워크플로우

```bash
tmux new-session -d -s codex
tmux send-keys -t codex "codex" Enter
termbridge --session codex
```

## 샌드박스 워크플로우

격리된 환경에서 에이전트를 실행하려면 Daytona 샌드박스를 사용하세요. Termbridge은 에이전트 CLI를 설치하고 인증 정보를 자동으로 동기화할 수 있습니다.

### 빠른 설정

```bash
export TERMBRIDGE_BACKEND=sandbox-daytona
export TERMBRIDGE_SANDBOX_AGENTS=claude-code,codex

termbridge
```

다음 작업이 수행됩니다:

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

전체 내용은 [코딩 에이전트 안내서](https://termbridge.inline0.dev/ko/docs/sandboxes/coding-agents)를 참조하세요.

## 팁

### 세션 이름 지정

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

```bash
termbridge --session claude-refactor
termbridge --session codex-tests
```

### 여러 에이전트

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

```bash
TERMBRIDGE_SESSIONS=2 termbridge
```

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

### 장시간 실행 작업

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

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

### 개입하기

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

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

## 샌드박스와 로컬 모드 비교

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

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

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