Have you ever started a coding session at work and wished you could continue it seamlessly at home? With Cloud Code teleportation, now you can. This feature, recently introduced by Anthropic, lets you move an entire Cloud Code session including context, conversation history, and working branch from your browser to your local terminal or another device.
In this guide, you’ll learn how to set up teleportation, manage sessions, and troubleshoot common issues, so you can work from anywhere without interruption.
What Is Cloud Code Teleportation?
Cloud Code teleportation allows you to transfer your AI-assisted coding session across devices and interfaces. Whether you’re coding in the Cloud Web interface or your local terminal, teleportation ensures that your context, chat history, and project state follow you.
This feature is perfect for developers who:
- Start work at the office and want to continue at home
- Use multiple machines
- Switch between Cloud Web, local terminal, or VS Code
With teleportation, you don’t need to copy-paste between environments your full session moves with you.
Step 1: Connect GitHub to Cloud Code
To begin, head over to claude.ai/code and follow the onboarding instructions:
- Connect your GitHub account
- Select repositories to share with Cloud Code
- You can authorize access to your full account or select specific repos
- Once complete, go back to your terminal
Make sure you’re running the Cloud Code CLI from inside a repository that you’ve granted access to otherwise, teleportation will not work.
Step 2: Update Cloud Code CLI
Teleportation requires the latest version of the Cloud CLI.
In your terminal, run:
clo update Then relaunch with:
clo
If you’re out of date, teleportation commands like % or /teleport may not function.
Step 3: Set Up Your Cloud Environment
Once your GitHub access is set:
- Navigate to the environment setup step in the onboarding flow
- Choose the level of access:
- Trusted or Full Access is recommended for downloading dependencies
- Name your environment appropriately (e.g.,
my-project-env)
Your Cloud environment is essentially a virtual workspace with access to your selected GitHub repo and project dependencies.
Step 4: Start a Cloud Code Session
In your terminal, navigate to your project folder and start a Cloud session using a % command:
% Create a new login system for the web app
If successful, Cloud Code will return a Session ID. This ID is the key to teleporting your session to another device.
If you encounter an error that says Cloud Code can’t start a background process, try re-authenticating:
/login
Authorize your CLI again and retry.
Step 5: View and Manage Sessions with /task
You can view your current background tasks and session info with:
/task
This command shows:
- Active tasks
- Session status
- Links to open sessions in the web interface
It helps confirm that your session is live and ready for teleportation.
Step 6: Teleport a Session
To move your session to a different terminal or device, use the following command:
clo-teleport <session-id>
Claude will begin restoring your session—including the conversation and working directory so you can continue exactly where you left off.
Tip: If you forget your Session ID, you can retrieve it from the web interface at claude.ai/code.
Bonus: Use Teleportation in VS Code
Claude also supports Cloud Code through a VS Code extension. Once installed:
- Launch the VS Code terminal
- Run the teleport command with your session ID
- Your context and files will load into the VS Code environment
Make sure to use Terminal view, as teleportation does not currently work in Chat view.
This gives you the flexibility of advanced local development tools while keeping your AI-assisted session intact.
Common Errors & Fixes
1. GitHub Access Denied
Error: Cannot start session or background task
Fix: Ensure Cloud Code has access to your repo in GitHub’s application permissions
2. Session Not Found
Fix: Check that the session has fully initialized (can take 30–60 seconds)
3. Background Task Doesn’t Start
Fix: Re-authenticate with /login, then try again in the same authorized repo
4. Session Doesn’t Appear in /task
Fix: Use the web interface to confirm the session exists and grab the correct Session ID
Final Thoughts
Cloud Code teleportation is still in preview, so you may encounter occasional bugs. However, it’s already a powerful way to move coding sessions across devices, streamline workflows, and avoid repetitive setup.
Whether you’re starting a session on your work computer or finishing a project on your laptop at home, teleportation ensures your AI coding assistant stays with you.
If you’re interested in more practical AI tools and development tips, be sure to check out the expert resources at the Data Bear blog.
