Auto mode 对 Anthropic API 上的所有用户可用，需要 Claude Opus 4.6 或更高版本、Sonnet 4.6 或更高版本，或 Fable model。组织管理员可以使用托管设置中的 disableAutoMode 键关闭 auto mode。

在路由 Desktop 到 Google Cloud 的 Agent Platform 的 Enterprise 部署中，auto mode 也默认可用；有关支持的模型，请参阅 Auto mode on Bedrock, Agent Platform, or Foundry。

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

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

预览你的应用

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

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

从浏览器窗格，你可以：

• 直接在浏览器窗格中与运行的应用交互
• 观看 Claude 自动验证其自己的更改：它拍摄屏幕截图、检查 DOM、点击元素、填充表单，并修复它发现的问题
• 从会话工具栏中的服务器下拉菜单启动或停止服务器
• 通过在下拉菜单中选择持久化会话来在服务器重启后保持 cookie 和本地存储，这样你就不必在开发期间重新登录
• 编辑服务器配置或一次停止所有服务器

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

要清除保存的会话数据，或完全关闭浏览器，请使用设置 → Claude Code 中的切换。

浏览外部网站

浏览器窗格是一个选项卡式浏览器，因此你可以在运行应用旁边打开文档、问题跟踪器或任何其他网站。要打开浏览器，在 macOS 上按 Cmd+Shift+B 或在 Windows 上按 Ctrl+Shift+B，或从视图菜单中选择它。当你点击聊天中的外部链接时，选择器会提供在应用中打开以使用浏览器窗格或默认浏览器以使用你自己的；在 macOS 上 Cmd 点击或在 Windows 上 Ctrl 点击直接在你的系统浏览器中打开链接。你可以登录窗格中的网站，包括弹出式登录流，例如 Google OAuth。

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

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

批准 Claude 在网站上的操作

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

即使在批准的网站上，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 阻止外部网站。

使用差异视图审查更改

Claude 对你的代码进行更改后，差异视图让你在创建拉取请求之前逐个文件审查修改。

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

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

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

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

审查你的代码

在差异视图中，点击右上角工具栏中的审查代码以要求 Claude 在你提交之前评估更改。Claude 检查当前差异并直接在差异视图中留下评论。你可以回应任何评论或要求 Claude 修订。

审查侧重于高信号问题：编译错误、明确的逻辑错误、安全漏洞和明显的错误。它不会标记样式、格式、预先存在的问题或 linter 会捕获的任何内容。

监控拉取请求状态

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

• 自动修复：启用后，Claude 会通过读取失败输出并迭代来自动尝试修复失败的 CI 检查。
• 自动合并：启用后，Claude 在所有检查通过后合并 PR。合并方法是压缩。首先在你的 GitHub 存储库设置中启用自动合并；没有它，Claude 无法合并 PR。

使用 CI 状态栏中的自动修复和自动合并切换来启用任一选项。Claude Code 也会在 CI 完成时发送桌面通知。要在 PR 合并或关闭后自动归档会话，请在设置 → Claude Code 中打开自动归档。

整理工作区

Code 选项卡围绕你可以以任何布局排列的窗格构建：聊天、diff、浏览器、终端、文件、plan、tasks 和 subagent，以及 macOS 上的 iOS Simulator。通过其标题拖动窗格来重新定位它，或拖动窗格边缘来调整大小。在 macOS 上按 Cmd+\ 或在 Windows 上按 Ctrl+\ 来关闭焦点窗格。从会话工具栏中的 Views 菜单打开其他窗格。

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

在终端中运行命令

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

打开和编辑文件

点击聊天或 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 来循环浏览它们。Thinking 模式仅在 Claude 在你正在查看的会话中产生思考后才出现在下拉菜单中。

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

快捷键

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

这些快捷键仅适用于 Code 选项卡。基于终端的交互模式快捷键（如 Shift+Tab 来循环权限模式）在 Desktop 中不适用。

检查使用情况

点击模型选择器旁的使用环形图来查看你当前的上下文窗口使用情况和你的计划在该期间的使用情况。上下文使用是按会话的；计划使用在所有 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+\ 来关闭焦点窗格并返回到单个会话。

