リモートコントロール
claude.aiのWebインターフェースやモバイルアプリから、ローカルで動作するClaude Codeを遠隔操作する機能。外出先や別デバイスからローカル環境のコードベースにアクセスして作業を継続できる。
コマンド・設定オプション36件
この機能に関連するスラッシュコマンド・CLIオプション・設定項目の一覧です。
スラッシュコマンド
Claude Code のインタラクティブセッション内で / から始めて入力するコマンド。
Remote Control(claude.ai / モバイルアプリからの遠隔操作)
/rc
`/remote-control` のエイリアス。実行中のセッションをRemote Control対象にする。
/rc My Project/remote-control
実行中のインタラクティブセッションをRemote Control対象にする。claude.aiやClaudeモバイルアプリからブラウザ・スマートフォンでセッションを操作できるようになる。`/rc` でも起動可能。
/remote-control My Project/teleport
Claude Code on the webで実行中のWebセッションをローカルターミナルに取り込む。ピッカーを開き、ブランチと会話を取得する。claude.aiサブスクリプションが必要。`/tp` でも起動可能。
/teleport/remote-env
`--remote` で起動するWebセッションのデフォルトのリモート環境を設定する。
/remote-envCLIオプション
`claude` コマンドをターミナルから起動する際に渡すオプション。
Remote Control(claude.ai / モバイルアプリからの遠隔操作)
--remote
**非推奨**: `--cloud` の旧名称。claude.aiに新しいWebセッションを作成してタスクを開始する。ローカルセットアップなしでクラウド実行したい場合に使用。
claude --remote "ログインバグを修正して"--cloud
claude.aiに新しいWebセッションを作成してタスクを開始する(`--remote` の後継名称)。ローカルセットアップなしでクラウド実行したい場合に使用。
claude --cloud "ログインバグを修正して"claude self-hosted-runner setup
自組織のインフラでClaude Codeクラウドセッションを実行する「セルフホスト環境」を対話形式でセットアップする(Team/Enterprise向けパブリックベータ、v2.1.224以降)。管理者が事前にadmin設定で有効化しておく必要がある。
claude self-hosted-runner setup--remote-control / --rc
Remote Controlを有効にしてインタラクティブセッションを開始する。claude.aiやClaudeモバイルアプリから遠隔操作できる。Pro/Max/Team/Enterprise プランかつclaude.ai OAuth認証が必要。
claude --rc "My Project"claude remote-control
サーバーモードでRemote Controlを起動する。複数のWebセッションから並列でタスクを受け付けられる。`--spawn worktree` でgit worktreeを使った隔離実行、`--capacity N` で最大並行セッション数を指定できる。
claude remote-control --spawn worktree --capacity 8 --name "My Server"--spawn
`claude remote-control` サーバーモードでのセッション作成方法を指定する。`same-dir`(デフォルト、全セッションが作業ディレクトリを共有)・`worktree`(オンデマンドセッションごとに独立したgit worktree)・`session`(単一セッション専用)から選択。
claude remote-control --spawn worktree--capacity
`claude remote-control` サーバーモードでの最大同時セッション数を指定する(デフォルト: 32)。`--spawn session` とは併用不可。
claude remote-control --capacity 8--create-session-in-dir / --no-create-session-in-dir
`claude remote-control` 起動時に現在のディレクトリでセッションを1つ事前作成するかどうかを設定する(デフォルト: 有効)。`worktree` モードではこの事前作成セッションのみ現在のディレクトリに留まる。
claude remote-control --no-create-session-in-dir--sandbox / --no-sandbox(Remote Control)
`claude remote-control` サーバーモードでファイルシステム・ネットワークのサンドボックス分離の有効/無効を切り替える(デフォルト: 無効)。
claude remote-control --sandbox--remote-control-session-name-prefix
Remote Controlのセッション名を自動生成する際のプレフィックスを設定する。デフォルトはマシンのホスト名(例: `myhost-graceful-unicorn`)。環境変数 `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` でも設定可能。
claude remote-control --remote-control-session-name-prefix dev-box--environment <environment-id>
指定したセルフホスト環境(IDは`ccpool_`で始まる)上で動くクラウドセッションを新規作成する(v2.1.224以降)。
claude --environment ccpool_abc123 "テストを実行して"claude self-hosted-runner doctor
デプロイ済みのセルフホストランナーを診断する(v2.1.224以降)。
claude self-hosted-runner doctorclaude self-hosted-runner orchestrator
オンデマンドランナーを起動するオーケストレータープロセスを開始する(v2.1.224以降)。
claude self-hosted-runner orchestrator--defer-shutdown-max-min
セルフホストランナーがSIGTERM受信後もセッションの提供を最大N分間継続してからドレインするよう設定する(`claude self-hosted-runner`実行時、v2.1.238以降)。ローリング再起動時のセッション中断を減らせる。
claude self-hosted-runner --defer-shutdown-max-min 10--proxy-authorization-command
セルフホストランナーが送信する`Proxy-Authorization`ヘッダーの値を、指定したシェルコマンドの標準出力から取得する(v2.1.238以降)。トークンを都度生成する社内プロキシ経由の通信に使用する。
claude self-hosted-runner --proxy-authorization-command "get-proxy-token.sh"--proxy-authorization-file
セルフホストランナーが送信する`Proxy-Authorization`ヘッダーの値を、ファイルの内容から取得する(v2.1.238以降)。別プロセスがトークンをローテーションする構成で使用する。
claude self-hosted-runner --proxy-authorization-file /var/run/proxy-token--client-label
セルフホストランナーの表示ラベルを上書きする(`claude self-hosted-runner`実行時、v2.1.248以降)。複数ランナーを運用する際の識別に使用する。
claude self-hosted-runner --client-label "runner-tokyo-1"--drain-grace-sec
セルフホストランナーがSIGTERM等を受けた後も、ロック済みオーナーのキューをその秒数だけポーリングし続けてから終了する(デフォルト0=即終了)。
claude self-hosted-runner --drain-grace-sec 120--retire-at <epoch-seconds>
指定したUNIX時刻にセルフホストランナーが新規セッションの受付を停止し、稼働中セッションを解放してから終了する。シグナルなしでホストが破棄されるスポットインスタンス等の環境向け。
claude self-hosted-runner --retire-at 1735689600--release-idle-session-min
セルフホストランナーが指定分数アイドル状態のセッションを解放し、次にユーザーがメッセージを送った際に別のランナーへ再開させる。
claude self-hosted-runner --release-idle-session-min 30設定オプション
`claude config set <key> <value>` または `~/.claude/settings.json` で設定する項目。
Remote Control(claude.ai / モバイルアプリからの遠隔操作)
disableRemoteControl
Remote Control機能を無効化する(v2.1.128以降)。`true` に設定するとRemote Controlセッションの開始がブロックされる。Managed設定でOrganization全体に適用する場合に使用。
managed-settings.json: {"disableRemoteControl": true}sshConfigs
チームで共有するSSH接続設定をプリセットとして定義する。Remote Controlサーバーモードで複数マシンへの接続先を事前設定しておく場合に使用。
~/.claude/settings.json: {"sshConfigs": [{"name": "dev-server", "host": "dev.example.com", "user": "ubuntu"}]}remoteControlAtStartup
起動時にRemote Controlに自動接続する(v2.1.119以降)。毎回 `--rc` フラグを渡さなくてもRemote Controlが有効になる。
~/.claude/settings.json: {"remoteControlAtStartup": true}CLAUDE_CODE_DISABLE_REMOTE_CONTROL
Remote Control機能を環境変数で無効化する。`1` に設定すると `disableRemoteControl: true` 設定と同等の効果。
export CLAUDE_CODE_DISABLE_REMOTE_CONTROL=1CLAUDE_CODE_REMOTE
Remote Controlのweb環境で実行中の場合に `"true"` が設定される環境変数(v2.1.199以降)。フックやスクリプトからリモート実行かどうかを判定するのに使用する。
if [ "$CLAUDE_CODE_REMOTE" = "true" ]; then echo remote; fiCLAUDE_CODE_BRIDGE_SESSION_ID
Remote ControlセッションのIDを保持する環境変数(v2.1.199以降)。フックからリモートセッションを識別する用途に使用する。
echo $CLAUDE_CODE_BRIDGE_SESSION_IDremote.defaultEnvironmentId
`claude --cloud`実行時のデフォルトのクラウド環境を指定する。セルフホスト環境の`ccpool_`から始まるIDは、user・managed設定または`--settings`からのみ読み込まれる。
~/.claude/settings.json: {"remote": {"defaultEnvironmentId": "ccpool_abc123"}}sshHostAllowlist
Desktop版のSSHセッションが接続できるホストを制限する。Managed設定向け。
managed-settings.json: {"sshHostAllowlist": ["*.example.com"]}disableDesktopLocalSessions
Claude Code Desktopアプリでデバイス上に直接セッションを起動する「ローカルセッション」機能をオフにする。
~/.claude/settings.json: {"disableDesktopLocalSessions": true}CLAUDE_CLIENT_PRESENCE_FILE
Remote Controlの通知要否を判定するため、ユーザーの在席状態を示すファイルのパスを指定する環境変数。
export CLAUDE_CLIENT_PRESENCE_FILE=/tmp/user-presencedesktopSessionCleanupPeriodDays
デスクトップアプリのローカルセッショントランスクリプトを保持する日数を設定する。
~/.claude/settings.json: {"desktopSessionCleanupPeriodDays": 30}CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS
Remote ControlやSDKホストなどのリモートクライアントに転送したダイアログを取り消すまでの期限(ミリ秒)。`dialogExpiry` 設定より優先。
export CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=600000