开始使用桌面应用

在桌面上安装 Claude Code 并开始您的第一个编码会话

桌面应用为您提供具有图形界面的 Claude Code，专为并行运行多个会话而构建：用于管理并行工作的侧边栏、带有集成终端和文件编辑器的拖放布局、可视化差异审查、实时应用预览、GitHub PR 监控和自动合并以及计划任务。无需终端。

apple Download for macOS

Universal build for Intel and Apple Silicon

windows Download for Windows

For x64 processors

For Windows ARM64, download the ARM64 installer. The desktop app is not available on Linux; use the CLI instead.

本页面将指导您安装应用并开始您的第一个会话。如果您已经设置完成，请参阅使用 Claude Code Desktop了解完整参考。

桌面应用有三个选项卡：

Chat：无文件访问权限的常规对话，类似于 claude.ai。
Cowork：一个自主后台代理，在云虚拟机中处理任务，拥有自己的环境。它可以独立运行，而您可以进行其他工作。
Code：一个交互式编码助手，可直接访问您的本地文件。您可以实时审查和批准每项更改。

Chat 和 Cowork 在 Claude Desktop 支持文章中有介绍。本页面重点关注 Code 选项卡。

安装

安装并登录

从上面的链接下载您的平台的安装程序并运行它。在 macOS 上从应用程序文件夹启动 Claude，或在 Windows 上从开始菜单启动，然后使用您的 Anthropic 账户登录。

打开 Code 选项卡

点击顶部中心的 Code 选项卡。如果点击 Code 提示您升级，您需要先订阅付费计划。如果提示您在线登录，请完成登录并重启应用。如果您看到 403 错误，请参阅身份验证故障排除。

桌面应用包含 Claude Code。您无需单独安装 Node.js 或 CLI。要从终端使用 claude，请单独安装 CLI。请参阅开始使用 CLI。

开始您的第一个会话

打开 Code 选项卡后，选择一个项目并告诉 Claude 要做什么。

选择环境和文件夹

选择 Local 以在您的机器上运行 Claude，直接使用您的文件。点击 Select folder 并选择您的项目目录。

您也可以选择：

Remote：在 Anthropic 的云基础设施上运行会话，即使关闭应用也会继续。远程会话使用与 Claude Code on the web 相同的基础设施。
SSH：通过 SSH 连接到远程机器（您自己的服务器、云虚拟机或开发容器）。必须在远程机器上安装 Claude Code。

选择模型

从发送按钮旁的下拉菜单中选择模型。请参阅模型了解 Opus、Sonnet 和 Haiku 的比较。您可以稍后从同一下拉菜单更改模型。

告诉 Claude 要做什么

输入您希望 Claude 做的事情：

Find a TODO comment and fix it
Add tests for the main function
Create a CLAUDE.md with instructions for this codebase

一个会话是与 Claude 关于您的代码的对话。每个会话跟踪自己的上下文和更改，因此您可以处理多个任务而不会相互干扰。

审查并接受更改

默认情况下，Code 选项卡以询问权限模式启动，其中 Claude 提议更改并等待您的批准后再应用。您将看到：

一个差异视图，显示每个文件中将发生的确切更改
接受/拒绝按钮以批准或拒绝每项更改
Claude 处理您的请求时的实时更新

如果您拒绝更改，Claude 将询问您希望如何以不同的方式进行。在您接受之前，您的文件不会被修改。

接下来呢？

您已经进行了第一次编辑。有关 Desktop 可以做的所有事情的完整参考，请参阅使用 Claude Code Desktop。以下是一些接下来可以尝试的事情。

中断并引导。 您可以随时中断 Claude。如果它走错了方向，点击停止按钮或输入您的更正并按 Enter。Claude 停止正在做的事情并根据您的输入进行调整。您无需等待它完成或重新开始。

为 Claude 提供更多上下文。 在提示框中输入 @filename 以将特定文件拉入对话，使用附件按钮附加图像和 PDF，或直接将文件拖放到提示中。Claude 拥有的上下文越多，结果越好。请参阅添加文件和上下文。

使用 skills 处理可重复的任务。 输入 / 或点击 + → Slash commands 以浏览内置命令、自定义 skills 和插件 skills。Skills 是可重用的提示，您可以在需要时调用，例如代码审查清单或部署步骤。

