Claude Codeの設定 - リモートアクセスのソースを表示

== 概要 ==
Claude Codeは、Anthropicが提供するAIエージェント型コーディングツールであり、OpenCodeのようなクライアント・サーバアーキテクチャを持たない。<br>
<br>
そのため、OpenCodeの <code>opencode serve</code> や <code>opencode web</code> コマンドのようなサーバ起動コマンドは存在せず、HTTPサーバとして動作させることはできない。<br>
<br>
しかし、以下に示す3つの方法でリモートアクセスを実現できる。<br>
* SSH + Tailscale + tmux
*: SSHでリモートサーバに接続し、Tailscaleでセキュアなネットワークを構築、tmuxでセッションを永続化する方法である。<br>
* VS Code Remote SSH
*: VS CodeのRemote SSH拡張機能を使用してリモートサーバに接続し、Claude Code拡張機能を使用する方法である。<br>
* Remote Control (/rc)
*: Claude Codeの組み込み機能を使用して、モバイルアプリやブラウザからローカルセッションを継続する方法である。<br>
<br>
下表に、各方法の特徴を示す。<br>
<center>
{| class="wikitable"
|+ リモートアクセス方法の比較
! 方法 !! 接続先 !! 必要なプラン !! 特徴
|-
| SSH + Tailscale + tmux || リモートサーバ || 全プラン対応 || セッション永続化<br>低コスト
|-
| VS Code Remote SSH || リモートサーバ || 全プラン対応 || IDE統合<br>使いやすいUI
|-
| Remote Control (/rc) || ローカルPC || Max / Pro (予定) || モバイル対応<br>公式機能
|}
</center>
<br><br>

== 方法 1 : SSH + Tailscale + tmux ==
SSHでリモートサーバに接続し、tmuxでセッションを永続化することで、Claude Codeをリモート環境で使用できる。<br>
Tailscaleを使用することで、ポート転送や動的DNSの設定不要でセキュアな接続が可能である。<br>
<br>
==== 前提条件 ====
* サーバ側
*: Claude CodeがインストールされているLinuxディストリビューション : RHEL、SUSE、Debian等
* クライアント側
*: SSHクライアントが動作する任意のデバイス : PC、スマートフォン等
* Tailscaleアカウント
*: 無料アカウントで最大100デバイスまで接続可能である。
<br>
==== Tailscaleの設定 ====
===== サーバ側の設定 =====
Tailscaleをサーバにインストールして設定する。<br>
<br>
 # Tailscaleのインストール (Linux)
 curl -fsSL https://tailscale.com/install.sh | sh
 
 # Tailscaleにログイン
 sudo tailscale up
