AI 编程教程中文版
官方教程中文版入门与安装

选择平台与集成

Claude Code 同一套智能体循环可以跑在 CLI、Desktop、IDE、Web、Mobile、Slack 和 CI/CD。选入口先看项目在哪里、任务要不要长跑、你需不需要视觉审查。

Claude Code 不是只有终端一种用法。真正的选择题是:你的项目在哪里、你想怎么审查改动、任务能不能离开电脑继续跑、团队要不要从 Slack 或 CI 触发。入口不同,底层 Agent 相同,工作边界不同。——翔宇

这一章用 12 分钟换什么:前面三章完成了产品定位、安装和登录。这一章帮你选入口:什么时候用 CLI,什么时候用 Desktop 或 IDE,什么时候把任务交给 Web、Mobile、Slack、CI/CD 或 Remote Control。

1. 先问“项目在哪里”

新手最容易问错问题:

Claude Code 哪个平台最好?

更好的问题是:

我的项目在哪里?我用什么方式审查结果?任务要不要离开电脑继续跑?

官方 Platforms and integrations 文档的核心意思是:Claude Code 在各个入口使用同一套底层引擎(same underlying engine),但每个 surface(界面)面向不同工作方式。

所以不要把 CLI、Desktop、IDE、Web 看成互相替代。它们更像同一套 Agent(智能体)的不同驾驶舱。

先用这张表快速判断:

你的主要需求优先界面
项目在本机或远程终端,想看完整工具链CLI
主要在编辑器里审 diff 和改小范围代码VS Code / JetBrains
需要可视化预览、并行会话、图形化 diffDesktop
长任务要离开电脑继续跑Claude Code on the Web
团队从聊天、PR 或 CI 触发任务Slack / GitHub Actions / GitLab CI

第一性原理:平台选择不是功能多寡排序,而是“Agent 运行在哪里、上下文从哪里来、结果怎么审、风险由谁把关”。

2. 六个主要入口怎么选

先看总表。

入口最适合你得到什么
CLI终端工作流、脚本、远程服务器、本机完整工具链最完整功能、Agent SDK、第三方供应商、macOS computer use
Desktop视觉审查、并行会话、差异和预览图形界面、内置终端、文件编辑器、PR 监控
VS Code不想离开 VS Code行内差异、集成终端、文件上下文
JetBrainsIntelliJ、PyCharm、WebStorm 等差异查看器、选区共享、终端会话
Web长任务、断线后继续跑、云端仓库Anthropic 托管云端会话
Mobile离开电脑后发起或监控任务云端会话、Remote Control、Dispatch

官方说 CLI 是 terminal-native work(终端原生工作)的最完整界面(surface)。原因是脚本和 Agent SDK 都是 CLI-only(仅 CLI)。第三方 provider(供应商)也能在 VS Code 使用;Enterprise Desktop 支持 Vertex AI 和 gateway provider,但 Bedrock 或 Foundry 更适合走 CLI 或 VS Code。

Desktop 和 IDE 牺牲一些 CLI-only 能力,换来视觉审查和编辑器贴合。

Web 跑在 Anthropic cloud(Anthropic 云端),所以你断开连接后任务还能继续。

Mobile 更像薄客户端:要么看 cloud session,要么通过 Remote Control 接本机会话,要么用 Dispatch 把任务发给 Desktop。

新手路线:先学 CLI,理解完整工作流;再按你的审查习惯加 Desktop 或 IDE;需要长任务再上 Web;团队协作再接 Slack / CI。

3. CLI:先学它,因为它暴露最完整边界

CLI 是最适合学习 Claude Code 的入口。

原因不是它“更高级”,而是它把关键边界暴露得最清楚:

  • 当前工作目录是什么。
  • Git 状态是什么。
  • 哪些命令真的跑了。
  • 权限弹窗对应哪个工具调用。
  • 测试、lint、构建输出是什么。
  • 环境变量和凭据来自哪个 shell。

典型启动方式:

cd your-project
claude

适合 CLI 的任务:

