26. 桌面应用与 Web 版

四种入口怎么选

前面你一直用终端里的 claude，那是 CLI。但 Claude Code 不止终端这一个入口。打个比方：CLI 像你亲自在工地上操作机器—全程自己动手。桌面应用像你坐在项目部的监控室里，同时看好几个工区的进度（可视化、能并排看好几个）。Web 版像你把工程外包给另一支施工队—他们在自己的工地上干，你关掉手机工程也照跑。

入口	代码跑在哪	从哪聊天	用你的本地配置	断网后继续跑
终端 CLI	你的机器	终端	是	否
桌面应用	你的机器或云	Desktop UI	本地为是，云为否	取决于会话类型
Web 版	Anthropic 云 VM	claude.ai 或手机	否，仅限仓库	是
Remote Control	你的机器	claude.ai 或手机	是	终端保持打开时

这章讲桌面应用和 Web 版。Remote Control 单独放第 30 章讲。

桌面应用

Claude Desktop 应用有三个选项卡：Chat（对话）、Cowork（Dispatch 和代理工作）、Code（软件开发）。这章只讲 Code 选项卡。

下载地址：macOS 和 Windows 从 claude.ai/download 下，Linux 走 apt（beta）。装好后启动、登录、点 Code 选项卡。

窗格布局：想怎么摆怎么摆

Code 选项卡围绕窗格（Pane）构建，你能把聊天、diff、浏览器、终端、文件编辑器并排放置。拖窗格标题能重新定位，拖边缘能调大小。Cmd+\（Mac）或 Ctrl+\（Windows）关掉焦点窗格。

从会话工具栏的 Views 菜单能打开其他窗格。几个常用窗格：

• 聊天窗格：跟 Claude 对话的主区域
• diff 窗格：看 Claude 改了哪些文件，能逐行评论
• 浏览器窗格：预览你跑着的应用，或打开外部网站
• 终端窗格：集成终端，跟 Claude 共享同一个工作目录
• 文件窗格：直接看和编辑文件

