选择平台与集成
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 |
| 需要可视化预览、并行会话、图形化 diff | Desktop |
| 长任务要离开电脑继续跑 | 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 | 行内差异、集成终端、文件上下文 |
| JetBrains | IntelliJ、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. 本章自检
试着用自己的话回答:
- 为什么平台选择的核心不是“哪个最强”,而是“Agent 跑在哪里”?对应 §1。
- CLI、Desktop、IDE、Web 四者的主要取舍是什么?对应 §2-§6。
- 为什么 Web session 不能直接访问你本机的 user-level MCP 和未提交文件?对应 §6。
- Remote Control 和 Dispatch 的区别是什么?对应 §7。
- 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 等外部系统。
官方来源
- Platforms and integrations
- Use Claude Code Desktop
- Claude Code on the web
- Remote Control
- Claude Code in Slack
- Claude Code GitHub Actions
接下来去哪
配置 Claude Code
选好入口后,下一步是理解 settings scope:哪些配置属于个人,哪些属于项目,哪些该由管理员下发。
登录与认证(上一篇)
如果 Remote Control、Web 或 Slack 不能用,先回到认证篇检查当前生效凭据。
深度理解:Claude Code 是什么
入口选择背后的底层逻辑,是 Claude Code 作为本地编程 Agent 的工作方式。
如果只记一个判断:先从 CLI 建立完整心智模型,再按任务需要叠加 Desktop、IDE、Web、Mobile 和团队集成;入口可以混用,但上下文、凭据和运行位置必须分清。