是什么
Claude Code Desktop 是独立的桌面应用,提供图形界面运行 Claude Code,无需终端。支持可视化 Diff 审查、并行会话管理、集成终端和文件编辑器、实时应用预览、GitHub PR 监控,以及本地和云端两种运行模式。
核心机制
三种运行环境:
- Local:在本机运行,直接访问本地文件
- Remote:在 Anthropic 云端运行,关闭应用后继续
- SSH:连接到远程机器,Desktop 自动安装 Claude Code
核心功能:
Diff 审查:文件修改后显示 +12 -1 指示器,点击打开 Diff 视图,可对特定行添加注释(Cmd+Enter 提交所有注释)。点击「Review code」让 Claude 自我审查变更。
应用预览:内嵌浏览器,Claude 可以启动 dev server、截图、检查 DOM、点击元素、填写表单,自动验证自己的修改。
PR 监控:开 PR 后显示 CI 状态栏,支持 Auto-fix(自动修复 CI 失败)和 Auto-merge(所有检查通过后自动合并)。
并行会话:侧边栏管理多个会话,每个会话有独立的 git worktree,互不干扰。
权限模式:Ask permissions(默认)→ Auto accept edits → Plan mode → Auto(需启用)→ Bypass permissions(需启用)。
Computer Use(macOS/Windows):让 Claude 控制桌面应用,需在 Settings 中启用。
Dispatch:从 Claude 移动端 App 发送任务,Desktop 创建新会话处理。
关键细节
- 需要 Pro/Max/Team/Enterprise 订阅
- Windows 需要安装 Git for Windows
- Linux 不支持 Desktop,使用 CLI
- Desktop 与 CLI 共享配置(CLAUDE.md、MCP 服务器、hooks、settings)
- 可同时运行 Desktop 和 CLI 在同一项目
- 企业部署支持 Vertex AI 和 gateway 提供商,Bedrock/Foundry 需用 CLI
关联
- desktop-quickstart — Desktop 安装和首次会话
- desktop-scheduled-tasks — 本地定时任务
- desktop-changelog — Desktop 版本更新记录
- platforms-overview — 各平台对比
- permission-modes — 权限模式详解
实践要点
- 复杂任务先用 Plan mode 探索,确认方案后切换到 Auto accept edits 执行
- 用 Preview 面板让 Claude 自动验证 UI 变更,减少手动检查
- 并行会话适合独立任务,每个会话在独立 worktree 中工作
- Auto-fix + Auto-merge 组合可以实现「提交 PR 后完全自动化」的工作流
- 侧边栏的 Tasks 面板可以查看当前会话中运行的 Subagents 和后台命令