Claude Code Desktop：图形界面下的AI编程助手完全指南

如果你已经听说过 Claude Code 这个能直接改代码、跑命令、修 bug 的 AI 编程工具那你可能会好奇它只能待在终端里吗答案是否定的。Anthropic 推出的 Claude Code Desktop 把同样的能力搬到了图形界面里而且加了不少终端里做不到的东西。这篇文章会从头到尾梳理 Claude Code Desktop 能做什么、怎么用以及它和命令行版本有什么不同。从终端到窗口Desktop 版做了什么Claude Code 原本是一个命令行工具开发者可以在终端里跟它对话让它读取项目文件、修改代码、运行测试。Desktop 版的出现等于给这个引擎套上了一个图形外壳——在 Claude 桌面应用的“Code”标签页里用户可以用熟悉的聊天界面来指挥 Claude 写代码。更重要的是Desktop 版额外加了一堆终端里没有的功能可视化的 diff 审阅、实时应用预览、Mac 上的屏幕控制、GitHub PR 的自动修复和合并、并行会话自动隔离、手机端通过 Dispatch 下发任务、定时任务以及各种第三方服务的连接器。换句话说Desktop 版不是简单地把终端功能搬了个家而是补齐了图形界面特有的交互体验。开始一次会话先选好四个东西在敲下第一条消息之前用户需要先在输入框附近确认四个设置环境选择代码跑在哪里。可以是本机Local也可以是 Anthropic 托管的云端Remote或者通过 SSH 连到自己的远程机器。项目文件夹告诉 Claude 要操作哪个目录或代码仓库。如果是远程会话还能一次添加多个仓库。模型从下拉菜单里挑一个模型会话开始后就不能换了。权限模式决定 Claude 有多少自主权。这个可以在会话过程中随时改。选好之后输入任务按回车一个独立的会话就开始了。每个会话都有自己的上下文和修改记录互不干扰。跟 Claude 一起写代码怎么发指令在输入框里打字按回车发送。Claude 会读取项目文件、做修改、跑命令——具体做到什么程度取决于当前选的权限模式。用户随时可以打断 Claude点一下停止按钮或者直接输入纠正的话按回车Claude 就会停下来按新指令调整。输入框旁边有个按钮点开可以挂载文件附件、调用技能skills、连接外部服务或者安装插件。给 Claude 喂上下文两种方式可以把外部信息塞给 Claude 提及文件输入加上文件名就把那个文件加到对话上下文里了远程会话不支持这个。附加文件点附件按钮或者直接拖拽可以上传图片、PDF 等文件。用来贴 bug 截图、设计稿或者参考文档都很方便。四种权限模式对应不同的信任程度权限模式决定了 Claude 动手之前要不要问一声模式行为Ask permissions默认改文件或跑命令之前都会弹窗询问用户可以看到差异diff后选择接受或拒绝。推荐新用户使用。Auto accept edits改文件自动接受但跑命令前仍然询问。适合信任文件改动、想加快迭代速度的场景。Plan mode只分析代码、制定计划不修改文件也不跑命令。复杂任务先走一遍思路再动手。Auto实验性功能后台做安全检查减少询问次数。需要 Sonnet 4.6 或 Opus 4.6Team/Enterprise/API 计划可用。Bypass permissions彻底跳过所有权限提示相当于命令行的--dangerously-skip-permissions。只能在沙盒或虚拟机里用企业管理员可以禁用。一个推荐的工作流是复杂任务先用 Plan mode 让 Claude 出方案审阅通过后切到 Auto accept edits 或 Ask permissions 执行。远程会话只支持 Auto accept edits 和 Plan mode。实时预览应用Claude 可以自己启动开发服务器然后在内嵌浏览器里打开预览。不管是前端网页还是后端 APIClaude 改完代码后通常会自动启动服务。用户也可以随时主动要求预览。预览面板里能干的事不少直接在内嵌浏览器里操作正在运行的应用观察 Claude 自动验证自己的改动——它会截图、检查 DOM、点击元素、填表单发现问题还会自己修从会话工具栏的预览下拉菜单里启停服务器勾选“Persist sessions”让 cookies 和本地存储在服务器重启后保留开发时不用反复登录如果项目的启动命令比较特殊可以编辑.claude/launch.json来定制Diff 审阅逐行看改动Claude 改完代码后界面上会显示一个类似12 -1的统计标签点开就能进 diff 查看器。左边是文件列表右边是每个文件的具体改动。用户可以在任意一行上点一下弹出评论框写反馈按回车添加评论。写完全部的评论后按CmdEnterMac或CtrlEnterWindows一次性提交。Claude 读到这些评论后会按意见修改产生新的 diff 供再次审阅。代码审阅按钮在 diff 界面的右上角有个“Review code”按钮。点一下Claude 会审视当前的所有改动然后在 diff 视图里直接留下评论。它主要关注高价值的问题编译错误、明确的逻辑漏洞、安全缺陷、明显的 bug。不会纠结代码风格、格式、已有的老问题或者 linter 能抓出来的东西。监控 PR 状态打开 Pull Request 之后会话里会出现一个 CI 状态栏。Claude Code 用 GitHub CLI 去轮询检查结果如果失败了开启Auto-fix后Claude 会读失败日志并尝试自动修复开启Auto-merge后所有检查通过时 Claude 会用 squash 方式合并 PR前提是 GitHub 仓库设置里也开了 auto-mergePR 监控需要本机装了gh并完成认证。没装的话桌面应用会提示安装。让 Claude 直接操作电脑这是 Desktop 版一个相当硬核的功能——Computer Use目前只在 macOS 上提供需要 Pro 或 Max 计划。开启后Claude 可以打开应用、控制屏幕、像真人一样操作图形界面。比如让 Claude 在 iOS 模拟器里测原生应用、操作一个没有命令行的桌面工具或者自动化某个只有 GUI 才能干的事。Computer Use 默认关闭。要打开它先去设置里找到开关然后授予两个 macOS 系统权限——辅助功能允许点击、打字、滚动和屏幕录制允许看到屏幕内容。这两个权限缺一不可。什么时候会用到 Computer UseClaude 有多种方式跟外部世界交互Computer Use 是范围最广、速度最慢的那个。它会按优先级选最精确的工具如果某个服务已经有连接器connector就用连接器如果任务是 shell 命令就用 Bash如果是浏览器操作而且配置了 Claude in Chrome就用那个以上都不行才动用 Computer Use每个应用还有访问级别浏览器只能“仅查看”终端和 IDE 只能“仅点击”其他应用才是“完全控制”。这套设计让 Claude 在有专用工具时优先走专用通道只有遇到原生应用、硬件控制面板、iOS 模拟器、没有 API 的专有工具时才用屏幕控制。应用权限弹窗Claude 第一次需要操作某个应用时会话里会弹一个授权窗。用户可以选择“Allow for this session”或“Deny”。批准的有效期是当前会话在 Dispatch 生成的会话里是 30 分钟。对于 Terminal、Finder、System Settings 这类能触及系统底层的应用授权弹窗里会有额外的警告提示。用户可以在设置里把某些应用加入“拒绝列表”以后就不弹窗了。还有一个选项叫“Unhide apps when Claude finishes”——Claude 干活时会隐藏其他窗口只跟被授权的应用交互干完后可以把隐藏的窗口恢复。会话管理并行、远程、从手机发起并行会话与 Git 隔离点侧边栏的“ New session”就可以并行处理多个任务。对于 Git 仓库每个会话会用自己的 Git worktree 获得一份隔离的项目副本——这意味着一个会话里改的文件不会影响到另一个直到提交为止。这些 worktree 默认存在.claude/worktrees/下可以在设置里改位置。用完后悬停在会话上点归档图标就能删掉 worktree。如果项目里有些被 gitignore 的文件比如.env也需要复制到新 worktree可以在项目根目录放一个.worktreeinclude文件。会话隔离依赖 Git。Mac 通常自带Windows 需要手动装 Git for Windows。侧边栏顶部可以用过滤器按状态活跃/归档和环境本地/云端筛选会话。点击会话标题可以重命名或查看上下文用量。当上下文快满的时候Claude 会自动总结对话并继续工作用户也可以手动输入/compact提前触发压缩。远程会话关掉电脑也能跑对于大规模重构、跑全套测试、数据迁移这类耗时任务启动会话时选“Remote”而不是“Local”。远程会话跑在 Anthropic 的云基础设施上即使关掉桌面应用甚至关机它还在后台继续跑。用户可以随时回来查看进度或调整方向也可以在 claude.ai/code 或 iOS 应用里监控。远程会话还支持多个仓库选好云环境后点仓库标签旁的按钮就能添加更多仓库每个仓库有自己的分支选择器。适合那些需要同时改多个代码库的任务比如更新一个共享库以及所有依赖它的项目。从手机发起会话Dispatch 集成Cowork 标签页里的 Dispatch 是一个持久的对话。用户给 Dispatch 发一条任务它自己决定怎么处理。任务可能以两种方式变成 Code 会话一是用户明确说“开一个 Claude Code 会话修登录 bug”二是 Dispatch 判断这个任务属于开发工作修 bug、更新依赖、跑测试、开 PR 等就自动生成一个 Code 会话。生成的 Code 会话会在侧边栏显示一个 Dispatch 徽章手机端会收到推送通知——完成或者需要批准时都会推。如果开启了 Computer UseDispatch 生成的 Code 会话也能用但应用授权的有效期只有 30 分钟不像普通 Code 会话那样持续整个会话。Dispatch 需要 Pro 或 Max 计划Team 和 Enterprise 不可用。换到另一个环境继续会话工具栏右下角有个 VS Code 图标点开“Continue in”菜单可以把当前会话挪到别的地方Claude Code on the Web把本地会话变成远程会话继续跑。桌面应用会推送分支、生成对话摘要、创建带完整上下文的远程会话然后用户可以选择归档本地会话或保留它。要求工作区干净不支持 SSH 会话。IDE在受支持的 IDE 里打开当前项目目录。扩展 Claude Code连接外部工具本地和 SSH 会话里点输入框旁的按钮选“Connectors”可以添加 Google Calendar、Slack、GitHub、Linear、Notion 等集成。可以在会话开始前或进行中添加。连接后 Claude 能读日历、发消息、建 issue直接跟这些工具交互。Connectors 本质上是带图形化配置界面的 MCP 服务器。如果需要的服务不在列表里也可以手动添加 MCP 服务器或者自己写一个。技能技能skills扩展了 Claude 的能力。Claude 会在相关时自动加载技能用户也可以主动调用在输入框里敲/或者点按钮选“Slash commands”浏览可用的内置命令、自定义技能、项目技能和插件里的技能。选中一个后会高亮显示在后面继续输入任务就行。插件插件是包含技能、代理、钩子、MCP 服务器和 LSP 配置的可复用包。本地和 SSH 会话里点选“Plugins”可以查看已安装的插件和它们的命令。选“Add plugin”打开插件浏览器从已配置的市场包括官方 Anthropic 市场里安装。选“Manage plugins”可以启用、禁用或卸载。插件可以作用域到用户账户、某个项目或者仅限本地。远程会话不支持插件。配置预览服务器Claude 会自动探测开发服务器的配置并存到项目根目录的.claude/launch.json里。预览功能把这个文件夹作为工作目录所以如果启动会话时选的是父文件夹子文件夹里的 dev server 不会被自动发现——要么直接在子文件夹开会话要么手动配一下。配置文件支持 JSON 带注释例如{version:0.0.1,configurations:[{name:my-app,runtimeExecutable:npm,runtimeArgs:[run,dev],port:3000}]}autoVerify默认打开Claude 改完代码后会自动截图、检查错误、确认改动有效。可以关掉——在launch.json里加autoVerify: false或者从预览下拉菜单里关。配置项里还有autoPort控制端口冲突时的行为true时自动找空闲端口false时直接报错不设置则询问用户。定时任务定时任务让 Claude 按设定的时间自动开启新会话。可以用来做每日代码审查、定期检查依赖更新、或者早上的简报从日历和邮箱拉数据。两种定时任务类型运行位置需要电脑开机访问本地文件权限弹窗本地任务本机是是可配置云端任务Anthropic 云否否每次全新克隆仓库无完全自主本地任务要求桌面应用开着、电脑醒着。如果电脑在预定时间睡着了那次运行会被跳过。可以在设置里开“Keep computer awake”防止空闲休眠但合上盖子仍然会睡。云端任务跑在 Anthropic 的基础设施上电脑关机也不影响但每次都是针对仓库的新鲜克隆没有本地未提交的改动。创建和配置在侧边栏点“Schedule”-“New task”-“New local task”填几个字段名称、简短描述、Prompt跟平时在输入框里写的消息一样、频率每小时/每天/工作日/每周/手动。频率选择器里没有的间隔比如每15分钟、每月1号可以直接用自然语言跟 Claude 说“安排一个任务每6小时跑一次全部测试”。每个任务在预定时间后会有最多10分钟的随机偏移但偏移是固定的同一个任务每次偏移量一样用于错开 API 流量高峰。错过运行的处理当应用启动或电脑从睡眠中醒来Desktop 会检查过去7天内有没有错过的运行。如果有它只会启动最近一次错过时间的 catch-up 运行更早的直接丢弃。比如一个每日任务连续错过了6天醒来后只跑一次。写 prompt 时最好考虑到这种可能——比如在 prompt 里加一句“只审查今天的提交。如果已经过了下午5点就跳过审查只贴一个总结说明错过了什么。”权限处理每个定时任务有自己的权限模式。如果任务跑在 Ask 模式下需要某个工具的权限任务会卡住等用户在侧边栏打开那个会话手动批准。为了避免卡住建议创建任务后先点“Run now”跑一遍遇到权限弹窗时勾选“always allow”后续自动运行就不会再问了。这些批准记录可以在任务的详情页查看和撤销。管理任务在 Schedule 列表里点一个任务进详情页可以立即运行、暂停/恢复重复、编辑设置、查看历史运行记录包括因电脑睡眠而跳过的、管理已保存的权限、删除任务。也可以用自然语言在会话里操作比如说“暂停我的 dependency-audit 任务”。任务配置存在~/.claude/scheduled-tasks/task-name/SKILL.md手动改这个文件会在下次运行时生效。但调度时间、文件夹、模型、启用状态不在这里改需要通过编辑表单或者告诉 Claude 来改。环境配置启动会话时选的环境决定了代码在哪执行Local本机直接访问本地文件环境变量从 shell 继承。需要额外变量就在~/.zshrc或~/.bashrc里设置然后重启桌面应用。RemoteAnthropic 云端会话持续运行。可以创建自定义云环境配置不同的网络访问级别和环境变量。SSH通过 SSH 连到远程机器自己的服务器、云 VM、dev container。填好名称、主机、端口、私钥文件路径后该连接会出现在环境下拉菜单里。远程机器上需要预先安装 Claude Code。企业配置Teams 和 Enterprise 计划的管理员可以通过后台控制台、托管设置文件和 MDM 策略来管控桌面应用行为。后台控制台可以控制是否允许组织中的人在桌面应用里用 Claude Code是否允许 web 会话是否允许 Remote Control是否禁用 Bypass permissions 模式托管设置可以推送一些配置键覆盖用户和项目设置。例如permissions.disableBypassPermissionsMode设为disable能彻底关掉绕过权限的模式disableAutoMode能从模式选择器里移除 Auto 模式。autoMode可以定制分类器信任和阻止的内容范围但这个配置只从托管设置、用户设置和本地设置里读取不会从检入仓库的.claude/settings.json读——防止一个克隆下来的仓库塞进自己的分类规则。MDM 和组策略macOS通过com.anthropic.Claude域用 Jamf 或 Kandji 管理Windows通过注册表SOFTWARE\Policies\Claude配置认证与数据企业可以要求所有用户使用 SSOSAML/OIDC。Claude Code 处理代码的方式本地会话在本地处理远程会话在 Anthropic 云上处理对话和代码上下文会发送给 Anthropic API。具体的数据保留、隐私、合规细节可以参考官方数据说明。跟 CLI 版对比Claude Code 命令行工具和桌面版共用同一个底层引擎甚至可以在同一台机器、同一个项目上同时跑互不干扰。它们共享配置文件CLAUDE.md、MCP 服务器配置、钩子、技能和项目记忆但会话历史各自独立。什么时候用桌面版什么时候用命令行桌面版想要可视化的 diff 审阅、文件附件、侧边栏管理多个会话、预览应用、定时任务、Computer Use。命令行需要脚本化、自动化、用第三方提供商Bedrock、Vertex、Foundry、或者就是习惯终端工作流。把 CLI 会话挪到桌面版在终端里运行/desktopClaude 会保存当前会话并在桌面应用里打开它然后退出 CLI。这个命令只在 macOS 和 Windows 上可用。功能对比简表功能CLIDesktop权限模式全包括dontAskAsk, Auto accept edits, Plan, Auto, Bypass需设置开启--dangerously-skip-permissions支持Bypass permissions 模式第三方提供商Bedrock, Vertex, Foundry不支持直连 Anthropic APIMCP 服务器配置文件Connectors UI 或配置文件插件/plugin命令插件管理器 UI提及文件文本式带自动补全仅本地/SSH文件附件不支持图片、PDF会话隔离--worktree标志自动 worktree并行会话开多个终端侧边栏标签页定时任务cron、CI 流水线内置 Scheduled tasksComputer Use需通过/mcp配置macOS 上直接开关Dispatch 集成不支持侧边栏显示 Dispatch 会话脚本和自动化--print、Agent SDK不支持桌面版没有的功能第三方模型提供商只能连 AnthropicLinux 版桌面应用仅 macOS 和 Windows行内代码建议桌面版是对话式不是自动补全风格Agent teams多智能体编排只在 CLI 和 Agent SDK 里常见问题与排查检查版本Mac菜单栏 Claude - About ClaudeWindowsHelp - About。点版本号可以复制。403 或认证错误最常见解决办法从应用菜单里退出登录再重新登录。确认订阅是 Pro、Max、Teams 或 Enterprise。如果 CLI 能用但桌面版不行完全退出应用不只是关窗口再打开重新登录。启动后空白或卡住重启应用检查是否有挂起的更新应用启动时会自动更新。Windows 可以去事件查看器 - Windows 日志 - 应用程序 里看崩溃日志。“Failed to load session”选中的文件夹可能已经不存在、仓库需要 Git LFS 但没装、或者文件权限问题。换个文件夹或重启应用。找不到已安装的工具npm、node 等确认这些工具在普通终端里能跑检查 shell profile 是否正确设置了 PATH重启桌面应用让环境变量重新加载。Git 和 Git LFS 错误Windows 上需要装 Git for Windows。如果提示需要 Git LFS从 git-lfs.com 安装运行git lfs install重启应用。Windows 上 MCP 服务器不工作检查配置是否正确重启应用在任务管理器里看服务器进程是否在跑看服务器日志。应用无法退出MacCmdQ如果没反应用CmdOptionEsc强制退出。WindowsCtrlShiftEsc开任务管理器结束进程。Windows 特定问题PATH 没更新开个新终端窗口安装时提示有另一个安装正在进行但没有用管理员权限运行安装程序ARM64 Windows 设备完全支持Intel Mac 上 Cowork 标签不可用Cowork 标签需要 Apple SiliconM1 或更新。Windows 上所有硬件都支持。Chat 和 Code 标签在 Intel Mac 上正常。“Branch doesn’t exist yet” 在 CLI 里打开时远程会话创建的分支在本地可能不存在。点会话工具栏里的分支名复制然后本地 fetchgit fetch origin branch-name再git checkout branch-name。还卡住了可以去 GitHub Issues 搜或提 bug也可以去 Claude 支持中心。报 bug 时最好带上桌面应用版本、操作系统、完整的错误信息、相关日志Mac 看 Console.appWindows 看事件查看器。Claude Code Desktop 把一个原本藏在终端里的 AI 编程助手变成了一款图形界面下可视、可控、可扩展的开发工具。从并行的隔离会话到手机端触发的远程任务从自动 diff 审阅到 macOS 上的屏幕控制它给不同需求和使用习惯的开发者提供了多种进入方式。而它和命令行版本共享同一套配置、同一套记忆也意味着用户可以随时在两种界面之间切换不用重复搭建环境。