TellWorldAI 世界档案
问档案English

首页›实践›实践

实践

Claude Code 桌面版上手

不用终端,在 Claude 桌面应用的 Code 标签页里打开本地项目,发出第一条指令,审阅改动,并选好权限模式。

这篇适合谁,读完能做到什么

适合不想打开终端、但想让 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]。

上手步骤

  1. 下载对应系统的安装包,安装后启动 Claude[1]。
  2. 点击侧边栏顶部的 Code 标签页。如果标签只显示图标,把鼠标悬停在上面就能看到名称[1]。
  3. 在输入框下方那一行,点击最左边的环境选择器,选择 Local 分组里的第一项。再点击它旁边的项目文件夹控件,选 Open folder…,然后选中你的项目目录[1]。
  4. 在同一行靠右的位置,从模型选择器里选一个模型,之后随时可以改[1]。
  5. 在输入框里说出你要做什么。示例包括:Find a TODO comment and fix it、Add tests for the main function、Create a CLAUDE.md with instructions for this codebase[1]。
  6. 检查权限模式。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]。

第一次会话的检查清单

  1. 打开 Code 标签页,确认没有升级、登录或 403 提示[1]。
  2. 确认环境是 Local 分组里的那一项,项目文件夹是你要改的目录[1]。
  3. 确认模型选择器里的模型,并知道它可以随时更换[1]。
  4. 看一眼权限模式。Manual 模式下每处改动都要批准;Auto 和 Accept edits 模式下,改动会直接应用,再通过 diff 视图审阅[1]。
  5. 发出第一条指令,等它完成后打开 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]。

来源

  1. 1
    Get started with the desktop appAnthropic Claude Code docs

引用本页: Claude Code 桌面版上手. TellWorld, https://www.tellworld.net/zh/practice/practice-claude-code-desktop. 更新于 2026-11-14

相关动态