Worktrees 默认存储在 <project-root>/.claude/worktrees/ 中。你可以在设置 → Claude Code 中的"Worktree location"下将其更改为自定义目录。你也可以设置一个分支前缀，该前缀会添加到每个 worktree 分支名称前面，这对于保持 Claude 创建的分支有组织很有用。要在完成后删除 worktree，请将鼠标悬停在侧边栏中的会话上并点击存档图标。要在 PR 合并或关闭时让会话自动存档，在设置 → Claude Code 中打开 Auto-archive after PR merge or close。自动存档仅适用于已完成运行的本地会话。

要在新 worktrees 中包含 gitignored 文件（如 .env），在你的项目根目录中创建一个 .worktreeinclude 文件。

使用侧边栏顶部的控制来按状态、项目或环境过滤会话，并按项目分组会话。要重命名会话，点击活跃会话顶部工具栏中的会话标题。

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

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

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

侧边聊天让你提出一个使用你的会话上下文的问题，但不会添加任何内容回到主对话。当你想要理解一段代码、检查一个假设或探索一个想法而不引导会话偏离时，使用它。

在 macOS 上按 Cmd+; 或在 Windows 上按 Ctrl+; 来打开侧边聊天，或在提示框中输入 /btw。侧边聊天可以读取主线程中到该点为止的所有内容。完成后，关闭侧边聊天并在你离开的地方继续主会话。

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

观看后台任务

任务窗格显示在当前会话内运行的后台工作：子代理、后台 shell 命令和动态工作流。从 Views 菜单打开它或将其拖入你的布局。

点击任何条目来在子代理窗格中查看其输出或停止它。要查看其他会话在做什么，使用侧边栏，或要求 Claude 为你检查它们。

跨会话工作

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

通过这个界面，Claude 只看到桌面应用本身运行的会话：本地、SSH 和 WSL 会话在 Code 选项卡中。Claude 看不到云会话，或你从终端 CLI 或 VS Code 扩展启动的会话，即使在同一项目的 worktrees 中，所以有九个终端 worktrees 打开和两个桌面会话，Claude 在其中一个回答时报告另一个桌面会话。Claude 永远不会列出你提问的会话。默认情况下，它看到 20 个最近活跃的会话，并跳过存档的会话，除非你要求它们。跨会话消息传递 单独让 Claude 向你的其他 Claude Code 会话发送消息，包括终端会话。

当 Claude 通过这个界面向另一个会话发送消息时，Claude Code 在那里将其显示为一张卡片，标记有发送会话的标题和返回链接，因此你总是可以看到消息来自哪里。如果接收会话正在执行任务中，Claude Code 会保留消息，Claude 在当前工作完成后读取它。接收的 Claude 可以回复，Claude Code 通过这个界面将回复传递回去。Claude 无法传递到存档的会话，并在消息未通过时告诉你。

Claude Code 在会话间应用四个安全行为：

• 在存档任何会话之前，Claude 首先询问你。你在每个权限模式中看到批准卡片，包括自动和绕过权限。
• 通过这个界面，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 移动应用监控云会话。

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

有关云会话如何工作的更多信息，请参阅 Web 上的 Claude Code。当一项工作需要许多云会话时，在侧边栏中选择 Projects 来创建一个项目，Claude 从一个对话中为你启动和跟踪会话。

在另一个表面继续

Continue in 菜单，可从会话工具栏右下角的 VS Code 图标访问，让你将会话移动到另一个表面：

• Web 上的 Claude Code：将你的本地会话发送到云中继续运行。Desktop 推送你的分支，生成对话摘要，并创建具有完整上下文的新云会话。你可以然后选择存档本地会话或保留它。这需要干净的工作树，对于 SSH 会话不可用。
• 你的 IDE：在当前工作目录的支持的 IDE 中打开你的项目。

来自 Dispatch 的会话

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

任务可以通过两种方式成为 Code 会话：你直接要求一个，例如"打开 Claude Code 会话并修复登录错误"，或 Dispatch 决定任务是开发工作并自己生成一个。通常路由到 Code 的任务包括修复错误、更新依赖项、运行测试或打开拉取请求。研究、文档编辑和电子表格工作保留在 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 工作时发送命令，就像任何其他消息一样，会话在轮次完成后返回空闲状态。在 v2.1.206 之前，在轮次中间发送的命令可能会导致会话显示为运行状态，你之后发送的消息未被传递。

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

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