场景为什么
修 bug / 加功能能直接读写项目和跑测试
远程服务器SSH 后直接进入项目目录
脚本和自动化CLI 参数、headless、Agent SDK 更自然
第三方供应商Bedrock / Vertex / Foundry 等多从 CLI 环境变量进入
精细权限调试/status/permissions、shell 环境更透明

CLI 不是“不安全”:CLI 只是更接近工程现场。风险来自你给的权限、当前目录和命令环境,不来自“终端”本身。

4. Desktop:适合看得见的开发过程

Claude Code Desktop 的 Code tab 更像一个图形化工作台。

官方 Desktop 文档里列了很多能力:parallel sessions、Git isolation、drag-and-drop pane layout、integrated terminal and file editor、side chats、computer use、Dispatch sessions、visual diff review、app previews、PR monitoring、connectors、enterprise configuration。

新手不需要一次记完,先记这 8 个判断点:

  • Visual diff review:想在图形界面里审改动。
  • App preview:前端 / Web app 需要边改边看效果。
  • Parallel sessions:多个任务并行,互不干扰。
  • Integrated terminal:不想回终端看命令输出。
  • File editor:想直接打开和编辑文件。
  • Side question:想问旁支问题但不打断主任务。
  • Dispatch:手机发任务,让 Desktop 在你的机器上开 session。
  • PR monitoring:看 PR 和 CI 状态。

边界也要记住:

  • Desktop app 当前没有 Linux 版;Linux 用户用 CLI。
  • Windows 首次打开 Code tab 需要 Git for Windows。
  • Desktop 的每个 conversation 是一个独立 session,有自己的项目目录、聊天历史和代码改动。
  • Desktop 适合视觉审查,不等于可以跳过权限和 diff。

什么时候用 Desktop:你要同时看聊天、diff、preview、terminal 和文件时,Desktop 比纯 CLI 舒服。

5. VS Code 和 JetBrains:减少上下文切换

IDE 插件解决的是另一个问题:你已经在编辑器里,不想频繁切终端和浏览器。

VS Code 更适合:

  • 看 inline diffs。
  • 使用 integrated terminal。
  • 让 Claude 直接拿到当前文件上下文。
  • 在编辑器里快速审查小改动。

JetBrains 更适合:

  • IntelliJ、PyCharm、WebStorm、GoLand 等长期用户。
  • selection sharing,把你选中的代码传给 Claude。
  • 用 IDE diff viewer 审改动。
  • 在 JetBrains terminal session 里继续 Claude Code 流程。

IDE 的取舍也很清楚:

  • 审查改动更顺手,但不如 CLI 暴露完整运行环境。
  • 当前文件上下文更自然,但复杂自动化仍要理解 CLI。
  • 切换成本低,但远程、脚本、第三方供应商场景不一定最直接。

不要把 IDE 当唯一入口:IDE 很适合看和改,但真正理解 Claude Code 的权限、认证、路径、自动化,仍然要懂 CLI。

6. Web:任务在云端继续跑

Claude Code on the Web 适合长任务和云端仓库任务。官方当前把它标为 research preview(研究预览),适用于 Pro、Max、Team,以及部分 Enterprise 席位。

官方 Web 文档里有几个关键事实:

  • 每个 session(会话)跑在 fresh Anthropic-managed VM(全新的 Anthropic 托管虚拟机),不是你的本机环境。
  • 仓库会被 clone 到云端,commit 到 repo 的内容才可用。
  • 本机用户配置不会自动带过去,user-level MCP、local secrets、未提交改动不在云端。
  • .claude/settings.json.mcp.json.claude/skills/ 等 repo 文件可用,所以团队配置要提交进仓库。
  • 还没有专用 secrets store,环境变量和 setup scripts 可被有权限编辑环境的人看到。

这意味着 Web 很适合:

  • 长时间重构。
  • 后台修 lint、补测试。
  • 你离开电脑也要继续跑的任务。
  • 从 Slack、Mobile 或网页发起的云端 session。

