# AIコーディングツール

TermbridgeはAIコーディングアシスタントの監視に最適です。ターミナルでエージェントを起動すれば、デスクから離れていてもスマートフォンで動作を確認できます。

## AIツールでTermbridgeを使う理由

- **リモートで監視**: ソファに座りながらClaude CodeやCodexの動作を確認
- **状況を把握**: エージェントが入力を求めたり、エラーに遭遇したりしたときに確認
- **すばやく介入**: スマートフォンからコマンドを送信したり、プロセスをキャンセルしたりできます
- **VPN不要**: どこからでも安全にアクセス

## 対応ツール

Termbridgeはtmuxセッション内で実行されるものをすべてストリーミングするため、ツールを認識する必要はありません。このページでは次のツールを例に使用します:

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

この3つはサンドボックスモードで自動インストールとサインインができるエージェントでもあります。ほかのターミナルベースのエージェントも同様に動作しますが、テストされていません。

## ローカルでのワークフロー

### スマートフォンで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/ja/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キー |
| 環境 | 自分のマシン | 隔離されたコンテナ |
| 永続性 | 再起動後も維持 | 直接モードならノートPCがスリープしても維持 |
| 認証 | 設定済み | Termbridgeが自動同期 |
| 最適な用途 | 手軽な監視 | 隔離された実験 |

ほとんどのユーザーにはローカルモードのほうが簡単です。次のような場合はサンドボックスモードを使用してください:

- クリーンで使い捨ての環境を使いたい
- エージェントの作業中にノートPCを空けておきたい
- ローカルの設定に影響を与えずに実験したい