T3 Codeの使い方:git worktreeでコーディングエージェントの作業を分ける
T3 Codeで複数のコーディングエージェントをまとめて管理する方法を解説します。git worktreeによるタスクの分離、各プロバイダーの接続、差分レビュー、スマートフォンからの操作まで、導入の流れを整理。安定版のテーマとnightly版のCSSカスタマイズの違い、利用前に確認したい制約も紹介します。
公開日

T3 Codeは、使い慣れたコーディングエージェントを1つのワークスペースから動かせるツールです。git worktreeを使ってタスクごとにブランチを分け、スマートフォンから同じ作業を引き継げます。エージェントや変更内容、利用端末の管理そのものが負担になってきたときに、導入を検討する価値があります。
変わるのは、作業のまとめ方です。エージェントごとの画面に合わせて手順を組み直さずに、タスクから差分の確認、プルリクエストへと進めます。T3 Codeは無料のオープンソースソフトウェアです。エージェントの利用料金は、引き続き各サービスのプランに従います。
対象バージョン:2026年11月16日時点。 安定版の基準は、11月11日公開のv0.1.9です。本記事はドキュメントに基づくガイドであり、インストールやスマートフォンとのペアリングを実機で検証したものではありません。セットアップ手順はリポジトリの現行ドキュメントに沿っています。新しいエージェントによる画面カスタマイズについては、以下でnightly版の機能と明記します。
T3 Codeを加えると、エージェントの使い方はどう変わるか
T3 Codeは、複数のエージェントに共通の作業場所を用意します。Theo Browneのチームによるオープンソースプロジェクトで、macOS、Windows、Linux向けのデスクトップアプリ、iOS、Android向けのモバイルアプリ、Webクライアントがあります。
専門家がそれぞれの作業台で働く工房を思い浮かべると、役割がわかりやすくなります。専門家に当たるのがコーディングエージェントです。T3 Codeは、各エージェントのワークスペース、会話、レビューの流れを整理します。独自の新しいモデルを提供するのではなく、既存のエージェントのハーネス、つまりモデルにツールを渡して処理を実行するソフトウェアを利用します。
リポジトリの機能概要では、スレッド内でのモデル変更、エージェント間の委任、worktree、差分レビュー、リモートアクセスが紹介されています。スレッドとは、あるタスクにひもづく会話です。差分では、どの行が変わったかを正確に確認できます。
導入の理由になるのは、これらを異なるプロバイダーにまたがってまとめて扱えることです。worktreeやリモートアクセスがあるからといって、各エージェントの純正アプリに同じ機能がないとは限りません。今の環境で1つのエージェントと1つのタスクを無理なく扱えているなら、画面を増やすだけの価値があるかを見極める必要があります。
利用するエージェントを選ぶ際は、AIコーディングエージェントの比較を参照してください。自分でコードを編集する環境を選ぶなら、エディターの比較も参考になります。
インストールして、小さなタスクを動かす
まずは、コードを置き、エージェントを動かすコンピューターから設定します。スマートフォンアプリの導入はその後です。
- デスクトップアプリをインストールします。 公式ダウンロードを利用してください。パッケージマネージャーを使う場合、macOSでは
brew install --cask t3-code、Windowsではwinget install T3Tools.T3Codeを実行します。Linux向けにはAppImageと.debが用意されています。マシンのアーキテクチャに合うファイルを選びます。AppImageは、起動前に実行権限を付ける必要があります。 - プロバイダーを1つ接続します。 Settings → Providersを開き、処理を実行するマシンを指す環境を選択して、下表に従ってエージェントを有効にします。インストールとログインは、そのマシン上で行います。
- 既存のGitプロジェクトを追加します。 Gitは変更履歴を記録するバージョン管理システムです。WebアプリではAdd projectを使い、デスクトップではフォルダーをサイドバーにドロップできます。デスクトップアプリの起動中に
t3 appを実行すると、ターミナルのカレントディレクトリをプロジェクトとして開くこともできます。 - スレッドを作成し、作業先を確認します。 プロジェクト、モデル、権限モードを選びます。他の作業から分けてコードを変更するなら、タスクを送信する前にNew worktreeとベースブランチを選択します。
- 結果を確認しやすいタスクを任せます。 たとえば「この既存のバリデーションルールのテストを追加し、該当するテストコマンドを実行して、差分を説明してください」と依頼します。変更を公開する前に、変更されたファイルとテスト出力を確認します。
まずWebから試すなら、npx t3@latestを使えます。Node.jsが必要で、npmが選ぶ安定版を実行します。インストール済みのnightlyビルドを呼び出すためのコマンドではありません。インストールガイドには、Linuxでの起動方法やWindows Subsystem for Linuxについても説明があります。WSLを使う場合、プロバイダーのツールは選択したLinuxディストリビューション内にインストールします。
対応する各エージェントを接続する
基本は共通です。エージェントが動く場所でログインし、その後T3 Codeで有効にします。ノートPCでログインしても、リモートサーバー上のエージェントが設定されるわけではありません。
CLIはコマンドラインインターフェースの略で、ターミナルから実行できるプログラムを指します。インストールしたエージェントが見つからない場合は、プロバイダー設定のBinary pathでプログラムの場所を指定します。プロバイダーのカードに表示される互換性の警告や推奨バージョンも確認してください。
ほかのACP対応エージェントを使う場合は、Settings → Providers → Add provider → Show moreを開きます。ACPはAgent Client Protocolの略で、エージェントのソフトウェアとクライアントを接続するプロトコルです。Registryのエージェントを選んで追加し、ログインを完了します。一方、Local ACP commandは、ホストにインストール済みの実行ファイルを接続するものです。使えるモデルやオプションは、そのエージェントが公開する機能によって異なります。詳しくはACP設定ガイドを参照してください。
git worktreeでタスクを分け、ブランチ全体をレビューする
worktreeは、同じGitリポジトリにひもづく独立した作業ディレクトリです。あるタスクがファイルを変更している間も、別のタスクは別の場所で作業できます。同じチェックアウトを両方が編集せずに済みます。
たとえば、購入手続きのバグ修正とドキュメント更新に、それぞれ別のスレッドを用意します。各スレッドでNew worktreeを選び、意図したベースブランチから開始します。タスクごとにブランチとディレクトリが割り当てられるため、結果も個別にレビューできます。