安装插件

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

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

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

插件浏览器在云会话中不可用，从桌面应用安装的插件不可用于云会话。要在云会话中使用插件，要么在存储库的 .claude/settings.json 中的 enabledPlugins 下声明它，以便 Claude Code 在会话启动时安装它，要么为你的 claude.ai 账户启用它，以便 Claude Code 将其作为同步插件加载。插件在 WSL 会话中不可用。有关完整的插件参考，包括创建你自己的插件，请参阅 plugins。

配置预览服务器

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

要自定义服务器的启动方式，例如使用 yarn dev 而不是 npm run dev 或更改端口，手动编辑文件或点击服务器下拉菜单中的 Edit configuration 在你的代码编辑器中打开它。该文件支持带注释的 JSON。

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

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

自动验证更改

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

自动验证默认打开。通过在 .claude/launch.json 中添加 "autoVerify": false 来按项目禁用它，或从服务器下拉菜单切换它。

{
  "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 连接的远程机器上运行，例如你自己的服务器、云虚拟机或开发容器
• WSL（Windows）：在你的机器上的 WSL 2 发行版内运行，使用其 Linux 工具链和本地路径

本地会话

桌面应用并不总是继承你的完整 shell 环境。在 macOS 上，当你从 Dock 或 Finder 启动应用时，它读取你的 shell 配置文件，例如 ~/.zshrc 或 ~/.bashrc，来提取 PATH 和一组固定的 Claude Code 变量，但你在那里导出的其他变量不会被拾取。在 Windows 上，应用继承用户和系统环境变量，但不读取 PowerShell 配置文件。

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

Extended thinking默认启用，这改进了复杂推理任务的性能，但使用额外的令牌。在 Anthropic API 上，在本地环境编辑器中将 MAX_THINKING_TOKENS 设置为 0 来关闭思考；这对 Fable 模型没有影响，Fable 模型始终使用 extended thinking。在 Anthropic API 上关闭思考后，Claude Code 发送努力级别 high 而不是更高级别给它知道的不接受该组合的模型，例如 Opus 5。

在具有自适应推理的模型上，除 0 外的 MAX_THINKING_TOKENS 值被忽略，因为自适应推理控制思考深度。在 Opus 4.6 和 Sonnet 4.6 上，设置 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 为 1 来使用固定思考预算；Fable 模型、Sonnet 5 和 Opus 4.7 及更高版本始终使用自适应推理，没有固定预算模式。

托管设备上的本地会话

你的管理员可以使用 disableDesktopLocalSessions 托管设置关闭本地会话。当他们这样做时，Local 保留在环境下拉菜单中但被灰显，无法选择，并显示一个工具提示说你的组织关闭了它，在 Windows 上 WSL 条目（其在托管设备上的可用性单独管理）也以相同方式灰显。新会话默认为第一个 SSH 连接（如果已配置），如果你尝试继续现有会话，Desktop 会显示一条消息说此设备上不可用本地会话。选择 SSH 或 cloud 环境，或联系你的 IT 团队。

云会话

云会话即使在你关闭应用后也会在后台继续。使用计入你的订阅计划限制，没有单独的计算费用。

你可以创建具有不同网络访问级别和环境变量的自定义云环境。在启动云会话时，打开提示框中的环境下拉菜单来管理它们：

• 添加环境：选择 Add cloud environment
• 编辑或存档你自己的环境之一：将鼠标悬停在它上面并点击齿轮图标

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

SSH 会话

SSH 会话让你在远程机器上运行 Claude Code，同时使用桌面应用作为你的界面。这对于使用存在于云虚拟机、开发容器或具有特定硬件或依赖项的服务器上的代码库很有用。

要添加 SSH 连接，在启动会话之前点击环境下拉菜单并选择 + Add SSH connection。对话框要求：

• Name：此连接的友好标签
• SSH Host：user@hostname 或在 ~/.ssh/config 中定义的主机
• SSH Port：如果留空，默认为 22，或使用你的 SSH 配置中的端口
• Identity File：你的私钥的路径，例如 ~/.ssh/id_rsa。留空以使用默认密钥或你的 SSH 配置。

添加后，连接出现在环境下拉菜单中。选择它在该机器上启动会话。Claude 在远程机器上运行，可以访问其文件和工具。

远程机器必须运行 Linux 或 macOS。Desktop 在你第一次连接时会自动在远程机器上安装 Claude Code。连接后，SSH 会话支持权限模式、connectors、plugins 和 MCP servers。

为你的团队预配置 SSH 连接

管理员可以通过将 sshConfigs 添加到托管设置文件来向团队成员分发 SSH 连接。以这种方式定义的连接会自动出现在每个用户的环境下拉菜单中，并显示为托管的，因此用户可以选择它们，但不能在应用中编辑或删除它们。

以下示例预配置了一个单个连接：

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

每个条目需要 id、name 和 sshHost。sshPort 和 sshIdentityFile 字段是可选的。用户也可以将 sshConfigs 添加到他们自己的 ~/.claude/settings.json，这是通过对话框添加的连接存储的位置。

限制用户可以连接的 SSH 主机

管理员可以通过将 sshHostAllowlist 添加到托管设置文件来限制 Desktop 的 SSH 会话到一组已批准的主机。设置后，用户只能连接到其解析的主机名与其中一个模式匹配的主机。将其设置为空数组以完全禁用 SSH 会话。

以下示例允许连接到 devboxes.example.com 下的任何主机以及单个命名的堡垒主机：

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

模式不区分大小写。* 匹配任何主机，*.example.com 匹配 example.com 和任何子域。其他任何内容都是精确匹配。检查针对通过 ssh -G 进行 ~/.ssh/config 解析后的主机名运行，因此允许 Host 别名和 ProxyCommand/ProxyJump 条目，只要解析的 HostName 匹配。

sshHostAllowlist 仅从托管设置中读取；用户或项目设置中的值被忽略。只有 Claude Desktop 应用遵守此设置；Claude Code CLI 和 IDE 扩展不读取它，它也不限制通过 Bash 工具运行的 ssh 命令。它管理 Desktop 应用连接到的主机，而不是网络出口，因此如果你需要硬边界，请将其与你的组织的网络或零信任控制配对。

企业配置

Teams 或 Enterprise 计划上的组织可以通过管理员控制台控制、托管设置文件和设备管理策略来管理桌面应用行为。

管理员控制台控制

这些设置通过管理员设置控制台配置：

• Desktop 中的 Code：控制你的组织中的用户是否可以在桌面应用中访问 Claude Code
• Web 中的 Code：为你的组织启用或禁用云会话
• Remote Control：为你的组织启用或禁用远程控制
• 禁用绕过权限模式：防止你的组织中的用户启用绕过权限模式

托管设置

托管设置覆盖项目和用户设置，并应用于 Desktop 中的 Claude Code 会话。你可以在你的组织的托管设置文件中设置这些键，或通过管理员控制台远程推送它们。

哪些托管设置到达 Desktop 会话取决于该会话运行的位置。模型限制（如 availableModels）在 Desktop 的 Claude Code 会话中的执行方式与在终端 CLI 中相同；请参阅表面覆盖。

• 此机器上的本地会话：部署到磁盘的托管设置文件适用。通过管理员控制台远程推送的托管设置也在会话使用符合条件的登录或密钥向 Anthropic 的 API 进行身份验证时到达这些会话，遵循与终端 CLI 相同的设置优先级。
• 云会话：接收服务器管理的设置；设备部署的文件无法到达它们，因为它们在 Anthropic 管理的虚拟机上运行。路由到自托管环境的会话也读取运行程序镜像中的托管设置文件。Claude Code 如何组合托管源说明该文件何时适用。
• SSH 会话：会话从远程主机读取托管设置文件。Desktop 本身从本地机器的托管设置中读取 sshConfigs、sshHostAllowlist 和 disableDesktopLocalSessions。
• Cowork 会话：在此机器上的 Cowork 会话中，Claude Code 永远不会获取管理员控制台设置，即使用户使用 Team 或 Enterprise 帐户登录，并读取部署到机器的策略，除非你的 Claude Desktop 配置设置 requireCoworkFullVmSandbox。远程 Cowork 会话都不接收。请参阅策略应用的位置和时间了解哪些设备文件到达 Cowork，以及MCP 权限规则了解 Bash 和 WebFetch 规则如何应用于 Cowork 的工具。

在本地和 SSH 会话中，桌面应用直接将每个用户连接的 claude.ai 连接器传递给 Claude Code。无论你使用哪个设置源或文件位置，都没有 MCP 设置或 managed-mcp.json 到达这些连接器。要在这些会话中阻止连接器的工具，请使用你的组织的连接器工具控制。连接器如何到达 Claude Code显示在每种会话中哪些设置管理连接器。

permissions.disableBypassPermissionsMode 和 disableAutoMode 也在用户和项目设置中工作，但将它们放在托管设置中可防止用户覆盖它们。

有关仅托管源可以设置的权限、插件和交付键，请参阅仅托管设置可以设置的键。

设备管理策略

IT 团队可以通过 macOS 上的 MDM 或 Windows 上的组策略管理桌面应用。可用的策略包括启用或禁用 Claude Code 功能、控制自动更新和设置自定义部署 URL。

• macOS：通过使用 Jamf 或 Kandji 等工具的 com.anthropic.claudefordesktop 偏好域配置
• Windows：通过 SOFTWARE\Policies\Claude 处的注册表配置

网络访问要求

Desktop 从 Anthropic CDN 主机加载其应用程序代码和用户内容。

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

流量在端口 443 上使用 HTTPS，除非你为 OTLP、LLM 网关或 MCP 服务器配置自定义端口。

有关代理服务器、自定义证书颁发机构、mTLS 和独立 CLI 需要的域，请参阅网络配置。

要减少防火墙通配符的数量，请改为允许这些 Anthropic 主机。某些子域是动态生成的，必须保持为通配符。

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
a-cdn.claude.ai
assets.claude.ai
downloads.claude.ai
*.livepreview.claude.ai
claude.com
platform.claude.com
*.livepreview.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

如果你的组织启用了IP 允许列表用于 Claude，请通过与 claude.ai 和 api.anthropic.com 相同的代理出口路由 bridge.claudeusercontent.com。如果你无法以这种方式路由它，请将你的代理用于该主机的出口地址添加到你的组织的 IP 允许列表，但仅当该地址专用于你的组织时：共享代理出口范围也允许代理供应商的其他客户。

Anthropic 根据它们到达的地址检查与该主机的连接是否符合你的组织的 IP 允许列表。如果你的代理通过不在该允许列表上的地址为其发送流量，Chrome 中的 Claude 和通过网桥连接的其他功能将停止工作，而应用的其余部分继续工作。

从 Google Fonts 加载字体的工件也请求 fonts.googleapis.com 和 fonts.gstatic.com。两个主机都是可选的。如果你阻止它们，工件将以备用字体呈现。使用快速拒绝而不是静默丢弃来阻止，以便字体请求立即失败，而不是延迟页面的首次呈现。

工件还可以从 cdnjs.cloudflare.com、cdn.jsdelivr.net、cdn.tailwindcss.com、code.jquery.com 和 unpkg.com 加载 JavaScript 库（如 React 或图表包），而不能从其他任何外部主机加载。如果你阻止这些主机，工件中依赖库的部分将无法工作，与阻止的字体不同，阻止的库没有备用。这里也使用快速拒绝，以便阻止的库请求立即失败，而不是挂起直到超时。

身份验证和 SSO

企业组织可以要求所有用户使用 SSO。有关计划级别的详细信息，请参阅身份验证，有关 SAML 配置，请参阅设置 SSO；OIDC 设置在 Claude Enterprise Administrator Guide 中介绍。

数据处理

Claude Code 在本地会话中本地处理你的代码，或在云会话中在 Anthropic 管理的基础设施上处理，除非你的组织将它们路由到自托管环境。云会话（包括在自托管环境中）将对话和代码上下文发送到 Anthropic 的 API 进行处理；本地和 SSH 会话将它们发送到你的部署配置的任何模型提供商，默认为 Anthropic 的 API。有关数据保留、隐私和合规性的详细信息，请参阅数据处理。

部署

Desktop 可以通过企业部署工具分发：

• macOS：通过 MDM（如 Jamf 或 Kandji）使用 .dmg 安装程序分发
• Windows：通过 MSIX 包部署。有关企业部署选项（包括静默安装），请参阅为 Windows 部署 Claude Desktop

有关在防火墙中允许列表的域，请参阅上面的网络访问要求。有关代理设置、自定义证书颁发机构和 LLM 网关，请参阅网络配置。

有关完整的企业配置参考，请参阅企业配置指南。

来自 CLI？

如果你已经使用 Claude Code CLI，Desktop 运行相同的底层引擎，具有图形界面。你可以在同一机器上同时运行两者，甚至在同一项目上。每个维护单独的会话列表，你可以将 CLI 会话带入 Desktop。它们通过 CLAUDE.md 文件共享配置和项目内存。

要将 CLI 会话移动到 Desktop，在终端中运行 /desktop。Claude 保存你的会话并在桌面应用中打开它，然后退出 CLI。此命令在 macOS 和 x64 Windows 上可用，当你使用 Claude 订阅登录时。它不适用于 API 密钥身份验证或 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry。

要从 Desktop 内部选择 CLI 会话，在提示框中输入 /resume。Desktop 列出你从 CLI 启动的会话，你可以按标题、文件夹或分支搜索它们，并预览每个会话的停止位置。选择一个会话，它将在应用中继续，具有完整的对话和上下文。

CLI 标志等效项

此表显示了常见 CLI 标志的桌面应用等效项。未列出的标志没有桌面等效项，因为它们是为脚本或自动化设计的。

共享配置

Desktop 和 CLI 读取相同的配置文件，因此你的设置会转移：

• CLAUDE.md 和 CLAUDE.local.md 文件在你的项目中被两者使用
• MCP servers 在 ~/.claude.json 或 .mcp.json 中配置在两者中工作
• Hooks 和 skills 在设置中定义适用于两者
• Settings 在 ~/.claude.json 和 ~/.claude/settings.json 中是共享的。权限规则、允许的工具和 settings.json 中的其他设置适用于 Desktop 会话。
• Models：相同的模型在两者中都可用。在 Desktop 中，从发送按钮旁的下拉菜单中选择模型。你可以在会话期间从相同的下拉菜单更改模型。

来自 Claude Desktop 聊天应用的 MCP servers

Desktop 应用从 claude_desktop_config.json 将 MCP servers 加载到本地 Code 选项卡会话中，以及来自 ~/.claude.json 和 .mcp.json 的服务器。在 claude_desktop_config.json 中定义的服务器在 Desktop 聊天表面和本地 Code 选项卡会话中都可用。

如果你在 claude_desktop_config.json 和 ~/.claude.json 或 .mcp.json 中定义相同的服务器名称，本地会话中的 Code 选项卡连接一次并使用 claude_desktop_config.json 定义。

该应用还将来自 ~/.claude.json 的 stdio 服务器重新传递到本地会话中的嵌入式 CLI。当 ~/.claude.json（用户范围）和 .mcp.json 的顶级定义相同的 stdio 服务器名称时，Code 选项卡使用 ~/.claude.json 定义，偏离 CLI 范围层次结构。

功能比较

此表比较了 CLI 和 Desktop 之间的核心功能。有关 CLI 标志的完整列表，请参阅 CLI 参考。

Desktop 中不可用的内容

以下功能在 Desktop 中不可用，除非另有说明：

• 第三方提供商：Desktop 默认连接到 Anthropic 的 API。要通过网关路由 Desktop，或在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自托管 LLM 网关上运行 Code 选项卡，请按照第三方提供商行中的链接操作。
• Linux (beta)：Linux 桌面应用中尚不提供计算机使用。请参阅 Claude Desktop on Linux。
• 内联代码建议：Desktop 不提供自动完成风格的建议。它通过对话提示和显式代码更改工作。
• Agent teams：协调的团队，其中 Claude 作为团队负责人从共享任务列表中为队友分配任务，在 CLI 中可用，不在 Desktop 中。对于一个会话内的多 agent 工作，使用动态工作流，它在 Desktop 中运行；Claude 也可以直接消息和管理你的其他会话。
• Terminal-dialog 命令：在终端中打开交互式面板的内置命令，其行为在 Code 选项卡中有所不同。直接编辑设置文件来管理权限规则和配置，或从独立 CLI 运行命令。
  • 没有参数形式的命令，例如 /permissions，回复 isn't available in this environment。
  • /config 打开设置 → Claude Code。命令后的文本被忽略，所以 /config theme=dark 不设置主题。

故障排除

下面的部分涵盖特定于桌面应用的问题。对于出现在聊天中的运行时 API 错误，如 API Error: 500、529 Overloaded、429 或 Prompt is too long，请参阅错误参考。这些错误及其修复在 CLI、Desktop 和 Web 中是相同的。

检查你的版本

要查看你运行的桌面应用版本：

• macOS：点击菜单栏中的 Claude，然后点击 About Claude
• Windows：点击 Help，然后点击 About

点击版本号将其复制到你的剪贴板。

Code 选项卡中的 403 或身份验证错误

如果在使用 Code 选项卡时看到 Error 403: Forbidden 或其他身份验证失败：

1. 从应用菜单中注销并重新登录。这是最常见的修复。
2. 验证你有活跃的付费订阅：Pro、Max、Team 或 Enterprise。
3. 如果 CLI 工作但 Desktop 不工作，完全退出桌面应用，而不仅仅是关闭窗口，然后重新打开并登录。
4. 检查你的互联网连接和代理设置。

启动时屏幕空白或卡住

如果应用打开但显示空白或无响应的屏幕：

1. 重启应用。
2. 检查待处理的更新。在 macOS 和 Windows 上，应用在启动时自动更新；在 Linux 上，通过 apt 更新，如 Claude Desktop on Linux 中所述。
3. 在托管网络上，确认你的防火墙允许网络访问要求中的 CDN 主机。
4. 在 Windows 上，在 Windows 日志 → 应用程序 下的事件查看器中检查崩溃日志。

"Failed to load session"

如果你看到 Failed to load session，选定的文件夹可能不再存在，Git 存储库可能需要未安装的 Git LFS，或文件权限可能阻止访问。尝试选择不同的文件夹或重启应用。

会话找不到已安装的工具

如果 Claude 找不到 npm、node 或其他 CLI 命令等工具，验证工具在你的常规终端中工作，检查你的 shell 配置文件是否正确设置 PATH，并重启桌面应用以重新加载环境变量。

Git 和 Git LFS 错误

在其自己的 worktree 中运行的会话需要 Git。如果你看到"Git is required"，安装 Git，或在 Windows 上安装 Git for Windows，然后重试。在 Windows 上，1.49585.0 之前的 Claude Desktop 版本在启动任何本地会话之前要求 Git；如果你看到该提示且不使用 worktrees，请更新应用。

如果你看到"Git LFS is required by this repository but is not installed"，从 git-lfs.com 安装 Git LFS，运行 git lfs install，并重启应用。

MCP servers 在 Windows 上不工作

如果 MCP server 切换不响应或服务器在 Windows 上连接失败，检查服务器在你的设置中是否正确配置，重启应用，验证服务器进程在任务管理器中运行，并查看服务器日志以获取连接错误。

应用无法退出

• macOS：按 Cmd+Q。如果应用不响应，使用 Cmd+Option+Esc 强制退出，选择 Claude，然后点击强制退出。
• Windows：使用 Ctrl+Shift+Esc 的任务管理器来结束 Claude 进程。

Windows 特定问题

• 安装后 PATH 未更新：打开新的终端窗口。PATH 更新仅适用于新的终端会话。
• 并发安装错误：如果你看到关于另一个安装正在进行的错误，但实际上没有，尝试以管理员身份运行安装程序。

在 CLI 中打开时"Branch doesn't exist yet"

远程会话可以创建在你的本地机器上不存在的分支。点击会话工具栏中的分支名称来复制它，然后在本地获取它：

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

仍然卡住？

• 在桌面应用中打开 Help → Get Support，或直接访问 Claude 支持中心
• 对于在独立 claude CLI 中也能重现的问题，在 GitHub Issues 上搜索或提交错误

提交问题时，包括你的桌面应用版本、你的操作系统、确切的错误消息和相关日志。在 macOS 上，检查 Console.app。在 Windows 上，检查事件查看器 → Windows 日志 → 应用程序。在将日志摘录发布到公开问题之前，请查看它们；它们可能包含来自你的环境的文件路径和其他详细信息。