Claude Code Desktop 的 Code 标签页在标准 Claude Code 体验之上增加了可视化 Diff 审查、应用实时预览、GitHub PR 监控(自动修复/合并)、Git Worktree 隔离的并行会话和持久化定时任务等高级功能。
开始一个会话(四项配置)
发送第一条消息前,在提示区配置四项:
| 配置项 | 选项 | 说明 |
|---|---|---|
| 环境 | Local / Remote / SSH | Local = 本机;Remote = Anthropic 云端(关闭 App 继续运行);SSH = 你管理的远程机器 |
| 项目目录 | 选择文件夹 | Remote 模式可添加多个仓库 |
| 模型 | 下拉选择 | 会话开始后锁定,不可更换 |
| 权限模式 | Ask / Auto accept / Plan / Bypass | 会话中随时可切换 |
四种权限模式
| 模式 | Settings Key | 说明 |
|---|---|---|
| Ask permissions | default | 每次操作询问,看到 Diff 后再接受/拒绝(新用户推荐) |
| Auto accept edits | acceptEdits | 自动接受文件编辑,仍询问终端命令 |
| Plan mode | plan | 只分析规划,不修改文件(适合复杂任务前评估) |
| Bypass permissions | bypassPermissions | 无任何权限提示(等同 CLI --dangerously-skip-permissions,仅在沙箱容器内使用) |
推荐工作流:先 Plan mode 审查方案 → 批准后切到 Auto accept edits 执行
应用预览(Preview)
Claude 编辑项目文件后自动启动开发服务器,嵌入式浏览器直接展示:
- Claude 自动验证变更:截图、检查 DOM、点击元素、填写表单,发现问题自动修复
- Preview 下拉菜单:启动/停止服务器;开启 Persist sessions(保留 Cookie/localStorage,避免反复登录)
- 自定义开发服务器命令:编辑
.claude/launch.json
可视化 Diff 审查与代码 Review
Diff 审查:
- Claude 修改文件后出现
+12 -1指示器 - 点击打开 Diff 视图,左侧文件列表,右侧对比内容
- 点击任意行添加注释,
Cmd+Enter(Mac)/Ctrl+Enter(Win)一次提交所有注释 - Claude 读取注释并修订
代码 Review:点击 Diff 视图右上角 Review code,Claude 自动检查并留下内联建议。
- 聚焦高信号问题:编译错误、逻辑错误、安全漏洞、明显 Bug
- 不标记风格/格式/Linter 问题/已有问题
GitHub PR 监控(需要 gh CLI)
开启 PR 后,CI 状态栏自动出现:
| 功能 | 说明 |
|---|---|
| Auto-fix | 开启后,Claude 读取失败 CI 输出并自动修复 |
| Auto-merge | 所有检查通过后自动合并(squash merge;需在 GitHub 仓库设置中开启 auto-merge) |
CI 完成时发送桌面通知。需要安装并认证 GitHub CLI (gh)。
并行会话(Git Worktree 隔离)
点击侧边栏 + New session,每个会话自动获得独立的 Git Worktree:
- Worktree 存储在
<project-root>/.claude/worktrees/(可在设置中更改) - 可设置分支前缀,统一管理 Claude 创建的分支
- 各会话修改互不干扰,Commit 后合并
- 完成后悬停会话点击归档图标删除 Worktree
筛选会话:点击侧边栏过滤图标,按状态(Active/Archived)和环境(Local/Cloud)筛选。
远程会话(云端 VM)
大规模重构、测试套件、数据迁移等长时间任务:
- 选择 Remote 环境,在 Anthropic 云端基础设施运行
- 关闭 App 或关机后继续运行
- 可从 claude.ai/code 或 Claude iOS App 监控进度
- Remote 模式支持添加多个仓库(点击 repo pill 旁的 +)
SSH 会话
连接你自己管理的远程机器:选择 SSH connection 环境,配置 SSH 主机信息。
定时任务(持久化,Desktop 专属)
不同于会话级 /loop,Desktop 定时任务跨会话持久:
- 在 Settings → Claude Code 中设置
- 支持频率:每天/每周/每两周/每月/自定义 Cron
- 错过执行时:下次 App 打开后执行
- 权限:默认 Auto accept edits;定时任务不支持 Ask permissions
企业配置
| 功能 | 说明 |
|---|---|
| Admin console 控制 | 限制权限模式(如禁用 Bypass permissions)、控制连接器访问 |
| Managed settings | 通过 Server-managed settings 或 MDM 统一下发配置 |
| 设备管理策略 | macOS MDM plist / Windows 注册表策略 |
| SSO 认证 | Enterprise 计划支持 SAML/OIDC 单点登录 |
常见问题排查
| 问题 | 解决方案 |
|---|---|
| 403 / 认证错误(Code 标签) | 退出并重新登录;确认组织账号权限 |
| 启动时白屏或卡住 | 检查版本更新;完全退出后重启 |
| 「Failed to load session」 | 检查项目目录权限;确认 Git 已初始化 |
| 会话找不到已安装工具 | 配置 .claude/launch.json 中的环境变量路径 |
| MCP 服务器在 Windows 不工作 | 检查 node 路径配置 |
| App 无法退出 | 在系统活动监视器强制结束进程 |
| Cowork 标签在 Intel Mac 不可用 | Cowork 需要 Apple Silicon Mac |
原文:Use Claude Code Desktop - Claude Code Docs | 来源:Anthropic 官方文档