スレッドのワークフローでは、同じプロンプトを複数のモデルに送ることもできます。新しいスレッドの選択画面でShiftキーを押しながらモデルをクリックし、ベースブランチを選んで送信します。選択したモデルごとに、個別のスレッドとworktreeが作成されます。この機能にはGitプロジェクトが必要です。
まずターン単位の差分で、そのターンの変更を確認します。次にブランチ比較で、ベースブランチからの変更全体を確認し、プロジェクトに必要なチェックを実行します。変更の準備が整ったら、スレッドのGit操作からコミット、プッシュ、プルリクエスト作成へと進めます。プルリクエストは、コードをマージする前にレビューしてもらうための提案です。
Gitの設定とコードホスティングサービスの認証は、T3 Codeを動かすマシン上で行います。ログイン後、Settings → Source control → Rescanを実行します。認証とレビューの操作は、ソース管理ガイドで説明されています。
worktreeが分けるのはファイルです。相反する設計判断まで両立させるわけではありません。別々のタスクが、同じ動作に異なる変更を加える可能性は残ります。また、ディレクトリが別だからといって、データベースや認証情報、外部サービスまで分離されると考えてはいけません。これらには、プロジェクト側で別途設定が必要です。
業務上の利点は、タスクの状況を把握し直すために見て回る場所を減らせることです。会話、ファイル、レビューが1つの流れにまとまります。作業手順として具体的な変化はありますが、何時間節約できるかを示す検証済みの数値はありません。動かすエージェントを増やしても、レビューの負担はなくなりません。
ホストを動かしたまま、スマートフォンで作業を続ける
スマートフォンはホストコンピューターを操作します。プロジェクトや認証情報、実行中のエージェントは、引き続きホスト側にあります。
- デスクトップのホストでSettings → Sharing & accessを開いてログインし、その環境のT3 Connectを有効にします。
- 公式サイトのiOSまたはAndroidのリンクから、モバイルアプリをインストールします。
- スマートフォンでも同じT3 Connectアカウントでログインし、環境を選択します。
- 既存のスレッドを開き、会話を続けたり承認に対応したりします。外出先で使う前に、実際に利用する予定のネットワークからホストに接続できるか確認してください。
コマンドラインで使うホストでは、t3 upによりT3 Connect、ローカルネットワーク経由、または両方のアクセスを選べます。T3 Codeはバックグラウンドサービスとして動きます。一方、デスクトップアプリのローカルサーバーを使う場合は、最後のウィンドウを閉じるとサーバーも停止します。コンピューターは起動し、接続可能な状態を保つ必要があります。

