Appearance
桌面应用完整指南
Claude Code Desktop 是 Claude 桌面应用的 Code 标签页，提供图形化的 Claude Code 体验——无需终端。在标准 Claude Code 功能之上，Desktop 还额外提供：可视化 Diff 审查与内联注释、实时应用预览（内嵌浏览器）、macOS/Windows 计算机控制、GitHub PR 监控与自动修复合并、自动 Git worktree 并行会话、连接器（GitHub/Slack/Linear）、定时任务，以及 SSH 和云端远程会话。本文覆盖所有功能、配置项、CLI 对比和故障排查。
Claude Desktop 的 Code 标签页提供图形化的 Claude Code 体验，无需终端。初次使用请先阅读 快速入门。
Desktop 在标准 Claude Code 基础上额外提供：
- 并行会话（自动 Git worktree 隔离）
- 拖拽布局（集成终端、文件编辑器、预览面板）
- 侧边对话（不打断主线程提问）
- 可视化 Diff 审查（内联注释）
- 实时应用预览（开发服务器、HTML、PDF）
- 计算机使用（macOS/Windows 屏幕与应用控制）
- GitHub PR 监控（自动修复、自动合并、自动归档）
- Dispatch 集成（从手机下发任务）
- 定时任务
- 连接器（GitHub、Slack、Linear 等）
- 本地、SSH 和云端远程环境
开始一次会话
发送第一条消息前，在提示框区域配置以下四项：
- 环境：选择 Claude 在哪里运行——Local（本机）、Remote（Anthropic 云端）或 SSH 连接
- 项目目录：选择要操作的文件夹或仓库。远程会话可添加多个仓库
- 模型：从发送按钮旁的下拉菜单选择，可在会话中随时切换
- 权限模式：从模式选择器选择，可在会话中随时切换
代码工作
使用提示框
输入任务后按 Enter 发送。Claude 读取项目文件、做变更并运行命令（取决于权限模式）。随时可以打断：点击停止按钮或输入修正后按 Enter。
添加文件和上下文
- @mention 文件：输入
@后跟文件名将文件加入对话上下文（仅限本地和 SSH 会话） - 附件按钮：上传图片、PDF，或直接拖放到提示框
选择权限模式
| 模式 | 设置键 | 行为 |
|---|---|---|
| Ask permissions | default | 编辑文件或运行命令前询问确认。新用户推荐。 |
| Auto accept edits | acceptEdits | 自动接受文件编辑和常见文件系统命令（mkdir/touch/mv），其他终端命令仍询问 |
| Plan mode | plan | 探索文件后提出计划，不修改源码。复杂任务先规划时使用 |
| Auto | auto | 带后台安全检查全自动执行。减少确认提示同时保持监督。研究预览，需 Team/Enterprise/API + Sonnet 4.6 或 Opus 4.6 |
| Bypass permissions | bypassPermissions | 无任何确认提示，等同 CLI --dangerously-skip-permissions。仅在沙箱容器/VM 中使用 |
远程会话支持 Auto accept edits 和 Plan mode；Ask permissions 不可用（远程会话默认自动接受文件编辑）；Bypass permissions 不可用（远程环境已沙箱化）。
预览应用
Claude 可启动开发服务器并在内嵌浏览器中验证变更——前端应用和后端服务器均支持（可测试 API 端点、查看服务器日志）。默认情况下，Claude 编辑文件后自动启动并自动验证变更。
预览面板还可打开静态 HTML 文件、PDF 和图片（点击聊天中的路径即可）。
在预览面板中可以：
- 直接在内嵌浏览器中与应用交互
- 观看 Claude 自动验证变更（截图、检查 DOM、点击元素、填写表单、修复问题）
- 从会话工具栏的 Preview 下拉菜单启动或停止服务器
- 勾选 Persist sessions 跨服务器重启保留 Cookie 和 Local Storage，避免重复登录
- 编辑服务器配置或一次停止所有服务器
Claude 基于项目自动生成初始服务器配置。如需自定义，编辑 .claude/launch.json（见配置预览服务器）。
清除已保存的会话数据：在 Settings → Claude Code 中关闭 Persist preview sessions。
完全禁用预览：在 Settings → Claude Code 中关闭 Preview。
用 Diff 视图审查变更
Claude 修改文件后，工具栏出现类似 +12 -1 的指示器。点击打开 Diff 视图：左侧文件列表、右侧显示每个文件的具体变更。
点击任意行打开注释框，输入反馈后按 Enter 添加。批量提交所有注释：
- macOS：Cmd+Enter
- Windows：Ctrl+Enter
Claude 读取注释并进行修改，以新 Diff 呈现。
审查代码
在 Diff 视图右上角点击 Review code，让 Claude 在提交前评估变更。Claude 检查当前 diff 并直接在 Diff 视图中留下注释，聚焦高信号问题：编译错误、明确的逻辑错误、安全漏洞和明显 bug（不标记样式、格式或 linter 问题）。
监控 Pull Request 状态
打开 PR 后，会话中出现 CI 状态栏，Claude Code 通过 GitHub CLI 轮询检查结果。
- Auto-fix：开启后，CI 检查失败时 Claude 自动读取失败输出并迭代修复
- Auto-merge：开启后，所有检查通过后 Claude 自动合并 PR（squash 方式）。需在 GitHub 仓库设置中启用 auto-merge
PR 合并或关闭后自动归档会话：在 Settings → Claude Code 中开启 auto-archive。
排列工作区
面板类型：聊天、Diff、预览、终端、文件、计划、任务、子代理。拖拽面板标题可重新定位，拖拽面板边缘可调整大小。
- macOS：Cmd+\ 关闭当前面板
- Windows：Ctrl+\ 关闭当前面板
- 从会话工具栏的 Views 菜单开启更多面板
集成终端
- macOS/Windows：Ctrl+` 打开
- 在会话工作目录中打开，与 Claude 共享同一环境
- 仅限本地会话
文件面板
点击聊天或 Diff 视图中的文件路径即可打开（HTML/PDF/图片路径会打开预览面板）。
本地/SSH 会话可用，远程会话请让 Claude 直接修改。
右键任意文件路径弹出菜单：
- Attach as context：附加到下一条提示
- Open in：在 VS Code、Cursor 或 Zed 中打开
- Show in Finder/Explorer：打开所在文件夹
- Copy path：复制绝对路径
切换视图模式
从工具栏 Transcript view 下拉菜单切换，或按 Ctrl+O 循环：
| 模式 | 显示内容 |
|---|---|
| Normal | 工具调用折叠为摘要，显示完整文本响应 |
| Verbose | 每个工具调用、文件读取和中间步骤 |
| Summary | 仅 Claude 的最终响应和变更 |
键盘快捷键
按 Cmd+/（macOS）或 Ctrl+/（Windows）查看所有快捷键。
| 快捷键 | 操作 |
|---|---|
| Cmd / | 显示快捷键 |
| Cmd N | 新建会话 |
| Cmd W | 关闭会话 |
| Ctrl Tab / Ctrl Shift Tab | 前/后一个会话 |
| Cmd Shift ] / [ | 前/后一个会话 |
| Esc | 停止 Claude 响应 |
| Cmd Shift D | 切换 Diff 面板 |
| Cmd Shift P | 切换预览面板 |
| Cmd Shift S | 在预览中选择元素 |
| Ctrl ` | 切换终端面板 |
| Cmd \ | 关闭当前面板 |
| Cmd ; | 打开侧边对话 |
| Ctrl O | 循环切换视图模式 |
| Cmd Shift M | 打开权限模式菜单 |
| Cmd Shift I | 打开模型菜单 |
| Cmd Shift E | 打开推理力度菜单 |
| 1–9 | 选择已打开菜单中的项目 |
计算机使用
计算机使用让 Claude 打开你的应用、控制屏幕——就像你亲自操作一样。适合测试原生 App（移动模拟器）、操作没有 CLI 的桌面工具，或自动化只能通过 GUI 完成的任务。
默认关闭，需在设置中开启。macOS 还需授予辅助功能和屏幕录制权限。
工具优先级
Claude 按精确度从高到低选择工具：
- 如果有该服务的连接器 → 使用连接器
- 如果是 shell 命令 → 使用 Bash
- 如果是浏览器任务且安装了 Claude in Chrome → 使用 Chrome
- 以上都不适用 → 使用计算机控制
开启计算机使用
- 在 Settings → Claude Code 下找到 Computer use
- 开启开关
- macOS 需在系统设置中授予辅助功能和屏幕录制权限
应用权限层级
Claude 第一次需要使用某个应用时会出现确认提示，选择 Allow for this session 或 Deny。批准有效期为当前会话（Dispatch 生成的会话为 30 分钟）。
| 层级 | Claude 可以做什么 | 适用范围 |
|---|---|---|
| 仅查看 | 截图查看 | 浏览器、交易平台 |
| 仅点击 | 点击和滚动，不能输入 | 终端、IDE |
| 完全控制 | 点击、输入、拖拽、键盘快捷键 | 其他所有应用 |
在 Settings > General 中可配置：
- Denied apps：添加后直接拒绝，无需每次询问
- Unhide apps when Claude finishes：Claude 工作时会隐藏其他窗口，完成后恢复（可关闭）
管理会话
并行会话
从侧边栏打开多个会话，每个会话在独立的 Git worktree 中运行，互不干扰。在任务面板中监控子代理和后台命令。
侧边对话
按 Cmd+; 打开侧边对话，提问而不打断主线程。
云端运行长时间任务
将任务发送到云端，关闭应用后继续运行。使用 Remote 环境时，可添加多个仓库。
跨平台继续会话
如果任务比预期更长，可在 Web 端或 IDE 中继续当前会话。
Dispatch 会话
从手机通过 Dispatch 下发任务，Desktop 接收并在侧边栏中生成会话。
扩展 Claude Code
使用 Skills
输入 / 或点击 + → Slash commands，浏览内置命令、自定义 Skills 和插件 Skills。
连接外部工具
点击 + → Connectors 连接 GitHub、Slack、Linear 等服务，让 Claude 直接操作这些工具。
安装插件
点击 + → Plugins，浏览并安装插件——为 Claude 增加 Skills、Agents、MCP 服务器等。
配置预览服务器
服务器配置存储在 .claude/launch.json。Claude 基于项目自动生成初始配置，如需自定义可直接编辑。
launch.json 字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
name | string | 服务器显示名称，出现在 Preview 下拉菜单 |
runtimeExecutable | string | 运行服务器的可执行文件（如 npm、yarn、bun） |
runtimeArgs | string[] | 传给可执行文件的参数（如 ["run", "dev"]） |
port | number | 服务器端口 |
cwd | string | 相对于项目根目录的工作目录 |
env | object | 额外的环境变量键值对。不要放密钥（此文件会提交到仓库） |
autoPort | boolean | 端口冲突时的处理方式（见下） |
program | string | 用 node 直接运行的脚本 |
args | string[] | 传给 program 的参数 |
program 与 runtimeExecutable 的区别
runtimeExecutable+runtimeArgs：通过包管理器启动（如npm run dev）program：直接用node运行脚本（如node server.js）
端口冲突处理
true：自动找空闲端口（适合大多数开发服务器）false：端口占用时报错（OAuth 回调或 CORS 白名单需要固定端口时使用）- 不设置（默认）：询问是否需要特定端口，并保存你的回答
配置示例
Next.js（Yarn）：
json
{
"version": "0.0.1",
"configurations": [
{
"name": "web",
"runtimeExecutable": "yarn",
"runtimeArgs": ["dev"],
"port": 3000
}
]
}前后端多服务器：
json
{
"version": "0.0.1",
"configurations": [
{
"name": "frontend",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"cwd": "apps/web",
"port": 3000,
"autoPort": true
},
{
"name": "api",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "start"],
"cwd": "server",
"port": 8080,
"env": { "NODE_ENV": "development" },
"autoPort": false
}
]
}直接运行 Node.js 脚本：
json
{
"version": "0.0.1",
"configurations": [
{
"name": "server",
"program": "server.js",
"args": ["--verbose"],
"port": 4000
}
]
}环境配置
本地会话
Desktop 不总是继承完整的 shell 环境：
- macOS：从 Dock/Finder 启动时，读取 shell profile（
~/.zshrc/~/.bashrc）提取 PATH 和 Claude Code 变量，但其他 export 变量不会被读取 - Windows：继承用户和系统环境变量，但不读取 PowerShell profile
设置本地会话和开发服务器的环境变量：在提示框的环境下拉菜单中，悬停在 Local 上点击齿轮图标，打开本地环境编辑器。此处保存的变量加密存储在本机，应用于所有本地会话和预览服务器。
也可以在 ~/.claude/settings.json 的 env 键中添加变量，但这些变量只到达 Claude 会话，不应用于开发服务器。
禁用扩展思考：在本地环境编辑器中设置 MAX_THINKING_TOKENS=0。
远程会话
远程会话在 Anthropic 云端基础设施运行，关闭应用后继续。用量计入订阅计划限额。
选择环境下拉菜单时点击 Add environment 可创建带不同网络访问级别和环境变量的自定义云端环境。详见云端环境。
SSH 会话
通过 SSH 连接远程机器运行 Claude Code，Desktop 作为图形界面。适合操作存放在云 VM、开发容器或有特定硬件需求的服务器上的代码库。
添加 SSH 连接：点击环境下拉菜单，选择 + Add SSH connection，填写：
- Name：连接的友好名称
- SSH Host：
user@hostname或~/.ssh/config中的主机名 - SSH Port：默认 22，留空则从 SSH config 读取
- Identity File：私钥路径（如
~/.ssh/id_rsa），留空则使用默认密钥
远程机器须运行 Linux 或 macOS，且须已安装 Claude Code。SSH 会话支持权限模式、连接器、插件和 MCP 服务器。
企业配置
管理员控制台
在 admin settings console 中配置：
- Code in the desktop：控制用户是否可在 Desktop 中使用 Claude Code
- Code in the web：启用或禁用 Web 会话
- Remote Control：启用或禁用远程控制
- Disable Bypass permissions mode：禁止用户启用 Bypass 权限模式
托管设置
| 键 | 说明 |
|---|---|
permissions.disableBypassPermissionsMode | 设为 "disable" 禁止 Bypass 权限模式 |
disableAutoMode | 设为 "disable" 禁止 Auto 模式，从选择器中移除 |
autoMode | 自定义 Auto 模式分类器的信任和阻止规则 |
设备管理策略
IT 团队可通过 MDM（macOS）或组策略（Windows）管理 Desktop：
- macOS：通过
com.anthropic.Claude偏好域配置（Jamf/Kandji） - Windows：通过注册表
SOFTWARE\Policies\Claude配置
可用策略包括：启用/禁用 Claude Code 功能、控制自动更新、设置自定义部署 URL。
认证与 SSO
Enterprise 组织可要求所有用户使用 SSO。详见认证和配置 SSO。
企业部署
- macOS：通过 MDM（Jamf/Kandji）分发
.dmg安装包 - Windows：通过 MSIX 包或
.exe安装。详见 Deploy Claude Desktop for Windows
网络配置（代理、防火墙白名单、LLM 网关）见网络配置。
从 CLI 迁移？
Desktop 和 CLI 使用完全相同的底层引擎，可同时在同一项目上运行。各自保存独立的会话历史，但通过 CLAUDE.md 文件共享配置和项目记忆。
将 CLI 会话迁移到 Desktop：在终端运行 /desktop，Claude 保存会话后在 Desktop 中打开，然后退出 CLI（仅 macOS 和 Windows）。
CLI 标志对应关系
| CLI | Desktop 对应 |
|---|---|
--model sonnet | 发送按钮旁的模型下拉菜单 |
--resume, --continue | 点击侧边栏中的会话 |
--permission-mode | 发送按钮旁的模式选择器 |
--dangerously-skip-permissions | Bypass permissions 模式（Settings → Claude Code → 开启 "Allow bypass permissions mode"） |
--add-dir | 远程会话中用 + 按钮添加多个仓库 |
--allowedTools, --disallowedTools | Desktop 不可用 |
--verbose | Transcript view 下拉菜单中的 Verbose 模式 |
--print, --output-format | Desktop 不可用（Desktop 仅交互模式） |
ANTHROPIC_MODEL 环境变量 | 模型下拉菜单 |
MAX_THINKING_TOKENS 环境变量 | 本地环境编辑器中设置 |
共享配置
Desktop 和 CLI 读取同一套配置文件：
- CLAUDE.md 和
CLAUDE.local.md两者均使用 ~/.claude.json或.mcp.json中的 MCP 服务器两者均有效- Hooks 和 Skills 同样适用
~/.claude/settings.json中的设置（权限规则、允许的工具等）应用于 Desktop 会话- 模型（Sonnet/Opus/Haiku）两者都可用
功能对比
| 功能 | CLI | Desktop |
|---|---|---|
| 权限模式 | 全部模式含 dontAsk | Ask/Auto accept/Plan/Auto/Bypass |
--dangerously-skip-permissions | CLI 标志 | Settings 中的 Bypass permissions 模式 |
| 第三方云（Bedrock/Vertex/Foundry） | 支持 | 默认 Anthropic API，企业部署可配置 |
| MCP 服务器 | 设置文件 | 本地/SSH 会话用连接器 UI 或设置文件 |
| 插件 | /plugin 命令 | 插件管理器 UI |
| @mention 文件 | 文本方式 | 带自动补全（仅本地/SSH） |
| 文件附件 | 不可用 | 图片、PDF |
| 会话隔离 | --worktree 标志 | 自动 worktree |
| 多会话 | 多个终端 | 侧边栏标签页 |
| 定时任务 | Cron 任务/CI 流水线 | 定时任务 |
| 计算机使用 | macOS via /mcp | macOS 和 Windows |
| 脚本/自动化 | --print/Agent SDK | 不可用 |
Desktop 中不可用的功能
- 第三方云：CLI 中用
--model和 Bedrock/Foundry 参数 - Linux：Desktop 仅支持 macOS 和 Windows
- 内联代码建议：Desktop 通过对话和显式代码变更工作
- Agent Teams：多代理编排通过 CLI 和 Agent SDK 使用
故障排查
查看版本
- macOS：菜单栏点击 Claude → About Claude
- Windows：点击 Help → About
Code 标签页 403 或认证错误
- 从应用菜单退出并重新登录（最常见的修复方法）
- 确认有有效的付费订阅（Pro、Max、Team 或 Enterprise）
- 完全退出应用（不只是关闭窗口），重新打开并登录
启动后空白或卡死
- 重启应用
- 检查是否有待更新项
- Windows：在事件查看器 → Windows 日志 → 应用程序 中查看崩溃日志
"Failed to load session"
选择的文件夹可能不存在、Git 仓库需要未安装的 Git LFS、或文件权限问题。尝试选择其他文件夹或重启应用。
Claude 找不到已安装的工具
确认工具在普通终端中可用；检查 shell profile 是否正确设置了 PATH；重启 Desktop 以重载环境变量。
Git 和 Git LFS 错误
Windows：Code 标签页本地会话需要 Git——安装 Git for Windows 后重启。Git LFS 错误：安装 Git LFS，运行 git lfs install，重启应用。
Windows：MCP 服务器无响应
检查设置中的服务器配置；重启应用；在任务管理器中确认服务器进程正在运行；查看服务器日志。
应用无法退出
- macOS：Cmd+Q；无响应则 Cmd+Option+Esc 强制退出
- Windows：Ctrl+Shift+Esc 打开任务管理器，结束 Claude 进程
Windows 特有问题
- 安装后 PATH 未更新：开启新终端窗口（PATH 更新只对新会话生效）
- 并发安装错误：以管理员身份运行安装程序
- ARM64：完全支持
Intel Mac 的 Cowork 标签页不可用
Cowork 标签页在 macOS 上需要 Apple Silicon（M1 或更新）。Chat 和 Code 标签页在 Intel Mac 上正常工作。
相关文档
常见问题
Q: Desktop 和 CLI 可以同时在同一项目上运行吗？
可以。两者使用同一底层引擎，共享 CLAUDE.md 配置文件。各自保存独立的会话历史，但配置完全互通。在终端运行 /desktop 可将 CLI 会话迁移到 Desktop。
Q: Remote 会话的费用如何计算？
远程会话用量计入订阅计划限额，没有额外的计算费用。详见成本管理。
Q: 计算机使用功能如何保证安全？
计算机使用按应用分层级授权，浏览器和终端等广泛访问的应用只能点击不能输入，防止意外操作。每次批准仅对当前会话有效。企业管理员可通过托管设置进一步限制。