T3 Code Windows チュートリアル: 携帯電話を使用して Codex、Claude Code、OpenCode をリモート制御する

T3 Codeは、それ自体を「エージェントハーネスコントロールサーフェス」として定義します。新しい基本モデルは提供しませんが、コンピューターに既にインストールされログオンされている Codex、Claude Code、Cursor、Grok Build、および OpenCode を制御します。

ローカル Web ページ、Electron デスクトップクライアント、またはモバイルインターフェイスを使用して、エージェントを表示および制御できます。これにより、コンピュータを離れた後もタスクの表示、質問への回答、および複数のローカルコーディングエージェントの管理を継続するという問題が解決されます。これは、T3 Codeの権限の上限が基礎となる CLI に依存することも意味します。 Codex がワークスペース全体を変更でき、Claude Code がコマンドを実行できる場合、リモートコントロールインターフェイスもこれらの機能をトリガーする可能性があります。関係者は、プロジェクトはまだ初期段階にあり、バグが予想されるため、この記事ではローカルのトライアルから始めて、その後リモートアクセスについて説明すると明確に述べています。

リモートデスクトップおよび Pi Web との違いは何ですか

リモートデスクトップは Windows グラフィカルインターフェイス全体を送信しますが、T3 Codeはエージェントセッションと関連コントロールのみを表示するため、携帯電話での操作が簡単です。これはモデルをクラウドに移動することではありません。 Agent CLI、ログインステータス、リポジトリ、およびコマンドは Windows コンピュータ上で引き続き実行されます。単一エージェントの Web パッケージ化と比較して、T3 Codeの目標は、複数のプロバイダを均一に制御し、Web、デスクトップ、モバイルポータルを提供することです。

適切な使用法:

通勤中に長期間のテスト結果を確認する。
携帯電話でエージェントの明確な質問に答える。
複数の独立したリポジトリセッションを同時に管理する。
社内のタブレットから開発ホストを制御する。 LAN;
既存の Codex または Claude Code サブスクリプションログインを保持します。無人コンピュータをパブリックネットワークに直接公開することは適切ではありません。また、成熟したエンタープライズ権限プラットフォームとみなされるべきでもありません。

インストール前に基盤となるエージェントを確認してください。

T3 Codeには、インストールされ認定されたプロバイダが少なくとも 1 つ必要です。 PowerShell で項目ごとに確認します。

1
2
3
4


codex --version
claude --version
cursor-agent --version
opencode --version

使用できるようにする必要があるのは 1 つだけであり、すべてをインストールする必要はありません。コーデックスログイン:

1

codex login

クロードコードログイン:

1

claude auth login

カーソル CLI ログイン:

1

cursor-agent login

OpenCode ログイン:

1

opencode auth login

これらのコマンドはプロジェクトバージョンごとに変更される可能性があり、対応する公式ドキュメントが優先されます。ログインが完了したら、まず通常の端末でテストリポジトリを開き、エージェントが起動してファイルを読み取れることを確認します。

ルート 1: npx を使用したゼロインストールトライアル

最速の正式な入り口は次のとおりです。

1

npx t3@latest

最初の実行では、npm パッケージがダウンロードされ、T3 Code バックエンドとローカル Web アプリケーションが開始されます。ターミナルに表示されるローカルアドレスとポートに注意してください。古いチュートリアルに基づいた特定のポートであると想定しないでください。すべてのパラメータを表示:

1

npx t3@latest --help

npm がパッケージをインストールするかどうかを尋ねる場合は、まずパッケージ名が確かに t3 であることを確認し、ソースが公式プロジェクトからのものであることを確認します。ターミナルを実行したままにして、同じコンピュータ上のブラウザでターミナルが出力するローカル URL にアクセスします。現時点ではパブリックネットワーク転送を構成しないでください。まずローカル機能の検証を完了してください。端末で Ctrl+C を押してテストを終了します。次に、プロセスが終了したかどうかを確認します。

1

