18>18>
19> 适用于 x64 处理器19> 适用于 x64 处理器
20 20
21> **[获取 Claude for Linux(测试版)](/docs/zh-CN/desktop-linux.md)**21> **[获取 Claude for Linux(测试版)](https://code.claude.com/docs/zh-CN/desktop-linux.md)**
22>22>
23> Ubuntu 和 Debian 的 apt 或 .deb23> Ubuntu 和 Debian 的 apt 或 .deb
24 24
25对于 Windows ARM64,请下载 [ARM64 安装程序](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)。在 Linux 上,使用 apt 安装;请参阅 [Claude Desktop on Linux](/docs/zh-CN/desktop-linux.md)。25对于 Windows ARM64,请下载 [ARM64 安装程序](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)。在 Linux 上,使用 apt 安装;请参阅 [Claude Desktop on Linux](https://code.claude.com/docs/zh-CN/desktop-linux.md)。
26 26
27> [!NOTE]27> [!NOTE]
28>28>
29> 这些情况在其他页面中有介绍:29> 这些情况在其他页面中有介绍:
30>30>
31> * **已经设置完成**:请参阅[使用 Claude Code Desktop](/docs/zh-CN/desktop.md)了解 Code 选项卡可以执行的所有操作31> * **已经设置完成**:请参阅[使用 Claude Code Desktop](https://code.claude.com/docs/zh-CN/desktop.md)了解 Code 选项卡可以执行的所有操作
32> * **想在您的终端中使用 `claude`**:[单独安装 CLI](/docs/zh-CN/quickstart.md)32> * **想在您的终端中使用 `claude`**:[单独安装 CLI](https://code.claude.com/docs/zh-CN/quickstart.md)
33> * **使用 Chat 或 Cowork**:请参阅 [Claude 帮助中心](https://support.claude.com/)33> * **使用 Chat 或 Cowork**:请参阅 [Claude 帮助中心](https://support.claude.com/)
34> * **需要了解有关安装或部署桌面应用的更多信息**:请参阅 [Claude Desktop 支持文章](https://support.claude.com/en/collections/16163169-claude-desktop)34> * **需要了解有关安装或部署桌面应用的更多信息**:请参阅 [Claude Desktop 支持文章](https://support.claude.com/en/collections/16163169-claude-desktop)
35 35
37 37
38**1. 安装并登录**38**1. 安装并登录**
39 39
40在 macOS 和 Windows 上,从上面的链接下载安装程序并运行它。在 Linux 上,请按照 [Linux 上的 Claude Desktop](/docs/zh-CN/desktop-linux.md) 中的安装步骤进行操作。在 macOS 上从应用程序文件夹启动 Claude,在 Windows 上从开始菜单启动,或在 Linux 上从应用程序启动器启动,然后使用您的 Anthropic 账户登录。40在 macOS 和 Windows 上,从上面的链接下载安装程序并运行它。在 Linux 上,请按照 [Linux 上的 Claude Desktop](https://code.claude.com/docs/zh-CN/desktop-linux.md) 中的安装步骤进行操作。在 macOS 上从应用程序文件夹启动 Claude,在 Windows 上从开始菜单启动,或在 Linux 上从应用程序启动器启动,然后使用您的 Anthropic 账户登录。
41 41
42**2. 打开 Code 选项卡**42**2. 打开 Code 选项卡**
43 43
45 45
46* **提示升级**:您需要先[订阅付费计划](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_upgrade)46* **提示升级**:您需要先[订阅付费计划](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_upgrade)
47* **提示在线登录**:完成登录并重启应用47* **提示在线登录**:完成登录并重启应用
48* **403 错误**:请参阅[身份验证故障排除](/docs/zh-CN/desktop.md#403-or-authentication-errors-in-the-code-tab)48* **403 错误**:请参阅[身份验证故障排除](https://code.claude.com/docs/zh-CN/desktop.md#403-or-authentication-errors-in-the-code-tab)
49 49
50桌面应用包含 Claude Code,因此您无需安装 Node.js 或 CLI 即可使用 Code 选项卡。50桌面应用包含 Claude Code,因此您无需安装 Node.js 或 CLI 即可使用 Code 选项卡。
51 51
55 55
56**1. 选择环境和文件夹**56**1. 选择环境和文件夹**
57 57
58在[输入框下方的一行](/docs/zh-CN/desktop.md#start-a-session)中,点击第一个控件(即环境选择器),然后选择**本地**分组中的第一项。接着点击环境选择器旁边的项目文件夹控件,选择**打开文件夹…**,并选择您的项目目录。58在[输入框下方的一行](https://code.claude.com/docs/zh-CN/desktop.md#start-a-session)中,点击第一个控件(即环境选择器),然后选择**本地**分组中的第一项。接着点击环境选择器旁边的项目文件夹控件,选择**打开文件夹…**,并选择您的项目目录。
59 59
60如果输入框下方没有出现环境选择器,说明您使用的是早期布局。请参阅[检查您使用的布局](/docs/zh-CN/desktop.md#check-which-layout-you-have)。60如果输入框下方没有出现环境选择器,说明您使用的是早期布局。请参阅[检查您使用的布局](https://code.claude.com/docs/zh-CN/desktop.md#check-which-layout-you-have)。
61 61
62> [!TIP]62> [!TIP]
63>63>
65 65
66您也可以选择:66您也可以选择:
67 67
68* **云**:在云中运行会话,即使关闭应用也能继续。请参阅 [在云中使用 Claude Code](/docs/zh-CN/claude-code-on-the-web.md) 了解云会话的工作原理。68* **云**:在云中运行会话,即使关闭应用也能继续。请参阅 [在云中使用 Claude Code](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md) 了解云会话的工作原理。
69* **SSH**:通过 SSH 连接到远程机器,例如您自己的服务器、云虚拟机或开发容器。请先[添加连接](/docs/zh-CN/desktop.md#ssh-sessions)。桌面版在您第一次连接时会自动在远程机器上安装 Claude Code。正在运行的任务可以[在桌面版断开连接时继续运行](/docs/zh-CN/desktop.md#keep-a-task-running-while-desktop-is-disconnected),但如果使用 Claude 账户,任务可能会在其登录过期时停止。69* **SSH**:通过 SSH 连接到远程机器,例如您自己的服务器、云虚拟机或开发容器。请先[添加连接](https://code.claude.com/docs/zh-CN/desktop.md#ssh-sessions)。桌面版在您第一次连接时会自动在远程机器上安装 Claude Code。正在运行的任务可以[在桌面版断开连接时继续运行](https://code.claude.com/docs/zh-CN/desktop.md#keep-a-task-running-while-desktop-is-disconnected),但如果使用 Claude 账户,任务可能会在其登录过期时停止。
70* **WSL**(Windows):在 [WSL 2 发行版](/docs/zh-CN/desktop-wsl.md) 内运行会话;Claude Code、工具和 git 在 Linux 端执行,使用本机路径。70* **WSL**(Windows):在 [WSL 2 发行版](https://code.claude.com/docs/zh-CN/desktop-wsl.md) 内运行会话;Claude Code、工具和 git 在 Linux 端执行,使用本机路径。
71 71
72**2. 选择模型**72**2. 选择模型**
73 73
74从输入框下方一行靠右侧的模型选择器中选择一个模型。请参阅 [模型](/docs/zh-CN/model-config.md#available-models) 以比较可用的模型。您可以稍后从模型选择器更改模型。74从输入框下方一行靠右侧的模型选择器中选择一个模型。请参阅 [模型](https://code.claude.com/docs/zh-CN/model-config.md#available-models) 以比较可用的模型。您可以稍后从模型选择器更改模型。
75 75
76**3. 告诉 Claude 要做什么**76**3. 告诉 Claude 要做什么**
77 77
81* `Add tests for the main function`81* `Add tests for the main function`
82* `Create a CLAUDE.md with instructions for this codebase`82* `Create a CLAUDE.md with instructions for this codebase`
83 83
84[会话](/docs/zh-CN/desktop.md#work-in-parallel-with-sessions) 是与 Claude 关于您的代码的对话。每个会话跟踪自己的上下文和更改。84[会话](https://code.claude.com/docs/zh-CN/desktop.md#work-in-parallel-with-sessions) 是与 Claude 关于您的代码的对话。每个会话跟踪自己的上下文和更改。
85 85
86**4. 审查并接受更改**86**4. 审查并接受更改**
87 87
88查看输入框下方一行中的[权限模式](/docs/zh-CN/desktop.md#choose-a-permission-mode),了解 Claude 是否会等待您的批准:88查看输入框下方一行中的[权限模式](https://code.claude.com/docs/zh-CN/desktop.md#choose-a-permission-mode),了解 Claude 是否会等待您的批准:
89 89
90* **自动或接受编辑**:Claude 应用其文件更改,并显示一个指示器(如 `+12 -1`),以便您可以在 [diff 视图](/docs/zh-CN/desktop.md#review-changes-with-diff-view)中审查它们90* **自动或接受编辑**:Claude 应用其文件更改,并显示一个指示器(如 `+12 -1`),以便您可以在 [diff 视图](https://code.claude.com/docs/zh-CN/desktop.md#review-changes-with-diff-view)中审查它们
91* **手动**:Claude 提议每项更改,并在应用前等待您的批准91* **手动**:Claude 提议每项更改,并在应用前等待您的批准
92 92
93在手动模式下,您将看到:93在手动模式下,您将看到:
98 98
99## 接下来呢?99## 接下来呢?
100 100
101您已经进行了第一次编辑。有关 Desktop 可以执行的所有操作的完整参考,请参阅 [使用 Claude Code Desktop](/docs/zh-CN/desktop.md)。以下是一些可以尝试的操作。101您已经进行了第一次编辑。有关 Desktop 可以执行的所有操作的完整参考,请参阅 [使用 Claude Code Desktop](https://code.claude.com/docs/zh-CN/desktop.md)。以下是一些可以尝试的操作。
102 102
103**中断并调整方向。** 您可以随时重定向 Claude。点击停止按钮立即中断,或输入更正并按 **Enter** 发送,无需停止正在运行的操作。无论哪种方式,您都不必等待它完成或重新开始。103**中断并调整方向。** 您可以随时重定向 Claude。点击停止按钮立即中断,或输入更正并按 **Enter** 发送,无需停止正在运行的操作。无论哪种方式,您都不必等待它完成或重新开始。
104 104
105**为 Claude 提供更多上下文。** 在提示框中输入 `@filename` 以将特定文件拉入对话。Claude 拥有的上下文越多,结果就越好。请参阅 [添加文件和上下文](/docs/zh-CN/desktop.md#add-files-and-context-to-prompts)。105**为 Claude 提供更多上下文。** 在提示框中输入 `@filename` 以将特定文件拉入对话。Claude 拥有的上下文越多,结果就越好。请参阅 [添加文件和上下文](https://code.claude.com/docs/zh-CN/desktop.md#add-files-and-context-to-prompts)。
106 106
107**使用 skills 处理可重复的任务。** 输入 `/` 或点击 **+** → **Slash commands** 以浏览 [内置命令](/docs/zh-CN/commands.md)、[自定义 skills](/docs/zh-CN/skills.md) 和插件 skills。Skills 是可重用的提示,您可以在需要时调用它们,例如代码审查清单或部署步骤。107**使用 skills 处理可重复的任务。** 输入 `/` 或点击 **+** → **Slash commands** 以浏览 [内置命令](https://code.claude.com/docs/zh-CN/commands.md)、[自定义 skills](https://code.claude.com/docs/zh-CN/skills.md) 和插件 skills。Skills 是可重用的提示,您可以在需要时调用它们,例如代码审查清单或部署步骤。
108 108
109**在提交前审查更改。** Claude 编辑文件后,会出现 `+12 -1` 指示符。点击它以打开 [diff 视图](/docs/zh-CN/desktop.md#review-changes-with-diff-view),逐个文件审查修改,并对特定行进行评论。Claude 会读取您的评论并进行修订。要让 Claude 自行审查这些更改,请在提示框中输入 [`/code-review`](/docs/zh-CN/desktop#review-your-code)。109**在提交前审查更改。** Claude 编辑文件后,会出现 `+12 -1` 指示符。点击它以打开 [diff 视图](https://code.claude.com/docs/zh-CN/desktop.md#review-changes-with-diff-view),逐个文件审查修改,并对特定行进行评论。Claude 会读取您的评论并进行修订。要让 Claude 自行审查这些更改,请在提示框中输入 [`/code-review`](https://code.claude.com/docs/zh-CN/desktop#review-your-code)。
110 110
111**调整您拥有的控制权。** 您的 [权限模式](/docs/zh-CN/desktop.md#choose-a-permission-mode) 设置了 Claude 在不请求批准的情况下可以执行的操作:111**调整您拥有的控制权。** 您的 [权限模式](https://code.claude.com/docs/zh-CN/desktop.md#choose-a-permission-mode) 设置了 Claude 在不请求批准的情况下可以执行的操作:
112 112
113* **Auto**:分类器在后台审查操作,并阻止风险操作,而不是询问您。113* **Auto**:分类器在后台审查操作,并阻止风险操作,而不是询问您。
114* **Manual**:Claude 在编辑文件或运行命令前询问。114* **Manual**:Claude 在编辑文件或运行命令前询问。
115* **Accept edits**:Claude 自动接受文件编辑以加快迭代。115* **Accept edits**:Claude 自动接受文件编辑以加快迭代。
116* **Plan**:Claude 提出一种方法而不编辑任何文件,这在大型重构前很有用。116* **Plan**:Claude 提出一种方法而不编辑任何文件,这在大型重构前很有用。
117 117
118**添加插件以获得更多功能。** 安装 [插件](/docs/zh-CN/desktop.md#install-plugins),这些插件可添加 skills、Agent、MCP 服务器等。118**添加插件以获得更多功能。** 安装 [插件](https://code.claude.com/docs/zh-CN/desktop.md#install-plugins),这些插件可添加 skills、Agent、MCP 服务器等。
119 119
120**整理您的工作区。** 将聊天、diff、终端、文件和浏览器窗格拖动到您想要的任何布局中。使用 **Ctrl+\`** 打开终端以在您的会话旁边运行命令,或点击文件路径以打开它。请参阅 [整理您的工作区](/docs/zh-CN/desktop.md#arrange-your-workspace)。120**整理您的工作区。** 将聊天、diff、终端、文件和浏览器窗格拖动到您想要的任何布局中。使用 **Ctrl+\`** 打开终端以在您的会话旁边运行命令,或点击文件路径以打开它。请参阅 [整理您的工作区](https://code.claude.com/docs/zh-CN/desktop.md#arrange-your-workspace)。
121 121
122**预览您的应用。** 当您在 desktop 中运行开发服务器时,您的应用会在浏览器窗格中打开,该窗格也可以 [打开外部网站](/docs/zh-CN/desktop.md#browse-external-sites)。Claude 可以查看正在运行的应用、测试端点、检查日志并对其看到的内容进行迭代。请参阅 [预览您的应用](/docs/zh-CN/desktop.md#preview-your-app)。122**预览您的应用。** 当您在 desktop 中运行开发服务器时,您的应用会在浏览器窗格中打开,该窗格也可以 [打开外部网站](https://code.claude.com/docs/zh-CN/desktop.md#browse-external-sites)。Claude 可以查看正在运行的应用、测试端点、检查日志并对其看到的内容进行迭代。请参阅 [预览您的应用](https://code.claude.com/docs/zh-CN/desktop.md#preview-your-app)。
123 123
124**跟踪您的拉取请求。** 打开 PR 后,Claude Code 会监控 CI 检查结果,并可以自动修复失败。请参阅 [监控拉取请求状态](/docs/zh-CN/desktop.md#monitor-pull-request-status)。124**跟踪您的拉取请求。** 打开 PR 后,Claude Code 会监控 CI 检查结果,并可以自动修复失败。请参阅 [监控拉取请求状态](https://code.claude.com/docs/zh-CN/desktop.md#monitor-pull-request-status)。
125 125
126**将 Claude 放在日程上。** 设置 [定时任务](/docs/zh-CN/desktop-scheduled-tasks.md) 以定期自动运行 Claude:每天早上进行代码审查、每周进行依赖项审计,或从您连接的工具中提取信息的简报。126**将 Claude 放在日程上。** 设置 [定时任务](https://code.claude.com/docs/zh-CN/desktop-scheduled-tasks.md) 以定期自动运行 Claude:每天早上进行代码审查、每周进行依赖项审计,或从您连接的工具中提取信息的简报。
127 127
128**准备好时扩展。** 从侧边栏打开 [并行会话](/docs/zh-CN/desktop.md#work-in-parallel-with-sessions) 以同时处理多个任务,可选择每个任务都在其自己的 Git worktree 中,并打开 [任务窗格](/docs/zh-CN/desktop.md#watch-background-tasks) 以观看会话正在运行的子代理和后台命令。打开 [侧边聊天](/docs/zh-CN/desktop.md#ask-a-side-question-without-derailing-the-session) 以提出问题而不偏离主线程。将 [长时间运行的工作发送到云端](/docs/zh-CN/desktop.md#run-long-running-tasks-in-the-cloud) 以便即使关闭应用也能继续,或 [将您已开始的会话移至云端](/docs/zh-CN/desktop.md#continue-in-another-surface)(如果任务花费的时间比预期长)。[连接外部工具](/docs/zh-CN/desktop.md#extend-claude-code)(如 GitHub、Slack 和 Linear)以整合您的工作流。128**准备好时扩展。** 从侧边栏打开 [并行会话](https://code.claude.com/docs/zh-CN/desktop.md#work-in-parallel-with-sessions) 以同时处理多个任务,可选择每个任务都在其自己的 Git worktree 中,并打开 [任务窗格](https://code.claude.com/docs/zh-CN/desktop.md#watch-background-tasks) 以观看会话正在运行的子代理和后台命令。打开 [侧边聊天](https://code.claude.com/docs/zh-CN/desktop.md#ask-a-side-question-without-derailing-the-session) 以提出问题而不偏离主线程。将 [长时间运行的工作发送到云端](https://code.claude.com/docs/zh-CN/desktop.md#run-long-running-tasks-in-the-cloud) 以便即使关闭应用也能继续,或 [将您已开始的会话移至云端](https://code.claude.com/docs/zh-CN/desktop.md#continue-in-another-surface)(如果任务花费的时间比预期长)。[连接外部工具](https://code.claude.com/docs/zh-CN/desktop.md#extend-claude-code)(如 GitHub、Slack 和 Linear)以整合您的工作流。
129 129
130## 接下来130## 接下来
131 131
132* [使用 Claude Code Desktop](/docs/zh-CN/desktop.md):权限模式、并行会话、差异视图、连接器和企业配置132* [使用 Claude Code Desktop](https://code.claude.com/docs/zh-CN/desktop.md):权限模式、并行会话、差异视图、连接器和企业配置
133* [从 CLI 迁移过来?](/docs/zh-CN/desktop.md#coming-from-the-cli):在同一项目上运行 Desktop 和 CLI,并比较功能、标志等效项以及 Desktop 中不可用的功能133* [从 CLI 迁移过来?](https://code.claude.com/docs/zh-CN/desktop.md#coming-from-the-cli):在同一项目上运行 Desktop 和 CLI,并比较功能、标志等效项以及 Desktop 中不可用的功能
134* [故障排除](/docs/zh-CN/desktop.md#troubleshooting):常见错误和设置问题的解决方案134* [故障排除](https://code.claude.com/docs/zh-CN/desktop.md#troubleshooting):常见错误和设置问题的解决方案
135* [最佳实践](/docs/zh-CN/best-practices.md):编写有效提示和充分利用 Claude Code 的提示135* [最佳实践](https://code.claude.com/docs/zh-CN/best-practices.md):编写有效提示和充分利用 Claude Code 的提示
136* [常见工作流](/docs/zh-CN/common-workflows.md):调试、重构、测试等教程136* [常见工作流](https://code.claude.com/docs/zh-CN/common-workflows.md):调试、重构、测试等教程