Appearance
桌面应用完整指南
Claude Desktop 的 Code 标签页提供了图形化的 Claude Code 体验，无需终端。
桌面应用在标准 Claude Code 功能之上额外提供：
- 可视化 Diff 查看与内联注释
- 实时应用预览（内嵌浏览器 + 开发服务器）
- 计算机使用（macOS 专属）：打开应用、控制屏幕
- GitHub PR 监控，支持自动修复和自动合并
- 并行会话（自动 Git worktree 隔离）
- Dispatch 集成：从手机下发任务，Desktop 接收并执行
- 定时任务（本地和云端）
- GitHub、Slack、Linear 等连接器
初次使用桌面应用？请先阅读 桌面应用快速入门 了解安装和第一次会话。
开始一次会话
发送第一条消息前，需要在提示框区域配置以下四项：
| 配置项 | 说明 |
|---|---|
| 环境 | Local（本机）、Remote（Anthropic 云）或 SSH（远程服务器） |
| 项目目录 | 选择 Claude 工作的目录或仓库 |
| 模型 | 从下拉菜单选择，会话开始后不可切换 |
| 权限模式 | 控制 Claude 的自主程度，可在会话中随时切换 |
代码操作
使用提示框
输入任务后按 Enter 发送。根据你的权限模式，Claude 会读取文件、进行修改、运行命令。随时可以打断：点击停止按钮或输入修正意见后按 Enter，Claude 会立即停下并调整。
提示框旁的 + 按钮提供文件附件、Skills、连接器和插件的入口。
引用文件的方式：
@文件名— 将特定文件添加到对话上下文- 附件按钮 — 上传图片、PDF 等文件
- 拖放 — 直接把文件拖到提示框
权限模式
| 模式 | 行为 |
|---|---|
| Ask permissions（默认） | 编辑文件或运行命令前询问确认，推荐新用户使用 |
| Auto accept edits | 自动接受文件编辑，仍询问终端命令，适合信任 Claude 改动时 |
| Plan mode | 仅分析和规划，不修改文件，适合大型重构前审查方案 |
| Bypass permissions | 跳过所有权限提示（高危，仅限沙箱容器/虚拟机使用） |
最佳实践：复杂任务先用 Plan mode 让 Claude 规划方案，审批后切换到 Auto accept edits 执行。
实时应用预览
Claude 可以启动开发服务器并打开内嵌浏览器验证改动，支持前端和后端项目：
- 在内嵌浏览器中直接与运行中的应用交互
- 观察 Claude 自动验证：截图、检查 DOM、点击元素、填写表单
- 从 Preview 下拉菜单启动或停止服务器
- 启用 Persist sessions 跨重启保持 Cookie 和本地存储
服务器配置存储在项目根目录的 .claude/launch.json：
json
{
"version": "0.0.1",
"configurations": [
{
"name": "web",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"port": 3000
}
]
}多服务器示例（前端 + API）：
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,
"autoPort": false
}
]
}autoPort 字段说明：
true：端口冲突时自动寻找空闲端口false：端口冲突时报错（需要固定端口时使用）- 未设置（默认）：询问用户并记住选择
查看 Diff
Claude 修改文件后，会出现 +12 -1 样式的指示器，点击打开 Diff 视图：
- 左侧文件列表，右侧显示每个文件的变更
- 点击任意行添加注释，按 Cmd+Enter（macOS）或 Ctrl+Enter（Windows）提交所有注释
- Claude 读取注释后修改，产生新的 Diff 供你审查
点击 Diff 视图右上角的 Review code 按钮，让 Claude 自我评估变更并留下内联建议（关注编译错误、逻辑错误、安全漏洞等高信号问题）。
监控 Pull Request
打开 PR 后，会话中会出现 CI 状态栏：
- Auto-fix：自动修复失败的 CI 检查
- Auto-merge：所有检查通过后自动合并 PR（需在 GitHub 仓库设置中启用 Auto-merge）
PR 监控需要安装并认证 GitHub CLI (
gh)。
计算机使用（macOS 专属）
计算机使用让 Claude 打开应用、控制屏幕，像用户一样直接在桌面操作。适合测试 iOS 模拟器、操作没有 CLI 的桌面工具等场景。
注意：计算机使用为 macOS 研究预览功能，需要 Pro 或 Max 计划，不支持 Team 或 Enterprise 计划。
计算机使用默认关闭。在 Settings > Desktop app > General 中开启，并授予以下 macOS 权限：
- Accessibility：允许 Claude 点击、输入和滚动
- Screen Recording：允许 Claude 查看屏幕内容
应用权限级别
Claude 首次使用某个应用时会弹出权限提示，权限级别按应用类别固定：
| 级别 | 可以做什么 | 适用范围 |
|---|---|---|
| 仅查看 | 截图查看应用 | 浏览器、交易平台 |
| 仅点击 | 点击和滚动，不能输入 | 终端、IDE |
| 完全控制 | 点击、输入、拖拽、快捷键 | 其他所有应用 |
管理会话
并行会话
点击侧边栏的 + New session 并行处理多个任务。对 Git 仓库，每个会话在独立的 Git worktree（<project-root>/.claude/worktrees/）中运行，互不干扰。
并行会话需要安装 Git。Windows 用户需要安装 Git for Windows。
远程运行长任务
选择 Remote 环境，任务在 Anthropic 云基础设施上运行，关闭应用或关机后仍然继续。支持添加多个仓库到一次云端会话。
在不同界面切换
通过会话工具栏右下角的 Continue in 菜单，可以将会话迁移到：
- Claude Code on the Web：推送本地分支，在云端继续
- 你的 IDE：在当前工作目录打开项目
Dispatch 集成
通过 Cowork 标签页的 Dispatch 功能，可以从手机发送任务，Code 标签页自动创建会话。适合以下任务：修复 Bug、更新依赖、运行测试、开 PR。
扩展 Claude Code
连接外部工具（连接器）
点击 + 按钮 → Connectors，添加 Google Calendar、Slack、GitHub、Linear、Notion 等集成。连接后 Claude 可以直接读取日历、发送消息、创建 Issue 等。
连接器本质上是 MCP 服务器的图形化配置，更多自定义集成请参考 MCP 文档。
使用 Skills
输入 / 或点击 + → Slash commands 浏览可用命令，包括内置命令、自定义 Skills、项目 Skills 和插件 Skills。
安装插件
点击 + → Plugins，从官方 Anthropic 插件市场或配置的其他市场安装插件。插件提供 Skills、代理、Hooks、MCP 服务器等扩展能力。
定时任务
定时任务让 Claude 自动定期工作，无需手动触发。
三种调度方式对比
| 云端任务 | 桌面任务 | /loop | |
|---|---|---|---|
| 运行位置 | Anthropic 云 | 你的机器 | 你的机器 |
| 关机后继续 | ✓ | ✗ | ✗ |
| 需要打开会话 | ✗ | ✗ | ✓ |
| 访问本地文件 | ✗（全新克隆） | ✓ | ✓ |
| 最短间隔 | 1 小时 | 1 分钟 | 1 分钟 |
创建桌面定时任务
点击侧边栏的 Schedule → New task → New local task：
| 字段 | 说明 |
|---|---|
| Name | 任务名称，会转为 kebab-case 用作目录名 |
| Description | 显示在任务列表中的简短描述 |
| Prompt | 任务运行时发送给 Claude 的指令 |
| Frequency | 运行频率：手动/每小时/每天/工作日/每周 |
频率选项：
- Manual：不自动运行，仅手动触发
- Hourly：每小时运行
- Daily：每天特定时间
- Weekdays：工作日每天运行
- Weekly：每周特定日期和时间
更复杂的调度（如每 15 分钟、每月第一天）可以直接用自然语言告诉 Claude。
注意事项
- 定时任务仅在桌面应用运行且电脑唤醒时执行
- 电脑睡眠期间跳过的任务，唤醒后只补跑一次（最近的那次）
- 关机后需要运行的任务，请使用云端任务
企业配置
企业管理员可以通过托管设置限制可用的权限模式，具体参见 权限配置。