Claude Code Desktop、IDE 与远程接续
Desktop 适合把并行会话、diff、终端、文件编辑器和预览放进一个可审查工作区；VS Code 适合围绕当前选区和编辑器 diff 工作；Remote Control 用来从网页或手机继续操控仍在本机运行的 CLI 或 VS Code 会话。
官方资料核对日期 2026-07-15 · 当前模型 Fable 5 / Opus 4.8 / Sonnet 5 · 图形工作区要求 Claude Desktop 1.2581.0 或更高版本
图片证据边界
Anthropic 的 Desktop reference 仍没有静态界面图，但 2026 年第 28 周官方更新页发布了 Desktop 内置浏览器视频。本章使用该官方视频的原始帧，并保留 Web、VS Code 与模型配置页的官方素材；不使用第三方旧截图或生成界面冒充产品画面。
先选对入口
| 入口 | 代码实际在哪里运行 | 适合的工作 |
|---|---|---|
| Desktop Code > Local | 你的电脑 | 可视化 diff、本地预览、多个隔离会话 |
| Desktop Code > Remote | Anthropic 云端 | 关掉 App 或电脑后仍继续的长任务 |
| Desktop Code > SSH / WSL | SSH 远端或本机 WSL 2 | 依赖在服务器、容器或 Linux 工具链中的项目 |
| VS Code 扩展 | 当前编辑器打开的项目 | 选区提问、行号引用、编辑器内 proposed diff |
| Claude Code on the web | Anthropic 云端 | 没有本地 checkout 时启动云端任务 |
| Remote Control | 仍在运行的本机 CLI 或 VS Code 进程 | 从 claude.ai/code、手机或平板接续本地工作 |
Remote 不是 Remote Control
Desktop 的 Remote 会话在 Anthropic 云端执行，电脑离线后仍可继续。Remote Control 只把本机正在运行的 CLI 或 VS Code 会话接到网页或 Claude 移动 App；本机进程、项目和工具仍是执行端，进程退出后远程会话也会结束。
安装 Desktop 并打开 Code
系统与账号要求
| 平台 | 官方安装入口 | 安装说明 |
|---|---|---|
| macOS | Universal DMG | 同时支持 Intel 与 Apple Silicon |
| Windows x64 | x64 安装器 | 本地会话还需要 Git for Windows |
| Windows ARM64 | ARM64 安装器 | 安装 Git 后应重启 App |
| Linux beta | Ubuntu / Debian 安装说明 | 通过 apt 或下载 .deb 安装 |
Code 标签需要 Pro、Max、Team 或 Enterprise 订阅。Desktop 已经包含运行 Code 标签所需的 Claude Code，不需要另装 Node.js 或 CLI；只有要在终端输入 claude 时才需单独安装 CLI。
首次启动
- 安装后从 macOS Applications、Windows 开始菜单或 Linux 应用启动器打开 Claude。
- 使用 Anthropic 账号登录。
- 点击窗口顶部中央的 Code。
- 若 Code 要求在线登录，完成浏览器授权后重启 App；若要求升级，先确认当前账号具备付费订阅。
- Windows 首次打开 Code 前确认 Git 已安装；安装后重启 App。
看到 403 时，不要反复重装。先核对当前登录账号、订阅和组织，再按官方 Desktop 页的 403 or authentication errors in the Code tab 分支处理。
当前模型选择
当前 Claude Code 可以用别名选择模型，不必在日常操作中记住完整 ID。本机 2.1.209 已满足 Fable 5、Opus 4.8 和 Sonnet 5 的最低 CLI 版本要求。
| 选择 | 当前含义 | 适合 |
|---|---|---|
default | 清除个人覆盖，回到账号或组织推荐默认值 | 不想固定模型时 |
best | 有权限时使用 Fable 5，否则使用最新 Opus | 希望自动选择当前最强可用模型 |
fable | Claude Fable 5；不是默认模型 | 跨较长时间、开放式、需要持续调查与验证的困难任务 |
opus | Anthropic API 当前为 Opus 4.8 | 复杂推理、架构判断和高价值代码工作 |
sonnet | Anthropic API 当前为 Sonnet 5 | 日常编码、工具调用和较高吞吐 |
haiku | 当前快速、轻量的 Haiku | 边界清楚的简单任务 |
Desktop 中从发送按钮旁的模型菜单选择；CLI 中使用 /model fable、/model opus，或启动时运行 claude --model fable。Fable 5 受组织权限和数据保留策略限制；provider 不同，opus 与 sonnet 的实际映射也会不同。
完成第一次本地修改
1. 选择运行环境和项目
在 Code 标签的新会话输入区完成四项设置：
- 环境选择 Local。
- 点击 Select folder，选择仓库根目录，而不是仓库的上级目录。
- 从发送按钮旁的菜单选择模型。
- 首次使用保留 Manual；复杂任务可先切到 Plan。
Local 会直接访问所选目录。Windows 本地会话必须有 Git；非 Git 目录仍可工作，但不会获得 Git worktree 隔离和完整的版本差异能力。
2. 先让 Claude 建立基线
第一次任务应小而可验证，例如：
先不要修改。确认项目根目录、当前分支、未提交文件，
定位登录按钮重复提交的原因，并列出最小修改方案与验证命令。
得到我确认后再改。可用 @文件名 把本地文件加入上下文，也可通过附件按钮或拖放加入图片、PDF 等材料。@mention 不适用于云端或 WSL 会话。
3. 选择合适的权限模式
| 模式 | Desktop 行为 | 适用时机 |
|---|---|---|
| Manual | 编辑文件和运行命令前询问；文件修改先显示 diff | 第一次使用、高风险仓库 |
| Accept edits | 自动接受文件编辑及常见文件系统命令，其他终端命令仍询问 | 修改范围已明确的快速迭代 |
| Plan | 读取和探索后给出方案，不修改源代码 | 大改、迁移、先审方案 |
| Auto | 以后台安全检查代替大部分逐项确认；是否显示受账号、模型与组织策略影响 | 边界清晰且可回滚的任务 |
| Bypass permissions | 跳过大多数确认，等同 CLI 的 --dangerously-skip-permissions | 仅限隔离容器或虚拟机 |
Desktop 不提供 CLI 的 dontAsk 模式。模式可以在会话中切换；建议先用 Plan 明确范围，再切回 Manual 或 Accept edits 实施。
4. 接受或拒绝 proposed diff
Manual 模式下，Claude 提议编辑时会显示逐文件 diff 和 Accept / Reject。接受前检查：
- 文件是否都属于目标范围；
- 是否混入格式化、依赖锁文件、调试日志或密钥；
- 删除和行为变化是否有依据；
- 原本存在的未提交修改是否被误算成 Claude 的工作。
拒绝后直接说明应保留什么、换哪种实现。官方 quickstart 明确说明：Manual 流程中，接受之前文件不会被这次提议修改。
会话、工作区与 Git 隔离
并行会话
点击侧栏的 + New session，或按 Cmd+N / Ctrl+N 新建任务。每个会话有独立的对话上下文、项目目录和代码改动；用 Ctrl+Tab / Ctrl+Shift+Tab 在会话间切换。
要并排查看两个会话，在 macOS 按住 Cmd、Windows 按住 Ctrl，再点击侧栏中的另一个会话。当前布局会显示两个 session pane；关闭聚焦 pane 后回到单会话。
自动 worktree
对 Git 仓库，Desktop 为并行会话自动创建隔离 worktree，默认位于：
<project-root>/.claude/worktrees/可以在 Settings > Claude Code > Worktree location 改位置，也可设置统一的分支名前缀。完成后在侧栏归档会话会移除对应 worktree；也可以开启 PR 合并或关闭后的自动归档。
需要把某些 gitignored 文件复制进新 worktree 时，可在项目根目录配置 .worktreeinclude。不要把生产密钥、个人 token 或不必要的 .env 当成普通依赖复制；worktree 只隔离 Git 文件，不会自动隔离数据库、端口、缓存和外部账号。
每个并行任务开始时都应记录：worktree 路径、分支、验证命令、端口和测试数据。多个会话不要同时写同一外部资源。
终端、文件编辑器与布局
版本门槛
官方 Desktop 文档明确说明：可拖拽 pane 布局、集成终端、文件编辑器和 Transcript 视图要求 Desktop 1.2581.0+。macOS 用 Claude > Check for Updates，Windows 用 Help > Check for Updates。
集成终端
从会话工具栏的 Views 菜单打开 Terminal，或按 Ctrl + 反引号键。终端会在当前会话的工作目录启动，并与 Claude 共享环境，因此 git status 和测试命令看到的是 Claude 正在编辑的同一份文件。
git status --short --branch
# 再运行仓库真实存在的 test、typecheck、lint 或 build 命令点击 terminal pane 标题栏的 + 可开第二个终端；也可右键聊天中的目录并选择 Open in terminal。集成终端只适用于 Local 会话。
文件编辑器
点击聊天或 diff 中的文件路径会在 file pane 打开文件。可做小范围编辑并点击 Save；如果磁盘上的文件已在打开后发生变化，Desktop 会警告并让你覆盖或放弃。Discard 会丢弃 file pane 内尚未保存的编辑。
file pane 适用于 Local 和 SSH 会话。右键文件路径还可以：
- Attach as context：加入下一条提示；
- Open in：交给已安装的 VS Code、Cursor 或 Zed；
- Show in Finder / Explorer：定位文件；
- Copy path：复制绝对路径。
聊天、diff、Browser、terminal、file、plan、tasks 和 subagent 都是可拖拽 pane。从 Views 打开所需视图，拖动标题调整位置，拖动边缘调整大小。
Diff、代码审查与 PR
审完整 diff
Claude 修改文件后，会出现类似 +12 -1 的统计。点击它打开 diff viewer：左侧是文件列表，右侧是逐行差异。
- 逐个文件检查完整 diff。
- 点击具体行打开评论框，输入反馈并按 Enter 添加。
- 多处评论完成后，macOS 按
Cmd+Enter、Windows 按Ctrl+Enter一次提交。 - Claude 根据评论修改后，再审新 diff，不要把“已响应评论”当成验证通过。
点击右上角 Review code，Claude 会针对当前 diff 留下行内审查意见。官方说明该审查聚焦编译错误、确定的逻辑错误、安全漏洞和明显 bug，不负责替代 linter，也不会主动报告纯风格或既有问题。
监控 PR
创建 PR 后，会话中会出现 CI 状态栏。该能力依赖本机已安装并认证的 GitHub CLI gh：
- Auto-fix：读取失败检查并尝试修复；
- Auto-merge：检查全部通过后 squash merge，且仓库必须先允许 GitHub auto-merge。
这两个开关都应按 PR 单独决定。涉及受保护分支、发布或数据库迁移时，不应把 CI 通过直接等同于允许自动合并。
Preview 与 Browser pane
让 Claude 验证正在运行的 App
完成改动后可直接要求：
启动本项目的开发服务器，在 Browser pane 验证登录流程；
检查控制台与服务日志，报告实际访问地址、验证步骤和仍未覆盖的状态。Desktop 会检测开发服务器并在 Browser pane 打开。Claude 可以截图、检查 DOM、点击和填写表单，并根据发现继续修改。autoVerify 默认开启，会在编辑后自动验证；也可以从 server 菜单关闭。
服务器配置位于所选项目根目录的 .claude/launch.json。若自动识别错了命令或端口，从 server 下拉菜单点 Edit configuration，例如：
{
"version": "0.0.1",
"configurations": [
{
"name": "web",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"port": 3000,
"autoPort": true
}
]
}autoPort: true 会在端口冲突时寻找空闲端口；OAuth callback 或 CORS 必须固定端口时用 false。不要把 secret 写进可提交的 launch.json，本地变量应放入 Local 环境编辑器。
外部站点边界
Browser pane 使用与个人浏览器分离的干净 profile，不继承个人历史或登录。Claude 第一次在外部站点执行点击、输入等动作时，会显示 Allow once / Always allow / Deny；不同站点和子域分别授权。本地开发服务器和项目文件不需要这项外站授权。
测试登录、支付、管理后台等流程时使用测试账号。即使站点已允许，购买、创建账号和 CAPTCHA 仍需要人工介入。
Remote、SSH 与跨界面接续
Desktop 的 Remote 与 Claude Code on the web 都把任务放在 Anthropic 托管环境中，适合不依赖本机未提交文件、且需要在电脑离线后继续的工作。启动前应确认云端选择的是正确仓库和分支。
Desktop 的三种非本地环境
| 环境 | 行为 | 关键限制 |
|---|---|---|
| Remote | 在 Anthropic 云端运行，关闭 App 或电脑后继续 | 本地未提交文件不会凭空出现在云端 |
| SSH | Desktop 自动在 Linux 或 macOS 远端安装并运行 Claude Code | 需要可用 SSH 账号、主机和密钥；file pane 可用，集成终端的本地限定仍需注意 |
| WSL | Windows 上在 WSL 2 内用 Linux 路径、Git 和工具链执行 | 先准备可用 WSL 2 distribution |
从新会话的 Environment 菜单选择环境。SSH 首次添加时填写名称、user@host、端口和可选 identity file；Remote 会话还可以通过仓库 pill 旁的 + 加多个仓库。
Continue in
会话工具栏右下角 VS Code 图标提供 Continue in：
- Claude Code on the Web：Desktop 推送分支、生成对话摘要并创建云端会话。要求 working tree 干净，不适用于 SSH 会话。
- Your IDE：在支持的 IDE 中，以当前会话 working directory 打开项目。
CLI 会话要转入 Desktop，可在 macOS 或 Windows 的订阅登录会话中运行 /desktop。CLI 保存会话、打开 Desktop 后退出；API key 登录及 Bedrock、Google Cloud Agent Platform、Microsoft Foundry 不支持此交接。
在 VS Code 中工作
VS Code 扩展是 Anthropic 官方推荐的 VS Code 图形入口，要求 VS Code 1.98.0 或更高版本。付费 Claude 订阅或 Claude Console 账号均可登录，扩展面板本身不要求手工填写 API Key。
扩展为图形面板自带一份私有 CLI，但不会把 claude 放入 PATH。要在 VS Code terminal 中使用 CLI，仍需单独安装 Claude Code CLI。
安装、登录和打开面板
- 在 VS Code 按
Cmd+Shift+X/Ctrl+Shift+X打开 Extensions。 - 搜索 Claude Code，确认发布者为 Anthropic 后点击 Install。
- 打开一个文件，点击编辑器右上角的 Spark 图标；也可用左侧 Activity Bar 的 Spark、Command Palette 中的 Claude Code: Open in New Tab，或右下角 Claude Code 状态项。
- 首次打开点击 Sign in，在浏览器完成授权。
- 若安装后入口未出现，执行 Developer: Reload Window 或重启 VS Code。
把选区和文件交给 Claude
在编辑器选择代码后，Claude 能自动看到该选区。按 Option+K / Alt+K 会在提示中插入带文件和行号的引用，例如 @app.ts#5-10；手工输入 @ 可模糊匹配文件或目录。
Plan 模式会把方案作为完整 Markdown 文档打开，可直接留下行内评论后再允许实施。需要并行会话时，从 Command Palette 使用 Open in New Tab 或 Open in New Window；每个会话保留独立历史和上下文。
审阅 proposed edit
Claude 请求编辑文件时，VS Code 显示原始内容与 proposed change 的并排 diff。你可以接受、拒绝，或直接修改 proposed 内容；若你在接受前手工改过 diff，扩展会把这一事实告诉 Claude，不会让它误以为原提议被原样应用。
要在 VS Code 内运行完整 CLI，在 integrated terminal 输入 claude；它会自动集成 IDE diff 和诊断。若 CLI 在外部 terminal 运行，在会话内输入 /ide 连接 VS Code。扩展与 CLI 共享会话历史，可在 terminal 用 claude --resume 选择并继续扩展会话。
Remote Control：从手机或浏览器继续本机会话
Remote Control 当前属于 research preview。它适合接续正在运行的本机会话，不应当作无人值守的云端执行环境。
启用前检查
Remote Control 适用于 Pro、Max、Team 和 Enterprise，API Key 不支持。Team 与 Enterprise 需要 Owner 先在 Claude Code 管理设置中打开 Remote Control。
同时确认：
- 已通过
claude中的/login或claude auth login使用 claude.ai 账号登录； - 已在目标项目运行过
claude并接受 workspace trust； - 会话直接连接
api.anthropic.com；Bedrock、Google Cloud Agent Platform、Microsoft Foundry 和自定义ANTHROPIC_BASE_URL不支持； - 本机进程会保持运行，网络不会长期断开。
启动方式
# 一个可在本机输入、也可远程接续的交互会话
cd /path/to/project
claude --remote-control "修复登录重复提交"
# 同一进程按需提供多个会话，并让新会话使用隔离 worktree
claude remote-control --name "Web 项目" --spawn worktree --capacity 4已有 CLI 会话中输入：
/remote-control 修复登录重复提交VS Code 扩展的提示框中输入 /remote-control 或 /rc；连接后 banner 会显示状态，可点 Open in browser。VS Code 入口不接受名称参数，也不显示 QR code。
从另一台设备连接
- 打开终端给出的 session URL，进入
claude.ai/code；或扫描 QR code。 - 在 Claude 移动 App 中也可进入 Code，按名称找到带绿色在线状态的会话。
- 远程发送指令、查看工具动作并处理权限请求。
- 回到电脑后继续使用同一会话；不要另开一个未隔离进程同时修改相同文件。
Remote Control 只建立本机到 Anthropic API 的出站 HTTPS 连接，不会在电脑上开放入站端口。流量经 TLS 传输，并使用用途独立、短期有效的凭据。
结束条件与故障边界
- 普通交互进程一次只有一个 Remote Control session；多会话使用 server mode。
- 关闭 terminal、退出 VS Code 或停止
claude进程会结束远程会话。 - 本机在线但无法联网约 10 分钟后，会话会超时并退出，需要重新启动。
Remote Control requires a claude.ai subscription通常表示当前不是 claude.ai OAuth 登录；先清除冲突的 API Key 环境，再重新登录。- Team / Enterprise 报组织策略禁用时，由 Owner 检查管理端 Remote Control 开关；本机无法绕过。
本地定时任务
Desktop 的 Routines 可创建访问本地文件的周期任务：
- 打开侧栏 Routines，点击 New routine > Local。
- 填写 Name、Description、Instructions、模型、权限模式和工作目录。
- Git 项目建议打开 worktree 隔离；否则任务会直接基于当前 working directory，包括未提交修改。
- 选择 Manual、Hourly、Daily、Weekdays 或 Weekly；更复杂频率可在会话中用自然语言要求 Claude 设置。
- 保存后先点 Run now，审一次完整权限、diff 和结果，再启用周期执行。
本地 routine 只在 Desktop 开着且电脑醒着时运行。唤醒后会检查最近 7 天的遗漏，但只补跑最近一次；需要电脑关机后仍可靠运行的任务，应选择云端 routine，而不是把本地计划任务当成后台服务器。
交付检查
- 会话环境确实是预期的 Local、Remote、SSH 或 WSL。
- 每个并行 session 的 worktree、分支、端口和外部资源互不冲突。
- Manual proposed diff 与最终完整 Git diff 都已检查。
- 测试、类型检查、构建或预览在正确 working directory 实际运行。
- Preview 使用测试账号，外部站点只授权必要域名和动作。
- Remote Control 与云端 Remote 没有混淆；本机进程退出的影响已经明确。
- PR 的 Auto-fix、Auto-merge 和定时任务都经过单独授权与首次人工验收。
官方资料
- Model configuration
- Get started with the desktop app
- Desktop application
- Schedule recurring tasks in Claude Code Desktop
- Use Claude Code in VS Code
- Continue local sessions with Remote Control
- Platforms and integrations
- Claude Desktop on Linux
- Claude Code Desktop in WSL
- Claude Code product page
- Week 28: in-app browser on Desktop