教程

Claude Code Desktop 深度使用指南:并行 Git Worktree、CI/PR 监控、应用预览与企业配置

Claude Code Desktop 深度指南:开始会话四项配置(环境 Local/Remote/SSH/模型/权限模式)、四种权限模式对比(Ask/Auto accept/Plan/Bypass 及推荐工作流)、应用预览(自动验证/持久化 Cookie/launch.json 配置)、可视化 Diff 审查(注释+Cmd+Enter 批量提交)和代码 Review(高信号问题聚焦)、GitHub PR 监控(Auto-fix/Auto-merge/gh CLI 要求)、并行 Git Worktree 会话(独立隔离/分支前缀/设置更改 Worktree 路径)、远程云端会话(关机继续/多仓库/iOS App 监控)、SSH 会话、Desktop 持久定时任务(跨会话/频率/错过执行策略),以及企业配置(Admin 控制/MDM/SSO)和常见问题排查。

2026/3/85分钟 阅读ClaudeEagle

Claude Code Desktop 的 Code 标签页在标准 Claude Code 体验之上增加了可视化 Diff 审查、应用实时预览、GitHub PR 监控(自动修复/合并)、Git Worktree 隔离的并行会话和持久化定时任务等高级功能。

开始一个会话(四项配置)

发送第一条消息前,在提示区配置四项:

配置项选项说明
环境Local / Remote / SSHLocal = 本机;Remote = Anthropic 云端(关闭 App 继续运行);SSH = 你管理的远程机器
项目目录选择文件夹Remote 模式可添加多个仓库
模型下拉选择会话开始后锁定,不可更换
权限模式Ask / Auto accept / Plan / Bypass会话中随时可切换

四种权限模式

模式Settings Key说明
Ask permissionsdefault每次操作询问,看到 Diff 后再接受/拒绝(新用户推荐)
Auto accept editsacceptEdits自动接受文件编辑,仍询问终端命令
Plan modeplan只分析规划,不修改文件(适合复杂任务前评估)
Bypass permissionsbypassPermissions无任何权限提示(等同 CLI --dangerously-skip-permissions,仅在沙箱容器内使用)

推荐工作流:先 Plan mode 审查方案 → 批准后切到 Auto accept edits 执行

应用预览(Preview)

Claude 编辑项目文件后自动启动开发服务器,嵌入式浏览器直接展示:

  • Claude 自动验证变更:截图、检查 DOM、点击元素、填写表单,发现问题自动修复
  • Preview 下拉菜单:启动/停止服务器;开启 Persist sessions(保留 Cookie/localStorage,避免反复登录)
  • 自定义开发服务器命令:编辑 .claude/launch.json

可视化 Diff 审查与代码 Review

Diff 审查

  1. Claude 修改文件后出现 +12 -1 指示器
  2. 点击打开 Diff 视图,左侧文件列表,右侧对比内容
  3. 点击任意行添加注释,Cmd+Enter(Mac)/ Ctrl+Enter(Win)一次提交所有注释
  4. 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 官方文档

相关文章推荐

教程Claude Code Desktop 定时任务完全指南:自动化每日代码审查、依赖更新和晨报Claude Code Desktop 定时任务完整教程:支持每日代码审查、依赖更新检查、晨报生成等自动化工作流。含三种定时方案对比、配置方法和实用场景示例。2026/4/7教程Claude Code Fast Mode 深度解析:2.5x 速度提升、定价、速率限制回退与企业 per-session 控制Claude Code Fast Mode 完整指南:2.5 倍速度提升原理(相同 Opus 4.6/不同 API 配置)、/fast 开关命令(自动切换到 Opus 4.6/↯ 图标/跨会话持久)、定价(<200K $30/$150;>200K $60/$225)、会话中途开启的成本影响(整段历史按 Fast Mode 价格)及最佳实践(会话开始时启用)、Fast Mode vs Effort Level 对比(组合使用最高速度)、适用和不适用场景、三大使用要求(账号类型/Extra Usage/平台限制 Bedrock 不支持)、企业配置(Console 启用/DISABLE_FAST_MODE 禁用/fastModePerSessionOptIn per-session 控制),以及速率限制自动回退机制(↯ 变灰/冷却后自动重启)。2026/3/9教程Claude Code Desktop 桌面应用快速入门:图形界面、三大标签页与并行会话详解Claude Code Desktop 桌面应用快速入门:三大标签页概览(Chat/Cowork/Code 功能对比)、macOS/Windows 下载地址(内置 Claude Code 无需安装 Node.js)、4 步开始第一个 Code 会话(选项目/下任务/审查 Diff)、七大核心功能(中断引导/@文件引用/三种权限模式/Diff 视图审查/实时应用预览/PR 监控自动合并/定时任务/并行会话/插件安装/外部工具连接),以及与 CLI 共用同一套引擎、共享 CLAUDE.md/MCP/Hooks/Skills/Settings 配置的关系说明。2026/3/8教程Claude Code Skills 进阶:动态上下文注入、路径限定激活和 Subagent 集成深度指南Claude Code Skills 三个高级特性深度指南:动态上下文注入(!! 命令预处理原理、内联和多行语法、实战健康检查 Skill 含 6 个命令块、安全注意事项);路径限定自动激活(TypeScript 严格模式/SQL 安全/React 组件三个实战示例);context: fork 在 Subagent 运行(适用场景判断、agent 类型选择);以及三种特性组合的完整 PR 审查 Skill 示例。2026/5/10教程Claude Code Skills 官方完整指南:从入门到高级模式的权威教程Claude Code Skills 官方文档完整中文整理:Skills vs CLAUDE.md 核心区别;目录结构;存储位置和优先级;实时变更检测和 Monorepo 自动发现;完整 Frontmatter 字段参考(20+字段);字符串替换(动态参数);内容类型(参考类 vs 任务类);调用控制表;Skill 内容生命周期(压缩保留机制);三个高级模式(动态注入/路径限定/Subagent运行);以及内置 Bundled Skills 和权限控制方法。2026/5/10教程Claude Code Slack 集成完整指南:团队协作、CI 通知和权限管理Claude Code Slack 集成完整指南:5 大核心功能(频道触发任务/代码问答/CI 通知/PR 审查/Routines 结果推送);安装配置步骤;4 个权限等级(read/write/execute/pr)及频道级配置;人工审批工作流;GitHub Actions + Slack 通知自动化;4 个团队协作场景(新人上手/PM 提需求/频道分工规范/结构化请求模板);以及官方 Slack 集成 vs OpenClaw 方案的对比。2026/5/8