Get-Process | Where-Object { $_.ProcessName -match 't3|node' }

他の開発サービスも Node を使用する可能性があるため、すべての Node プロセスを任意に終了しないでください。

ルート 2: Windows デスクトップバージョンをインストールする

winget によるインストールを正式にサポート:

1

winget install T3Tools.T3Code

インストール後にスタートメニューから起動するか、プログラムが登録されているか確認します:

1

winget list T3Tools.T3Code

アップグレード:

1

winget upgrade T3Tools.T3Code

エンタープライズポリシーで winget がブロックされている場合は、公式からダウンロードできます。 GitHub リリース署名付きインストールパッケージをダウンロードします。再パッケージ化されたインストーラーをサードパーティのソフトウェアダウンロードサイトから入手しないでください。

デスクトップバージョンは引き続きローカルプロバイダーに依存します。 Codex または Claude Code のログインが自動的に完了するわけではありません。

テストリポジトリへの初めての接続

機密コードを含まない新しいディレクトリを作成します。

1
2
3
4


$testRoot = 'C:\Work\t3code-demo'
New-Item -ItemType Directory -Path $testRoot -Force
Set-Location $testRoot
git init

いくつかのサンプルファイルを作成した後、T3 Codeからこのディレクトリを選択し、ログインしたプロバイダを起動します。最初のタスクは読み取り専用である必要があります。例:

1

列出仓库中的文件，说明每个文件用途，不要修改文件，也不要运行安装命令。

インターフェースが正しく表示されているかどうかを確認します:

プロバイダ名;
現在の作業ディレクトリ;
エージェントの出力;
ツールの呼び出しまたは承認;
セッション停止ボタン;
ページ更新後のセッションのステータス。

合格したら、エージェントにテストファイルを変更させ、Git を使用してスコープを確認します。

1
2


git status --short
git diff

Windows ID と環境変数が一致しない理由

npx t3@latest が PowerShell から起動されると、通常、現在のユーザー、PATH および環境変数が継承されます。ターミナル。デスクトップアプリケーションは、[スタート] メニューから起動すると異なる環境になる場合があります。典型的な症状は、ターミナルで codex を実行できるが、T3 Codeでプロバイダーが見つからないというメッセージが表示されることです。最初にコマンドの場所を確認します。

1
2
3


Get-Command codex
Get-Command claude
$env:PATH -split ';'

Windows に再ログインするか、デスクトップアプリケーションを再起動して、インストール後に変更されたユーザーレベル PATH を更新します。「すべてを解決する」ために API キーをシステムレベルの環境変数に書き込まないでください。 T3 Codeは、プロバイダーの既存の認証を再利用するように設計されており、CLI ログインとプログラムの可視性の修正を優先します。

T3 Codeが別の Windows ユーザーとして実行されている場合、現在のアカウントで認証ファイルは自動的に読み取られません。

ローカル Web および LAN アクセス

ローカルリスニングアドレス 127.0.0.1 には、現在のコンピュータからのみアクセスできます。これが最も安全なデフォルトです。同じ Wi-Fi 上の携帯電話からアクセスするには、T3 Codeがリスニングアドレスパラメータを提供しているかどうかを確認する必要があります。まず見てください:

1

npx t3@latest --help

公式パラメータが明確にサポートしている場合にのみ、LAN インターフェイスへのリスニングアドレスを変更します。次に、コンピュータの IP を調べます:

1
2


Get-NetIPAddress -AddressFamily IPv4 |
  Where-Object { $_.IPAddress -notlike '169.254*' -and $_.IPAddress -ne '127.0.0.1' }

実際のリスニングを表示します:

1
2
3


Get-NetTCPConnection -State Listen |
  Sort-Object LocalPort |
  Select-Object LocalAddress,LocalPort,OwningProcess

