SpyBara
Go Premium

desktop-quickstart.md 2026-09-09 22:58 UTC to 2026-09-10 23:00 UTC

This page contains 46 additions and 47 deletions.

2026
Thu 10 23:00 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58

开始使用桌面应用

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

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

apple Download for macOS

Universal build for Intel and Apple Silicon
windows Download for Windows

For x64 processors
linux Get Claude for Linux (beta)

apt or .deb for Ubuntu and Debian

For Windows ARM64, download the ARM64 installer. On Linux, install with apt; see Claude Desktop on Linux.

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

桌面应用有三个选项卡：

  • Chat：无文件访问权限的常规对话，类似于 claude.ai。
  • Cowork：一个自主后台代理，在沙箱虚拟机中处理任务，拥有自己的环境，可以独立运行，而您可以进行其他工作。本地 Cowork 会话在您的计算机上运行虚拟机；远程 Cowork 会话改为在 Anthropic 管理的虚拟机上运行。
  • Code：一个交互式编码助手，可直接访问您的本地文件。根据权限模式，您可以在 Claude 提出更改时批准每项更改，或在 Claude 进行更改后审查这些更改。

Chat 和 Cowork 在 Claude 帮助中心中有介绍；安装和部署桌面应用在 Claude Desktop 支持文章中有介绍。本页面重点关注 Code 选项卡。

安装

1

安装并登录

在 macOS 和 Windows 上，从上面的链接下载安装程序并运行它。在 Linux 上，请按照 Claude Desktop on Linux 中的安装步骤进行操作。在 macOS 上从应用程序文件夹启动 Claude，在 Windows 上从开始菜单启动，或在 Linux 上从应用程序启动器启动，然后使用您的 Anthropic 账户登录。

2

打开 Code 选项卡

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

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

开始您的第一个会话

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

1

选择环境和文件夹

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

您也可以选择：

  • 云：在云中运行会话，即使关闭应用也能继续。云会话使用与 网页版 Claude Code 相同的基础设施。
  • SSH：通过 SSH 连接到远程机器，例如您自己的服务器、云虚拟机或开发容器。桌面版在您第一次连接时会自动在远程机器上安装 Claude Code。
  • WSL（Windows）：在 WSL 2 发行版 内运行会话；Claude Code、工具和 git 在 Linux 端执行，使用本机路径。
2

选择模型

从发送按钮旁的下拉菜单中选择一个模型。请参阅 模型 以比较可用的模型。您可以稍后从同一下拉菜单更改模型。

3

告诉 Claude 要做什么

输入您想让 Claude 做的事情：

  • 查找 TODO 注释并修复它
  • 为主函数添加测试
  • 为此代码库创建一个 CLAUDE.md 文件，包含说明

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

4

审查并接受更改

接下来发生的情况取决于发送按钮旁的选择器中显示的 权限模式：

  • 自动或接受编辑：Claude 应用其文件更改，并显示一个指示器（如 +12 -1），以便您可以在差异视图中审查它们
  • 手动：Claude 提议每项更改并等待您的批准后再应用。在您接受之前，您的文件不会被修改，如果您拒绝更改，Claude 会询问您希望如何继续

在手动模式下，您将看到：

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

接下来呢？

你已经完成了第一次编辑。如需了解 Desktop 的完整功能参考，请查看 使用 Claude Code Desktop。以下是一些可以尝试的后续操作。

中断并调整方向。 你可以随时重定向 Claude。点击停止按钮立即中断，或输入更正内容并按 Enter 发送，无需停止正在运行的操作。无论哪种方式，你都不必等待它完成或重新开始。

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

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

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

调整你拥有的控制权。 你的 permission mode 设置了 Claude 在不请求批准的情况下可以做多少事情：

  • Auto：分类器在后台审查操作，阻止风险操作而不是询问你。
  • Manual：Claude 在编辑文件或运行命令前询问。
  • Accept edits：Claude 自动接受文件编辑以加快迭代。
  • Plan：Claude 提出方法而不编辑任何文件，这在大型重构前很有用。

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

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

预览你的应用。 当你在 desktop 中运行开发服务器时，你的应用会在浏览器窗格中打开，该窗格也可以 打开外部网站。Claude 可以查看正在运行的应用、测试端点、检查日志并对所看到的内容进行迭代。请参阅 预览你的应用。

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

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

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

接下来