这篇适合谁,读完能做到什么
适合不想打开终端、但想让 AI 直接读写自己项目代码的人。读完这篇,你能在桌面应用里打开一个本地项目文件夹,发出第一条指令,查看 Claude 改了什么,并知道几种权限模式的区别。
桌面版是什么
Claude 桌面应用的侧边栏顶部有一个 Code 标签页。它是 Claude Code 的图形界面:你让 Claude 处理电脑上某个文件夹里的代码,然后自己逐个文件查看改动,整个过程不需要终端[1]。桌面应用已经内置 Claude Code,所以使用 Code 标签页不必单独安装 Node.js,也不必安装命令行版本[1]。如果你还想在终端里直接运行 claude,需要另外安装命令行版本[1]。
准备
- 订阅:Claude Code 桌面版需要 Pro、Max、Ultra、Team 或 Enterprise 订阅[1]。没有符合要求的订阅时,点击 Code 标签页会出现升级提示。
- 系统:macOS 提供通用版安装包,同时支持 Intel 和 Apple Silicon 芯片;Windows 提供 x64 安装包,Windows ARM64 另有专用安装包;Linux 版目前是测试版(beta),Ubuntu 和 Debian 可以用 apt 或 .deb 安装[1]。
- 账号:启动应用后,用 Anthropic 账号登录[1]。
上手步骤
- 下载对应系统的安装包,安装后启动 Claude[1]。
- 点击侧边栏顶部的 Code 标签页。如果标签只显示图标,把鼠标悬停在上面就能看到名称[1]。
- 在输入框下方那一行,点击最左边的环境选择器,选择 Local 分组里的第一项。再点击它旁边的项目文件夹控件,选 Open folder…,然后选中你的项目目录[1]。
- 在同一行靠右的位置,从模型选择器里选一个模型,之后随时可以改[1]。
- 在输入框里说出你要做什么。示例包括:
Find a TODO comment and fix it、Add tests for the main function、Create a CLAUDE.md with instructions for this codebase[1]。 - 检查权限模式。Auto 或 Accept edits 模式下,Claude 直接改文件,并显示
+12 -1之类的标记供你审阅;Manual 模式下,每一处改动都会以 diff 的形式出现,带批准和拒绝按钮,Claude 等你决定后才会应用[1]。
每个会话都是一次和 Claude 关于你代码的对话,有自己的上下文和改动记录,所以可以同时开好几个,各做各的任务[1]。
中途怎么干预
Claude 运行时,点停止按钮可以立即打断。也可以直接在输入框里输入修正意见,按 Enter 发送,不必停下来[1]。输入 @文件名 可以把某个文件放进对话,给 Claude 更多上下文;输入 / 可以浏览内置命令、自定义技能和插件技能[1]。
怎么审阅改动
点击 +12 -1 这类标记会打开 diff 视图,可以逐个文件查看改动,还能在具体的行上留言。Claude 会读取你的留言并修改[1]。想让 Claude 自己审查这些改动,可以在输入框里输入 /code-review[1]。
四种权限模式怎么选
- Auto:后台由分类器审查每个动作,拦下有风险的动作,而不是每次都来问你[1]。
- Manual:Claude 改文件或运行命令之前都会先问你[1]。
- Accept edits:自动接受文件改动,迭代更快[1]。
- Plan:Claude 只提出方案,不改任何文件,适合在大型重构前先把思路理清[1]。
进阶:终端、预览和 PR
- 按 Ctrl+` 可以打开终端面板,在会话旁边运行命令[1]。
- 在桌面应用里运行开发服务器后,应用会在 Browser 面板中打开。Claude 可以查看运行中的页面、测试接口、查看日志,并据此继续修改[1]。
- 开了 PR 之后,Claude Code 会监控 CI 检查结果,并可以自动修复失败的检查[1]。
- 定时任务可以让 Claude 按固定周期自动运行,例如每天做一次代码审查[1]。
- 侧边栏可以打开多个并行会话,每个会话还可以各自使用一个 Git worktree[1]。
限制和常见问题
- Code 标签页提示升级:说明需要先订阅付费计划[1]。
- 提示在线登录:完成登录后重启应用[1]。
- 出现 403 错误:参考官方文档中的认证排查部分[1]。
- SSH 远程会话:第一次连接时,桌面应用会自动在远程机器上安装 Claude Code。桌面断开时任务可以继续运行,但如果用的是 Claude 账号,登录过期后任务可能会停止[1]。
- 云端会话:选择 Cloud 时,关闭应用后会话仍会继续运行[1]。
第一次会话的检查清单
- 打开 Code 标签页,确认没有升级、登录或 403 提示[1]。
- 确认环境是 Local 分组里的那一项,项目文件夹是你要改的目录[1]。
- 确认模型选择器里的模型,并知道它可以随时更换[1]。
- 看一眼权限模式。Manual 模式下每处改动都要批准;Auto 和 Accept edits 模式下,改动会直接应用,再通过 diff 视图审阅[1]。
- 发出第一条指令,等它完成后打开 diff 视图,逐个文件检查,有问题就留言让 Claude 修改[1]。
三种运行环境怎么选
在输入框下方那一行的环境选择器里,除了上面说的 Local,还能看到 Cloud、SSH 和 WSL 三个选项[1]。
- Local:在你自己的电脑上运行,也就是上面步骤里选中的那一项[1]。
- **想在终端里运行
claude**:命令行版本需要单独安装,Code 标签页本身不需要它[1]。 - Cloud:在云端运行。即使你关闭应用,会话也会继续[1]。
- SSH:连接远程机器。第一次连接时,桌面应用会自动在远程机器上安装 Claude Code[1]。
- WSL(仅 Windows):会话在 WSL 2 发行版里运行,Claude Code、工具和 git 都在 Linux 一侧,使用原生路径执行[1]。
选哪一个,取决于代码在哪里。平时在自己电脑上改的项目,用 Local 最直接;需要长时间跑的任务,可以放到 Cloud[1]。
下一步
先从一个你熟悉的小项目开始,这是看清 Claude Code 能做什么最快的办法。想了解权限模式、并行会话、diff 视图、连接器和企业配置,可以读官方的 Claude Code Desktop 文档[1]。
来源
- 1Get started with the desktop appAnthropic Claude Code docs
引用本页: Claude Code 桌面版上手. TellWorld, https://www.tellworld.net/zh/practice/practice-claude-code-desktop. 更新于 2026-11-14