在云端使用 Claude Code

• 浏览器：claude.ai/code，也称为网络上的 Claude Code
• 移动设备：Claude 应用中的 Code 标签页
• 桌面应用：在启动会话时，在环境选择器中选择 Cloud 下的某个环境
• 终端：claude --cloud
• 云端定时任务：定时运行和触发运行每次都作为云端会话运行

​

云环境

• 您的第一个环境：如果您还没有环境，入门流程会设置一个具有受信任网络访问的默认环境，要么为您创建它，要么要求您创建它。请参阅默认环境，了解在您的计划上会发生哪种情况
• 会话使用哪个环境：请参阅默认环境，了解当您有多个环境时会话如何选择环境
• 更改会话可以访问的内容或在启动时运行的内容：请参阅配置云环境
• 无需任何配置即已安装的内容：请参阅已安装的工具

​

GitHub 身份验证选项

• 自动修复：在仓库上安装 Claude GitHub App 也会为其中的 Pull Request 启用自动修复
• 项目：项目中的线程需要在其克隆的每个仓库上安装 Claude GitHub App，无论您使用哪种方法连接。请参阅设置 GitHub 访问权限

​

面向 Team 和 Enterprise 的快速设置

• /web-setup：成员可以使用 /web-setup 连接 GitHub。该设置关闭时，此命令处于隐藏状态
• GitHub App 提示：浏览器入门引导会跳过 Claude GitHub App 安装提示
• 第一个环境：浏览器入门引导会为成员创建 Default 环境，而不是显示环境表单

​

在终端和云之间移动任务

​

从终端启动云端会话

claude --cloud "Fix the authentication bug in src/auth/login.ts"

​

云任务提示

claude --permission-mode plan

claude --cloud "Execute the migration plan in docs/migration-plan.md"

claude --cloud "Fix the flaky test in auth.spec.ts"
claude --cloud "Update the API documentation"
claude --cloud "Refactor the logger to use structured output"

​

发送没有 GitHub 的本地存储库

• macOS、Linux 和 WSL：Claude Code 会将名称类似于凭据或密钥的文件的未提交更改排除在上传之外。这涵盖 .env 文件、Terraform *.tfvars 文件以及密钥文件，例如 id_rsa 和 *.pem。它还会排除由 git 过滤器（例如 Git LFS）管理的文件的未提交更改。Left on this machine: 通知会列出被排除的文件，会话以每个文件的已提交版本启动，如果该文件没有任何已提交版本，则不包含该文件。
• 原生 Windows：对已跟踪文件的未提交更改会按原样上传，无论文件名称如何。在启动云端会话之前，请先 stash 或还原您不希望出现在云端会话中的编辑。

CCR_FORCE_BUNDLE=1 claude --cloud "Run the test suite and fix any failures"

• 目录必须是具有至少一个提交的 git 存储库
• 捆绑的存储库必须小于 100 MB。较大的存储库会回退到仅捆绑当前分支，然后回退到工作树的单个压缩快照，如果快照仍然太大则失败
• 未跟踪的文件不包括在内；对您希望云会话看到的文件运行 git add
• 在 macOS、Linux 和 WSL 上，当 Claude Code 无法遵循影响哪些属性规则适用于您的文件的 git 设置时，它会拒绝上传，例如在包含的配置文件中设置的 core.attributesFile。拒绝消息 命名该设置和修复
• 从捆绑创建的会话只有在您的 GitHub 连接 对该存储库具有推送访问权限时，才能推送回 GitHub 远程