终端在本地会话中可用，快捷键 Ctrl+` 打开。

并行会话：一个窗口干多件事

侧边栏列出你的所有会话。点 + New session 或 Cmd+N/Ctrl+N 新建，Ctrl+Tab 在会话间切换。

每个会话独立跟踪自己的上下文和改动。对于 Git 仓库，每个会话自动用 Git worktree（工作树）获得自己的项目隔离副本—一个会话改的代码不会影响另一个，直到你提交。

会话完成但你没在看时，桌面应用会发系统通知。还能在设置里开「Auto-archive after PR merge or close」，PR 合并或关闭后自动存档会话。

应用预览：Claude 自己验自己的活

Claude 能启动开发服务器，在浏览器窗格里打开它来验证改动。它拍截图、检查 DOM、点元素、填表单，发现的问题自己修。

浏览器窗格也能打开项目里的静态 HTML、PDF、图片和视频。点击聊天里的这些文件路径就会在那打开。

Claude 根据你的项目自动创建初始服务器配置，存在 .claude/launch.json 里。想自定义（比如用 yarn dev 而不是 npm run dev），手动改这个文件：

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

diff 审查和 PR 监控

Claude 改完代码后，diff 指示器显示增删行数（如 +12 -1）。点它打开 diff 查看器，左边文件列表，右边每个文件的改动。

想给特定行提反馈，点 diff 里的行，输入评论，Cmd+Enter（Mac）或 Ctrl+Enter（Windows）一次提交所有评论。Claude 读你的评论、改代码，改动显示为新的 diff 给你审。

diff 视图右上角还有 Review code 按钮，让 Claude 在你提交前评估改动—检查编译错误、逻辑错误、安全漏洞，直接在 diff 里留注释。

开 PR 后，CI 状态栏出现在会话里。两个开关：

• Auto-fix：开启后 Claude 自动读 CI 失败输出、迭代修复
• Auto-merge：开启后所有检查通过就合并 PR（压缩合并）

侧边聊天：问偏题不跑偏

有时候你在跟 Claude 干一件正经事，突然想问个偏门问题—比如「这段代码为什么这么写」。如果直接在主对话里问，会把主线的上下文带偏。

侧边聊天解决这个问题。Cmd+;（Mac）或 Ctrl+;（Windows）打开，或输 /btw。它能读主线程到当前为止的所有内容，但你的问题不会加回主对话。问完关掉，继续主线。

视图模式

发送按钮旁的 Transcript view 下拉菜单切三种模式（Ctrl+O 循环）：

模式	显示内容
Normal	工具调用折叠成摘要，带完整文本响应
Verbose	Claude 的每个工具调用、文件读取和中间步骤
Summary	只有 Claude 的最终响应和它做的改动

调试 Claude 为什么走某条路时用 Verbose，跑多个会话想快速扫结果时用 Summary。

从 CLI 搬过来

Desktop 跟 CLI 跑同一个底层引擎，能同时跑，甚至同一个项目上一起用。每个维护单独的会话历史，但通过 CLAUDE.md 和设置文件共享配置。

终端里跑 /desktop，Claude 保存你的会话并在桌面应用里打开，然后退出 CLI。这个命令需要 Claude 订阅登录，API 密钥或第三方提供商不行。

Web 版：claude.ai/code

Web 版在 Anthropic 管理的云基础设施上跑，不在你的机器上。从浏览器 claude.ai/code 或 Claude 手机 App 提交任务。

Web 版适合干什么

Web 版的核心优势是「关掉浏览器也在跑」。适合这几类活：

• 并行任务：同时跑多个独立任务，每个有自己的会话和分支，不用管 worktree
• 本地没有的仓库：Claude 每次新鲜克隆仓库，你不用检出
• 不需要频繁指导的任务：丢一个定义明确的任务，干别的去，回来收结果
• 代码探索：理解代码库或追踪功能怎么实现，不用本地检出

需要你的本地配置、工具或环境的活，在本地跑或用 Remote Control 更合适。

会话怎么跑

提交任务后四步：

1. 克隆和准备：仓库克隆到 Anthropic 管理的 VM，有设置脚本就跑
2. 配置网络：按环境的访问级别设网络
3. 工作：Claude 分析代码、改文件、跑测试、检查工作。你能全程看和指导，也能走开
4. 推送分支：Claude 到停止点后把分支推到 GitHub，你审 diff、留评论、建 PR

推分支不会关会话。PR 创建和后续编辑都在同一个对话里进行。

连接 GitHub

Web 版需要 GitHub 仓库。两种连接方式：

方法	工作原理	最适合
GitHub App	入门时授权 Claude GitHub App	浏览器入门；想要自动修复的团队
/web-setup	终端里跑 /web-setup 同步本地 gh CLI 令牌	已经用 gh 的个人开发者

已经在用 GitHub CLI 的，在 Claude Code CLI 里跑 /web-setup 就行，它会读你本地的 gh 令牌、同步到 Claude 账户，没云环境还会帮你建一个默认的。

云环境

每个云会话在一个新的 Anthropic 管理的 VM 里跑，克隆你的仓库。预装了一堆常用工具：

类别	包含
Python	3.x，带 pip、poetry、uv、black、mypy、pytest、ruff
Node.js	20/21/22（nvm），带 npm、yarn、pnpm、eslint、prettier
Ruby	3.1/3.2/3.3，带 bundler、rbenv
Java	OpenJDK 21，带 Maven、Gradle
Go	最新稳定版
Rust	rustc、cargo
Docker	docker、dockerd、docker compose
数据库	PostgreSQL 16、Redis 7.0

资源上限大约：4 个 vCPU、16 GB RAM、30 GB 磁盘。需要更多内存的大构建或测试可能失败或被杀。

设置脚本和环境缓存

设置脚本是一个 Bash 脚本，在新云会话启动时、Claude Code 启动前跑。用来装预装列表里没有的东西：

#!/bin/bash
apt update && apt install -y gh

脚本以 root 跑在 Ubuntu 24.04 上，apt install 和大多数包管理器都能用。非关键命令加 || true 避免不稳定安装失败导致会话起不来。

环境缓存：脚本第一次跑完后，Anthropic 对文件系统快照，后续会话以你的依赖和工具已在磁盘上开始，跳过脚本步骤。改了脚本或允许的网络主机、或者缓存约 7 天过期后，会重跑。

网络访问级别

每个环境指定一个访问级别：

级别	出站连接
无	无出站网络
受信任（默认）	允许列表域：包注册表、GitHub、云 SDK
完全	任何域
自定义	你自己的允许列表，可选包含默认值

所有 GitHub 操作走专用代理，你的真实凭证不进沙箱。所有出站流量走安全代理，提供防恶意请求、速率限制、内容过滤。

—cloud：把任务扔到云端

从终端用 --cloud 标志启动云会话：

claude --cloud "Fix the authentication bug in src/auth/login.ts"

这会在 claude.ai 上创建一个新的云会话，克隆你当前目录的 GitHub 远程。如果你有本地提交，先推—VM 从 GitHub 克隆，不从你机器。

任务在云端跑，你继续在本地干活。用 CLI 里的 /tasks 查进度，或在 claude.ai/手机 App 上直接交互。

并行跑多个云任务

每个 --cloud 命令建自己的云会话，独立运行：

claude --cloud "Fix the flaky test in auth.spec.ts"
claude --cloud "Update the API documentation"
claude --cloud "Refactor the logger to use structured output"

用 /tasks 监控所有会话。

没有 GitHub 也能用

从没连 GitHub 的仓库跑 claude --cloud，Claude Code 会把你的本地仓库打包直接上传。包括完整历史、所有分支，加上跟踪文件的未提交改动。

强制打包（即使连了 GitHub）：CCR_FORCE_BUNDLE=1 claude --cloud "..."。限制：必须是 git 仓库且至少一个提交、100MB 以下、未跟踪文件不含（先 git add）、打包创建的会话推不回远程。

—teleport：把云会话拉回来

用 --teleport 把云会话拉到终端继续：

# 交互式选择器
claude --teleport

# 直接恢复特定会话
claude --teleport <session-id>

或者在一个已有 CLI 会话里跑 /teleport 或 /tp，不用重启 Claude Code。也能从 /tasks 列表里按 t 传送，或从网络界面选「在 CLI 中打开」复制命令。

传送时 Claude 验证你在正确的仓库、从云会话获取并检出分支、把完整对话历史加载到终端。

--teleport 跟 --resume 不一样：--resume 从本地历史重开对话，不列云会话；--teleport 拉的是云会话及其分支。

从桌面应用继续到别处

桌面应用的「Continue in」菜单（会话工具栏右下角的 VS Code 图标）能把会话移到别处：

• Web 上的 Claude Code：把本地会话发到远程继续跑。Desktop 推送分支、生成对话摘要、创建有完整上下文的新远程会话。需要干净的工作树，SSH 会话不可用
• 你的 IDE：在当前工作目录的 IDE 里打开项目

Dispatch：从手机派活

Dispatch 是 Cowork 选项卡里跟 Claude 的持久对话。你发任务消息，它决定怎么处理。

任务变成 Code 会话有两种方式：你直接要一个（如「打开 Claude Code 会话修登录 bug」），或 Dispatch 判断是开发活自己生成一个。Code 会话出现在 Code 选项卡侧边栏，带 Dispatch 徽章。完成或需要你批准时，手机上收到推送通知。

小结

• 桌面应用：窗格布局、并行会话（自动 worktree）、应用预览、diff 审查、PR 监控、侧边聊天。/desktop 从 CLI 搬过来
• Web 版：云端跑、关浏览器也在跑、预装工具、设置脚本+环境缓存、网络访问四级
• --cloud：终端启动云会话，能并行跑多个
• --teleport：把云会话拉回本地终端，带分支和完整历史
• Desktop 和 CLI 共享配置：CLAUDE.md、MCP、hooks、skills、设置文件都通用
• Dispatch：从手机派 Code 会话，完成时推送通知

下一章讲 Git 工作流—worktree、提交、PR、自动代码审查，怎么让 Claude Code 帮你管版本控制。