Claude on the Go — モバイルで使う Claude CLI

Tool

概要

claude-on-the-go は、Mac 上で動かしている Claude Code CLI を自分のスマートフォンやタブレットのブラウザから操作できるようにするプロジェクトです。実際の計算や AI 推論は Mac 側の claude プロセスで行い、スマホ側にはターミナル表示を転送するだけなので、レスポンスは速く、データはローカルネットワークに留まります。外部クラウドに情報を預けたくない、家の WiFi やローカル環境で手軽にコード補助を受けたい開発者に向いたツールで、Python 製の軽量なサーバーコンポーネントを中心に設計されています。セットアップは比較的シンプルで、claude のインストール済み Mac とブラウザがあれば利用可能です。(約300字)

GitHub

リポジトリの統計情報

  • スター数: 3
  • フォーク数: 0
  • ウォッチャー数: 3
  • コミット数: 27
  • ファイル数: 15
  • メインの言語: Python

主な特徴

  • ローカル実行: Claude Code CLI を Mac 上で実行し、スマホは表示&入出力端末として利用。データはローカルネットワーク内に留まる。
  • モバイルファースト: iPhone、Android、任意のブラウザ対応でソファや外出先から手軽にターミナルを操作可能。
  • シンプル構成: Python ベースの軽量サーバーでプロセス管理と端末転送を行うため、セットアップが容易。
  • プライバシー重視: クラウド同期や外部サービスを介さないため、機密コードやプロンプトが外に流出しにくい。

技術的なポイント

claude-on-the-go は「端末のリモート表示」と「ローカルで動く CLI プロセスの橋渡し」にフォーカスしています。基本的な流れは、Mac 上で claude プロセスを起動し、Python 製サーバーがその標準入出力(stdin/stdout)や擬似端末(pty)を監視して、Web クライアントへ表示と入力をリアルタイムで中継するという構成です。ブラウザ側はターミナル風の UI(例: xterm.js のようなライブラリ)を使って文字単位の入出力を扱い、WebSocket 等の双方向通信で低レイテンシにやり取りします。

実装上の注目点としては、プロセス管理とセキュリティが重要になります。claude プロセスの起動と終了、標準入出力のストリーミング、同時接続時のセッション管理をきちんと行う必要があります。また、ローカルネットワークでの通信とはいえ認証やアクセス制御が求められるため、.env による設定や、必要に応じて HTTPS や SSH トンネル、ローカルファイアウォールの活用を推奨します。ログの扱いや一時ファイルの管理、プロンプトやコード断片が外部に漏れないような取り扱い方針(SECURITY.md の参照)も設計上のポイントです。

開発者視点では、Python の subprocess/pty まわり、非同期の入出力(asyncio 等)や WebSocket サーバー実装、クロスプラットフォームのパスや権限周りの設計が肝となります。さらにモバイルブラウザでの表示やキーボード挙動、長時間セッションの再接続戦略(再接続時のバッファ同期)もユーザビリティに直結するため設計時に考慮されます。全体としては「ローカルでの安全なリモート端末アクセス」をシンプルに実現するアーキテクチャになっています。(約700〜800字)

プロジェクトの構成

主要なファイルとディレクトリ(抜粋):

  • .env.example: 環境変数のサンプル。ポート番号や認証キーなどの設定をここからコピーして .env を作成する想定。
  • .gitignore: Git 管理対象外にするファイル一覧。
  • LICENSE: ライセンスファイル。利用・再配布時の条件を確認する。
  • README.md: セットアップ手順や使い方、依存関係の説明。
  • SECURITY.md: セキュリティに関するガイドラインや報告方法。

その他の想定ファイル(リポジトリ内の構成に基づく推測):

  • サーバー本体スクリプト(Python): claude プロセス管理、WebSocket や HTTP サーバーを起動するコア部分。
  • 静的資産(HTML/CSS/JS): モバイル向けのターミナル UI を提供するフロントエンド。
  • サンプル設定やユーティリティ: 起動スクリプト、README に記載のセットアップ用シェルや Python requirements。
  • テストや CI 設定(存在する場合): 基本的な動作検証やフォーマットチェックなど。

ファイル数は合計で 15、コミット数 27 と比較的小規模なプロジェクトです。主要機能はシンプルにまとまっており、拡張ポイント(認証の強化、HTTPS 化、複数セッション管理、ログ機能の追加など)が把握しやすくなっています。セットアップ手順は README にあり、.env.example を基に環境を整えれば動作させられる設計です。

…他 10 ファイル

まとめ

ローカルで安全に Claude CLI をモバイルから使いたい開発者にとって実用的で軽量なソリューションです。(約50字)

リポジトリ情報:

READMEの抜粋:

Claude-on-the-go

Control your Mac’s claude CLI from your phone. Because sometimes you just want to code from the couch.

Use Claude on your iPhone, Android, or any device with a browser - while your Mac does the heavy lifting. No cloud sync, no data leaks, just your local network keeping things fast and private.