Desktop application

充分利用 Claude Code Desktop：使用 Git 隔离的并行会话、拖放窗格布局、集成终端和文件编辑器、侧边聊天、计算机使用、从手机 Dispatch 会话、可视化 diff 审查、应用预览、PR 监控、连接器和企业配置。

Claude Desktop 应用有三个选项卡：Chat 用于对话，Cowork 用于 Dispatch 和更长的代理工作，Code 用于软件开发。本页是 Code 选项卡的参考。

对于 Windows ARM64，请下载 ARM64 安装程序。在 Linux 上，使用 apt 安装；请参阅 Claude Desktop on Linux。

安装后，启动 Claude，登录，然后点击 Code 选项卡。有关首次会话的演练，请参阅快速开始指南。

在 Code 选项卡中，每个对话都是一个会话：它有自己的聊天历史和项目文件夹，独立于任何其他会话。侧边栏列出你的会话，让你可以并行运行多个会话。在一个会话中，你可以：

• 使用 diff 视图审查和评论更改，然后通过 CI 监控生成的 PR
• 在浏览器窗格中预览你的运行应用，同时 Claude 验证自己的更改，并在其旁边打开外部网站
• 在 iOS Simulator 窗格中观看 Claude 运行和测试你的 iOS 应用
• 整理窗格，将聊天、diff、浏览器、终端和文件编辑器并排放置
• 提出侧边问题，使用会话的上下文而不偏离主线
• 让 Claude 检查、消息或存档你的其他会话
• 连接外部工具，如 GitHub、Slack 和 Linear
• 让 Claude 打开应用和控制你的屏幕
• 在你的机器上、云中或通过 SSH 运行

有关计划的定期工作、快捷键或从手机发送任务，请参阅链接的页面和部分。如果你已经使用基于终端的 CLI，请参阅 CLI 比较了解哪些内容可以继续使用。

启动会话

在发送第一条消息之前，在提示区域配置四件事：

• 环境：选择 Claude 运行的位置。选择 Local 在您的机器上运行，选择 Cloud 使用云端会话，该会话在您关闭应用后仍会继续运行；选择 SSH 连接使用您管理的远程机器；或在 Windows 上选择 WSL 发行版。SSH 会话中的任务可以在 Desktop 断开连接时继续运行，但如果使用 Claude 账户，任务可能会在登录过期时停止。请参阅环境配置。
• 项目文件夹：选择 Claude 工作的文件夹或存储库。对于云会话，你可以添加多个存储库。
• 模型：从发送按钮旁的下拉菜单中选择一个模型。你可以在会话期间更改此设置。
• 权限模式：从模式选择器中选择 Claude 拥有多少自主权。你可以在会话期间更改此设置。

输入你的任务并按 Enter 启动。每个会话独立跟踪其自己的上下文和更改。

使用代码

为 Claude 提供正确的上下文，控制它自主执行的工作量，并审查它所做的更改。

使用提示框

输入您想让 Claude 做的事情，然后按 Enter 发送。Claude 会读取您的项目文件，进行更改，并根据您的权限模式运行命令。您可以随时重定向 Claude：点击停止按钮立即中断，或输入更正并按 Enter 发送，无需停止正在运行的操作。Claude 会在当前操作完成后立即读取更正，并在下一步之前进行调整。

提示框旁边的 + 按钮让您可以访问文件附件、skill、连接器 和插件。

接受建议的提示词

Claude 回复后，Code 选项卡可能会在空的输入框中以灰色文本显示建议的下一条提示词。Claude Code 通过一个简短的后台请求，根据您的对话生成每条建议，该请求会计入您套餐的用量限制或您的 API 费用。

• 使用建议：按 Tab 或 右箭头 将其放入输入框，根据需要进行编辑，然后按 Enter 发送。在接受建议之前按 Enter 不会发送它。
• 编写自己的提示词：直接开始输入。建议仅在输入框为空且没有附加文件时显示。

前往 Settings > Claude Code，在 Sessions 下关闭 Prompt suggestions，即可从每个会话下次启动或恢复时起停止显示建议。

向提示添加文件和上下文

提示框支持两种方式来引入外部上下文：

• @mention 文件：输入 @ 后跟文件名，将文件添加到对话上下文。Claude 随后可以读取和引用该文件。@mention 在云端或 WSL 会话中不可用。
• 附加文件：使用附件按钮将图像、PDF 和其他文件附加到您的提示，或直接将文件拖放到提示中。这对于共享错误的屏幕截图、设计模型或参考文档很有用。

选择权限模式

权限模式控制 Claude 在会话期间的自主程度：它是否在编辑文件、运行命令或两者之前询问。您可以随时使用发送按钮旁边的模式选择器切换权限模式。要自己批准每项更改，请切换到 Manual。

要为新的本地会话设置默认模式，请将 permissions.defaultMode 添加到您的设置文件。桌面应用读取与 CLI 相同的设置文件。您在选择器中选择的模式会被记住（按文件夹），并对该文件夹优先于 defaultMode，除了 Plan，它仅适用于当前会话。

Code 选项卡的早期版本将这些模式标记为 Ask permissions、Auto accept edits 和 Plan mode。

dontAsk 权限模式仅在 CLI 中可用。

云端会话支持 Accept edits、Plan 和 Auto。Accept edits 对应于 default 模式：云端会话预先批准文件编辑，因此选择器显示 Accept edits 而不是 Manual。Bypass permissions 在云端会话中不可用，包括自托管环境中的会话。

Enterprise 管理员可以限制哪些权限模式可用。有关详细信息，请参阅企业配置。

自动模式可用性

自动模式对 Anthropic API 上的所有用户可用，需要 Claude Opus 4.6 或更高版本、Sonnet 4.6 或更高版本、Haiku 5.5，或 Fable 模型。组织管理员可以使用托管设置中的 disableAutoMode 键关闭自动模式。

在将 Desktop 路由到 Google Cloud 的 Agent Platform 的 Enterprise 部署中，自动模式也默认可用；有关支持的模型，请参阅 Bedrock、Agent Platform 或 Foundry 上的自动模式。

预览您的应用

Claude 可以启动开发服务器并在浏览器窗格中打开它以验证其更改。这适用于前端 Web 应用以及后端服务器：Claude 可以测试 API 端点、查看服务器日志，并迭代它发现的问题。在大多数情况下，Claude 在编辑项目文件后自动启动服务器。您也可以随时要求 Claude 进行预览。默认情况下，Claude 自动验证每次编辑后的更改。

浏览器窗格也可以打开项目中的静态 HTML 文件、PDF、图像和视频。在聊天中点击 HTML、PDF、图像或视频路径以在那里打开它。

从浏览器窗格，您可以：

• 直接在浏览器窗格中与运行的应用交互
• 观看 Claude 自动验证其自己的更改：它拍摄屏幕截图、检查 DOM、点击元素、填充表单，并修复它发现的问题
• 从浏览器窗格标题栏中的 Dev servers 菜单启动或停止服务器，或一次停止所有服务器
• 通过浏览器窗格 ⋮ 菜单中的 Keep cookies，选择浏览器在您退出应用后是否保留 cookie，这样您就不必在开发期间重新登录

Claude 根据您的项目创建初始服务器配置。如果您的应用使用自定义开发命令，编辑 .claude/launch.json 以匹配您的设置。有关完整参考，请参阅配置预览服务器。

要清除浏览器保存的数据，请在浏览器窗格的 ⋮ 菜单中选择 Clear browsing data。要完全关闭浏览器，请在 Settings > Claude Code 中关闭 Browser tools。