• 较旧的 git：已安装的 git 早于 2.31。请更新 git，然后重试。
• 上传不支持的检出布局：您在子模块内启动、在使用 git clone --separate-git-dir、--shared 或 --reference 创建的克隆中启动、在设置了 core.worktree 的检出中启动，或在以 reftable 格式保存 refs 的仓库中启动。请改为从使用普通 git clone 创建的克隆的主检出启动。
• 带有稀疏检出的链接 worktree：git sparse-checkout 会将设置写入该 worktree 自己的 config.worktree 文件，而上传不接受该文件，因此具有这些设置的 worktree 不会被上传，Claude Code 使用 worktree.sparsePaths 创建的 worktree 也不会被上传。请改为从仓库的主检出启动。
• 保存在工作树内的 git 配置：您的 git 配置包含位于检出内部的文件，例如指向仓库内部的 include.path 条目。请将该文件移到工作树之外或删除该 include，然后重试。

​

从 CLI 发送后续消息

claude -p "your message" --cloud <session-id>

​

输出

Sent to cloud session.
Session ID: session_01DiUkqY2kzbUbDmW1w96rfi
View: https://claude.ai/code/session_01DiUkqY2kzbUbDmW1w96rfi?from=cli&m=0

​

在终端中继续云端会话

• 使用 --teleport：从命令行运行 claude --teleport 以获得交互式会话选择器，或 claude --teleport <session-id> 以直接恢复特定会话。如果您有未提交的更改，系统会提示您先隐藏它们。--resume 从此机器的本地历史记录重新打开对话，不列出云端会话。
• 使用 /teleport：在现有 CLI 会话内，运行 /teleport 或 /tp 以打开相同的会话选择器，无需重启 Claude Code。
• 从 /tasks：运行 /tasks 以查看您的后台会话，然后按 t 以 teleport 到其中一个。
• 从 claude.ai/code：从会话菜单中选择 Open in > Terminal 以复制可以粘贴到终端的命令。
• 从云会话内部：键入 /teleport，Claude Code 会回复该会话的确切 claude --teleport <session-id> 命令，准备从存储库的检出运行。需要会话环境中的 Claude Code v2.1.223 或更高版本。

​

Teleport 要求

​

--teleport 不可用

• 您使用 API 密钥或 Console 账户登录：在您的 shell 中运行 claude auth login，然后使用 claude.ai 登录
• 错误指明了您的提供商：云端会话无法通过第三方提供商使用。请参阅错误表
• 您已通过 claude.ai 登录：您的组织可能已禁用云端会话

​

处理会话

​

云端会话中的权限模式

• 重新打开 Anthropic 托管的环境已过期的会话
• 向自托管运行程序在空闲时释放的会话发送消息

​

审查更改

• 您也可以点击会话标题栏中的 Changes，或标题栏 ⋮ 菜单中的该选项。
• 面板隐藏时，要显示面板，请点击会话标题栏中的 Show session rail 图标，或标题栏 ⋮ 菜单中的该选项。

• 评论：在特定行上留下内联评论，然后随下一条消息将这些评论发送给 Claude
• 比较：diff 视图默认将会话的更改与其基础分支进行比较。要与仓库中的任何其他分支进行比较，请选择 Compare against 并选择一个分支

• 完整演练（包括 PR 创建）：请参阅审查和迭代
• 让 Claude 自动监控 PR 的 CI 失败和审查评论：请参阅自动修复 Pull Request

​

排查 diff 视图中缺失的文件

• 尚未推送更改：列表包含 Claude 自己所做的编辑，但不包含 Claude 运行的命令（例如格式化工具）所做的更改
• 已推送更改：列表包含已推送的提交，但不包含上次推送之后所做的更改

​

管理上下文

• /model、/effort、/color 和 /rename：将值作为参数传递，例如 /model sonnet，而不是打开终端选择器或滑块。参数形式遵循每个命令的可用性说明。
• /fast：当快速模式在你的账户上可用时，为会话切换快速模式。需要会话环境中的 Claude Code v2.1.271 或更高版本。
• /config：在浏览器中访问 claude.ai/code 时，此命令会打开 Settings > Code 或 Settings > Claude Code，而不是设置某个值。要更改云端会话的设置，请在环境中设置环境变量。在项目的线程之外且仅包含一个仓库的会话中，请改为将该键提交到该仓库的 .claude/settings.json 中。云端会话中的设置列出了每个会话读取的内容。