不适合:

  • 依赖你本机未提交文件的任务。
  • 依赖本机 private credentials 的任务。
  • 需要本机 GUI、特定硬件、特殊内网环境的任务。

把云端 session 拉回终端,用 Teleport:

claude --teleport

或在已有 CLI session 里:

/teleport

注意 Teleport 要求:clean git state、同一个仓库、云端分支已 push、同一个 Claude.ai 账号。API key、Bedrock、Vertex AI、Foundry 认证不支持 Teleport。

Web 不是你的本机延长线:它是云端新 VM。只有提交到仓库和配置到 cloud environment 的东西,才可靠存在。

7. Mobile、Remote Control 和 Dispatch

离开电脑后,官方提供几种方式继续工作。

最容易混淆的是 Remote Control 和 Dispatch:

  • Remote Control:Claude 跑在你的本机 CLI 或 VS Code session,你从 claude.ai/code 或 Claude mobile app 控制。适合接管正在跑的本机会话。
  • Dispatch:Claude 跑在你的机器上的 Desktop session,由 Claude mobile app 发任务。适合从手机派一个新任务给 Desktop。
  • Mobile cloud session(移动端云会话):Claude 跑在 Anthropic cloud,由 Claude iOS / Android app 发起或监控云端任务。

Remote Control 当前也是 research preview(研究预览),对 Claude Code 版本有最低要求;具体版本号以官方 Remote Control 页 当前说明为准(功能在快速迭代)。普通交互会话可以这样启动:

claude --remote-control

也可以给 session 起名:

claude --remote-control "My Project"

它不需要你机器打开入站端口。官方说明是:本地 session 通过 HTTPS outbound 连接 Anthropic API,远端浏览器或手机通过 Anthropic 服务器路由消息。

Remote Control 的边界:

  • 需要 Claude.ai OAuth full-scope login。
  • CLAUDE_CODE_OAUTH_TOKEN 这种长期 token 不够。
  • API key、Bedrock、Vertex AI、Foundry 不支持 Remote Control。
  • Team / Enterprise 默认关闭,需要管理员在 Claude Code 管理设置里开启。
  • 网络断开太久,本地 session 会超时退出;官方文档给出的参考是大约 10 分钟。

远程控制不是云端执行:Remote Control 只是从手机或浏览器控制你的本机 session。机器睡眠、断网、目录状态异常,都会影响它。

8. Chrome、Slack、CI/CD 和 Code Review

集成层解决的是“让 Claude Code 进入已有工作流”。

官方 platforms 页面列的常见集成可以按场景理解:

  • Chrome:控制已登录浏览器,适合测 Web app、填表、自动化没有 API 的网站。
  • GitHub Actions:在 CI 中运行 Claude,适合 PR review、issue triage、定时维护。
  • GitLab CI/CD:在 GitLab 流水线中运行 Claude,适合 GitLab 项目自动化。
  • Code Review:自动审查 PR,重点看逻辑错误、安全风险和回归。
  • Slack:在频道里 @Claude 发起任务,适合从团队讨论直接生成 session / PR。
  • MCP / connectors:接 Linear、Notion、Google Drive、内部 API,适合连接外部系统。

Slack 要特别注意权限边界:

  • 需要 Claude Code on the Web enabled。
  • 需要 GitHub 账号连接到 Claude Code on the Web。
  • 每个用户用自己的 Claude account 和计划额度。
  • Claude 只响应它被邀请进的 channel。
  • Slack direct messages(私信)不支持,只支持公开或私有 channel。
  • Slack thread 和 channel context 会被用于理解任务,要只在可信频道使用。
  • 当前 Slack 集成只支持 GitHub 仓库。

CI/CD 也不要直接全自动放飞。以 GitHub Actions 为例,官方示例会把 Claude 用在 pull_request 上做 review,并限制 turns。团队应该明确 token、权限、仓库范围和输出位置。

团队集成原则:越靠近公共频道、CI、PR 和生产流程,越要把权限、审查和日志写清楚。集成不是绕过审查,而是把审查前移。