浏览外部网站

浏览器窗格是一个选项卡式浏览器，因此您可以在运行的应用旁边打开文档、问题跟踪器或任何其他网站。要打开浏览器，在 macOS 上按 Cmd+Shift+B 或在 Windows 上按 Ctrl+Shift+B，或点击会话标题栏中的 Browser。您可以在窗格中登录网站，包括弹出式登录流程，例如 Google OAuth。

您第一次点击聊天中的外部链接时，会出现一个对话框，询问链接是在浏览器窗格中打开还是在您的默认浏览器中打开。要在之后更改您的选择，请使用浏览器窗格 ⋮ 菜单中的 Open links in built-in browser。在 macOS 上 Cmd 点击或在 Windows 上 Ctrl 点击会直接在您的默认浏览器中打开链接。

Claude 可以使用与验证您的应用相同的工具读取和交互外部页面，并进行两项额外的安全检查：

• 安全分类器在每个权限模式中审查 Claude 在外部页面上的写入操作，例如点击和输入。这些与自动模式使用的分类器相同，当它们标记操作时，无论模式如何，您都会收到权限提示。
• 在 Auto 和 Bypass permissions 以外的权限模式中，在 Claude 导航到新网站之前也会应用域名允许列表检查。

批准 Claude 在网站上的操作

Claude 第一次在外部网站上操作时，会出现权限卡，Claude 等待您的选择：Allow once、Always allow 或 Deny。Allow once 批准操作而不保存任何内容。Always allow 在您的设备上保存该网站的批准，您可以在设置中撤销它。每个网站都需要自己的批准，包括子域。您的本地开发服务器和项目文件不需要批准，因此自动验证继续工作而不需要提示。

即使在批准的网站上，Claude 也不会在没有您的输入的情况下购买物品、创建账户或绕过 CAPTCHA。在浏览器窗格中浏览使用与 Claude in Chrome extension 相同的安全模型。有关 Claude 如何处理敏感网站和风险操作的信息，请参阅安全使用 Chrome 中的 Claude。

在浏览器和 Chrome 扩展之间选择

浏览器窗格使用干净的浏览器配置文件，与您的个人浏览器分开，没有您保存的登录或历史记录。将其用于构建和测试您的应用以及不需要您的身份的网站。当您想让 Claude 在您的登录会话中以您的身份操作时，请改用 Claude in Chrome extension，它共享您的浏览器的登录状态。

为您的组织限制外部浏览

浏览器遵循与 Claude in Chrome 扩展相同的网站允许列表和阻止列表控制。如果您的组织已经为扩展配置了这些列表，浏览器会自动遵循它们。管理员也可以使用 browserExternalPageTools 托管设置关闭 Claude 在外部页面上的工具。禁用工具后，用户仍然可以访问外部网站；Claude 的工具无法读取或操作它们。

要完全关闭外部浏览，请将 disableBrowserExternalNavigation 托管设置设置为 true。这会阻止浏览器中的所有外部导航，包括您的组织允许列表上的网站；localhost 开发服务器和文件预览继续工作。使用 browserExternalPageTools 让用户继续浏览外部网站而不使用 Claude 的工具，使用 disableBrowserExternalNavigation 为用户和 Claude 阻止外部网站。

使用 diff 视图审查更改

Claude 对您的代码进行更改后，diff 视图让您在创建 Pull Request 之前逐个文件审查修改。

当 Claude 更改文件时，会出现一个 diff 统计指示器，显示添加和删除的行数，例如 +12 -1。点击此指示器打开 diff 查看器，它在左侧显示文件列表，在右侧显示每个文件的更改。

要对特定行进行评论，点击 diff 中的任何行以打开评论框。输入您的反馈并按 Enter 添加评论。在多行添加评论后，一次提交所有评论：

• macOS：按 Cmd+Enter
• Windows：按 Ctrl+Enter

Claude 读取您的评论并进行请求的更改，这些更改显示为您可以审查的新 diff。

审查您的代码

要让 Claude 在您提交之前审查您的更改，请在输入框中输入 /code-review。审查完成后，结果会出现在对话中。

在本地、SSH 和 WSL 会话中，结果会显示为一张按文件分组的 Code review 卡片。使用该卡片处理这些结果：

• 点击 Walk through in diff 打开 diff 视图，逐条查看结果。当前 diff 中的结果会显示在其对应的行上，您可以在那里点击 Fix this one 或忽略它。
• 点击 Apply fixes 让 Claude 修复仍未处理的结果。

在任何会话中，您也可以在输入框中要求 Claude 修复审查发现的问题。有关 /code-review 检查的内容及其接受的参数，请参阅使用 /code-review 在本地审查。

监控 Pull Request 状态

打开 Pull Request 后，CI 状态栏会出现在会话中。Claude Code 使用 GitHub CLI 轮询检查结果并显示失败。

• Auto-fix CI & address comments：启用后，Claude 会通过读取失败输出并迭代来自动尝试修复失败的 CI 检查。在本地会话中，当评论作者是仓库所有者、组织成员、协作者或 GitHub App 时，Claude 还会处理除您之外的其他人留下的新审查评论。
• Auto-merge when ready：启用后，Claude 在所有检查通过后合并 PR。合并方法是 squash。请先在您的 GitHub 仓库设置中启用自动合并；没有它，Claude 无法合并 PR。

要启用这些选项，请点击状态栏中的 CI。要在 PR 合并或关闭后自动归档会话，请在 Settings > Claude Code 中打开自动归档。

整理工作区

Code 选项卡围绕可以以任何布局排列的窗格构建：聊天、diff、浏览器、终端、文件、计划、任务和子代理，以及 macOS 上的 iOS Simulator。通过其标题拖动窗格来重新定位它，或拖动窗格边缘来调整大小。在 macOS 上按 Cmd+\ 或在 Windows 上按 Ctrl+\ 来关闭焦点窗格。点击会话标题栏中的 Terminal、Changes 或 Browser 来打开终端、diff 或浏览器窗格。它们旁边的 ⋮ 菜单可打开更多窗格（例如 Files），并在窗口过窄无法显示这些按钮时容纳它们。

要在多个屏幕上工作，可以将 diff 或终端等窗格弹出到其自己的窗口中，完成后再停靠回来。Claude 继续在主窗口中工作。

在终端中运行命令

