Claude Code Remote

· Applications

Claude Code は現在最も強力な AI 搭載コーディングアシスタントの一つですが、ローカルコンソールウィンドウから使用するには実際の制限があります。インストールされているマシンに縛られ、スマートフォンからアクセスできず、同僚とセッションを共有する簡単な方法もありません。

sgcClaudeCodeRemote はこれらすべてを解決します。Claude Code を Web ベースのターミナル内にラップする軽量 Windows サーバーで、デスクトップ・ノートPC・タブレット・スマートフォンの任意のブラウザから接続できます。内部では、実際のターミナルセッション用に Windows ConPTY 擬似コンソール API を使用し、ターミナルの入出力をリアルタイムでブラウザにストリーミングするために sgcWebSockets を使用しています。

この記事では、機能・設定オプション、およびコンソールから Claude Code を直接実行する場合と比較した利点について説明します。

Claude Code をリモートで使用する理由

sgcClaudeCodeRemote は、コンソールで Claude Code を使用する際に開発者が直面する最も一般的な問題点を解決します。

任意のデバイスからアクセス
スマートフォン・タブレット・ノートPCのブラウザを開いて、開発マシンで動作している Claude Code に接続します。Node.js も CLI のインストールも不要 — URL だけで OK。 		コラボレーティブセッション
複数の開発者が同じ名前付きセッションに参加し、Claude の出力をリアルタイムで確認できます。ペアプログラミングが組み込み済み — 画面共有ツール不要。 		デフォルトでセキュア
ブルートフォース保護付きパスワード認証・設定可能なタイムアウト・IP ブロック、インターネット向け展開のためのオプション TLS 1.3 暗号化を備えています。

モバイルフレンドリーなターミナル

Web インターフェースはモバイルデバイスでの動作向けに設計されています。画面下部のタッチ最適化キーツールバーは、Claude Code に必要だがモバイルキーボードにない特殊キーを提供します：

ボタン 機能
Esc 現在の操作をキャンセルするか戻ります
Tab 候補を承認してオートコンプリートします
Intro 入力を確定します（Enter キー）
Ctrl スティッキーモディファイアー — 1回タップして、Ctrl+C（割り込み）などのコンボのために文字をタップします
↑ ↓ ← → コマンド履歴とメニューを操作します

ツールバーはタッチスクリーンで即時レスポンスのために pointerdown イベントを使用し、ターミナルをアクティブに保つためにフォーカス奪取を防止します。ビューポートは動的ビューポートユニット（dvh）を使用してモバイルブラウザのクロームに適応し、スクロールせずにツールバーが常に表示されます。

名前付きセッション

各接続はセッション名を指定できます（例：「backend-refactor」・「devops」・「testing」）。セッションはサーバーの有効期間中持続するため、後で切断して同じ Claude Code インスタンスに再接続できます。

認証とセキュリティ

sgcClaudeCodeRemote は標準で複数の保護レイヤーを含んでいます：

パスワード認証
単一の共有パスワードでアクセスを保護します。ユーザー名は不要 — パスワードのみです。ログインフォームはブラウザの認証情報オートコンプリートを無効化して誤った保存を防止します。 		ブルートフォース保護
同じ IP から5回の認証失敗後、そのアドレスを5分間ブロックします。ブロックされた IP は接続レベルでそれ以上の処理前に拒否されます。
認証タイムアウト
クライアントは設定可能なウィンドウ内（デフォルト15秒）に認証する必要があります。認証情報を送信しないアイドル接続は自動的に切断されます。 		TLS 1.3 暗号化
インターネット向け展開では、証明書とキーファイルで TLS を有効化します。ブラウザとサーバー間のすべてのトラフィックがエンドツーエンドで暗号化されます。

権限プロンプトのスキップ。 ログイン画面のチェックボックス（デフォルトでオン）は、--dangerously-skip-permissions フラグで Claude Code を起動します。これはサーバーコンソールの権限ダイアログを操作できないリモートセッションに不可欠です。

sgcClaudeCodeRemote vs. コンソール版 Claude Code

Claude Code をローカルで実行する場合と sgcClaudeCodeRemote を通じて実行する場合の並べた比較です。

機能 コンソール sgcClaudeCodeRemote
任意のデバイスからアクセス なし あり
モバイル・タブレットサポート なし あり（タッチツールバー）
同一セッションで複数ユーザー なし あり
名前付き永続セッション なし あり
パスワード保護 なし あり（ブルートフォースブロック）
TLS 暗号化 N/A TLS 1.3
クライアントソフトウェアが必要 Node.js + CLI ブラウザのみ
ペアプログラミング 外部ツール 組み込み
リアルタイムレイテンシー表示 なし あり
クライアントプラットフォーム 同一マシンのみ Windows、macOS、Linux、Android、iOS

はじめに

sgcClaudeCodeRemote をダウンロードし、パスワードを指定してコマンドラインから実行します：

sgcClaudeCodeRemote.exe --password MySecretPassword

次にブラウザを開いて http://your-server-ip:8765/ にアクセスします。パスワードを入力し、セッション名を選択すれば接続完了です。

例

カスタムポートと高い接続上限：

sgcClaudeCodeRemote.exe --port 9000 --password MyPass --max-conn 20

インターネット経由のセキュアアクセスのための TLS 暗号化：

sgcClaudeCodeRemote.exe --tls --tls-cert cert.pem --tls-key key.pem --password MyPass

コマンドラインオプション

オプション 説明 デフォルト
--port サーバーリスニングポート 8765
--password アクセスパスワード（認証有効時に必須） —
--command ターミナルで実行するコマンド claude
--cols / --rows 初期ターミナルサイズ 120 × 40
--max-conn 最大同時接続数 10
--timeout 認証タイムアウト（秒） 15
--no-auth 認証を完全に無効化 —
--tls TLS 1.3 暗号化を有効化 —
--tls-cert / --tls-key 証明書と秘密鍵の PEM ファイル —
--tls-password 秘密鍵のパスワード（暗号化されている場合） —
--tls-port TLS リスニングポート --port と同じ

ユースケース

動作の仕組み

sgcClaudeCodeRemote は3つのコア技術で構築された Delphi コンソールアプリケーションです：

Windows ConPTY
Windows 10 の擬似コンソール API は VT100/ANSI シーケンスを完全サポートする実際のターミナルセッションを作成します。Claude Code は通常のターミナルウィンドウと同様にこのコンソール内で動作します。 		sgcWebSockets
sgcWebSockets ライブラリはすべての WebSocket 通信・HTTP サービング・オプションの TLS 暗号化を処理します。バイナリフレームはターミナル出力を運び、JSON テキストフレームは認証とコントロールメッセージを処理します。 		xterm.js
ブラウザは xterm.js と fit アドオン（ウィンドウへの自動リサイズ）および web-links アドオン（クリック可能な URL）を使用してターミナルをレンダリングします。ダークテーマは Claude Code の外観に合わせています。

システム要件。 サーバーは Windows 10 バージョン 1809 以降（ConPTY サポート用）とホストマシンに Claude Code がインストールされている必要があります。クライアントにはモダンな Web ブラウザのみが必要です。

Web インターフェースの機能

シングルページ Web UI は実行ファイルに直接埋め込まれており、外部ファイルの展開は不要です。以下を含みます：

sgcClaudeCodeRemote をダウンロード

sgcClaudeCodeRemote は sgcWebSockets で構築されています — Delphi および .NET 向けの高性能 WebSocket コンポーネントです。

www.esegece.com