桌面应用 Desktop

Claude 桌面应用 Code 标签页：图形化并行编码会话，仅 macOS/Windows。

是什么

Claude 桌面应用含三个标签页：Chat（对话）、Cowork（Dispatch 与长时 agentic 工作）、Code（软件开发），本页是 Code 标签页的参考文档。Code 标签页里每个对话都是一个独立的 session，拥有各自的聊天历史、项目文件夹和代码变更，互不影响，侧边栏列出所有 session 并可并行运行。

桌面应用与 CLI 运行同一套底层引擎，只是带图形界面；两者可在同一台机器、甚至同一项目上同时运行，各自维护独立的 session 历史，但通过 CLAUDE.md 共享配置与项目记忆。桌面应用不支持 Linux（请改用 CLI）。

怎么工作

发送首条消息前先在 prompt 区配置四项：Environment（Local / Remote / SSH）、Project folder（项目文件夹/仓库）、Model（发送键旁下拉选择）、Permission mode（权限模式选择器），输入任务按 Enter 启动。
Permission mode 控制 Claude 自主程度：Ask permissions(default)、Auto accept edits(acceptEdits)、Plan mode(plan)、Auto(auto)、Bypass permissions(bypassPermissions)，可在 session 进行中随时切换。
Diff view 逐文件审阅变更，可点击行添加评论（macOS Cmd+Enter / Windows Ctrl+Enter 一次性提交），Claude 据评论修改并生成新 diff；点 Review code 让 Claude 先评审。
Preview 面板可启动 dev server 并在内嵌浏览器中验证变更（截图、检查 DOM、点击元素、填表并自动修复），也能打开静态 HTML/PDF/图片/视频；配置存于 .claude/launch.json。
开 PR 后出现 CI 状态栏，用 GitHub CLI 轮询检查结果，可开启 Auto-fix（自动修复失败检查）与 Auto-merge（全部通过后 squash 合并）。
面板（chat、diff、preview、terminal、file、plan、tasks、subagent）可拖拽自由排布与缩放；从 Views 菜单打开更多面板。
并行 session：每个 Git 仓库 session 通过 Git worktree 获得隔离副本（默认存于 <project-root>/.claude/worktrees/），提交前互不影响。
Side chat（Cmd+; / Ctrl+; 或 /btw）可借用 session 上下文提问而不影响主线程；computer use 可让 Claude 操作屏幕与本机应用。

怎么配置 / 用法

.claude/launch.json 配置 preview server（支持带注释 JSON）：

json

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

字段含 name、runtimeExecutable、runtimeArgs、port（默认 3000）、cwd、env、autoPort、program、args；顶层加 "autoVerify": false 可关闭每次编辑后的自动验证。管理员可在 managed settings 用 sshConfigs 预置 SSH 连接、sshHostAllowlist 限制可连主机、managedMcpServers 下发 MCP server。

什么时候用

想在单一窗口里管理多个并行 session、把面板并排排布、或可视化审阅变更时，用 Desktop。
需要内嵌浏览器预览并让 Claude 自动验证前后端改动（截图、点击、填表、查日志）时。
要操作没有 CLI 的原生应用、GUI 工具、硬件控制面板或移动模拟器时，启用 computer use。
跑大型重构、测试套件、迁移等长时任务时选 Remote，会话在云端后台继续，即使关掉应用。
在云 VM、dev container 或特定硬件/依赖的机器上工作时，用 SSH session。

限制 / 坑

不支持 Linux；桌面应用仅 macOS 和 Windows 可用，Linux 请用 CLI。
不提供行内代码补全（inline code suggestions），只通过对话式 prompt 与显式改动工作。
无脚本/自动化能力（--print、--output-format、Agent SDK 不可用），Desktop 仅交互式。
/permissions、/config、/agents、/doctor 等终端弹窗式命令在 Code 标签页不可用，会回复 isn't available in this environment。
computer use 与 Dispatch 是 macOS/Windows 上的 research preview，需 Pro 或 Max 套餐，Team/Enterprise 不可用。

硬事实速查（12 条）

下载：macOS 通用版（Intel + Apple Silicon）；Windows x64 安装包，另有 Windows ARM64 安装包。
Windows 首次打开 Code 标签页需先装 Git for Windows 并重启应用；session 隔离依赖 Git。
权限模式 Auto 是面向所有 Anthropic API 用户的 research preview，不支持第三方 provider，需 Claude Opus 4.6+ 或 Sonnet 4.6。
面板布局、终端、文件编辑器、视图模式需 Claude Desktop v1.2581.0 或更高版本。
PR 监控需本机安装并认证 GitHub CLI(gh)，自动合并使用 squash 且需仓库启用 auto-merge。
快捷键：Cmd+/ 查看全部、Cmd+N 新建 session、Esc 停止响应、Ctrl+反引号切换终端、Cmd+; 开 side chat（Windows 用 Ctrl 代替 Cmd）。
视图模式有 Normal、Verbose、Summary 三种，Ctrl+O 循环切换。
computer use 三档权限：View only（浏览器/交易平台）、Click only（终端/IDE）、Full control（其余），由应用类别固定，审批默认持续整个 session（Dispatch 生成的 session 为 30 分钟）。
Desktop 默认连 Anthropic API，不支持 Bedrock/Foundry；企业部署可配 Vertex AI 与 gateway provider。
在 CLI 终端运行 /desktop 可把当前 session 迁入桌面应用（需 Claude 订阅登录，API key / Bedrock / Vertex / Foundry 不支持）。
Desktop 与 CLI 共享配置：CLAUDE.md / CLAUDE.local.md、~/.claude.json 与 .mcp.json 的 MCP server、hooks、skills、~/.claude/settings.json。
Remote session 用量计入订阅套餐额度，无单独计算费用；可在 claude.ai/code 或 Claude iOS 应用监控。

官方出处：https://code.claude.com/docs/en/desktop

桌面应用 Desktop ​

是什么 ​

怎么工作 ​

怎么配置 / 用法 ​

什么时候用 ​

限制 / 坑 ​