SpyBara
Go Premium

desktop-quickstart.md 2026-09-11 23:01 UTC to 2026-09-12 03:02 UTC

This page contains 7 additions and 7 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 下载 macOS 版本

适用于 Intel 和 Apple Silicon 的通用版本
windows 下载 Windows 版本

适用于 x64 处理器
linux 获取 Claude for Linux（测试版）

Ubuntu 和 Debian 的 apt 或 .deb

对于 Windows ARM64，请下载 ARM64 安装程序。在 Linux 上，使用 apt 安装；请参阅 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）以整合你的工作流。

接下来