集成终端让您无需切换到另一个应用即可在会话旁运行命令。点击会话标题栏中的 Terminal，或在 macOS 或 Windows 上按 Ctrl+`。终端在您的会话工作目录中打开，并与 Claude 共享相同的环境，因此 npm test 或 git status 等命令看到 Claude 正在编辑的相同文件。要打开第二个终端选项卡，点击终端窗格标题中的 + 或右键点击聊天中的文件夹来选择 Open in terminal。

终端在本地和 SSH 会话中可用，但在 Windows 远程机器上存在限制。

打开和编辑文件

点击聊天或 diff 查看器中的文件路径在文件窗格中打开它。HTML、PDF、图像和视频路径改为在浏览器窗格中打开。进行现场编辑并点击 Save 来写回。如果文件自您打开它以来在磁盘上更改，窗格会警告您并让您覆盖或丢弃。点击 Discard 来恢复您的编辑，或点击窗格标题中的路径来复制绝对路径。

文件窗格在本地和 SSH 会话中可用。对于云端会话，要求 Claude 进行更改。

在其他应用中打开文件

右键点击聊天、diff 查看器或文件窗格中的任何文件路径来打开上下文菜单：

• Attach as context：将文件添加到您的下一个提示词
• Open in：在已安装的编辑器（如 VS Code、Cursor 或 Zed）中打开文件
• Show in Finder（macOS）、Show in Explorer（Windows）：打开包含文件夹
• Copy path：将绝对路径复制到您的剪贴板

切换视图模式

视图模式控制聊天会话记录中显示的详细程度。要切换视图模式，请从会话标题旁的插入符号打开会话菜单并选择 Transcript view，或在 macOS 或 Windows 上按 Ctrl+O 循环切换。只有在 Claude 于您正在查看的会话中产生思考后，Thinking 模式才会出现在菜单中。

使用 Thinking 来跟踪 Claude 的推理，工具调用仍然折叠。在调试 Claude 为什么采取特定操作时使用 Verbose。Claude Desktop 1.46388.1 之前的版本也列出了 Summary 模式，仍然设置为 Summary 的会话在您更新后会以 Normal 打开。

快捷键

在 macOS 上按 Cmd+/ 或在 Windows 上按 Ctrl+/ 来查看 Code 选项卡中可用的所有快捷键。在 Windows 上，对下面的快捷键使用 Ctrl 代替 Cmd。会话循环、终端切换和视图模式切换在每个平台上使用 Ctrl。

这些快捷键适用于 Code 选项卡。在 Desktop 中，Shift+Tab 不会像在终端的交互模式中那样循环切换权限模式。

检查使用情况

点击模型选择器旁的使用环形图来查看您当前的上下文窗口使用情况和您的计划在该期间的使用情况。上下文使用是按会话的；计划使用在所有 Claude Code 使用入口上共享。

让 Claude 使用你的计算机

计算机使用让 Claude 打开你的应用、控制你的屏幕，并像你一样直接在你的机器上工作。要求 Claude 与没有 CLI 的桌面工具交互，或自动化只能通过 GUI 工作的东西。对于运行和测试 iOS 应用，Desktop 会打开专用的 iOS Simulator 窗格，而不是控制你的屏幕；该窗格无需启用计算机使用即可工作。

计算机使用默认关闭。在设置中启用它，然后 Claude 才能控制你的屏幕。在 macOS 上，你还需要授予辅助功能和屏幕录制权限。

在 macOS 上，计算机使用也可以在后台运行：Claude 在你批准的应用中工作，同时你继续工作。

何时应用计算机使用

Claude 有多种方式与应用或服务交互，计算机使用是最广泛和最慢的。它首先尝试最精确的工具：

• 如果你有一个服务的连接器，Claude 使用连接器。
• 如果任务是 shell 命令，Claude 使用 Bash。
• 如果任务是浏览器工作且你已设置Chrome 中的 Claude，Claude 使用那个。
• 如果任务是运行或测试 iOS 应用，Claude 使用 iOS Simulator 窗格，它不使用屏幕控制。
• 如果以上都不适用，Claude 使用计算机使用。

按应用访问层强化了这一点：浏览器限制为仅查看，终端和 IDE 限制为仅点击，即使计算机使用处于活跃状态，也会引导 Claude 使用专用工具。屏幕控制保留给其他工具无法到达的东西，如原生应用、硬件控制面板或没有 API 的专有工具。

启用计算机使用

计算机使用默认关闭。如果你要求 Claude 做需要它的事情而它关闭时，Claude 会告诉你如果在设置中启用计算机使用，它可以完成任务。

应用权限

Claude 第一次需要使用应用时，会话中会出现提示。点击允许此会话或拒绝。批准持续当前会话，或在 Dispatch 生成的会话中持续 30 分钟。

提示还显示 Claude 为该应用获得的控制级别。这些层由应用类别固定，无法更改：

像终端、Finder 或文件浏览器以及系统设置或设置这样具有广泛影响的应用在提示中显示额外警告，以便你知道批准它们授予什么。

设置 > 此计算机 > 系统中的计算机使用部分包含以下选项：

• 拒绝的应用：在此处添加应用以拒绝它们而不提示。Claude 可能仍然通过允许应用中的操作间接影响被拒绝的应用，但它无法直接与被拒绝的应用交互。
• Claude 完成时取消隐藏应用：当计算机使用不在后台运行时，Claude 隐藏你的其他窗口，以便它仅与批准的应用交互。当 Claude 完成时，隐藏的窗口被恢复，除非你关闭此设置。

管理会话

每个会话是一个独立的对话，拥有自己的上下文和更改。您可以并行运行多个会话、开启侧边聊天、让 Claude 查看您的其他会话并向其发送消息、将工作发送到云端，或让 Dispatch 从您的手机为您启动会话。

使用会话并行工作

点击侧边栏中的 + New session，或在 macOS 上按 Cmd+N、在 Windows 上按 Ctrl+N，即可并行处理多个任务。按 Ctrl+Tab 和 Ctrl+Shift+Tab 可在侧边栏中循环切换会话。对于 Git 仓库，选择分支名称旁边的 worktree 选项，即可使用 Git worktrees 为会话提供项目的独立隔离副本。

要同时查看两个会话，请在 macOS 上按住 Cmd 或在 Windows 上按住 Ctrl 并点击侧边栏中的会话。该会话会在第二个窗格中打开，与您已打开的会话并排显示。分屏处于活跃状态时，点击侧边栏中的另一个会话会替换当前具有焦点的窗格。在 macOS 上按 Cmd+\ 或在 Windows 上按 Ctrl+\ 可关闭具有焦点的窗格并返回单个会话。

Worktree 默认存储在 <project-root>/.claude/worktrees/ 中。您可以将其更改为自定义目录：

• 本地会话：在 Settings > Claude Code 中设置 Worktree location
• SSH 会话：在 SSH 连接上设置 Worktree folder

您还可以在 Settings > Claude Code 中设置 Branch prefix。Desktop 会将其添加到每个 worktree 分支名称的前面，这有助于让 Claude 创建的分支保持条理。

完成后要删除 worktree，请将鼠标悬停在侧边栏中的会话上并点击存档图标。要让会话在其 Pull Request 合并或关闭时自动存档，请在 Settings > Claude Code 中打开 Auto-archive after PR merge or close。自动存档仅适用于已完成运行的本地会话。

要在新 worktree 中包含被 gitignore 的文件（如 .env），请在项目根目录中创建一个 .worktreeinclude 文件。有关 worktree 会话从何处读取项目设置、hook 和 skill，请参阅 worktree 与主检出共享的内容。

使用侧边栏顶部的控件可按状态、项目或环境筛选会话，并按项目对会话分组。要重命名会话，请点击活跃会话顶部工具栏中的会话标题。

要检查上下文使用情况，请参阅检查使用情况。当上下文填满时，Claude 会自动总结对话并继续工作。您也可以输入 /compact 提前触发总结并释放上下文空间。有关压缩工作原理的详细信息，请参阅上下文窗口。

当 Code 会话完成任务且您当前未在查看该会话时，桌面应用会发送操作系统通知。对于属于某个项目的会话，您将收到该项目的通知。

在不偏离会话的情况下提出侧边问题

侧边聊天让您可以向 Claude 提出一个使用会话上下文的问题，但不会向主对话添加任何内容。当您想要理解一段代码、检查某个假设或探索某个想法，又不想让会话偏离方向时，可以使用它。

在 macOS 上按 Cmd+; 或在 Windows 上按 Ctrl+; 打开侧边聊天，或在输入框中输入 /btw。侧边聊天可以读取主线程中截至该时刻的所有内容。完成后，关闭侧边聊天，即可从中断处继续主会话。

侧边聊天可在本地、SSH 和 WSL 会话中使用。桌面应用不会将侧边聊天保存到磁盘，因此关闭应用后无法再返回之前的侧边聊天。

查看后台任务

任务窗格显示当前会话内正在运行的后台工作：子代理、后台 shell 命令和动态工作流。会话中有后台工作后，可通过标题栏 ⋮ 菜单中的 Background tasks 打开该窗格。

点击任意条目可在子代理窗格中查看其输出或将其停止。要查看其他会话正在做什么，请使用侧边栏，或请 Claude 为您查看。

跨会话工作

Claude 可以列出您的其他 Code 选项卡会话，读取每个会话一直在做的工作，并在它们之间发送消息。用自然语言提问即可："哪个会话涉及了身份验证重构？"、"API 会话得出了什么结论？"或"告诉支付会话 schema 已更改"。您也可以请 Claude 重命名或存档会话。Claude 存档会话的方式与侧边栏的存档图标相同，因此可以让它清理 PR 已合并的会话。

通过此使用入口，Claude 只能看到桌面应用自身运行的会话：Code 选项卡中的本地、SSH 和 WSL 会话。Claude 看不到云端会话，也看不到您从终端 CLI 或 VS Code 扩展启动的会话，即使它们位于同一项目的 worktree 中也是如此。因此，如果打开了九个终端 worktree 和两个桌面会话，在其中一个桌面会话中回答的 Claude 只会报告另一个桌面会话。Claude 从不会列出您正在提问的那个会话。默认情况下，它可以看到最近活跃的 20 个会话，并跳过已存档的会话，除非您明确要求。跨会话消息传递则另外让 Claude 可以向您的其他 Claude Code 会话发送消息，包括终端会话。

当 Claude 通过此使用入口向另一个会话发送消息时，Claude Code 会在对方会话中将其显示为一张卡片，卡片标有发送会话的标题和返回链接，因此您始终可以知道消息来自何处。如果接收会话正在执行任务，Claude Code 会暂存该消息，Claude 会在当前工作完成后读取它。接收方的 Claude 可以回复，Claude Code 会通过此使用入口将回复传回。Claude 无法向已存档的会话发送消息，并会在消息未送达时告知您。

Claude Code 在跨会话时应用四项安全行为：

• 在 Claude 存档会话之前，您会看到一张批准卡片，但自动模式和 Bypass permissions 模式除外，在这两种模式下 Claude 可以在没有批准卡片的情况下存档会话。如需在存档前被询问，请切换到 Manual。
• 通过此使用入口，Claude 无法从无人查看的会话（例如定时任务运行）发送跨会话消息，也无法向此类会话发送消息。
• Claude Code 会根据接收会话的入站控制检查来自此使用入口的每条消息，即使接收会话本身未启用跨会话消息传递。如果您在接收会话中将 crossSessionInbound 设置为 refuse，Claude Code 会丢弃来自此使用入口的消息。Claude Code 会向 Claude 桌面应用报告该拒绝。在 v2.1.234 之前，对于未启用跨会话消息传递的接收会话，Claude Code 会丢弃来自此使用入口的所有消息。
• Claude Code 会引用每条传入消息并注明其来自哪个发送会话，且 Claude 在据此执行操作时仍遵循接收会话自身的权限设置。

Claude 还可以建议新会话。当它注意到值得修复但超出当前任务范围的问题时，会在聊天中以任务标签的形式提供该工作。点击该标签即可在拥有独立 worktree 的新会话中开始该工作；Claude 会继续您的当前会话而不受干扰。

在云端运行长时间运行的任务

对于大型重构、测试套件、迁移或其他长时间运行的任务，请在启动会话时选择 Cloud 而不是 Local。云端会话默认在 Anthropic 管理的基础设施上运行，即使您关闭应用或关闭计算机也会继续运行。您可以随时回来查看进度，或引导 Claude 转向不同的方向。您也可以从 claude.ai/code 或 Claude 移动应用监控云端会话。

云端会话还支持多个仓库。选择云端环境后，点击所选仓库旁边的 + 按钮即可向会话添加更多仓库。每个仓库都有自己的分支选择器。这对于跨越多个代码库的任务很有用，例如更新共享库及其使用方。

有关云端会话工作方式的更多信息，请参阅在云端使用 Claude Code。当一项工作需要许多云端会话时，请在侧边栏中选择 Projects 创建一个项目，Claude 会在一个对话中为您启动并跟踪这些会话。

在另一个使用入口继续

要在其他地方继续会话，请通过会话标题旁边的下拉箭头或侧边栏中该会话所在的行打开会话菜单，然后选择 Open in：

• 选择 Cloud 可将会话作为云端会话继续，您的对话会以摘要形式带过去。在您确认之前，对话框会说明您的文件是否也会一并移动，以及云端会话就绪后此会话是否会被存档。通过 SSH 或在 WSL 中运行的会话无法以这种方式移动。
• 选择已安装的编辑器或文件管理器，可在其中打开该会话在磁盘上的文件夹。

控制哪些会话显示在您的其他设备上

本地会话在 Remote Control 将其连接后，会显示在您的其他设备上。已连接的会话会出现在 claude.ai/code 的会话列表中，以及登录了您 claude.ai 账户的设备上的 Claude 应用中。

本地会话会在您为其打开 Remote Control 时连接，或在启动时自动连接：

• 您为该会话打开它：使用该会话的 Remote Control 开关，或在其输入框中输入 /remote-control。
• 在启动时连接：当 Settings > Claude Code 中的 Connect new sessions to Remote Control 处于打开状态时，新会话会自动连接。如果您从未更改过该设置，Desktop 会遵循您的用户设置或托管设置中的 remoteControlAtStartup，其次是您组织的默认值。

要查看会话是否已连接，请查看工具栏中会话标题前的笔记本电脑图标。会话已连接或正在连接时，该图标会高亮显示。点击它可打开该会话的 Remote Control 开关。

要让会话不出现在您的其他设备上，请在所需的级别关闭 Remote Control：

• 单个会话：关闭其 Remote Control 开关。在启动时已自动连接的会话中，输入 /remote-control 会保持 Remote Control 打开，并显示 Remote Control is already on. This session connected automatically when it started.。点击该行上的 Turn off 即可断开连接。
• 此计算机上的新 Desktop 会话：在 Settings > Claude Code 中关闭 Connect new sessions to Remote Control。如果它已显示为关闭，请先将其打开再关闭，以便 Desktop 保存您的选择。保存后，它优先于 remoteControlAtStartup 和默认值。
• 此计算机上的任何会话，包括 CLI：在 ~/.claude/settings.json 中将 disableRemoteControl 设置为 true，以阻止会话连接。保存该文件时已连接的会话会保持连接，直到您为其关闭 Remote Control。

要隐藏已显示在您其他设备上的会话，请在 Desktop 中将其存档。Desktop 也会存档该会话的 Remote Control 副本，使其从这些设备上的默认会话列表中移除。要在那里查看或删除它，请参阅存档会话。

来自 Dispatch 的会话

Dispatch 是一个与 Claude 的持久对话，位于 Cowork 选项卡中。您向 Dispatch 发送任务消息，由它决定如何处理。

任务可以通过两种方式成为 Code 会话：您直接提出要求，例如"打开一个 Claude Code 会话并修复登录错误"；或者 Dispatch 判断该任务属于开发工作，并自行创建一个会话。通常会路由到 Code 的任务包括修复错误、更新依赖、运行测试或创建 Pull Request。研究、文档编辑和电子表格工作则保留在 Cowork 中。

无论哪种方式，Code 会话都会出现在 Code 选项卡的侧边栏中，并带有 Dispatch 徽章。当它完成或需要您批准时，您会在手机上收到推送通知。

如果您启用了计算机使用，由 Dispatch 创建的 Code 会话也可以使用它。这些会话中的应用批准会在 30 分钟后过期并重新提示，而不是像常规 Code 会话那样在整个会话期间有效。

有关设置、配对和 Dispatch 设置，请参阅 Dispatch 帮助文章。Dispatch 需要 Pro 或 Max 计划，Team 或 Enterprise 计划不可用。

Dispatch 是您离开终端时与 Claude 协作的几种方式之一。有关与其他选项的比较，请参阅平台和集成。

扩展 Claude Code

连接外部服务、添加可重用工作流、自定义 Claude 的行为并配置预览服务器。要在一个地方管理连接器、skills 和插件，请点击侧边栏中的自定义。Cowork 标签页在桌面应用中从此自定义配置获取其 skills、插件和连接器，该配置通过你的 claude.ai 账户同步，而不是从 CLI 的 ~/.claude 目录。

Claude Code 还会在你使用同一账户登录的终端会话中加载为你的 claude.ai 账户启用的 skills 和插件。请参阅从 claude.ai 同步的 Skills 和从 claude.ai 同步的插件。

连接外部工具

对于本地和 SSH 会话，点击提示框旁的 + 按钮并选择 Connectors 来添加集成，如 Google Calendar、Slack、GitHub、Linear、Notion 等。你可以在会话之前或期间添加连接器。+ 按钮在云会话或 WSL 会话中不可用，但 routines 在 routine 创建时配置连接器。

要管理或断开连接器，请在桌面应用中转到设置 → Connectors，或从提示框中的 Connectors 菜单中选择 Manage connectors。

连接后，Claude 可以读取你的日历、发送消息、创建问题并直接与你的工具交互。你可以询问 Claude 在你的会话中配置了哪些连接器。

连接器是MCP servers，具有图形设置流程。使用它们快速与支持的服务集成。对于连接器中未列出的集成，通过设置文件手动添加 MCP servers。你也可以创建自定义连接器。

使用 skills

Skills扩展 Claude 可以做的事情。Claude 在相关时自动加载它们，或者你可以直接调用一个：在提示框中输入 / 或点击 + 按钮并选择 Slash commands 来浏览可用的内容。这包括内置命令、你的自定义 skills、来自你的代码库的项目 skills 以及来自任何已安装插件的 skills。选择一个，它会在输入字段中突出显示。在它之后输入你的任务并照常发送。

您可以在 Claude 工作时发送命令，就像发送任何其他消息一样，会话会在该轮次完成后返回空闲状态。

本地会话从 ~/.claude/skills/ 加载你的个人 skills。SSH 会话从远程主机的主目录读取 ~/.claude/skills/，而不是从你的机器。

本地和云会话也加载为你的 claude.ai 账户启用的 skills，除非你的组织设置了 disableSideloadFlags。云会话改为加载它们，而不是 ~/.claude/skills/，如Cowork 和云会话中的 Skills所述。

安装插件

Plugins是可重用的包，为 Claude Code 添加 skills、agents、hooks、MCP servers 和 LSP 配置。你可以从桌面应用安装插件，而无需使用终端。

对于本地和 SSH 会话，点击提示框旁的 + 按钮并选择 Plugins 来查看你已安装的插件及其 skills。要添加插件，从子菜单中选择 Add plugin 来打开插件浏览器，它显示来自你配置的市场的可用插件，包括官方 Anthropic 市场。选择 Manage plugins 来启用、禁用或卸载插件。

你可以将插件限定到你的用户账户、特定项目或仅本地。如果你的组织集中管理插件，这些插件在桌面会话中的可用方式与在 CLI 中相同，除了桌面应用在 disableSideloadFlags 下扣留的那些。

插件浏览器在云会话中不可用，从桌面应用安装的插件不可用于云会话。云会话也不会安装存储库的 .claude/settings.json 声明的插件，如从你的设置中继承的内容所述。插件在 WSL 会话中不可用。有关完整的插件参考，包括创建你自己的插件，请参阅 plugins。

配置预览服务器

Claude 自动检测你的开发服务器设置并将配置存储在启动会话时选择的文件夹根目录的 .claude/launch.json 中。Preview 使用此文件夹作为其工作目录，因此如果你选择了父文件夹，具有自己开发服务器的子文件夹将不会自动检测。要使用子文件夹的服务器，要么直接在该文件夹中启动会话，要么手动添加配置。

要自定义服务器的启动方式，例如使用 yarn dev 而不是 npm run dev，或更改端口，请编辑 .claude/launch.json。该文件支持带注释的 JSON。

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

你可以定义多个配置来从同一项目运行不同的服务器，例如前端和 API。请参阅下面的示例。

自动验证更改

启用 autoVerify 时，Claude 在编辑文件后自动验证代码更改。它拍摄屏幕截图、检查错误并在完成响应之前确认更改有效。

自动验证默认开启。可通过在 .claude/launch.json 中添加 "autoVerify": false 来按项目禁用它，或在 Browser 窗格的 ⋮ 菜单中关闭 Auto-verify changes。

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

禁用时，预览工具仍然可用，你可以随时要求 Claude 验证。自动验证使其在每次编辑后自动进行。

配置字段

configurations 数组中的每个条目接受以下字段：

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 8443,
      "url": "https://localhost:8443"
    }
  ]
}

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "url": "https://app.localhost:3000"
    }
  ]
}

{
"version": "0.0.1",
"configurations": [
{
"name": "web",
"runtimeExecutable": "yarn",
"runtimeArgs": ["dev"],
"port": 3000
}
]
}

{
"version": "0.0.1",
"configurations": [
{
"name": "frontend",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"cwd": "apps/web",
"port": 3000,
"autoPort": true
},
{
"name": "api",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "start"],
"cwd": "server",
"port": 8080,
"env": { "NODE_ENV": "development" },
"autoPort": false
}
]
}

{
"version": "0.0.1",
"configurations": [
{
"name": "server",
"program": "server.js",
"args": ["--verbose"],
"port": 4000
}
]
}

您在启动会话时选择的环境决定了 Claude 在何处执行以及您如何连接：

• Local：在您的计算机上运行，可直接访问您的文件
• Cloud：默认在 Anthropic 托管的基础设施上运行。即使您关闭应用，会话也会继续。
• SSH：在您通过 SSH 连接的远程计算机上运行，例如您自己的服务器、云虚拟机或开发容器。正在运行的任务可以在 Desktop 断开连接时继续运行，但使用 Claude 账户时，任务可能会在其登录过期时停止。
• WSL（Windows）：在您计算机上的 WSL 2 发行版内运行，使用该发行版的 Linux 工具链和原生路径

本地会话

桌面应用并不总是继承您完整的 shell 环境。在 macOS 上，当您从 Dock 或 Finder 启动应用时，它会读取您的 shell profile 文件（例如 ~/.zshrc 或 ~/.bashrc），为 Claude Code 提供 PATH 和一组固定的 Claude Code 变量，但不包括您在其中导出的其他变量。在 Windows 上，应用会继承用户和系统环境变量，但不会读取 PowerShell profile 文件。

若要在任何平台上为本地会话和开发服务器设置环境变量，请打开输入框中的环境下拉菜单，将鼠标悬停在 Local 上，然后点击齿轮图标以打开本地环境编辑器。您在此处保存的变量会加密存储在您的计算机上，并应用于您启动的每个本地会话和预览服务器。您也可以将变量添加到 ~/.claude/settings.json 文件中的 env 键，但这些变量只会传递给 Claude 会话，不会传递给开发服务器。有关受支持变量的完整列表，请参阅环境变量。

扩展思考默认启用，这可以提升复杂推理任务的表现，但会消耗额外的 token。在 Anthropic API 上，在本地环境编辑器中将 MAX_THINKING_TOKENS 设置为 0 即可关闭思考；这对 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 模型无效，这些模型始终使用扩展思考。在 Anthropic API 上关闭思考后，对于 Claude Code 已知不接受该组合的模型（例如 Opus 5），Claude Code 会发送 effort high，而不是更高的级别。

在支持自适应推理的模型上，Claude Code 会忽略正值 MAX_THINKING_TOKENS 中的具体数值，因为自适应推理会改为控制思考深度。在 Opus 4.6 和 Sonnet 4.6 上，将 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 设置为 1 可使用固定的思考预算；Fable 模型、Sonnet 5 及更高版本、Haiku 5.5 以及 Opus 4.7 及更高版本始终使用自适应推理，没有固定预算模式。

托管设备上的本地会话

您的管理员可以通过 disableDesktopLocalSessions 托管设置关闭本地会话。关闭后，Local 仍会显示在环境下拉菜单中，但呈灰色且无法选择，并带有说明您的组织已将其关闭的工具提示；在 Windows 上，WSL 条目（其在托管设备上的可用性另行管控）也会以同样方式呈灰色。如果已配置 SSH 连接，新会话默认使用第一个 SSH 连接；如果您尝试继续现有的本地会话，Desktop 会显示一条消息，说明本设备上无法使用本地会话。请改为选择 SSH 或云端环境，或联系您的 IT 团队。

云端会话

即使您关闭应用，云端会话也会在后台继续运行。用量计入您的订阅套餐限额，不单独收取计算费用。

您可以创建具有不同网络访问级别和环境变量的自定义云端环境。若要管理这些环境，请打开输入框中的环境下拉菜单并选择 Cloud：

• 添加环境：选择 Add cloud environment
• 编辑或归档您自己的某个环境：将鼠标悬停在该环境上，然后点击齿轮图标

有关配置网络访问和环境变量的详细信息，请参阅配置云端环境。

SSH 会话

SSH 会话让您可以在远程计算机上运行 Claude Code，同时使用桌面应用作为界面。这对于处理位于云虚拟机、开发容器或具有特定硬件或依赖的服务器上的代码库非常有用。

若要添加 SSH 连接，请在开始会话之前打开输入框中的环境下拉菜单，然后选择 SSH > Add SSH connection… 并填写连接详细信息：

• Name：此连接的友好标签
• SSH host：user@hostname 或在 ~/.ssh/config 中定义的主机
• SSH port：留空时默认为 22，或使用您 SSH 配置中的端口
• SSH key (optional)：您的私钥路径，例如 ~/.ssh/id_ed25519。留空则使用您的 SSH 配置或 SSH agent。
• Worktree folder：远程计算机上的一个文件夹（例如 ~/worktrees），新会话会在其中创建 worktree。留空则使用远程计算机的默认位置。

添加后，该连接会显示在环境下拉菜单的 SSH 下。选择它即可在该计算机上启动会话。Claude 在远程计算机上运行，可以访问其文件和工具。

远程计算机可以运行 Linux、macOS 或 Windows。首次连接时，Desktop 会自动在远程计算机上安装 Claude Code。连接后，SSH 会话支持权限模式、连接器、插件和 MCP 服务器。

SSH 会话的远程计算机要求

Linux 或 macOS 远程计算机需要受支持的处理器、带 SFTP 的 SSH 服务器、未以 noexec 挂载的安装文件夹、可正常工作的 shell 以及网络访问。请在连接之前检查每项要求，或在登录后连接失败时进行检查：

• 系统：x86_64 或 arm64 处理器。该计算机还必须满足 Claude Code 的系统要求。在 Linux 上，Claude Code 需要 glibc 2.17 或更高版本，或 musl。若要查看该计算机使用的是哪一种，请在其上运行 ldd --version。在 Alpine Linux 等基于 musl 的发行版上，还需安装 Claude Code 所需的软件包。
• SFTP：SSH 服务器必须提供 SFTP 子系统，该子系统通过其 sshd_config 中的 Subsystem sftp 行启用。若要检查，请在您计算机上的终端中使用 sftp 连接到相同的主机和端口。正常工作的服务器会显示 sftp> 提示符。
• 每个连接的会话数：macOS 和 Linux 上的 Desktop 会在一个 SSH 连接上打开多个会话。如果服务器的 sshd_config 设置了 MaxSessions 1，请将其调高，例如调到 OpenSSH 的默认值 10。
• 安装文件夹：Desktop 会在您主目录下的 ~/.claude/remote/ 中安装一个辅助程序和 Claude Code。它从该位置运行这些程序，因此该文件夹不能位于以 noexec 挂载的文件系统上。请在每个连接用户的主目录中预留约 1 GB 的磁盘空间。有关该文件夹包含的内容，请参阅远程计算机上的文件和进程。
• Shell：远程计算机上为您的账户设置的 shell 必须能运行通过 SSH 发送的命令，Bash、Zsh 和 sh 均可
• 网络：Claude Code 在远程计算机上运行，并从那里发出网络请求，因此该计算机需要具备 Claude Code 所需的网络访问。如果该计算机无法下载 Claude Code，Desktop 会在您的计算机上下载并上传它。Claude Code 的其他请求仍从远程计算机发出。在 Linux 远程计算机上，如果这些请求需要代理，请为 SSH 会话设置代理。

为 SSH 会话设置代理或 CA 证书

如果 Linux 远程计算机通过代理访问互联网或需要 CA 证书，请在该计算机上的 ~/.claude/settings.json 中的 env 下添加代理和 CA 变量。即使您已在该计算机上的 ~/.profile、~/.bash_profile、~/.zprofile 或 ~/.zshrc 中导出它们，也要添加。

SSH 会话不会从这些文件中获取它们，即使在该计算机终端中运行的 claude 可以获取。此时会话可能会挂起，或显示 The connection from … to the API failed 或 Authentication failed，且重新登录也无济于事。

{
"env": {
"HTTPS_PROXY": "http://proxy.example.com:8080",
"NODE_EXTRA_CA_CERTS": "/etc/ssl/certs/example-ca.pem"
}
}

查找远程计算机上其他位置设置的代理或 CA 变量

请检查 Linux 远程计算机是否在其他位置设置了代理或 CA 变量，因为会话会使用该值，并忽略任何设置文件中的值：

在 macOS 和 Linux 上使用您的 SSH 配置

在 macOS 和 Linux 上，Desktop 通过在您的计算机上运行 OpenSSH 客户端进行连接，因此会使用您的 ~/.ssh/config。通过 OpenSSH 客户端连接需要 Claude Desktop v1.37937.0 或更高版本。在 SSH host 字段中输入该文件中的 Host 名称，即可使用其条目中的设置，例如 HostName、User、IdentityFile、CertificateFile、ProxyJump 和 ProxyCommand。

添加连接之前，请在您计算机上的终端中检查客户端和条目：

• 客户端版本：运行 ssh -V。客户端必须是 OpenSSH 7.6 或更高版本。
• 条目：使用 Host 名称运行 ssh，例如 ssh devbox。如果失败，请先修复该条目。

您可以将 SSH port 和 SSH key (optional) 字段留空。如果填写其中之一，Desktop 会将其与条目一起使用：

• SSH port：此处的值会覆盖条目的 Port
• SSH key (optional)：除条目的 IdentityFile 和您 SSH agent 中的密钥外，Desktop 还会提供您选择的密钥文件

访问跳板机后面的计算机

若要访问位于跳板机（也称为堡垒机）后面的计算机，请在条目中设置 ProxyJump 或 ProxyCommand。以下条目通过 bastion.example.com 访问 devbox.internal.example.com：

Host devbox
  HostName devbox.internal.example.com
  User alice
  ProxyJump bastion.example.com

在 SSH host 字段中输入 devbox。

访问远程计算机上的容器

若要在未发布 SSH 端口的容器内运行会话，请使用 ProxyCommand 访问它，因为 Desktop 不会运行您所连接条目的 RemoteCommand。如果您的条目使用 RemoteCommand 进入容器，会话将在该条目登录的计算机上运行，而不是在容器中运行。

Host devbox-container
User dev
ProxyCommand ssh build.example.com docker exec -i devbox /usr/sbin/sshd -i

在 `ProxyCommand` 中使用来自 shell 的变量

若要在 ProxyCommand 或 Match exec 命令中使用您自己的环境变量，请在 shell 启动文件（例如 ~/.zshrc）中导出它，然后退出并重新打开 Desktop。Desktop 启动时会读取您的登录 shell 导出的内容，并在您退出之前一直保留这些值。

这需要 Claude Desktop v2.37337.0 或更高版本，以及一个接受 -0 的 env 命令，您可以在计算机上的终端中运行 env -0 进行检查。

[profile corp]
region = us-east-1
credential_process = /full/path/to/your-credential-helper

Host i-*
ProxyCommand sh -c "aws ssm start-session --profile corp --target %h --document-name AWS-StartSSHSession --parameters 'portNumber=%p'"

提高 SSH 连接超时时间

如果您的 SSH 配置没有为该主机设置 ConnectTimeout，Desktop 会给 ssh 30 秒的连接时间。通过跳板机或 ProxyCommand 连接时，该时间包括路由建立连接所需的时间。如果您的路由需要更长时间，请在条目中添加更高的值：

Host devbox
  HostName devbox.internal.example.com
  User alice
  ProxyJump bastion.example.com
  ConnectTimeout 120

ssh 会使用它为主机找到的第一个值，因此请将该条目放在任何设置了 ConnectTimeout 的 Host * 条目之上。若要确认，请在您计算机上的终端中运行 ssh -G devbox。其输出包含 connecttimeout 120。更改该值后，请退出并重新打开 Desktop。

如果远程计算机本身等待您在手机上批准，无论您设置的 ConnectTimeout 是多少，都请在 45 秒内批准。您无法提高此限制，因为 Desktop 会自行设置 ServerAliveInterval 和 ServerAliveCountMax，之后 ssh 会关闭远程计算机在这么长时间内未发送任何内容的登录。如果是跳板机或 ProxyCommand 在等待您，请在远程计算机的条目中提高 ConnectTimeout 以涵盖该时间。

修复仅由 Desktop 应用的 `Match host` 块

如果 Desktop 使用了终端中 ssh devbox 不使用的设置，请查找条目 HostName 行上方的 Match host 块。在终端中，ssh 会在 HostName 行之前读取该处的块，因此它将该块与 devbox 进行比较。Desktop 在命令行中向 ssh 提供 HostName 值，因此 ssh 会将该块与该值进行比较。

若要检查，请像 Desktop 那样，在您计算机上的终端中运行 ssh -G，并在命令行中提供条目的 HostName 和 User 值：

ssh -G -o HostName=devbox.internal.example.com -l alice devbox

将输出与 ssh -G devbox 的输出进行比较。如果该块的设置（例如 proxycommand）仅出现在第一个输出中，则该块仅在 Desktop 中生效。若要让 Desktop 也跳过它，请在其 Match 行中添加 !originalhost devbox：

Match host *.internal.example.com !originalhost devbox

若要确认，请再次运行第一个命令。该块的设置将不再出现在其输出中。

Desktop 保持关闭的转发设置

在与远程计算机的连接上，Desktop 会保持 ForwardAgent、ForwardX11、LocalForward、RemoteForward、DynamicForward 和 Tunnel 关闭，即使您的 SSH 配置启用了它们。在终端或 ! 命令中，您的转发设置只在某些情况下生效，因为 Desktop 可能会在那里启动一个遵循这些设置的单独 ssh。

• 若要访问远程计算机上的端口：自行转发
• 若要在远程计算机上使用您自己的密钥：在远程计算机本身上设置凭据，例如用于 git push

若要防止 Desktop 转发您的 SSH agent 或端口，请在您计算机上的终端中运行 ssh -G devbox。然后按照 Desktop 可能的运行方式再次运行它，使用它输出的 hostname 和 user 值，如 ssh -G -o HostName=devbox.internal.example.com -l alice devbox。第二个输出可能会显示第一个输出跳过的 Match 块中的设置。

在两个输出中查找值不是 no 的 forwardagent 行，以及以 localforward、remoteforward 或 dynamicforward 开头的行。如果找到，请从您的 SSH 配置中删除该设置。对于您的 ProxyCommand 使用 ssh 访问的主机，也执行同样的操作。

访问远程计算机上的端口

若要打开在远程计算机上运行的服务器（例如端口 3000 上的开发服务器），请自行转发端口。在您计算机上的终端中，使用 -L 和您连接的主机（例如 devbox）运行 ssh：

ssh -N -L 3000:localhost:3000 devbox

如果您在连接上填写了 SSH port 或 SSH key (optional)，请添加带有相同值的 -p 或 -i。保持该命令运行，然后在您计算机上的浏览器中打开 http://localhost:3000 以访问远程计算机的端口 3000。如果 ssh 输出 open failed: administratively prohibited，请让该计算机的管理员允许 TCP 转发，这由 SSH 服务器 sshd_config 中的 AllowTcpForwarding 控制。

Windows 远程计算机

Windows 远程计算机需要 Claude Desktop v2.31226.0 或更高版本。

请使用 Microsoft 的 OpenSSH Server。该计算机可以是 x64 或 ARM64。SSH 服务器启动的 shell 可以是 cmd.exe、Windows PowerShell 5.1 或 Git Bash。

Windows 远程计算机的测试少于 Linux 远程计算机。在依赖它之前，请先在其上试运行您自己的工作。

在 Windows 远程计算机上，预计会有以下限制（包括但不限于）：

• 终端：在文件夹为 Windows 路径（例如 C:/projects/app）的会话中，终端不会打开
• 沙箱：Claude Code 在那里以原生 Windows 方式运行，在此环境下它运行命令时不使用沙箱。请参阅沙箱在何处运行。
• 插件：如果插件包含 Windows 无法存储的文件或文件夹名称（例如含有 : 的名称），Desktop 不会复制该插件。会话会列出 Desktop 遗漏的插件。
• MCP 服务器：在某些 Windows 远程计算机上，Claude 对来自 claude_desktop_config.json 的 MCP 服务器的调用会经过 Desktop，因此 Desktop 断开连接时 Claude 无法调用其工具。在 Claude Desktop v2.37337.0 之前，这适用于所有 Windows 远程计算机。
• Worktree：worktree 位于 <project-root>/.claude/worktrees/。如果您选择其他文件夹，Desktop 会忽略它。
• 早期消息：如果 SSH 服务器的 shell 是 cmd.exe 或 Windows PowerShell，您可能需要先连接才能看到会话的早期消息
• 分叉：如果 SSH 服务器的 shell 是 cmd.exe 或 Windows PowerShell，您只能在会话的第一条消息处分叉会话
• 断开连接时运行：只有当 SSH 服务器允许程序在启动它的连接结束后继续存在时，任务才会在 Desktop 断开连接时继续运行。若要确认，请测试远程计算机。
• 残留进程：会话结束后，请检查计算机上是否有 Claude Code 启动的程序，因为它们可能会继续运行。Desktop 安装的后台辅助程序在那里不会自行停止。

在 Desktop 断开连接时保持任务运行

如果您的计算机进入睡眠、网络中断或您退出 Desktop，任务会继续进行，直到完成、需要您处理或达到某项限制。合上笔记本盖也算作睡眠。Desktop 或您计算机的重启（包括因更新而重启）算作退出。

Claude Code 作为进程在远程计算机上运行，由 Desktop 在那里安装的后台辅助程序管理，因此它无需您的 SSH 连接即可继续运行。本节所述行为需要 Claude Desktop v2.31226.0 或更高版本。

• 睡眠或网络中断后：如果进程仍在运行且 Desktop 可以无需提示登录，您会重新获得正在运行的任务。如果无法登录，请发送消息。
• 退出之后：任务会继续运行，但除非 Desktop 能重新接入其进程，否则当会话再次打开时您会失去该任务。退出之前，请查看 Desktop 何时可以重新接入。如果您失去了任务，请发送消息以继续。

当您回来而任务尚未完成时，请检查是否有 Desktop 无法重新连接的提示、身份验证错误或等待中的请求：

• Desktop 无法重新连接：会话会说明原因，也可能会有通知说明。Desktop 可能需要您登录。
• 身份验证错误：登录令牌或凭据可能已过期。使用 Claude 账户时，请发送消息以继续。使用第三方提供商时，请参阅 3P 上 Claude Desktop 中的 SSH 远程会话。
• 等待中的请求：回应该请求
• 以上都不是：发送消息以继续

• 先更新：在开始长时间任务之前更新 Desktop。在 macOS 和 Windows 上，Desktop 可能会自行重启以安装已下载的更新。当 Claude 正在处理 SSH 任务时，该重启会等待。在使用 Claude 账户的 macOS 上，默认情况下，更新等待 72 小时后，重启仍可能进行。
• 在 Windows 上，或在 v2.42304.0 之前使用第三方提供商时，不要退出：在这些情况下，退出后您会失去正在运行的任务，因此请在任务期间保持 Desktop 打开。在其他任何情况下，退出之前请查看您能找回什么。
• 减少请求：选择让任务更少等待您的权限模式、规则或 hook
• 检查跳板机：如果您的跳板机要求登录（例如向手机发送推送），请改用无需提示即可工作的登录方式。否则，Desktop 每次尝试重新连接时都可能发送另一条推送。
• 测试远程计算机：启动一个短任务，在任务仍在运行时退出 Desktop，并在任务应该完成很久之后再次打开会话。如果任务尚未完成且会话未显示身份验证错误，请检查远程计算机上可能结束任务的因素。
• 不要在 Desktop 的终端中运行命令：如果远程计算机会注销空闲终端，请从 Desktop 之外的 SSH 登录运行您自己的命令

• 登录令牌或凭据：使用 Claude 账户时，令牌过期后任务会因身份验证错误而停止。使用第三方提供商时，会过期的凭据（例如来自单点登录或凭据辅助程序的凭据）同样如此。请参阅 3P 上 Claude Desktop 中的 SSH 远程会话。使用 Claude 账户时，请保持 Desktop 运行并连接，以便它能续期登录。
• 远程计算机：如果远程计算机重启，或在您的 SSH 连接关闭时结束您的进程，正在运行的任务就会结束。在 Desktop 断开连接期间，不会有任何东西重新启动它。systemd-logind 的 KillUserProcesses 为 yes 且适用于您用户的 Linux 计算机会以这种方式结束您的进程。若要在这类计算机上保持任务运行，请让管理员豁免您的用户，例如使用 KillExcludeUsers。
• 空闲终端：某些 Linux 远程计算机会注销在设定时间内无人输入的终端（systemd-logind 的 StopIdleSessionSec）。在 macOS 或 Linux 上的 Desktop 中，会话的终端和 ! 命令默认共享 Desktop 的 SSH 连接。因此，该注销会在 Desktop 连接期间结束连接，正在运行的任务也可能随之结束。关闭终端窗格并不能防止这种情况，因此请不要在该终端中运行命令。
• Desktop 更新：如果更新带来了新的辅助程序，Desktop 会在之后的某次连接时替换远程计算机上的辅助程序，这可能会结束仍在运行的任务
• 长时间离开：在 Linux 或 macOS 远程计算机上，如果 Desktop 30 天内未连接，辅助程序会停止，并结束在其下运行的所有 Claude Code 进程。请在此之前连接。

在 Desktop 断开连接期间，文件编辑和某些工具可能会失败。如果任务需要它们，请保持 Desktop 连接：

• Worktree：在使用 worktree 的会话中，Desktop 会在 Claude 进行每次文件编辑之前对其进行检查。在 Desktop 断开连接期间，每次编辑会等待约 30 秒，然后失败。Shell 命令仍会运行。在 Linux 或 macOS 远程计算机上，编辑可以继续工作。如果您不确定，请在不使用 worktree 的情况下启动会话。
• 文件夹限制：如果您的组织限制了会话可以使用的文件夹，无论是否使用 worktree，Desktop 都会检查每次文件读取、搜索和编辑。在 Desktop 断开连接期间，每项操作最多等待 10 分钟，然后失败。
• 连接器：连接器和 Desktop 提供的其他工具通过 Desktop 运行，因此在其断开连接期间，每次调用都会在约 30 秒后失败
• 工作流：Desktop 会在每个新工作流启动前对其进行检查，因此在 Desktop 断开连接期间，新工作流最多等待 10 分钟，然后失败
• MCP 服务器：Claude Code 在远程计算机上启动的 MCP 服务器不通过 Desktop 运行，因此 Claude 仍可调用其工具。仅当 Desktop 未使用其内置 SSH 客户端时，来自 claude_desktop_config.json 的服务器才属于这一类。否则，以及在某些 Windows 远程计算机上，Desktop 断开连接期间 Claude 无法调用其工具。

drop connection #0 from [203.0.113.7]:51234 on [192.0.2.10]:22 penalty: connections without attempting authentication

fail2ban-regex -o ip lines.log "sshd[mode=aggressive]"

claude://code/new?ssh_host=dev%40build.example.com&ssh_port=2222&ssh_folder=/srv/payments&q=Investigate%20the%20failed%20deploy

{
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "user@dev.example.com",
      "sshPort": 22,
      "sshIdentityFile": "~/.ssh/id_ed25519"
    }
  ]
}

{
  "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}

{
  "disableDesktopLocalSessions": true,
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "dev.example.com"
    }
  ],
  "sshHostAllowlist": ["dev.example.com"]
}

anthropic.com
*.anthropic.com
claude.ai
*.claude.ai
claude.com
*.claude.com
claude.app
*.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

anthropic.com
api.anthropic.com
a-api.anthropic.com
a-cdn.anthropic.com
s-cdn.anthropic.com
assets-proxy.anthropic.com
claude.ai
a.claude.ai
assets.claude.ai
downloads.claude.ai
*.livepreview.claude.ai
claude.com
platform.claude.com
*.livepreview.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

claude --desktop --resume <session-id>

git fetch origin <branch-name>
git checkout <branch-name>