古法编程

Claude Code 桌面应用快速入门：安装、首次会话与核心功能

Claude Code 桌面应用提供图形化编程环境，支持 macOS（Intel/Apple Silicon）和 Windows（x64/ARM64），无需终端即可运行 Code 标签页与本地代码交互。安装后登录账号、选择项目目录、挑选模型、输入任务，在 Diff 视图中审查并批准修改。应用内置 Chat（对话）、Cowork（云端自主代理）和 Code（本地交互编程）三标签页，Code 标签页默认使用 Ask permissions 模式，每次编辑前需确认。支持并行会话、权限模式切换、定时任务、PR 监控、应用预览和插件扩展。

系统要求与下载

Claude Code 桌面应用适用于 macOS（Intel 和 Apple Silicon）和 Windows x64/ARM64。Linux 仅支持 CLI。需 Pro、Max、Teams 或 Enterprise 订阅。

平台 下载链接
macOS（Intel + Apple Silicon） 下载 macOS 版本
Windows x64 下载 Windows x64 版本
Windows ARM64 下载 ARM64 版本

Linux 用户可以改用 CLI 快速开始。

三个标签页

桌面应用有三个标签页：

  • Chat：通用对话，无文件访问权限，类似 claude.ai。
  • Cowork：在云端 VM 中独立运行的自主代理，可后台处理任务。
  • Code：交互式编程助手，直接访问本地文件，每个变更需你实时审批。

Chat 和 Cowork 详见 Claude Desktop 支持文章。本页聚焦 Code 标签页。

安装与首次启动

  1. 从上方链接下载对应平台的安装程序并运行。
  2. 从 macOS 的“应用程序”文件夹或 Windows 的“开始”菜单启动 Claude。
  3. 使用 Anthropic 账户登录。
  4. 点击顶部的 Code 标签页。

桌面应用内置完整 Claude Code 引擎，无需单独安装 Node.js 或 CLI。若要在终端中使用 claude 命令，请单独安装 CLI（参见CLI 快速开始）。

开始第一次 Code 会话

打开 Code 标签页后，按以下步骤操作：

  1. 选择运行环境
    点击提示框左上角的下拉菜单，选择：

    • Local：直接使用本地文件。点击 Select folder 选择项目目录。

      建议从你熟悉的小项目开始，这是最快体验方式。Windows 上需要安装 Git；macOS 默认包含 Git。

    • Remote：在 Anthropic 云端基础设施上运行，关闭应用后任务继续。Remote 会话与 Claude Code on the web 使用相同后端。
    • SSH：通过 SSH 连接到远程机器（如你自己的服务器、云 VM 或 dev container），桌面应用首次连接时会自动在远程机器上安装 Claude Code。

  2. 选择模型
    在发送按钮旁的下拉菜单中选择模型：Opus、Sonnet 或 Haiku（参见模型对比）。可在会话进行中随时切换模型。

  3. 输入任务
    在提示框中输入你想让 Claude 做的事，例如：

    • Find a TODO comment and fix it
    • Add tests for the main function
    • Create a CLAUDE.md with instructions for this codebase

    每个 Code 会话是独立的对话，每个会话维护自己的上下文和修改，可并行处理多个任务互不干扰。

  4. 审查并批准变更
    默认使用 Ask permissions 权限模式——Claude 提出修改，等你批准后才应用。你会看到：

    • Diff 视图：精确显示每个文件的变化。
    • Accept/Reject 按钮：逐一批准或拒绝。
    • 实时更新：Claude 处理请求时实时刷新。

    如果拒绝变更，Claude 会询问你希望如何调整。在你接受前，文件不会被修改。

下一步可以做什么

完成第一次编辑后，桌面应用可帮你做更多事：

中途介入：点击停止按钮立即打断 Claude，或直接输入修正意见后按 Enter 发送（不停止当前动作）。无需等它完成或重新开始。

提供更多上下文：在提示框中输入 @文件名 拉取指定文件，使用附件按钮上传图片和 PDF，或直接拖放文件。更多参见添加文件和上下文。

使用 Skills 重复任务：输入 / 或点击 + → Slash commands 浏览内置命令、自定义 Skills 和插件 Skills。Skills 是可复用的提示词（如代码审查清单、部署步骤）。

提交前审查变更：Claude 编辑文件后会显示 +12 -1 等指示器。点击它打开 Diff 视图，逐文件审查、针对某行添加注释。Claude 会读取注释并修改。点击 Review code 让 Claude 自我评估 diff 并留下内联建议。

调整权限模式：通过权限模式控制控制程度：

  • Ask permissions（默认）：每次编辑前需批准。
  • Auto accept edits：自动接受文件编辑，适合快速迭代。
  • Plan mode：只规划方案，不修改文件，适合大型重构前。

添加插件：点击提示框旁的 + 按钮，选择 Plugins，浏览安装插件，添加 Skills、Agents、MCP 服务器等能力。

排列工作区：拖拽聊天、Diff、终端、文件、预览面板到任意布局。按 Ctrl+` 打开终端运行命令，点击文件路径在文件面板中打开。参见排列工作区。

预览应用：点击 Preview 下拉菜单，直接在桌面中运行开发服务器。Claude 可查看运行中的应用、测试端点、检查日志并迭代。参见预览应用。

监控 Pull Request：打开 PR 后，Claude Code 监控 CI 检查结果，可自动修复失败或在检查通过后自动合并。参见监控 PR 状态。

设置定时任务：配置定时任务，让 Claude 按计划自动运行：每日代码审查、每周依赖审计、从连接工具汇总动态。

并行会话与后台任务：从侧边栏打开并行会话，每个会话在独立 Git worktree 中运行；打开任务面板查看子代理和后台命令。侧边对话可提问而不中断主线程；长时间任务可发送到云端继续运行；或在 Web 或 IDE 中继续会话。连接 GitHub、Slack、Linear 等外部工具整合工作流。

从 CLI 迁移？

桌面应用与 CLI 使用完全相同的 Claude Code 引擎，只是多了图形界面。两者可同时运行在同一项目上，共享配置（CLAUDE.md 文件、MCP 服务器、Hooks、Skills 和设置）。功能对比和 CLI 专有功能的差异，参见CLI 对比。

常见问题

桌面应用需要额外安装 Node.js 吗？

不需要。桌面应用内置完整 Claude Code 引擎，无需额外安装 Node.js 或 CLI。如果你要从终端使用 claude 命令，则需单独安装 CLI。

Code 标签页中的 403 错误怎么解决？

403 错误通常表示认证问题。请尝试重新登录或重启应用。如果问题持续，检查你的网络能否访问 An thropic API，并参考认证故障排查。

本地会话在 Windows 上无法运行怎么办？

Windows 本地会话需要安装 Git。请确保已安装 Git（下载）并添加到 PATH。另外，选择项目目录时请确保有读写权限。