​

对话中的插件建议

​

添加或移除建议的插件

​

关闭插件建议

{
  "permissions": {
    "deny": ["SearchPlugins", "SuggestPluginInstall"]
  }
}

​

取回已排队的消息

​

共享会话

​

从 Enterprise 或 Team 账户共享

• 可见性选项：私有和团队。团队可见性使会话对您的 claude.ai 组织中的其他成员可见
• 仓库访问权限：默认启用验证，基于收件人账户所连接的 GitHub 账户
• 您的名称：您账户的显示名称对所有有访问权限的收件人可见
• Slack 会话：Claude in Slack 会话会自动以团队可见性共享

​

从 Max、Ultra 或 Pro 账户共享

• 可见性选项：私有和公开。公开可见性使会话对任何登录 claude.ai 的用户可见
• 仓库访问权限：默认不启用验证
• 敏感内容：共享前请检查您的会话。会话可能包含来自私有 GitHub 仓库的代码和凭据

• 如果 Settings 菜单显示的是 Code 而不是 Claude Code：前往 Privacy，其中包含这些设置
• 否则：前往 Claude Code > Sharing settings

​

归档会话

​

查找已归档的会话

​

删除会话

• 从侧边栏：将鼠标悬停在会话上，打开其 ⋯ 菜单，然后选择 Delete
• 从会话菜单：打开会话，选择会话标题旁的下拉菜单，然后选择删除
• 从 Archived 标签页：在 Archived 标签页上将鼠标悬停在会话上，打开其 ⋮ 菜单，然后选择 Delete

​

自动修复拉取请求

• 在云端会话中创建的 PR：打开 claude.ai/code 处的会话，在 Changes 卡片中找到该拉取请求。打开拉取请求标题旁边的 ⋮ 菜单并启用 Auto-fix
• 从终端：在 PR 的分支上运行 /autofix-pr。Claude Code 使用 gh 检测打开的 PR，生成云会话，并一步启用自动修复
• 从移动应用：告诉 Claude 自动修复 PR，例如”watch this PR and fix any CI failures or review comments”
• 任何现有 PR：将 PR URL 粘贴到会话中并告诉 Claude 自动修复它

​

Claude 如何响应 PR 活动

• 明确的修复：如果 Claude 对修复有信心且不与早期指令冲突，Claude 会进行更改、推送它，并在会话中解释所做的工作
• 模糊的请求：如果审查者的评论可以以多种方式解释或涉及架构上重要的内容，Claude 会在采取行动前询问你
• 重复或无操作事件：如果事件是重复的或不需要更改，Claude 会在会话中记录它并继续

​

安全和隔离

• 隔离的虚拟机：每个会话在隔离的、Anthropic 管理的 VM 中运行。您的组织路由到自托管环境的会话改为在您自己的基础设施上运行，其中隔离是您的部署的责任
• 网络访问控制：在 Anthropic 托管的环境中，网络访问默认受限，可以禁用。请参阅网络访问了解访问级别、默认允许的域和不通过允许列表的流量。在自托管环境中，您在自己的网络边界处限制会话出口。当在禁用网络访问的情况下运行时，Claude Code 仍然可以与 Anthropic API 通信，这可能允许数据从 VM 中退出。
• 凭据保护：在 Anthropic 托管的环境中，git 凭据和签名密钥保持在沙箱外，代理使用作用域凭据代表会话进行身份验证。在自托管环境中，您的部署提供 git 凭据；请参阅配置 git
• 网络密钥：在 Anthropic 托管的环境中，您添加到云环境的密钥以相同的方式保持在沙箱外，在请求离开会话后附加到匹配的请求。自托管环境没有网络密钥
• 安全分析：代码在会话的隔离环境内分析和修改，然后创建 PR

​

故障排除

​

会话创建失败

