Modern software development rarely happens in one place. You might start a coding session at the office, then need to finish the job from a different computer. There is a way—but it usually means pushing code to GitHub, pulling it down on another machine, and, worst of all, losing your entire conversation history with your AI assistant. is Recently, I started using Session Teleportation in Claude Code. It lets you move an entire conversation—including context, history, and the working branch—between the web and your local terminal. In this tutorial, I’ll show you how it works and how to use it to make your workflow seamless. First-Time Setup (Do This First) Before you can teleport anything, you need to connect your local environment to Claude’s cloud. Install and Update Install and Update First, make sure you have the latest version of Claude Code. npm install -g @anthropic-ai/claude-code npm install -g @anthropic-ai/claude-code or use this command: claude update claude update Turn on Claude Code on Web Turn on Claude Code on Web Open the website https://claude.ai/code and finish the onboarding. https://claude.ai/code https://claude.ai/code You must connect your GitHub account. This is critical because Claude needs access to your repositories to “teleport” the code changes between devices. must 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. 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. How Session Teleportation Works Navigate to your project folder in the terminal and run claude. Claude will detect your Git repository and ensure it has the necessary permissions to access it. claude The teleportation is built around two simple commands. 1. The & Prefix (Send to Web) This is how you start a "background session." If I type & before my prompt in the CLI or VS Code, Claude runs the task on its cloud infrastructure. 1. The & Prefix (Send to Web) & Example: & Refactor the authentication module to use JWT tokens Example: & Refactor the authentication module to use JWT tokens Example: & Refactor the authentication module to use JWT tokens 2. The /teleport Command (Bring to Local): This is how you resume work. You can pull that web session into your local terminal or VS Code using claude --teleport <session-id>. 2. The /teleport Command (Bring to Local): claude --teleport <session-id> 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 & prefix! Important Note: one-way & Moving Tasks from VS Code to the Web 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 &: & Refactor the authentication module to use JWT tokens instead of sessions & Refactor the authentication module to use JWT tokens instead of sessions 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. Monitor the session. Use /tasks in the CLI or click on the task in the web interface to see status. /tasks /tasks Press enter or click to view image in full size Press enter or click to view image in full size You can also run claude — status <session‑id> from any device. claude — status <session‑id> claude — status <session‑id> Pulling Web Sessions Back to Your Terminal (VS Code or Cursor) 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 <session‑id> to resume a specific session. /teleport (or /tp) /teleport (or /tp) claude — teleport <session‑id> claude — teleport <session‑id> claude --teleport session_01RyZ89nysBFFZnqFMZ4KpkZ claude --teleport session_01RyZ89nysBFFZnqFMZ4KpkZ Meet the requirements Before teleporting, Claude checks several conditions: Clean Git state: You must have no uncommitted changes. Teleport will prompt you to stash them if necessary.
Correct repository: You must be in a checkout of the same repository used on the web.
Branch availability: The branch created during the web session must be pushed to the remote; teleport will fetch and check it out.
Same account: You must be authenticated as the same Claude.ai user. Clean Git state: You must have no uncommitted changes. Teleport will prompt you to stash them if necessary. Clean Git state: Correct repository: You must be in a checkout of the same repository used on the web. Correct repository: Branch availability: The branch created during the web session must be pushed to the remote; teleport will fetch and check it out. Branch availability: Same account: You must be authenticated as the same Claude.ai user. Same account: 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. Pro Tips for Getting the Most Out of Claude Code Teleport Parallel Work Streams: Sometimes I run multiple & commands at once to start several tasks simultaneously.
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.
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 & if you think you might need to move!
Maintain a clean Git state. Teleportation requires a clean working directory. Use Git stashes or commit your changes before pulling sessions Parallel Work Streams: Sometimes I run multiple & commands at once to start several tasks simultaneously. Parallel Work Streams: 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. Team Collaboration: 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 & if you think you might need to move! One-Way Only: Maintain a clean Git state. Teleportation requires a clean working directory. Use Git stashes or commit your changes before pulling sessions Maintain a clean Git state. Claude Code Teleportation Tutorial I also have a video with step-by-step instructions on how to use Claude Code teleportation. Please make sure to check it out. https://youtu.be/2j93xjmtI9U?si=KFnRJUOtp_K7aNJW&embedable=true https://youtu.be/2j93xjmtI9U?si=KFnRJUOtp_K7aNJW&embedable=true Watch on YouTube: Claude Code Tutorial: Teleportation Watch on YouTube: Claude Code Tutorial: Teleportation Watch on YouTube: Claude Code Tutorial: Teleportation Claude Code Tutorial: Teleportation Claude Code Tutorial: Teleportation Conclusion 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 my YouTube channel, where I share a lot of useful tutorials for devs ;). my YouTube channel my YouTube channel my YouTube channel

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

This story contains AI-generated text. The author has used AI either for research, to generate outlines, or write the text itself. 

Claude Code Launches Teleport Workflow: Start Anywhere, Continue Everywhere

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

10 Git Commands Senior Devs Should Know (and Use Daily)

Two Hours With Cursor Changed How I See AI Coding

The Case for Version-Controlling Your AI

Claude Code Is Teaching Developers to Be Their Own Tech Leads

Claude Code Cracks Down on Power Users With New Weekly Limits

Claude Code Bets on Spec-Driven Development to Deliver More Reliable AI Software

10 Git Commands Senior Devs Should Know (and Use Daily)

Two Hours With Cursor Changed How I See AI Coding

The Case for Version-Controlling Your AI

Claude Code Is Teaching Developers to Be Their Own Tech Leads

Claude Code Cracks Down on Power Users With New Weekly Limits

Claude Code Bets on Spec-Driven Development to Deliver More Reliable AI Software

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps