Modern software development rarely happens in one place. You might start a coding session at the office, but later need to finish the job from a different computer.
There is a way. You have to push code to GitHub, pull it down on your other machine, and-worst of all-you lose your entire conversation history with your AI assistant.
Recently, I started using Session Teleportation in Claude Code. It allows you to move an entire conversation, including context, history, and the working branch, between the web and your local terminal.
In this tutorial, I show you how it works and how to use it to make your workflow seamless.
<h2>First-Time Setup (Do This First)</h2>
Before you can teleport anything, you need to connect your local environment to Claude’s cloud.
Install and Update First, make sure you have the latest version of Claude Code.
<pre><code class="language-bash">npm install -g @anthropic-ai/claude-code
</code></pre>
or use this comand:
<pre><code class="language-bash">claude update
</code></pre>
<h3>Turn on Claude Code on Web</h3>
<img src="https://miro.medium.com/v2/resize:fit:700/1*n74G1nZ3uTZNkh4_Ks_WrA.png" alt="Turn on Claude Code on Web">
Open the website <a href="https://claude.ai/code" target="_blank" rel="noopener nofollow">https://claude.ai/code</a> and finish the onboarding.
You must connect your GitHub account. This is critical because Claude needs access to your repositories to “teleport” the code changes between devices.
Note: If you use an organization’s repository (like at work), you might need to click “Grant” next to your organization’s name in the GitHub permissions screen.
Then set up cloud environments. Give it a name and network access.
<img src="https://miro.medium.com/v2/resize:fit:700/1*BCoVR1GHciIk8dIp3yR5uA.png" alt="Set up cloud environments">
<h2>How Session Teleportation Works</h2>
Navigate to your project folder in the terminal and run <code>claude</code>. Claude will detect your git repository and make sure it has permission to access it.
The teleportation is built around two simple commands.
1. The <code>**&amp;**</code> Prefix (Send to Web) This is how you start a “background session.” If I type <code>&amp;</code> before my prompt in the CLI or VS Code, Claude runs the task on its cloud infrastructure. Example:
<pre><code class="language-bash">&amp; Refactor the authentication module to use JWT tokens
</code></pre>
2. The <code>**/teleport**</code> Command (Bring to Local): This is how you resume work. You can pull that web session into your local terminal or VS Code using <code>claude --teleport &lt;session-id&gt;</code>.
Important Note: This process is one-way. You can pull a web session down to your terminal, but you cannot “push” an existing local session up to the web. If you think you might need to switch devices later, always start your task with the <code>&amp;</code> prefix!
<h2>Moving Tasks from VS Code to the Web</h2>
Install the Claude Code extension in VS Code or Cursor (via the Extensions panel). Once installed, you can send tasks to the web directly from within your editor.
Compose your prompt. For example, if you want Claude to refactor authentication logic, start your prompt with &amp;:
<pre><code class="language-bash">&amp; Refactor the authentication module to use JWT tokens instead of sessions
</code></pre>
This creates a background web session and returns a session ID. The task continues even if you close VS Code or shut down your laptop.
<img src="https://miro.medium.com/v2/resize:fit:700/1*31QPWfrS0NA2ilXRTiRXRA.png" alt="creates a background web session">
Monitor the session. Use /tasks in the CLI or click on the task in the web interface to see status.
<img src="https://miro.medium.com/v2/resize:fit:700/1*K1MotgAWtaYtMNPmBfa_Jg.png" alt="Monitor the session">
You can also run claude — status &lt;session‑id&gt; from any device.
<h2>Pulling Web Sessions Back to Your Terminal (VS Code or Cursor)</h2>
Locate your session. In the Claude chat, run /teleport (or /tp) to see all active web sessions. From the command line, run claude — teleport for an interactive picker or claude — teleport &lt;session‑id&gt; to resume a specific session.
<pre><code class="language-bash">claude --teleport session_01RyZ89nysBFFZnqFMZ4KpkZ
</code></pre>
Meet the requirements. Before teleporting, Claude checks several conditions:
<ul>
<li>Clean Git state: You must have no uncommitted changes. Teleport will prompt you to stash them if necessary.</li>
<li>Correct repository: You must be in a checkout of the same repository used on the web.</li>
<li>Branch availability: The branch created during the web session must be pushed to the remote; teleport will fetch and check it out.</li>
<li>Same account: You must be authenticated as the same <a href="http://Claude.ai" target="_blank" rel="noopener nofollow">Claude.ai</a> user.</li>
</ul>
<img src="https://miro.medium.com/v2/resize:fit:700/1*mKbNHhr2GCreExcHRxn7IQ.png" alt="Teleport the session">
Teleport the session. Once these conditions are satisfied, Claude will fetch the branch, load the conversation history, and attach the session to your local environment. You can then continue the conversation and review code in Cursor or the terminal as if you never left.
<h2>Pro Tips for Getting the Most Out of Claude Code Teleport</h2>
<ul>
<li>Parallel Work Streams: Sometimes I run multiple &amp; commands at once to start several tasks simultaneously.</li>
<li>Team Collaboration: This is a hidden gem. I can share a Session ID with a teammate, and they can teleport into my session on their machine. It is perfect for async pair programming.</li>
<li>One-Way Only: Remember, you can pull a web session down to your terminal, but you cannot “push” an existing local session up to the web. Always start with &amp; if you think you might need to move!</li>
<li>Maintain a clean Git state. Teleportation requires a clean working directory. Use Git stashes or commit your changes before pulling sessions</li>
</ul>
<h2>Claude Code Teleportation Tutorial</h2>
I also have a video with step-by-step instructions on how to use Claude Code teleportation. Please make sure to check it out.
Watch on YouTube: <a href="https://youtu.be/2j93xjmtI9U?si=KFnRJUOtp_K7aNJW" target="_blank" rel="noopener nofollow">Claude Code Tutorial: Teleportation</a>
<h2>Conclusion</h2>
Session teleportation blurs the line between local and remote development. It allows you to offload compute‑heavy tasks to the cloud, then seamlessly resume work locally without losing context. This cross‑device mobility is valuable for distributed teams and individuals who switch machines throughout the day.
I hope you found this tutorial helpful. If so, please leave your comments and subscribe to <a href="https://www.youtube.com/@proflead/videos?sub_confirmation=1" target="_blank" rel="noopener nofollow">my YouTube channel</a>, where I share a lot of useful tutorials for devs ;).

Helping devs stay ahead with WebDev, AI & productivity tools.

proflead

Claude Code's Session Teleportation feature enables developers to move entire AI coding sessions between devices while preserving conversation history and code context. The workflow involves starting tasks with the '&' prefix to create cloud sessions, then using the '/teleport' command to resume work locally. Setup requires installing Claude Code CLI, connecting a GitHub account, and maintaining a clean Git state. The feature supports cross-device development, parallel task execution, and team collaboration through shared session IDs.

Stop Copy-Pasting Your Code to Claude (Do This Instead)