• 检查 status.claude.com 以了解云会话事件
• 一分钟后重试，因为容量是按需配置的
• 通过遵循连接 GitHub 后没有存储库出现来确认你的 GitHub 连接可以访问存储库

​

Your new session couldn’t start

• 连接中断：请检查您的网络连接以及您使用的任何 VPN 或代理，然后重新发送您的提示词
• 服务器错误：请稍等片刻，然后重新发送您的提示词。如果该通知再次出现，请检查 status.claude.com

​

Can’t rewind to this message

​

无法获取组织 UUID

• Unable to get organization UUID
• Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.
• Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.
• 在不带会话 ID 运行 claude --teleport 时，会话选择器中显示 Error loading Claude Code sessions

​

分支不在 GitHub 上

​

Remote Control 会话已过期或访问被拒绝

• 在本地运行 /login 以刷新你的凭证，然后重新连接
• 确认你已登录到拥有会话的相同账户
• 如果你看到 Remote Control may not be available for this organization，所有者尚未为你的组织启用云会话

​

向云端会话发送消息时的错误

​

环境已过期

• 会恢复：您的对话历史
• 不会恢复：VM 被回收时仍在运行或待处理的后台工作，包括：
  • Shell 命令：Claude Code 会告知 Claude 哪些命令已停止。请让 Claude 重新运行您仍需要的命令。
  • 子代理：Claude Code 会告知 Claude 哪些子代理已停止，以及其中哪些可以恢复而无需从头开始。请让 Claude 继续它们的工作。
  • 会话范围的定时任务：您在会话中安排的任务以及正在等待下一次迭代的 /loop 不会延续到重新打开的会话中。请让 Claude 重新安排这些任务，或再次运行 /loop 以重新启动循环。

​

限制

• 速率限制：云端会话与您账户内所有其他 Claude 和 Claude Code 使用共享速率限制。并行运行多个任务会按比例消耗更多速率限制。
• 时间限制：Claude 运行的命令和 SessionStart hooks 有你可以更改的默认超时，设置脚本仅在大约五分钟内完成时才被缓存。请参阅时间限制
• 存储库身份验证：你只能在认证到相同账户时将云会话拉入你的终端
• 平台限制：在 Anthropic 托管环境中克隆仓库以及创建 Pull Request 需要 GitHub。Team 和 Enterprise 计划支持自托管的 GitHub Enterprise Server 实例。您可以通过设置 CCR_FORCE_BUNDLE=1 将 GitLab、Bitbucket 或其他非 GitHub 仓库作为本地捆绑发送到云端会话，但会话无法将结果推送回该远程
  • 自托管环境：对于托管在其他 git 平台上的仓库，请参阅使用 --environment 启动会话的要求。
• 组织 IP 允许列表：云端会话从 Anthropic 管理的基础设施（而非您的网络）调用 Anthropic API，而自托管环境中的会话则从您自己的网络调用它。如果您的组织启用了 IP 允许列表，每个 Anthropic 托管的云端会话都会因身份验证错误而失败。
  • Code Review 和定时任务：这同样适用于 Code Review 以及在 Anthropic 托管环境中运行的云端定时任务。路由到自托管环境的定时任务会从您自己的网络调用 API。
  • 获取豁免：请联系 Anthropic 支持，将 Anthropic 托管的服务从您组织的 IP 允许列表中豁免。

​

相关资源

• 云环境：为云会话配置网络访问、环境变量和设置脚本
• Projects：一个对话，Claude 在其中协调您的存储库上的并行云会话并报告结果
• Ultrareview：在云沙箱中运行深度多代理代码审查
• 云端定时任务：按计划、通过 API 调用或响应 GitHub 事件自动化工作
• Hooks 配置：在会话生命周期事件处运行脚本
• 所有设置：所有配置选项
• 安全：隔离保证和数据处理
• 数据使用：Anthropic 从云会话保留的内容
• Claude Tag：在 Slack 中由组织管理的 @Claude，运行在相同的云基础设施上