Claude Code 平台集成

桌面版快速开始

2 分钟阅读

桌面版入门指南

在桌面端安装 Claude Code 并开始你的首次编码会话

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

下载 macOS 版

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

下载 Windows 版

适用于 x64 处理器

获取 Linux 版 Claude（测试版）

适用于 Ubuntu 和 Debian 的 apt 或 .deb 包

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

Claude Code 需要 Pro、Max、Team 或 Enterprise 订阅。

本页面将指导你安装应用并开始首次会话。如果你已完成设置，请参阅 Claude Code 桌面版使用指南获取完整参考。

桌面版应用有三个标签页：

聊天：无需文件访问权限的通用对话，类似于 claude.ai。
协作：一个自主后台代理，在具有独立环境的云虚拟机中处理任务。它可以在你处理其他工作时独立运行。
代码：一个交互式编码助手，可直接访问你的本地文件。你可以实时审查并批准每一项更改。

聊天和协作功能在 Claude Desktop 支持文章中有详细说明。本页面重点介绍代码标签页。

安装

安装并登录

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

打开代码标签页

点击顶部中央的代码标签页。如果点击代码后提示你升级，则需要先订阅付费计划。如果提示你在线登录，请完成登录并重启应用。如果你看到 403 错误，请参阅身份验证故障排除。

桌面版应用已包含 Claude Code。你无需单独安装 Node.js 或 CLI。若要在终端中使用 claude，请单独安装 CLI。请参阅 CLI 入门指南。

开始你的首次会话

打开代码标签页后，选择一个项目并让 Claude 执行一些操作。

选择环境和文件夹

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

从一个小型且你熟悉的项目开始。这是了解 Claude Code 功能的最快方式。在 Windows 上，必须安装 Git 才能使用本地会话。大多数 Mac 默认已包含 Git。

你还可以选择：

远程：在 Anthropic 的云基础设施上运行会话，即使关闭应用也会继续。云会话使用与 Claude Code 网页版相同的基础设施。
SSH：通过 SSH 连接到远程机器，例如你自己的服务器、云虚拟机或开发容器。桌面版会在首次连接时自动在远程机器上安装 Claude Code。

选择模型

从发送按钮旁边的下拉菜单中选择一个模型。有关可用模型的对比，请参阅模型。你可以稍后从同一个下拉菜单中更改模型。

告诉 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 关于你代码的对话。每个会话跟踪自己的上下文和更改，因此你可以同时处理多个任务而不会相互干扰。

审查并接受更改

默认情况下，代码标签页以手动模式启动，Claude 会提出更改并在应用前等待你的批准。你将看到：

一个差异视图，显示每个文件将要发生的具体更改
接受/拒绝按钮，用于批准或拒绝每项更改
Claude 处理你的请求时的实时更新

如果你拒绝某项更改，Claude 会询问你希望如何以不同方式继续。你的文件在你接受之前不会被修改。

接下来做什么？

你已完成首次编辑。有关桌面版所有功能的完整参考，请参阅 Claude Code 桌面版使用指南。以下是一些接下来可以尝试的操作。

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

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

使用技能完成可重复任务。 输入 / 或点击 + → 斜杠命令 浏览内置命令、自定义技能和插件技能。技能是可重复使用的提示，你可以随时调用，例如代码审查清单或部署步骤。

提交前审查更改。 Claude 编辑文件后，会显示 +12 -1 指示器。点击它以打开差异视图，逐文件审查修改，并对特定行发表评论。Claude 会阅读你的评论并进行修改。点击 审查代码 让 Claude 自行评估差异并留下内联建议。

调整你的控制程度。 你的权限模式设置 Claude 在无需请求批准的情况下可以执行的操作：

手动：默认模式。Claude 在编辑文件或运行命令前会询问。
接受编辑：Claude 自动接受文件编辑，以便更快迭代。
计划：Claude 提出方案而不编辑任何文件，这在大型重构之前很有用。

添加插件以获得更多功能。 点击提示框旁边的 + 按钮并选择插件，浏览并安装插件，以添加技能、代理、MCP 服务器等。

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

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

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

让 Claude 按计划运行。 设置定时任务，让 Claude 按重复计划自动运行：每天早晨的每日代码审查、每周依赖项审计，或从已连接工具拉取信息的简报。

准备就绪后扩展规模。 从侧边栏打开并行会话，同时处理多个任务，每个任务都在自己的 Git 工作树中，并打开任务窗格查看会话运行的子代理和后台命令。打开侧边聊天提出问题而不会打断主线程。将长时间运行的任务发送到云端，即使关闭应用也会继续，或者如果任务耗时超出预期，可以在网页或 IDE 中继续会话。连接外部工具如 GitHub、Slack 和 Linear，将你的工作流程整合在一起。

从 CLI 迁移而来？

桌面版运行与 CLI 相同的引擎，并带有图形界面。你可以在同一个项目上同时运行两者，它们共享配置（CLAUDE.md 文件、MCP 服务器、钩子、技能和设置）。有关功能对比、等效标志以及桌面版中不可用功能的完整说明，请参阅 CLI 对比。

下一步

Claude Code 桌面版使用指南：权限模式、并行会话、差异视图、连接器和企業配置
故障排除：常见错误和设置问题的解决方案
最佳实践：编写有效提示并充分利用 Claude Code 的技巧
常见工作流：调试、重构、测试等教程

上一页GitLab CI/CD 集成下一页桌面版完整指南