开始使用桌面应用
在桌面上安装 Claude Code 并开始您的第一个编码会话
桌面应用为您提供具有图形界面的 Claude Code,专为并行运行多个会话而构建:用于管理并行工作的侧边栏、带有集成终端和文件编辑器的拖放布局、可视化差异审查、实时应用预览、GitHub PR 监控和自动合并以及计划任务。无需终端。
适用于 Intel 和 Apple Silicon 的通用版本
适用于 x64 处理器
Ubuntu 和 Debian 的 apt 或 .deb
对于 Windows ARM64,请下载 ARM64 安装程序。在 Linux 上,使用 apt 安装;请参阅 Claude Desktop on Linux。
Claude Code 需要 Pro、Max、Team 或 Enterprise 订阅。
本页面将指导您安装应用并开始您的第一个会话。如果您已经设置完成,请参阅使用 Claude Code Desktop了解完整参考。
桌面应用有三个选项卡:
- Chat:无文件访问权限的常规对话,类似于 claude.ai。
- Cowork:一个自主后台代理,在沙箱虚拟机中处理任务,拥有自己的环境,可以独立运行,而您可以进行其他工作。本地 Cowork 会话在您的计算机上运行虚拟机;远程 Cowork 会话改为在 Anthropic 管理的虚拟机上运行。
- Code:一个交互式编码助手,可直接访问您的本地文件。根据权限模式,您可以在 Claude 提出更改时批准每项更改,或在 Claude 进行更改后审查这些更改。
Chat 和 Cowork 在 Claude 帮助中心中有介绍;安装和部署桌面应用在 Claude Desktop 支持文章中有介绍。本页面重点关注 Code 选项卡。
安装
安装并登录
在 macOS 和 Windows 上,从上面的链接下载安装程序并运行它。在 Linux 上,请按照 Claude Desktop on Linux 中的安装步骤进行操作。在 macOS 上从应用程序文件夹启动 Claude,在 Windows 上从开始菜单启动,或在 Linux 上从应用程序启动器启动,然后使用您的 Anthropic 账户登录。
桌面应用包含 Claude Code。您无需单独安装 Node.js 或 CLI。要从终端使用 claude,请单独安装 CLI。请参阅开始使用 CLI。
开始您的第一个会话
打开代码选项卡,选择一个项目,并告诉 Claude 要做什么。
选择环境和文件夹
选择本地以在您的机器上运行 Claude,直接使用您的文件。点击选择文件夹并选择您的项目目录。
从一个您熟悉的小项目开始。这是查看 Claude Code 能做什么的最快方式。
您也可以选择:
- 云:在云中运行会话,即使关闭应用也能继续。云会话使用与 网页版 Claude Code 相同的基础设施。
- SSH:通过 SSH 连接到远程机器,例如您自己的服务器、云虚拟机或开发容器。桌面版在您第一次连接时会自动在远程机器上安装 Claude Code。
- WSL(Windows):在 WSL 2 发行版 内运行会话;Claude Code、工具和 git 在 Linux 端执行,使用本机路径。
选择模型
从发送按钮旁的下拉菜单中选择一个模型。请参阅 模型 以比较可用的模型。您可以稍后从同一下拉菜单更改模型。
告诉 Claude 要做什么
输入您想让 Claude 做的事情:
查找 TODO 注释并修复它为主函数添加测试为此代码库创建一个 CLAUDE.md 文件,包含说明
会话 是与 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 以浏览和安装 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)以整合您的工作流。
接下来
- 使用 Claude Code Desktop:权限模式、并行会话、差异视图、连接器和企业配置
- 从 CLI 迁移过来?:在同一项目上运行 Desktop 和 CLI,并比较功能、标志等效项以及 Desktop 中不可用的功能
- 故障排除:常见错误和设置问题的解决方案
- 最佳实践:编写有效提示和充分利用 Claude Code 的提示
- 常见工作流:调试、重构、测试等教程