它到底是什么

--teleport 把一个 cloud session（在 claude.ai/code、手机 App、Desktop 或 claude --cloud 启动的云端会话）拉到本地终端继续。官方 CLI 参考的一句话描述是："Resume a cloud session in your local terminal"。

接受的值：

• 不带参数：打开交互式 session 选择器。
• 带 <session-id>：直接恢复指定会话。

拉取时，Claude Code 会确认你在正确的仓库里，fetch 并 checkout 云端会话的分支，并把完整对话历史载入终端。

用法

# 交互式选择器
claude --teleport

# 直接恢复指定会话
claude --teleport <session-id>

其他进入方式（同一份官方文档）：

与其他 flag 的组合 / 互斥

• --resume：二者不同。--resume 只重开本机本地历史里的对话，不会列出云端会话；--teleport 拉取云端会话及其分支。
• --cloud（--remote 是已弃用别名）：方向相反，用于从终端新建云端会话。CLI 的会话迁移是单向的：能用 --teleport 把云端会话拉下来，不能把已有的终端会话推上去。
• --remote-control：与云端会话无关，用于从 claude.ai 或 Claude App 监控、操控本地会话。

官方文档没有说明 --teleport 与其他启动 flag 的更多组合或互斥规则。

运行约束 / 限制

fetch 分支时不会在终端等待输入。如果 git 或 ssh 需要密码、密钥口令或确认新 SSH host,fetch 会失败。此时只有本地克隆已有该分支，checkout 才能成功。官方建议：把密钥加载进 ssh-agent，并先手动 git fetch 一次以记录 host。

常见坑

• 本地副本与云端互不同步：teleport 后终端拿到的是自己的一份拷贝。在终端里的新工作留在本地，不会出现在 claude.ai 或手机 App 的云端会话里。想继续从手机操控，需在本地会话里启动 /remote-control。
• Unable to get organization UUID：用 API key 认证或账号信息过期时会出现。不带 session ID 运行 claude --teleport 时，选择器里则显示 Error loading Claude Code sessions。处理方式是运行 /login，用 claude.ai 账号登录后重试。
• Remote Control session expired / Access denied:--teleport 复用 Remote Control 的会话基础设施，所以认证和过期错误会带 Remote Control 字样。连接 token 有效期短且限定账号。运行 /login 刷新凭据，并确认登录的是会话所属账号。
• Remote Control may not be available for this organization：文档说明这是组织 Owner 未启用云端会话。
• SSH host 别名：remote 形如 git@work:owner/repo.git、无法解析出主机名时，Claude Code 会请你确认。当 remote 的 owner 和仓库名与会话仓库匹配时，才接受该 checkout。

来源

• CLI reference - Claude Code Docs
• Use Claude Code in the cloud - Claude Code Docs