クイックスタート

Mac と iPhone に Tactic Remote をインストールし、初回接続とセッション実行を行います。

Windows: アカウントで Windows に接続する.

このガイドでは、Tactic Remote のインストールから初回接続までを説明します。Mac（または Windows PC）と iPhone が必要です。

所要時間： 初回セットアップに約10分。以降の再接続は数秒。

前提条件

Tactic Remote Mac App — ローカルサーバーと固定バージョンの Node runtime を内蔵しています。初回起動時にローカル依存関係を確認し、Homebrew や tmux などの基本コンポーネントのインストールを補助できます。
少なくとも 1 つの AI コーディング agent CLI — Tactic Remote は Claude Code、OpenAI Codex、Sourcegraph Amp を起動できます。最初のセッションを作成する前に、使いたい agent をインストールしてログインしてください。
# Claude Code（Claude Code 公式ドキュメント推奨の native installer） curl -fsSL https://claude.ai/install.sh | bash # OpenAI Codex npm install -g @openai/codex # Sourcegraph Amp npm install -g @sourcegraph/amp
すでにターミナルで claude、codex、または amp が動くなら、Tactic Remote から利用できます。
tmux — Mac/Linux のターミナルセッションを切断後も維持します。Mac App が確認し、インストールを補助できます。CLI ユーザーは macOS で brew install tmux を実行できます。

Mac App ではなく 1 コマンド CLI 起動を使う場合で、Node.js や Homebrew が未インストールなら先にインストール：

# Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
# Node.js
brew install node

Tactic Remote には Mac で使える 2 つのセットアップ方法があります。

ダウンロードページから Tactic Remote Mac アプリをダウンロード。DMG を開き、アプリを Applications にドラッグします。

初回起動時、アプリはメニューバーに表示されます。アイコンをクリックすると：

Mac アプリはサーバーを内蔵しており、セットアップも案内されるため、ターミナル中心でないユーザーには通常こちらが最も簡単です。

ターミナルでこの 1 つのコマンドを実行します：

npx tacticremote

サーバーが起動し、QR コードが表示されます。iPhone でスキャンすれば接続完了です。

要件：Node.js 16+、tmux（macOS では brew install tmux）、およびインストール済みの agent CLI（claude、codex、amp のいずれか）。

macOS と Linux で動作します。

どちらを選ぶべきですか？ 多くのユーザーには、セットアップを案内し、QR コードをメニューバーに表示してくれる Mac App が最適です。CLI は、普段から Terminal を使う人や、macOS と Linux で同じ流れを使いたい人に向いています。

Bonjour 自動検出： 両デバイスが同一 WiFi にある場合、iOS アプリが Bonjour 経由で Mac を自動検出します。

List the files in the current directory.

agent のレスポンスがスマホにストリーミング表示されれば、すべて正常に動作しています。

確認項目	期待される動作
ターミナル出力	1〜2秒以内にテキストが表示される
バックグラウンド再接続	30秒間他のアプリに切り替え後、戻るとセッションが自動復元
プッシュ通知	スマホをロックし、agent のタスク完了を待つと通知が届く