9. 怎么做选择

把前八节压成一张决策树:

flowchart TD
    Q1{第一次学 Claude Code<br/>或日常本机项目?}
    Q1 -->|是| CLI[CLI]
    Q1 -->|否| Q2{需要视觉 diff 或<br/>app preview?}
    Q2 -->|是| Desktop[Desktop 或 IDE + preview]
    Q2 -->|否| Q3{要离开电脑<br/>继续跑长任务?}
    Q3 -->|是| Web[Web / Mobile]
    Q3 -->|否| Q4{团队从 Slack / PR / CI<br/>触发任务?}
    Q4 -->|是| Team[Slack / GitHub Actions / Code Review]
    Q4 -->|否| CLI

    style CLI fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
    style Desktop fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style Web fill:#dcfce7,stroke:#22c55e,stroke-width:2px
    style Team fill:#fce7f3,stroke:#ec4899,stroke-width:2px

实用选择可以先按这个顺序判断:

  • 第一次学习 Claude Code:CLI。
  • 日常本机项目,喜欢终端:CLI。
  • 前端改动需要看页面:Desktop 或 IDE + preview。
  • 不想离开 VS Code:VS Code。
  • JetBrains 重度用户:JetBrains。
  • 长任务,离开电脑也要继续跑:Web。
  • 手机上派任务给自己电脑:Dispatch + Desktop。
  • 手机上接管正在跑的本机任务:Remote Control。
  • 团队从 Slack 讨论转任务:Slack + Web。
  • PR 自动审查:Code Review / GitHub Actions。
  • 连接外部系统:MCP / connectors。

更简单的版本:

现在要做什么直接选
学习和本机开发CLI
视觉审查和预览Desktop
不想离开编辑器VS Code / JetBrains
离开电脑也要继续Web / Mobile
团队触发和自动化Slack / CI / Code Review

10. 本章自检

试着用自己的话回答:

  1. 为什么平台选择的核心不是“哪个最强”,而是“Agent 跑在哪里”?对应 §1。
  2. CLI、Desktop、IDE、Web 四者的主要取舍是什么?对应 §2-§6。
  3. 为什么 Web session 不能直接访问你本机的 user-level MCP 和未提交文件?对应 §6。
  4. Remote Control 和 Dispatch 的区别是什么?对应 §7。
  5. Slack 和 CI/CD 集成为什么更需要权限和审查边界?对应 §8。

过关标准:你能为一个真实任务选出入口,并能说明项目在哪里、谁审结果、任务是否需要离线继续、哪些凭据和权限会被用到。

本篇术语速查表
  • Surface:界面,CLI、Desktop、IDE、Web、Mobile 这类交互界面。
  • CLI:命令行入口,最完整、最适合学习和自动化的本地入口。
  • Agent SDK:智能体开发包,用来把 Claude Code 能力接入脚本或自动化系统。
  • Computer use:电脑控制,让 Claude 在支持的平台上操作本机应用或浏览器。
  • Desktop:桌面应用,图形化 Code tab,适合 diff、preview、并行 session。
  • IDE extension:编辑器扩展,VS Code / JetBrains 内的 Claude Code 入口。
  • Web session:云端会话,跑在 Anthropic-managed VM 的 Claude Code session。
  • Teleport:传送会话,把云端 session 拉回本地 CLI 的机制。
  • Remote Control:远程控制,从 Web 或 mobile 控制本机 CLI / VS Code session。
  • Dispatch:派发任务,从手机把任务发给 Desktop 创建 session。
  • Channels:频道触发,从 Telegram、Discord 或自建服务推事件进 CLI session。
  • Code Review:代码审查集成,自动审查 PR 的 Claude Code 集成。
  • Connectors:连接器,接入 Linear、Notion、Google Drive 等外部系统。

官方来源

接下来去哪

如果只记一个判断:先从 CLI 建立完整心智模型,再按任务需要叠加 Desktop、IDE、Web、Mobile 和团队集成;入口可以混用,但上下文、凭据和运行位置必须分清。

本页目录