教程

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 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 MCP 完整使用指南:安装配置主流 MCP 服务器扩展 AI 能力Claude Code MCP(Model Context Protocol)完整使用指南:MCP 是什么(AI 工具扩展标准)、claude mcp 命令管理服务器(add/remove/list)、主流 MCP 服务器安装配置(文件系统/GitHub/PostgreSQL/Brave Search/Slack)、本地 stdio 与远程 SSE 两种连接方式、MCP 服务器安全配置、在 CLAUDE.md 中声明 MCP 工具使用规范,以及自定义 MCP 服务器的快速开发入门。2026/3/18教程Claude Code 输出格式控制完全指南:JSON、流式、结构化输出使用方法Claude Code 和 Claude API 输出格式完整控制指南:--output-format 参数(text/json/stream-json)、非交互模式(-p)的输出控制、结构化 JSON 输出(--json-schema 字段约束)、流式输出(Server-Sent Events)的处理方式、include-partial-messages 流式渐进显示、以及 CI/CD 管道中解析 JSON 输出的实用技巧。2026/3/18教程Claude Code 项目初始化最佳实践:新项目 5 分钟搭建完美 AI 编程环境Claude Code 新项目最佳初始化流程:CLAUDE.md 标准模板(项目背景/技术栈/代码规范/禁止操作)、.claudeignore 初始配置、.claude/commands/ 常用命令预置、settings.json 权限与模型设置、--init 命令的自动化初始化、项目级 vs 全局配置的优先级说明,以及不同类型项目(Web前端/后端API/全栈/开源库)的专项初始化模板。2026/3/18教程Claude Code 权限管理完全指南:精确控制 AI 能执行哪些操作Claude Code 权限系统完整解析:四种权限模式(default/acceptEdits/bypassPermissions/plan)、--allowedTools 和 --disallowedTools 精确工具控制、Bash 命令白名单语法(通配符匹配)、settings.json 持久化权限配置、CLAUDE.md 中的权限规则声明、CI/CD 自动化场景的权限配置、以及如何在效率和安全之间找到平衡点。2026/3/18