Teleport en Claude Code: el comando que parece Remote Control y hace justo lo contrario

Dos comandos de Claude Code aceptan el mismo id de sesión y hacen cosas opuestas con él. Uno se asoma a la sesión, el otro se la lleva, y confundirlos deja tu trabajo en un sitio distinto del que creías.

El mismo id de sesión pasado a --cloud o a --teleport acaba en sitios opuestos

TL;DR /teleport (o /tp) baja a tu terminal una sesión que estaba corriendo en la nube, con su rama y el historial completo. No la duplica: a partir de ahí el terminal tiene su propia copia y lo que hagas ya no vuelve a claude.ai. No lo confundas con --remote-control, que hace lo contrario: deja el código en tu máquina y abre una ventana para el móvil.

Corre claude --help y busca. Son 234 líneas de salida. Aparece --remote-control, aparece --resume, aparece --continue. No aparece --teleport. Tampoco --cloud.

Los dos que mueven trabajo entre tu máquina y la nube están registrados con hideHelp(), así que el único de la familia que el --help te enseña es precisamente el que hace lo contrario de lo que probablemente buscas. De ahí sale media confusión.

El mismo argumento, resultados opuestos

Esta es la parte que de verdad se atraganta. --cloud y --teleport aceptan los dos un id de sesión, y con el mismo id hacen cosas contrarias. Las descripciones salen del registro de flags del binario:

--teleport [session]                  Resume a teleport session, optionally specify session ID
--cloud [description|session_id|url]  Create a cloud session with the given description,
                                      or attach to an existing one by session ID or claude.ai/code URL

Comando	Dónde ejecuta Claude	Dónde acaba la sesión
`claude --cloud "tarea"`	VM de Anthropic	Nace una sesión nueva en la nube
`claude --cloud <session-id>`	VM de Anthropic	Te reenganchas a una que ya corre. Sigue en la nube
`claude --teleport <session-id>`	Tu máquina	Te la bajas al terminal. Deja de vivir en la nube
`claude --remote-control`	Tu máquina	No mueve nada. Abre una ventana desde fuera

Teleport traslada la sesión. --cloud <id> solo se asoma a ella. Remote Control expone la tuya local. Y --remote, que verás en tutoriales de hace unos meses, no es ninguno de los tres: el binario lo trata como la misma opción que --cloud, así que es su grafía vieja, deprecada pero viva. Un guion de diferencia entre --remote y --remote-control, y comportamientos opuestos.

Compruébalo tú:

claude --help | grep -c -- "--teleport"        # 0
claude --help | grep -c -- "--cloud"           # 0
claude --help | grep -c -- "--remote-control"  # 2

Las cuatro formas de bajarte una sesión

# Selector interactivo de tus sesiones en la nube
claude --teleport

# Directo a una concreta
claude --teleport <session-id>

Dentro de una sesión ya abierta, sin reiniciar Claude Code:

/teleport

Y desde el panel de tareas, que es la vía más cómoda si ya estabas mirando cómo iba: /tasks, te sitúas sobre la sesión y pulsas t. La cuarta es el botón Open in CLI de la interfaz web, que te copia el comando ya montado para pegarlo.

Al llegar, Claude comprueba que estás en el repositorio correcto, se trae la rama de la sesión cloud y carga la conversación entera. No empiezas de cero: sigues la charla donde iba.

El detalle que se le escapa a casi todo el mundo

Teleportar no es sincronizar. El terminal se queda con su propia copia. Lo que trabajes a partir de ese momento se queda en local y ya no aparece en claude.ai ni en la app del móvil. La sesión de la nube se queda congelada en el punto en que te la llevaste.

Si querías seguir dirigiéndola desde el teléfono, teleport no es lo que necesitas: teleporta y luego arranca /remote-control en la sesión local. Ahí sí se componen, y en ese orden.

Los cuatro requisitos que valida antes

Requisito	Qué pasa si no se cumple
Working tree limpio	Te ofrece hacer stash antes de continuar
Mismo repositorio	Tiene que ser un checkout del mismo repo, no un fork
Rama subida al remoto	La rama de la sesión cloud debe existir en el remoto. Él hace fetch y checkout
Misma cuenta	Tienes que estar autenticado con la cuenta claude.ai que creó la sesión

Cuando el comando directamente no existe

En el binario, /teleport se declara con un isHidden que se activa cuando falta el gate de sesiones remotas o no estás con una cuenta claude.ai. Es decir, no falla con un error: se oculta del menú, y te quedas buscando un comando que tu instalación no te va a ofrecer.

Los tres casos y su mensaje:

Con API key: Unable to get organization UUID. Ejecuta /login y entra con tu cuenta claude.ai.
En Bedrock, Vertex o Foundry: Cloud sessions aren't available with <proveedor>. Las sesiones cloud corren en infraestructura de Anthropic, así que por ahí no hay salida.
Errores que hablan de Remote Control: Remote Control session expired o Access denied cuando tú estabas teleportando. No te has equivocado de comando. Teleport viaja por la misma fontanería de sesión que Remote Control, así que hereda su vocabulario de errores. /login y reintenta.

Si estás con cuenta claude.ai y aun así no aparece, tu organización tiene las sesiones cloud desactivadas.

Referencia

Comando	Qué hace
`claude --teleport`	Selector de sesiones cloud para bajarte una
`claude --teleport <session-id>`	Baja una sesión concreta
`/teleport` o `/tp`	Igual, desde dentro de una sesión abierta
`/tasks` y pulsar `t`	Teleporta desde el panel de tareas
`claude --cloud "tarea"`	Lo contrario: crea una sesión en la nube
`claude --cloud <session-id>`	Se reengancha a una sesión cloud sin bajártela
`claude --remote-control` o `--rc`	Ni una cosa ni otra: expone tu sesión local

Dos límites que te ahorrarán un mensaje de error: --cloud no se puede combinar con --print (las sesiones cloud son interactivas y punto), y --teleport no se combina con otros backends remotos, porque los dos eligen dónde vive la sesión y solo puede ganar uno.

Y una distinción que conviene tener clara: --teleport no es --resume. --resume reabre una conversación del historial local de esta máquina y no lista nada de la nube. --teleport se trae una sesión cloud con su rama.

Si aún no tienes montada la parte de arriba, empieza por las sesiones en la nube, que es donde se crean las sesiones que luego te vas a bajar.

Documentación oficial: Claude Code en la web

Requisitos

Suscripción Pro, Max, Team o Enterprise. Las API keys no sirven
Autenticación con cuenta claude.ai (/login), no ANTHROPIC_API_KEY
No disponible en Amazon Bedrock, Google Cloud Agent Platform ni Microsoft Foundry
Verificado en Claude Code v2.1.223