実際のポートのみに対して Windows ファイアウォールルールを作成し、リモートアドレスをホームネットワークセグメントまたは職場ネットワークセグメントに制限します。すべてのポート、すべてのネットワークプロファイルを許可する広範なルールを作成しないでください。セッションコンテンツと制御リクエストが同じネットワークセグメント上のデバイスによって盗聴される可能性があるため、公共 Wi-Fi ではネイキッド HTTP アクセスを使用しないでください。

より安全なリモートアクセス方法

LAN から離れた後は、Tailscale、WireGuard、または既存のエンタープライズ VPN などのネットワーク VPN を優先的に使用します。このようにして、T3 Codeはプライベートネットワークのみをリッスンし続けることができます。推奨される関係は次のとおりです。

1

手机 -> 私有 VPN -> Windows 开发机 -> T3 Code -> 本地 Agent CLI

推奨されない関係:

1

互联网 -> 路由器端口转发 -> 未认证的 T3 Code HTTP 端口

リバースプロキシを使用する必要がある場合は、少なくとも HTTPS、強力な認証、送信元制限、WebSocket サポート、および短いセッションが必要です。また、T3 Code独自の認証メカニズムが推測の難しい URL のみに依存していないことを確認してください。 Cloudflare トンネルは発信元アドレスを隠すことができますが、パブリックトンネルは依然としてパブリックネットワークの入り口です。アクセス認証と組み合わせる必要がありますが、「ルーターのポートが開いていない」というだけでリスクがないわけではないと考えないでください。

携帯電話でどのようなアクションを確認する必要があるか

最初の携帯電話接続の直後に実際の開発タスクを実行しないでください。項目ごとにテストします。

既存のセッションを開きます。
長い出力が完了したかどうかを確認します。
プレーンテキストで返信します。
ツールの承認を一度拒否します。
実行中のエージェントを停止します。
別のエージェントに切り替えますリポジトリ;
電話画面をロックした後に再接続します。
VPN を切断し、アクセスできないことを確認します。特に、「stop」が実際に基礎となるプロセスを終了するかどうかをテストします。一部のインターフェイスは出力を停止するだけで、コマンドがバックグラウンドでまだ実行されている可能性があります。 Windows 側の関連プロセスを確認します。

1
2
3


Get-CimInstance Win32_Process |
  Where-Object { $_.Name -match 'codex|claude|node|t3' } |
  Select-Object ProcessId,Name,CommandLine

ワークスペースと複数のプロバイダーセッションを混同しないでください。

T3 Codeは複数のプロバイダーを制御できます。これは、プロバイダーが同じコンテキスト、権限、構成を共有することを意味するものではありません。セッションごとに明示的に記録します:

プロバイダー、
リポジトリへの絶対パス、
現在のブランチ、
書き込みが許可されているかどうか、
コマンドの実行が許可されているかどうか。
タスクの目標。
承認コマンド。リモート操作の前にエージェントに報告を要求する:

1

只报告当前工作目录、Git 分支和未提交文件，不要修改任何内容。

ディレクトリまたはブランチが間違っている場合は、続行する前にセッションを停止し、コンピュータ上で修正してください。携帯電話の画面は小さいため、ルート案内を無視しやすくなります。

サブスクリプション、API キー、および料金

公式説明 T3 Codeは、Codex、Claude Code、Cursor、Grok Build、および OpenCode の既存のサブスクリプションまたは認定を使用できます。

料金は引き続き対応するプロバイダーによって発生します。 T3 Codeは単なるコントロールサーフェスであり、価値の高いタスクを無料のタスクに変えるわけではありません。個別に確認する必要があります:

プロバイダがサブスクリプションログインまたは API キーを使用しているかどうか、
並列セッションにより消費量が増加しているかどうか、
長期的なバックグラウンドタスクがまだ実行されているかどうか、
失敗した再試行中に負荷の高い操作が繰り返されているかどうか。
携帯電話が切断されたときにタスクを自動的に停止するかどうか。プロバイダーの認証ディレクトリをパブリッククラウドディスクに同期したり、API キーを T3 Code チャットに貼り付けたりしないでください。