在提交前审查更改。 Claude 编辑文件后，会出现 +12 -1 指示器。点击它以打开差异视图，逐个文件审查修改，并对特定行进行评论。Claude 会读取您的评论并进行修订。点击 Review code 让 Claude 自己评估差异并留下内联建议。

调整您拥有的控制量。 您的权限模式控制平衡。询问权限（默认）在每次编辑前需要批准。自动接受编辑会自动接受文件编辑以加快迭代。Plan mode 让 Claude 在不接触任何文件的情况下规划方法，这在大型重构前很有用。

添加插件以获得更多功能。 点击提示框旁的 + 按钮并选择 Plugins 以浏览和安装插件，这些插件添加 skills、代理、MCP servers 等。

整理您的工作区。 将聊天、差异、终端、文件和预览窗格拖放到您想要的任何布局中。使用 Ctrl+` 打开终端以在会话旁运行命令，或点击文件路径以在文件窗格中打开它。请参阅整理您的工作区。

预览您的应用。 点击 Preview 下拉菜单以直接在桌面中运行您的开发服务器。Claude 可以查看正在运行的应用、测试端点、检查日志并对其看到的内容进行迭代。请参阅预览您的应用。

跟踪您的拉取请求。 打开 PR 后，Claude Code 监控 CI 检查结果，可以自动修复失败或在所有检查通过后合并 PR。请参阅监控拉取请求状态。

将 Claude 放在日程上。 设置计划任务以定期自动运行 Claude：每天早上进行代码审查、每周进行依赖审计，或从您连接的工具中提取信息的简报。

准备好时扩展。 从侧边栏打开并行会话以同时处理多个任务，每个任务都在自己的 Git worktree 中，并打开任务窗格以观看会话正在运行的子代理和后台命令。打开侧边聊天以提出问题而不会偏离主线程。将长期运行的工作发送到云，以便即使关闭应用也能继续，或者如果任务花费的时间比预期长，在网络或 IDE 中继续会话。连接外部工具，如 GitHub、Slack 和 Linear，以整合您的工作流。

来自 CLI？

Desktop 运行与 CLI 相同的引擎，但具有图形界面。您可以在同一项目上同时运行两者，它们共享配置（CLAUDE.md 文件、MCP servers、hooks、skills 和设置）。有关功能、标志等效项和 Desktop 中不可用内容的完整比较，请参阅 CLI 比较。

接下来是什么

使用 Claude Code Desktop：权限模式、并行会话、差异视图、连接器和企业配置
故障排除：常见错误和设置问题的解决方案
最佳实践：编写有效提示和充分利用 Claude Code 的提示
常见工作流：调试、重构、测试等教程

desktop-quickstart.md +129 −0 created

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

5# 开始使用桌面应用

7> 在桌面上安装 Claude Code 并开始您的第一个编码会话

9桌面应用为您提供具有图形界面的 Claude Code，专为并行运行多个会话而构建：用于管理并行工作的侧边栏、带有集成终端和文件编辑器的拖放布局、可视化差异审查、实时应用预览、GitHub PR 监控和自动合并以及计划任务。无需终端。

11<CardGroup cols={2}>

12 <Card title="Download for macOS" icon="apple" href="https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code&utm_medium=docs">

13 Universal build for Intel and Apple Silicon

14 </Card>

16 <Card title="Download for Windows" icon="windows" href="https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code&utm_medium=docs">

17 For x64 processors

18 </Card>

19</CardGroup>

21For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). The desktop app is not available on Linux; use the [CLI](/en/quickstart) instead.

23<Note>

24 Claude Code 需要 [Pro、Max、Team 或 Enterprise 订阅](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing)。

25</Note>

27本页面将指导您安装应用并开始您的第一个会话。如果您已经设置完成，请参阅[使用 Claude Code Desktop](/zh-CN/desktop)了解完整参考。

29桌面应用有三个选项卡：

31* **Chat**：无文件访问权限的常规对话，类似于 claude.ai。

32* **Cowork**：一个自主后台代理，在云虚拟机中处理任务，拥有自己的环境。它可以独立运行，而您可以进行其他工作。

33* **Code**：一个交互式编码助手，可直接访问您的本地文件。您可以实时审查和批准每项更改。

35Chat 和 Cowork 在 [Claude Desktop 支持文章](https://support.claude.com/en/collections/16163169-claude-desktop)中有介绍。本页面重点关注 **Code** 选项卡。

37## 安装

39<Steps>

40 <Step title="安装并登录">

41 从上面的链接下载您的平台的安装程序并运行它。在 macOS 上从应用程序文件夹启动 Claude，或在 Windows 上从开始菜单启动，然后使用您的 Anthropic 账户登录。

42 </Step>

44 <Step title="打开 Code 选项卡">

45 点击顶部中心的 **Code** 选项卡。如果点击 Code 提示您升级，您需要先[订阅付费计划](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_upgrade)。如果提示您在线登录，请完成登录并重启应用。如果您看到 403 错误，请参阅[身份验证故障排除](/zh-CN/desktop#403-or-authentication-errors-in-the-code-tab)。

46 </Step>

47</Steps>

49桌面应用包含 Claude Code。您无需单独安装 Node.js 或 CLI。要从终端使用 `claude`，请单独安装 CLI。请参阅[开始使用 CLI](/zh-CN/quickstart)。

51## 开始您的第一个会话

53打开 Code 选项卡后，选择一个项目并告诉 Claude 要做什么。

55<Steps>

56 <Step title="选择环境和文件夹">

57 选择 **Local** 以在您的机器上运行 Claude，直接使用您的文件。点击 **Select folder** 并选择您的项目目录。

59 <Tip>

60 从一个您熟悉的小项目开始。这是查看 Claude Code 能做什么的最快方式。在 Windows 上，必须安装 [Git](https://git-scm.com/downloads/win) 才能使本地会话正常工作。大多数 Mac 默认包含 Git。

61 </Tip>

63 您也可以选择：

65 * **Remote**：在 Anthropic 的云基础设施上运行会话，即使关闭应用也会继续。远程会话使用与 [Claude Code on the web](/zh-CN/claude-code-on-the-web) 相同的基础设施。

66 * **SSH**：通过 SSH 连接到远程机器（您自己的服务器、云虚拟机或开发容器）。必须在远程机器上安装 Claude Code。

67 </Step>

69 <Step title="选择模型">

70 从发送按钮旁的下拉菜单中选择模型。请参阅[模型](/zh-CN/model-config#available-models)了解 Opus、Sonnet 和 Haiku 的比较。您可以稍后从同一下拉菜单更改模型。

71 </Step>

73 <Step title="告诉 Claude 要做什么">

74 输入您希望 Claude 做的事情：

76 * `Find a TODO comment and fix it`

77 * `Add tests for the main function`

78 * `Create a CLAUDE.md with instructions for this codebase`

80 一个[会话](/zh-CN/desktop#work-in-parallel-with-sessions)是与 Claude 关于您的代码的对话。每个会话跟踪自己的上下文和更改，因此您可以处理多个任务而不会相互干扰。

81 </Step>

83 <Step title="审查并接受更改">

84 默认情况下，Code 选项卡以[询问权限模式](/zh-CN/desktop#choose-a-permission-mode)启动，其中 Claude 提议更改并等待您的批准后再应用。您将看到：

86 1. 一个[差异视图](/zh-CN/desktop#review-changes-with-diff-view)，显示每个文件中将发生的确切更改

87 2. 接受/拒绝按钮以批准或拒绝每项更改

88 3. Claude 处理您的请求时的实时更新

90 如果您拒绝更改，Claude 将询问您希望如何以不同的方式进行。在您接受之前，您的文件不会被修改。

91 </Step>

92</Steps>

94## 接下来呢？

96您已经进行了第一次编辑。有关 Desktop 可以做的所有事情的完整参考，请参阅[使用 Claude Code Desktop](/zh-CN/desktop)。以下是一些接下来可以尝试的事情。

98**中断并引导。** 您可以随时中断 Claude。如果它走错了方向，点击停止按钮或输入您的更正并按 **Enter**。Claude 停止正在做的事情并根据您的输入进行调整。您无需等待它完成或重新开始。

100**为 Claude 提供更多上下文。** 在提示框中输入 `@filename` 以将特定文件拉入对话，使用附件按钮附加图像和 PDF，或直接将文件拖放到提示中。Claude 拥有的上下文越多，结果越好。请参阅[添加文件和上下文](/zh-CN/desktop#add-files-and-context-to-prompts)。

101

102**使用 skills 处理可重复的任务。** 输入 `/` 或点击 **+** → **Slash commands** 以浏览[内置命令](/zh-CN/commands)、[自定义 skills](/zh-CN/skills) 和插件 skills。Skills 是可重用的提示，您可以在需要时调用，例如代码审查清单或部署步骤。

103

104**在提交前审查更改。** Claude 编辑文件后，会出现 `+12 -1` 指示器。点击它以打开[差异视图](/zh-CN/desktop#review-changes-with-diff-view)，逐个文件审查修改，并对特定行进行评论。Claude 会读取您的评论并进行修订。点击 **Review code** 让 Claude 自己评估差异并留下内联建议。

105

106**调整您拥有的控制量。** 您的[权限模式](/zh-CN/desktop#choose-a-permission-mode)控制平衡。询问权限（默认）在每次编辑前需要批准。自动接受编辑会自动接受文件编辑以加快迭代。Plan mode 让 Claude 在不接触任何文件的情况下规划方法，这在大型重构前很有用。

107

108**添加插件以获得更多功能。** 点击提示框旁的 **+** 按钮并选择 **Plugins** 以浏览和安装[插件](/zh-CN/desktop#install-plugins)，这些插件添加 skills、代理、MCP servers 等。

109

110**整理您的工作区。** 将聊天、差异、终端、文件和预览窗格拖放到您想要的任何布局中。使用 **Ctrl+\`** 打开终端以在会话旁运行命令，或点击文件路径以在文件窗格中打开它。请参阅[整理您的工作区](/zh-CN/desktop#arrange-your-workspace)。

111

112**预览您的应用。** 点击 **Preview** 下拉菜单以直接在桌面中运行您的开发服务器。Claude 可以查看正在运行的应用、测试端点、检查日志并对其看到的内容进行迭代。请参阅[预览您的应用](/zh-CN/desktop#preview-your-app)。

113

114**跟踪您的拉取请求。** 打开 PR 后，Claude Code 监控 CI 检查结果，可以自动修复失败或在所有检查通过后合并 PR。请参阅[监控拉取请求状态](/zh-CN/desktop#monitor-pull-request-status)。

115

116**将 Claude 放在日程上。** 设置[计划任务](/zh-CN/desktop-scheduled-tasks)以定期自动运行 Claude：每天早上进行代码审查、每周进行依赖审计，或从您连接的工具中提取信息的简报。

117

118**准备好时扩展。** 从侧边栏打开[并行会话](/zh-CN/desktop#work-in-parallel-with-sessions)以同时处理多个任务，每个任务都在自己的 Git worktree 中，并打开[任务窗格](/zh-CN/desktop#watch-background-tasks)以观看会话正在运行的子代理和后台命令。打开[侧边聊天](/zh-CN/desktop#ask-a-side-question-without-derailing-the-session)以提出问题而不会偏离主线程。将[长期运行的工作发送到云](/zh-CN/desktop#run-long-running-tasks-remotely)，以便即使关闭应用也能继续，或者如果任务花费的时间比预期长，[在网络或 IDE 中继续会话](/zh-CN/desktop#continue-in-another-surface)。[连接外部工具](/zh-CN/desktop#extend-claude-code)，如 GitHub、Slack 和 Linear，以整合您的工作流。

119

120## 来自 CLI？

121

122Desktop 运行与 CLI 相同的引擎，但具有图形界面。您可以在同一项目上同时运行两者，它们共享配置（CLAUDE.md 文件、MCP servers、hooks、skills 和设置）。有关功能、标志等效项和 Desktop 中不可用内容的完整比较，请参阅 [CLI 比较](/zh-CN/desktop#coming-from-the-cli)。

123

124## 接下来是什么

125

126* [使用 Claude Code Desktop](/zh-CN/desktop)：权限模式、并行会话、差异视图、连接器和企业配置

127* [故障排除](/zh-CN/desktop#troubleshooting)：常见错误和设置问题的解决方案

128* [最佳实践](/zh-CN/best-practices)：编写有效提示和充分利用 Claude Code 的提示

129* [常见工作流](/zh-CN/common-workflows)：调试、重构、测试等教程

desktop-quickstart.md 2026-05-02 18:14 UTC to 2026-05-04 22:58 UTC

开始使用桌面应用

安装

安装并登录

打开 Code 选项卡

开始您的第一个会话

选择环境和文件夹

选择模型

告诉 Claude 要做什么

审查并接受更改

接下来呢？

来自 CLI？

接下来是什么