桌面应用为您提供具有图形界面的 Claude Code。您可以要求 Claude 处理计算机上文件夹中的代码,然后自行查看更改,而无需使用终端。

Claude Code 位于应用侧边栏顶部的 Code 选项卡中。本页面将指导您安装应用并在其中开始您的第一个会话。Claude Code 需要 Pro、Max、Ultra、Team 或 Enterprise 订阅。

[card] 下载 macOS 版本

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

[card] 下载 Windows 版本

适用于 x64 处理器

[card] 获取 Claude for Linux(测试版)

Ubuntu 和 Debian 的 apt 或 .deb

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

注意

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

安装

1. 安装并登录

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

2. 打开 Code 选项卡

点击侧边栏顶部的 Code 选项卡。如果选项卡仅显示图标,将鼠标悬停在图标上即可查看其名称。如果点击 Code 后出现提示或错误,请按照对应的解决方法操作:

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

开始您的第一个会话

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

1. 选择环境和文件夹

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

如果新会话的输入框下方没有显示环境,说明您使用的是早期布局。请参阅检查您使用的布局。

提示

从一个您熟悉的小项目开始。这是查看 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),以便您可以在 diff 视图中审查它们
  • 手动:Claude 提议每项更改,并在应用前等待您的批准

在手动模式下,您将看到:

  1. 一个 diff,准确显示将要发生的更改
  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)以整合您的工作流。

接下来