プロジェクトがまだ初期段階にあるとはどういう意味ですか

公式の README には「バグが予想される」と明記されていますが、現時点では完全な公開ドキュメントサイトはありません。実際の使用の想定:

アップグレードによりセッション形式が変更される可能性があります。
Web バージョンとデスクトップバージョンの動作が一致しない可能性があります。
一部のプロバイダ統合は新しい CLI バージョンより遅れます。
リモート再接続により一部が失われる可能性があります。状態;
バックグラウンドプロセスは手動検査が必要です。
セキュリティモデルは調整される可能性があります。

独自の開発環境や独自のセッション履歴を以前のバージョンに基づいて作成しないでください。実際のコードは常に Git に保存され、重要なタスクの説明は問題またはリポジトリのドキュメントに保存されます。

症状によって特定される T3 Code障害

`npx t3@latest` ダウンロードに失敗しました

npm レジストリ、エージェント、ノードのバージョンを確認します:

1
2
3


npm config get registry
node --version
npm cache verify

原因を確認せずに企業 TLS チェックをオフにしたり、信頼できないミラーを使用したりしないでください。

T3 Codeで Codex または Claude が見つかりません

同じ Windows ユーザーで Get-Command を実行し、デスクトップアプリケーションを再起動し、CLI ログインが別のユーザーまたは WSL にのみ存在しないことを確認します。

ブラウザを開いた後に空白になる

ターミナル、ブラウザコンソール、ポート占有の起動時の最初のエラーを確認します。スクリプトのブロックを除外するには、拡張機能のないブラウザウィンドウを試してください。

携帯電話の接続がタイムアウトしました

携帯電話とコンピュータネットワークが到達可能であること、プログラムが 127.0.0.1 を監視していないこと、Windows ファイアウォールルールの範囲が正しいこと、VPN ルートが確立されていることを確認してください。

セッションは実行中であると表示されますが、出力がありません

基盤となるエージェントが承認を待っているか、ログインの有効期限が切れているか、コマンドが停止しているかどうかを確認してください。 Windows 側に戻り、プロセスと起動ログを表示します。

リポジトリで予期しない変更が発生しました。

エージェントを直ちに停止し、証拠を保存してください。

1
2
3


git status --short
git diff --stat
git diff

サイトを直接消去するために破壊的な Git コマンドを使用しないでください。まず、どのファイルが最初にユーザーによって変更されたかを確認します。

日常的なセキュリティ習慣

Windows 開発マシンでディスク暗号化とロック画面を有効にする。
携帯電話で生体認証とリモートワイプを有効にする。
T3 Codeはローカルマシンまたはプライベート VPN のみをリッスンする。
ファイルを直接開かないでください。パブリックネットワークポート。
エージェントは管理者ではなく一般ユーザーを使用します。
リスクの高いコマンドは手動による承認を保持します。
各リモートタスクのディレクトリとブランチを確認します。
T3 Codeと基礎となるプロバイダを定期的にアップグレードします。
終了前に Git の状態を保存します。コンピュータ;
デバイスが見つからない場合は、VPN とプロバイダーのセッションを取り消します。

インストールする価値はありますか

10 分以上続く Codex または Claude Code タスクを頻繁に実行する場合、T3 Code のモバイルコントロールエントリは非常に魅力的です。評価する最も速い方法は、すぐにパブリックネットワークに展開するのではなく、テストリポジトリで npx t3@latest を実行して、ローカル Web、タスクの停止、およびセッションの回復を体験することです。

ローカルエリアが信頼できることを確認した後、プライベート VPN 経由で携帯電話にアクセスします。認証、権限、ログ、切断動作が検証された場合にのみ、実際に動作するリポジトリの制御を許可する必要があります。

T3 Code の参考資料

T3 Code 公式リポジトリ
Codex 公式文書
[Claude Code 公式]ドキュメント](https://docs.anthropic.com/en/docs/claude-code/overview)

リモート デスクトップおよび Pi Web との違いは何ですか