SpyBara
Go Premium

desktop-quickstart.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 55 additions and 69 deletions.

2026
Sun 4 23:58 Tue 6 23:59 Thu 8 22:58 Tue 13 23:57 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Wed 28 23:57 Fri 30 23:01

开始使用桌面应用

安装 Claude 桌面应用，打开 Code 选项卡，并在您计算机上的项目文件夹中开始您的第一个 Claude Code 会话。

桌面应用为您提供具有图形界面的 Claude Code，因此您可以要求 Claude 处理计算机上文件夹中的代码，并查看其更改，而无需使用终端。本页面将指导您安装应用并在 Code 选项卡中开始您的第一个会话。Claude Code 需要 Pro、Max、Team 或 Enterprise 订阅。

下载 macOS 版本

适用于 Intel 和 Apple Silicon 的通用版本

下载 Windows 版本

适用于 x64 处理器

获取 Claude for Linux（测试版）

Ubuntu 和 Debian 的 apt 或 .deb

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

[!NOTE]

这些情况在其他页面中有介绍：

桌面应用有三个选项卡：

  • Chat：无文件访问权限的常规对话，类似于 claude.ai。
  • Cowork：一个自主后台代理，在您进行其他工作时独立处理任务。
  • Code：一个交互式编码助手，可直接访问您的本地文件。根据权限模式，您可以在 Claude 提出更改时批准每项更改，或在 Claude 进行更改后审查这些更改。

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

安装

1. 安装并登录

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

2. 打开 Code 选项卡

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

桌面应用包含 Claude Code，因此您无需安装 Node.js 或 CLI 即可使用 Code 选项卡。

开始您的第一个会话

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

1. 选择环境和文件夹

在输入框下方的一行中，点击第一个控件（即环境选择器），然后选择本地分组中的第一项。接着点击环境选择器旁边的项目文件夹控件，选择打开文件夹…，并选择您的项目目录。

如果输入框下方没有出现环境选择器，说明您使用的是早期布局。请参阅检查您使用的布局。

[!TIP]

从一个您熟悉的小项目开始。这是查看 Claude Code 能做什么的最快方式。

您也可以选择：

  • 云：在云中运行会话，即使关闭应用也能继续。请参阅 在云中使用 Claude Code 了解云会话的工作原理。
  • SSH：通过 SSH 连接到远程机器，例如您自己的服务器、云虚拟机或开发容器。请先添加连接。桌面版在您第一次连接时会自动在远程机器上安装 Claude Code。正在运行的任务可以在桌面版断开连接时继续运行，但如果使用 Claude 账户，任务可能会在其登录过期时停止。
  • WSL（Windows）：在 WSL 2 发行版 内运行会话；Claude Code、工具和 git 在 Linux 端执行，使用本机路径。

2. 选择模型

从输入框下方一行靠右侧的模型选择器中选择一个模型。请参阅 模型 以比较可用的模型。您可以稍后从模型选择器更改模型。

3. 告诉 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 关于您的代码的对话。每个会话跟踪自己的上下文和更改。

4. 审查并接受更改

查看输入框下方一行中的权限模式，了解 Claude 是否会等待您的批准：

  • 自动或接受编辑：Claude 应用其文件更改，并显示一个指示器（如 +12 -1），以便您可以在差异视图中审查它们
  • 手动：Claude 提议每项更改，并在应用前等待您的批准

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

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

接下来呢？

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

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

为 Claude 提供更多上下文。 在提示框中输入 @filename 以将特定文件拉入对话。Claude 拥有的上下文越多，结果就越好。请参阅 添加文件和上下文。

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

在提交前审查更改。 Claude 编辑文件后，会出现 +12 -1 指示符。点击它以打开 diff 视图，逐个文件审查修改，并对特定行进行评论。Claude 会读取您的评论并进行修订。要让 Claude 自行审查这些更改，请在提示框中输入 /code-review。

调整您拥有的控制权。 您的 权限模式 设置了 Claude 在不请求批准的情况下可以执行的操作：

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

添加插件以获得更多功能。 安装 插件，这些插件可添加 skills、Agent、MCP 服务器等。

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

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

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

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

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

接下来