Claude Code teleportの使い方 — クラウドのセッションをローカルへ引き継ぐ

claude teleportは、クラウドのセッションをローカルのターミナルへ引き継ぐ機能です。claude --teleportか、セッション内の/teleport(短縮形/tp)で実行します。ブランチと会話履歴が手元に入り、続きをそのまま進められます。逆向き(ローカルからクラウド)は--cloud、ローカルを外から操作するのは/remote-controlで、役割が別です。入口は5つ、事前に満たす条件は4つあり、どれか1つでも欠けるとエラーか確認プロンプトで止まります。

ローカルとクラウドの行き来は、方向ごとに操作が違う

「ローカルとクラウドを行き来したい」ときは、どの方向かで使うコマンドが決まります。teleportが担うのはクラウドからローカルの1方向だけです。

CLIから進行中のセッションをクラウドへ送る操作はありません。--cloudは新しいセッションを作る命令で、既存のターミナルセッションは移りません。旧称の--remoteは非推奨エイリアスとして今も動きます。

テレポートはセッションをどう引き込むか

テレポートとは、claude.ai上のクラウドセッションをローカル端末のターミナルに引き込むClaude Codeの機能です。対象はWeb版やモバイルアプリで動いているセッションで、実行すると次の順に処理が進みます。

claude.aiとClaude Codeがそれぞれ何を担うかはClaude.aiとClaude Codeの違いで比較しています。バックグラウンド編集を直接許可する設定はworktree.bgIsolationにまとめています。

クラウドセッションはPro、Max、Teamプランで使え、EnterpriseではプレミアムシートかChat + Claude Codeシートが対象です。典型的な使い方は、通勤中にモバイルアプリでタスクを投げておき、帰宅後にテレポートで手元のターミナルへ持ち帰って続きを詰める、という組み合わせです。クラウド側は環境構築済みの状態でタスクを進めており、ローカルに戻ったあとはエディタや手元のツールをフル活用できます。

引き込み後のターミナルセッションは、独立したコピーになります。ローカルで続けた作業はそのマシンだけのもので、claude.aiやモバイルアプリ側のクラウドセッションには反映されません。複数のセッションを並行して手元で管理したい場合は、Worktreeガイドでブランチごとの作業ツリー分離を確認できます。

クラウド側の操作から知りたい場合は、Claude Code Web版の使い方ガイドが早道です。

--teleportと--resumeはどちらを使うか

名前が似ていますが、参照するデータが違います。迷ったら「セッションがどこで動いていたか」で決まります。

実行前に満たす4つの条件

テレポートは実行前に4つの条件を確認します。1つでも欠けると、エラーになるか解決を促すプロンプトが出ます。

未コミットの変更は、v2.1.243より前はセッションIDを直接指定する形(claude --teleport <session>)だと、stashを提案せずに終了していました。ピッカー経由では以前から提案されていたので、v2.1.243以降は両方の経路で同じ挙動になります。

リポジトリが違う場合、v2.1.219以降のエラーは、セッション側のリポジトリと手元のチェックアウトの両方を名指しします。それ以前は、手元のチェックアウトのリポジトリ名が出ませんでした。

「同一リポジトリ」の判定は、git@work:owner/repo.gitのようなSSHホストエイリアスでも通る作りになっています。リモートをホスト名に解釈できないときは、確認プロンプトを出します。そのうえでowner名とリポジトリ名がセッション側と一致すれば、チェックアウトを受け付けます。

テレポートする5つの入口

同じ引き込み処理に対して、入口は5つあります。どこからでも結果は同じで、選ぶのは自分がいま居る場所だけです。

ターミナルを開いていない状態から始めるなら--teleportが最短です。

claude --teleport

セッションIDが分かっている場合は引数に渡すと、ピッカーを経由せず直接そのセッションへ入れます。IDはclaude.ai/codeのセッション一覧で確認できます。

claude --teleport session_01DiUkqY2kzbUbDmW1w96rfi

v2.1.285のclaude --helpでは、この引数は省略可能なものとして出ます。手元で確認した出力は次のとおりです。

claude --help | grep -A1 -e '--teleport'

  --teleport [session]                  Resume a teleport session, optionally
                                        specify session ID

同じヘルプでは、--cloudは説明文かセッションIDかclaude.ai/codeのURLを受け取ると表示されます。新しいクラウドセッションを作るコマンド(-p付きなら既存セッションへメッセージを送るコマンド)で、テレポートとは別物です。名前を取り違えやすい点に注意が要ります。

ピッカーやセッション一覧で複数の作業を見分けやすくしたい場合は、あらかじめセッションに名前を付けておくと--teleport実行時も迷いません。名前を付ける5つの経路と、付けなかった場合に自動で付く2種類のラベルの違いはClaude Codeでセッションに名前をつけて管理するにまとめています。

teleportとRemote Controlはどう違うか

teleportはセッションの中身を手元へコピーし、Remote Controlは手元のセッションを遠隔から操作します。Remote Controlはclaude.aiやモバイルアプリから、自分のマシンで動くセッションに指示を出す仕組みで、実行場所は変わりません。teleportは実行場所がクラウドからローカルに移ります。