通常、T3 Connectアカウントで利用できるホストマシンは3台までです。スマートフォンとブラウザーはこの上限に含まれません。ローカルネットワークやTailscale経由で直接ペアリングする方法もあります。ペアリングURLは認証情報であり、既定のペアリングでは広い権限が与えられます。権限を絞る方法や接続を取り消す方法は、リモートアクセスガイドを参照してください。
長時間継続するジョブについては、長時間動く本番タスクのガイドで、作業そのものをどう監督するかという別の課題を扱っています。
画面のカスタマイズ:安定版のテーマとnightly版のCSS
新しいカスタマイズ機能では、色を選ぶだけでなく、エージェントがCSSを使って画面の見た目を変更できます。CSSはWeb画面の表示を制御するルールです。
ここでは、リリースごとの違いを押さえる必要があります。安定版v0.1.9では、パレット編集、テーマのインポートとエクスポート、環境ごとのテーマが利用できます。同バージョンの外観ガイドに記載されています。エージェントによる色やレイアウトのカスタマイズが載っているのは、11月14日公開のプレリリースv0.1.10-nightly.20261114.4669です。リリース履歴で確認できます。
新機能に対応したビルドでは、Settings → Appearance → Create themeを開き、Custom CSSへ進みます。CSSはテーマと一緒にエクスポートされます。または、サーバーと同じマシンで動くエージェントに、チャットのヘッダーを高くするなどの具体的な変更を依頼できます。そのスレッドではFull accessを使う必要があります。
適用範囲にも注意が必要です。モバイルには独自の外観設定があります。環境ごとのテーマはapp.t3.codesやほかの接続には適用されません。CSSのクラス名はリリース間で変わる可能性があるため、現行ガイドでは、代わりに安定していそうなdata-属性を対象にすることを推奨しています。テーマCSSによる外部ファイルの読み込みには制限があります。
カスタマイズによって必要な操作項目が見えなくなったら、別のテーマを選ぶか、サーバー上でt3 theme set t3-chatを実行します。機能と復旧手順は、現行の外観ドキュメントに説明があります。まずは読みやすさを改善する変更を1つだけ加え、差分と承認の操作項目が引き続き見えることを確かめるのがおすすめです。
試す価値のあるワークフロー、優先順に5つ
以下は実際に試せる使い方です。顧客の成果を測定した事例ではありません。
T3 Codeの周辺で事業にできそうな2つの仕組み
最も有望なのは、リポジトリ専用のworktreeセットアップキットです。 タスクごとのディレクトリに、依存関係、ローカル設定、テスト用データベース、開発サーバーのポートを再現可能な手順で用意できるなら、対価を払うチームが考えられます。最小限でも役立つ形にするなら、あるチームのリポジトリに対応し、前提条件を確認し、後片付けのコマンドを提供します。作業の開始とレビューの画面には、引き続きT3 Codeを使います。
このワークフローへの関心が、そのままこの製品への需要を証明するわけではありません。事業として確かめるべきなのは、新しいworktreeを使える状態にする作業で、チームが繰り返し時間を失っているかどうかです。難点は、リポジトリごとの違いにあります。汎用のラッパーは簡単に模倣できますが、確実に動くセットアップの知識は技術構成ごとに異なります。その固有性こそが、最も有望と考える理由でもあります。
もう1つは、プロバイダーの導入と互換性確認を支援するキットです。 受託開発会社や社内ツールのチーム向けに、各ホストにどのエージェントツールがインストールされているかを確認し、認証情報を収集せずに認証手順を案内し、動作確認済みの構成を文書化します。MVPとしては、ローカルの診断レポートとチーム用セットアップガイドを組み合わせ、まず小規模な導入支援サービスとして提供してからソフトウェア化する方法が考えられます。
情報を探す人がいるだけでは、有料のセットアップキットが求められている証拠にはなりません。T3 Codeにはすでにプロバイダー設定、互換性の警告、更新の操作機能があるため、それらを複製するだけでは弱い製品です。価値を生むには、チームの環境を再現できる仕組みと、導入プロセスに踏み込む必要があります。プロバイダーが変わるたびに、継続的な保守も必要です。
T3 Codeを導入する価値があるのは、どんなときか
複数のエージェントに共通するワークフロー、互いに分離した複数のタスク、別の端末からのアクセスが必要なら、導入を検討できます。そのどれも繰り返し起きる問題の解決につながらないなら、今の環境を使い続けるのがよいでしょう。
制約は実務的なものです。プロバイダーの認証と利用上限は残ります。リモートホストは利用可能な状態にしておく必要があります。worktreeでも依存関係とテストは必要です。プルリクエストの説明文を生成しても、コードレビューをしたことにはなりません。mainブランチの現行ドキュメントには、安定版のダウンロードに含まれない新機能が載っている場合があります。nightly版でのカスタマイズは、管理すべき要素をさらに増やします。
最初に使う日は、リスクの低い変更を1つ選び、ひと通りの流れを試してください。エージェントを1つ接続し、リポジトリを開き、worktreeを作り、チェックを実行し、差分を確認して、プルリクエストを準備します。スマートフォンからのアクセスを追加するのは、この流れが動いてからです。作業全体の管理が楽になるなら、T3 Codeを使い続ける価値があります。
T3 Code Nightlyを使うべきですか?
初めて設定する場合は、安定版を基準にしてください。Nightlyはプレリリースで、新しいエージェントによるCSSカスタマイズを使いたい場合の選択肢です。本記事では、安定版v0.1.9と、その機能が記載された11月14日のnightly版を区別しています。
T3 Code Mobileは、スマートフォン上でエージェントを動かしますか?
スマートフォンは、別のマシンにあるT3 Codeサーバーに接続します。そのホストがエージェントを実行し、プロジェクトを保持します。ホストを起動して接続可能な状態に保ち、T3 Connectまたは適切なペアリング方法で接続してください。
T3 CodeはWindowsやLinuxでも使えますか?
はい。Windowsにはデスクトップインストーラーとパッケージマネージャー経由の導入方法があります。Linuxでは、対応するアーキテクチャ向けにAppImageとDebianパッケージが用意されています。WSLを使う場合は、選択したディストリビューション内でエージェントを設定してください。
T3 CodeはWebブラウザーで使えますか?
はい。Webクライアントは、自分のT3 Codeサーバーに接続します。ホスト型のapp.t3.codesクライアントにはHTTPSのエンドポイントが必要です。クライアントを使うだけで、到達できないホストに接続できるようになるわけではありません。
エージェントのワークスペースをチームで再現可能な形に整えたい場合は、本番運用のワークフローづくりを支援できます。
- 公開日
- カテゴリー
- Build
- 言語