<br>
ログインが完了すると、サーバにTailscaleのIPアドレス (例: 100.64.1.5) が割り当てられる。<br>
また、ホスト名 (例: myserver.ts.net) でアクセスできるようになる。<br>
<br>
===== クライアント側の設定 =====
クライアントデバイスにもTailscaleをインストールする。<br>
<br>
* Windows / MacOS / Linux
*: [https://tailscale.com/download Tailscaleの公式サイト]からインストーラをダウンロードしてインストールする。
* iOS / Android
*: App Store または Google PlayからTailscaleアプリをインストールする。
<br>
サーバ側と同じTailscaleアカウントでログインすることにより、デバイス間で接続可能になる。<br>
<br>
==== SSH接続設定 ====
===== サーバ側のSSH設定 =====
SSHサーバが有効になっていることを確認する。<br>
<br>
 # RHEL / SUSE
 sudo systemctl enable sshd
 sudo systemctl start sshd
 
 # ファイアウォールでSSHを許可 (firewalld使用時)
 sudo firewall-cmd --permanent --add-service=ssh
 sudo firewall-cmd --reload
<br>
===== クライアント側からの接続 =====
Tailscale経由でSSH接続する。<br>
<br>
 # TailscaleのIPアドレスで接続
 ssh <ユーザ名>@<IPアドレス または ホスト名  例: 100.64.1.5>
 
 # またはTailscaleのホスト名で接続
 ssh <ユーザ名>@<IPアドレス または ホスト名  例: myserver.ts.net>
 </syntaxhighlight>
<br>
==== tmuxによるセッション永続化 ====
===== tmuxのインストール =====
サーバ側にtmuxをインストールする。<br>
<br>
 # RHEL
 sudo dnf install tmux
 
 # SUSE
 sudo zypper install tmux
 
 # Debian
 sudo apt install tmux
 
 # MacOS
 brew install tmux
 </syntaxhighlight>
<br>
===== tmuxセッションの作成と使用 =====
tmuxセッションを作成して、Claude Codeを実行する。<br>
<br>
 # 新しいtmuxセッションを作成
 tmux new -s claude
 
 # Claude Codeを起動
 claude
 
 # セッションからデタッチ ([Ctrl] + [B]キー → [D]キー)
 # セッションはバックグラウンドで継続する
<br>
===== tmuxセッションへの再接続 =====
接続が切れた場合や別のデバイスから接続する場合、既存のセッションに再接続できる。<br>
<br>
 # セッション一覧を表示
 tmux ls
 
 # 既存のセッションにアタッチ
 tmux attach -t claude
 
 # セッションが存在する場合はアタッチ、存在しない場合は新規作成
 tmux new -A -s claude
<br>
===== SSH接続時に自動的にtmuxセッションに接続する設定 =====
<u>.ssh/config</u> ファイルを設定することにより、SSH接続時に自動的にtmuxセッションに接続できる。<br>
<br>
 vi ~/.ssh/config
<br> 
 # ~/.ssh/configファイル
 
 Host claude-server
    HostName <ホスト名  例: myserver.ts.net>
    User <ユーザ名>
    RequestTTY yes
    RemoteCommand tmux new -A -s claude
<br>
この設定により、以下に示すコマンドだけで自動的にtmuxセッションに接続できる。<br>
<br>
 ssh claude-server
<br><br>

== 方法 2 : VS Code Remote SSH ==
VS CodeのRemote SSH拡張機能を使用して、リモートサーバ上のClaude CodeをIDE内で使用できる。<br>
<br>
==== 前提条件 ====
* クライアント側
*: Visual Studio Code 1.98.0以降
* サーバ側
*: SSHサーバが動作するLinuxサーバ (RHEL 7以降、Ubuntu 16.04以降等)
*: 最低1[GB] RAM、推奨2[GB] RAM以上<br>
<br>
==== VS Code拡張機能のインストール =====
===== Remote SSH拡張機能のインストール =====
VS CodeでRemote SSH拡張機能をインストールする。<br>
<br>
# VS Codeを開く。
# 拡張機能ビューを開く。([Ctrl] + [Shift] + [X]キー)
# <u>Remote - SSH</u> を検索する。
# Microsoftが提供する <u>Remote - SSH </u> 拡張機能をインストールする。
<br>
===== Claude Code拡張機能のインストール =====
# 拡張機能ビューで <u>Claude Code</u> を検索する。
# Anthropicが提供する公式拡張機能をインストールする。
<br>
==== Remote SSHの設定 =====
===== SSHホストの追加 =====
# コマンドパレットを開く。([Ctrl] + [Shift] + [P]キー)
# <u>Remote-SSH: Add New SSH Host</u> を選択する。
# 接続コマンドを入力する。
#: <pre>ssh <ユーザ名>@<IPアドレス または ホスト名  例: myserver.ts.net></pre>
# SSH設定ファイルを選択する。<br>通常は、<u>~/.ssh/config</u> ファイル
<br>
===== SSH設定ファイルの例 =====
 vi ~/.ssh/config
<br> 
 # ~/.ssh/configファイル
 
 Host claude-server
    HostName <IPアドレス または ホスト名  例: myserver.ts.net>
    User <ユーザ名>
    IdentityFile ~/.ssh/id_ed25519
<br>
==== リモートサーバへの接続 =====
# コマンドパレットを開く。([Ctrl] + [Shift] + [P]キー)
# [Remote-SSH: Connect to Host]を選択する。
# 設定したホスト名を選択する。
# 新しいVS Codeウィンドウが開いて、リモートサーバに接続される。
<br>
初回接続時は、VS Code Serverがリモートサーバに自動的にインストールされる。<br>
数分掛かる場合があることに似注意する。<br>
<br>
==== Claude Code拡張機能の使用 =====
リモートサーバに接続した状態で、Claude Code拡張機能を使用できる。<br>
<br>
# サイドバーのClaude Codeアイコンを選択する。
# チャットパネルが開くので、リモートサーバ上のファイルやプロジェクトに対してClaude Codeを使用できる。
<br>
<u>※注意</u><br>
<u>VS Code拡張機能では <code>/rc</code> コマンド (Remote Control) はサポートされていない。</u><br>
<br><br>

== 方法 3 : Remote Control (/rc) ==
Remote Controlは、Claude Codeの組み込み機能であり、ローカルで実行中のセッションをモバイルアプリやWebブラウザから継続できる。<br>
<br>
==== 機能の概要 ====
Remote Controlを使用すると、以下に示すことが可能である。<br>
* デスクで開始したタスクを、スマートフォンやタブレットから継続できる。
* ローカル環境 (ファイルシステム、MCPサーバ、ツール、プロジェクト設定) をリモートから利用できる。
* 複数のデバイス間で会話が同期される。
* ネットワーク切断やスリープから自動的に復旧できる。
<br>
<u>※注意</u><br>
<u>セッションはローカルPCで実行され続ける。</u><br>
<u>ソースコードはクラウドに転送されない。</u><br>
<br>
==== 対応プラン ====
<center>
{| class="wikitable"
|+ Remote Control対応プラン
! プラン !! 対応状況
|-
| Max || 対応済み (リサーチプレビュー)
|-
| Pro || 順次ロールアウト予定
|-
| Team || 未対応
|-
| Enterprise || 未対応
|-
| API キー || 未対応
|}
</center>
<br>
==== 設定方法 =====
===== 前提条件 =====
* Maxプラン または Proプランのサブスクリプションを契約していること。
* <code>claude</code> コマンドで <code>/login</code> を実行してclaude.aiで認証済みであること。
* ワークスペースの信頼ダイアログを承認済みである琴。
<br>
===== 新規セッションの開始 =====
プロジェクトディレクトリで以下に示すコマンドを実行する。<br>
<br>
 # Remote Controlセッションを開始
 claude remote-control
<br>
セッションURLとQRコードが表示される。<br>
スペースキーを押下すると、QRコードの表示を切り替えられる。<br>
<br>
===== 既存セッションからのRemote Control開始 =====
既にClaude Codeセッションを実行中の場合、以下のコマンドでRemote Controlを開始できる。<br>
<br>
 /remote-control
 # または短縮形で
 /rc
<br>
===== 他のデバイスからの接続 =====
Remote Controlセッションがアクティブな場合、以下に示す方法で接続できる。<br>
<br>
* ブラウザでセッションURLを開く<br>
*: [https://claude.ai/code claude.ai/code]でセッションに直接アクセスできる。
* QRコードをスキャンする。
*: Claude mobile app (iOS / Android) でQRコードをスキャンして接続する。
* Claude mobile appでセッション一覧から選択する。
*: リモートセッションはコンピュータアイコンと緑のステータスドットで表示される。
<br>
===== 全セッションでRemote Controlを有効にする =====
デフォルトでは、Remote Controlは明示的に有効化した場合のみ動作する。<br>
<br>
全てのセッションで自動的にRemote Controlを有効にするには、Claude Code内で <code>/config</code> を実行し、<br>
[Enable Remote Control for all sessions]を <code>true</code> に設定する。<br>
<br>
==== 制限事項 ====
* <u>1つのClaude Codeセッションにつき1つのリモート接続のみサポート</u>
* <u>ターミナルを閉じるとセッションが終了する。</u>
* <u>ネットワークが約10分間切断されるとセッションがタイムアウトする。</u>
<br><br>

== トラブルシューティング ==
==== SSH接続できない場合 ====
===== チェックリスト =====
* SSHサーバが起動しているか確認<br>
*: <code>sudo systemctl status sshd</code> コマンドで確認する。
* ファイアウォール設定を確認
*: SSHポート (デフォルトは、22番ポート) が開放されているか確認する。
* Tailscaleの接続状態を確認
*: <code>tailscale status</code> コマンドでデバイスがオンラインか確認する。
<br>
===== Tailscaleのトラブルシューティング =====
 # Tailscaleの状態確認
 tailscale status
 
 # Tailscaleの再接続
 sudo tailscale down
 sudo tailscale up
 
 # DNSの確認
 tailscale status --json | jq .Self.DNSName
<br>
==== tmuxセッションが見つからない場合 ====
 # セッション一覧を表示
 tmux ls
 
 # 全てのセッションを確認
 tmux list-sessions
 
 # セッションが存在しない場合は新規作成
 tmux new -s claude
<br>
==== VS Code Remote SSHで接続できない場合 ====
* ログの確認
*: [表示] - [出力] - [Remote-SSH] でログを確認する。
* SSH設定の確認
*: <u>~/.ssh/config</u> ファイルの設定が正しいか確認する。
* 手動SSH接続の確認
*: ターミナルから直接 <code>ssh <ユーザ名>@<IPアドレス または ホスト名></code> で接続できるか確認する。
<br>
==== Remote Controlが動作しない場合 ====
===== プランの確認 =====
<u>Remote Controlは、Claude MaxプランまたはProプランでのみ利用可能である。</u><br>
Team、Enterprise、APIキーを使用している場合は利用できない。<br>
<br>
===== 認証の確認 =====
 # ログイン状態を確認
 claude /login
 
 # 再度ログイン
 claude /login
<br>
===== ネットワークの確認 =====
* ローカルPCがインターネットに接続されているか確認する。
* ファイアウォールで発信HTTPS接続がブロックされていないか確認する。
<br>
==== モバイルアプリでQRコードが読み取れない場合 ====
* Claude mobile appが最新版であることを確認する。
* QRコードを拡大してスキャンする。
* 手動でセッションURLを入力する。
<br><br>

== 関連リンク ==
* [https://code.claude.com/docs/en/remote-control Claude Code公式ドキュメント - Remote Control]
* [https://code.claude.com/docs/en/vs-code Claude Code公式ドキュメント - VS Code Extension]
* [https://code.visualstudio.com/docs/remote/ssh VS Code公式ドキュメント - Remote SSH]
* [https://apps.apple.com/us/app/claude-by-anthropic/id6473753684 Claude iOS App]
* [https://play.google.com/store/apps/details?id=com.anthropic.claude Claude Android App]
* [https://tailscale.com Tailscale公式サイト]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Claude Code,Remote Access,SSH,Tailscale,tmux,VS Code,Remote SSH,Remote Control,Anthropic,AI,Development,SUSE,Linux,RHEL
|description={{PAGENAME}} - Claude Codeのリモートアクセス方法 (SSH+Tailscale+tmux、VS Code Remote SSH、Remote Control) に関する設定ガイド | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]