テレポート後にスマホから操作するには

テレポートしたセッションはローカルの独立したコピーなので、そのままではスマホやブラウザーから見えません。テレポート後も外出先から指示を出したい場合は、ローカルセッション内で/remote-control(短縮形/rc)を起動します。表示されるURLを開くかQRコードをスキャンすれば、そのローカルセッションをclaude.aiやモバイルアプリから操作できます。「クラウドで始めて手元に持ち帰り、そこから先はRemote Controlでスマホから仕上げる」という流れが組めます。

この組み合わせには、過去の不具合があります。v2.1.261より前は、Remote Control接続中に/teleportで引き込むと、元のセッションの末尾に引き込んだ内容が付いた状態で、スマホやWebに表示されていました。古いバージョンでこの表示に当たったら、更新が先です。

なお、接続中の端末には、引き込んだ会話の過去の履歴が届きません。こちらは不具合ではなく仕様で、更新しても変わりません。

Remote Controlの認証や制限まで含めた詳細はClaude Code Web版の使い方ガイドにまとめています。

変更履歴で見るテレポートの改善点

テレポートは、v2.0.24でWeb→CLIの引き継ぎとして追加された機能です。公式changelogを追うと、機能追加のあとは運用まわりの修正が続いてきた経緯が見えます。

初期は機能追加そのものでしたが、v2.1.108以降は失敗したときの見え方を直す修正が続いています。v2.1.223のクラウド側ヒントは、テレポートの存在をWeb側のUIから気づかせる導線の追加です。

v2.1.285の変更は、SSHの鍵にパスフレーズが付いている環境に関わります。/teleportのfetch中にパスフレーズの入力を求められる代わりに、その場で失敗する挙動になりました。テレポートが取得で止まるときは、SSHの認証状態を先に見ておく選択肢があります。

テレポートでよくあるエラーと対処

テレポートが動かないときは、エラー文言で、認証・プロバイダー・組織ポリシーのどれが原因かを見分けられます。

• Cloud sessions aren't available with <provider>が出る: テレポートはclaude.aiサブスクリプション認証が前提です。Amazon BedrockやGoogle CloudのAgent Platformなどのサードパーティプロバイダーを設定している場合、クラウドセッションはAnthropicのインフラ上で動くため使えません。メッセージにはプロバイダー名が入り、CLAUDE_CODE_USE_BEDROCKなどの設定を外してAnthropicアカウントでサインインし直します
• Unable to get organization UUIDが出る: APIキー認証のまま、またはアカウント情報が古いままテレポートを呼んでいる状態です。/loginでclaude.aiアカウントに改めてサインインしてから再実行します
• ピッカーにError loading Claude Code sessionsと出る: セッションIDなしのclaude --teleportで、APIキー認証かアカウント情報の古さが原因のときは、上のメッセージではなくこの表示になります。対処は同じで/loginです
• Remote Control session expiredやAccess deniedが出る: テレポートはクラウドセッションと同じRemote Control基盤を経由するため、認証エラーがRemote Control由来の文言で出ます。接続トークンは短命でアカウントに紐づいています。/loginで認証情報を更新し、セッションを作ったのと同じアカウントかを確認します
• Cloud sessions are disabled by your organization's policyやRemote Control may not be available for this organizationが出る: 組織のallow_remote_sessionsポリシーが無効です。Ownerがclaude.ai/admin-settings/claude-codeのClaude Code管理設定で有効にします

v2.1.268より前は、組織ポリシーでクラウドセッションが無効なとき、/teleportや/remote-envが「Unknown command」と返す仕様でした。コマンド自体が無いように見えるので、古いバージョンでこの表示が出たら、まず組織ポリシーを疑う手があります。

v2.1.108より前は、作業ディレクトリに変更が残っている・セッションが見つからないといった前提条件エラーがメッセージを出さずに終了しており、原因が追いにくい状態でした。同バージョン以降は、失敗の理由が画面に出ます。履歴を読めないときのFailed to fetch session from Sessions APIは、再実行と報告の手順で扱っています。

テレポートしたブランチはそのままpushできるか

Web版からのテレポートに限り、v2.0.41以降はブランチのupstream設定が自動で行われます。取り込んだブランチにはあらかじめリモート追跡ブランチが結び付けられているため、作業を終えたあとはgit pushだけでリモートに反映できます。-uオプションでリモートを指定し直す必要はありません。

CLIやモバイルアプリ発のセッションが、この自動設定の対象になるかは、公式changelogに明記がありません。push前にgit branch -vvで追跡先を確認しておくと安心です。

まとめ

手元で続けるなら引き込むだけ、外出先からも触りたいなら引き込んだ先でRemote Controlを起動する、という使い分けになります。

セッションを引き込むのではなく、最初からリモートサーバー上でclaudeを直接使いたい場合は、Claude Code SSH接続ガイドの認証手順が別途必要です。/teleport以外のコマンド一覧も押さえておくと、クラウドとローカルを行き来する運用がさらにスムーズになります。