Appearance
桌面应用快速入门
Claude Code 桌面应用提供图形化界面，支持 macOS 和 Windows，无需终端即可使用 AI 辅助编程。应用内置三个标签页：Chat（对话）、Cowork（云端自主代理）和 Code（本地交互式编程助手）。本文从下载安装开始，介绍首次会话的完整流程——选择运行环境、选择模型、输入任务、在 Diff 视图中审查变更——以及后续可探索的高级功能：并行会话、权限模式、应用预览、PR 监控和定时任务。
Claude Code 桌面应用提供图形化的编程助手界面：侧边栏管理并行会话、拖拽布局含终端和文件编辑器、可视化 Diff 审查、实时应用预览、GitHub PR 监控与自动合并、定时任务——无需终端。
本文介绍安装应用并完成第一次编程会话的完整流程。已安装的用户请参考 桌面应用完整指南 了解全部功能。
如果你已经会用 CLI，桌面版最需要先理解的是配置边界：Code 标签页使用同一套 Claude Code 引擎，所以项目里的 CLAUDE.md、MCP、Hooks、Skills 和多数 settings.json 配置会继续生效；但桌面应用登录、窗口布局、图形化面板属于应用自身体验。
配置边界速查
| 问题 | 结论 | 下一步 |
|---|---|---|
桌面版会读取项目 .claude/settings.json 吗？ | Code 标签页会读取项目配置 | settings.json 配置指南 |
| 桌面版和 CLI 登录状态完全一样吗？ | 不完全一样；桌面应用登录属于应用自身体验 | 认证配置 |
| 桌面版权限模式和 settings 里的权限规则是什么关系？ | 图形界面负责选择模式，settings 负责规则细节 | 权限模式 |
| 改了 settings 不生效怎么办？ | 重启当前会话，必要时重启桌面应用 | settings 排查 |
三个标签页
桌面应用包含三个标签页：
| 标签页 | 说明 |
|---|---|
| Chat | 通用对话，无文件访问权限，类似 claude.ai |
| Cowork | 在云端 VM 中自主运行的后台代理，可在你做其他工作时独立运行 |
| Code | 交互式编程助手，直接访问本地文件，每个变更均需你实时审批 |
Chat 和 Cowork 的说明见 Claude Desktop 支持文章。本文聚焦 Code 标签页。
安装
下载应用
| 系统 | 下载 |
|---|---|
| macOS（Intel + Apple Silicon） | Claude for macOS |
| Windows x64 | Claude for Windows |
| Windows ARM64 | Claude for Windows ARM64 |
Linux 目前暂不支持桌面应用。
登录并打开 Code 标签页
安装后打开 Claude（macOS 在应用程序文件夹，Windows 在开始菜单），使用 Anthropic 账号登录，然后点击 Code 标签页。
- 如提示升级，需先订阅付费套餐（Pro、Max、Teams 或 Enterprise）
- 如提示在线登录，完成后重启应用即可
桌面应用内置完整的 Claude Code 引擎，无需额外安装 Node.js 或 CLI。若要在终端中使用
claude命令，需单独安装 CLI，参见 快速开始。
开始第一次会话
1. 选择环境和目录
在提示框中选择运行环境：
- Local（本地）：直接访问本地文件——推荐首次使用
- Remote（远程）：在 Anthropic 云端运行，关闭应用后任务仍继续
- SSH：连接到远程服务器（需在远程机器上安装 Claude Code）
选择 Local 后，点击 Select folder 选择你的项目目录。
Windows 提示：本地会话需要安装 Git。大多数 Mac 默认已包含 Git。
2. 选择模型
从发送按钮旁的下拉菜单选择模型——Opus（最强）、Sonnet（均衡）或 Haiku（最快）。会话开始后无法切换模型。
3. 告诉 Claude 做什么
在提示框输入你的需求，例如：
找一个 TODO 注释并修复它
为主函数添加测试
为这个代码库创建一个 CLAUDE.md 指令文件4. 审查并接受变更
默认启用 Ask permissions（询问权限） 模式，Claude 提议变更后等待你确认：
- Diff 视图：展示每个文件将会发生的具体变更
- Accept/Reject 按钮：逐一批准或拒绝
- 实时更新：随 Claude 工作进度实时刷新
拒绝变更时，Claude 会询问如何以不同方式推进。在你接受之前，文件不会被修改。
接下来能做什么
完成第一次编辑后，可以继续探索以下功能：
中途介入：随时打断 Claude——点击停止按钮，或直接输入修正意见后按 Enter。Claude 停下并调整，无需等它完成或重新开始。
添加更多上下文：在提示框输入 @文件名 引用特定文件，通过附件按钮上传图片或 PDF，或直接拖放文件。上下文越丰富，结果越好。参见添加文件和上下文。
使用 Skills 完成重复任务：输入 / 或点击 + → Slash commands，浏览内置命令、自定义 Skills 和插件 Skills。Skills 是可复用的工作流提示词，比如代码审查清单或部署步骤。
提交前审查变更：Claude 编辑文件后，会出现类似 +12 -1 的指示器。点击打开 Diff 视图，逐文件查看变更，并对特定行添加注释。点击 Review code 让 Claude 自我评估 diff 并留下内联建议。
调整控制粒度：权限模式 控制控制程度：
| 模式 | 说明 |
|---|---|
| Ask permissions（默认） | 每次编辑前需要确认 |
| Auto accept edits | 自动接受文件编辑，迭代更快 |
| Plan mode | 仅规划方案，不修改任何文件——大型重构前使用 |
添加插件：点击提示框旁的 + 按钮，选择 Plugins，浏览并安装插件，为 Claude 增加 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 和设置）。
迁移时建议按这个顺序检查：
- 先确认账号登录是否正常，遇到凭证冲突看认证配置。
- 再确认项目
.claude/settings.json、.claude/settings.local.json是否仍符合预期。 - 最后根据桌面版权限模式决定是否继续使用 CLI 里的自动权限规则。
功能对比、标志等效关系和桌面应用暂不支持的功能，参见 CLI 对比。
相关文档
- settings.json 配置指南：权限、模型、statusline、环境变量和项目级配置。
- 认证配置：登录方式、API Key、OAuth 和长期 Token。
- JetBrains IDE 集成：IDE 插件和桌面版之外的本地开发入口。
- 桌面应用完整指南：权限模式、并行会话、Diff 视图、连接器和企业配置。
- 故障排查：常见错误和安装问题的解决方案。
- 最佳实践：撰写高效提示词，充分发挥 Claude Code 的能力。
- 常见工作流：调试、重构、测试等实战教程。
常见问题
Q: 桌面应用需要单独安装 Node.js 或 CLI 吗？
不需要。桌面应用内置了完整的 Claude Code 引擎，开箱即用。只有需要在终端中使用 claude 命令时，才需要单独安装 CLI。
Q: Chat、Cowork 和 Code 三个标签页有什么区别？
Chat 是普通对话，无文件访问权限。Cowork 是云端自主代理，可在后台独立完成任务。Code 是与本地文件直接交互的编程助手，每个变更均需你实时审批——这是桌面应用的核心功能。
Q: 会话开始后可以切换模型吗？
不可以。模型需要在会话开始前从下拉菜单选择，一旦会话开始就无法切换。如果需要换模型，需要开启新会话。