---
title: "选择平台与集成"
description: "Claude Code 同一套智能体循环可以跑在 CLI、Desktop、IDE、Web、Mobile、Slack 和 CI/CD。选入口先看项目在哪里、任务要不要长跑、你需不需要视觉审查。"
canonical: "https://xiangyugongzuoliu.com/tag/claude-code"
verifiedAt: "2026-05-08"
---

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

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

## 1. 先问“项目在哪里”

新手最容易问错问题：

```text
Claude Code 哪个平台最好？
```

更好的问题是：

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

官方 [Platforms and integrations](https://code.claude.com/docs/en/platforms) 文档的核心意思是：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 |

> [!IMPORTANT]
> **第一性原理**：平台选择不是功能多寡排序，而是“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。

> [!TIP]
> **新手路线**：先学 CLI，理解完整工作流；再按你的审查习惯加 Desktop 或 IDE；需要长任务再上 Web；团队协作再接 Slack / CI。

## 3. CLI：先学它，因为它暴露最完整边界

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

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

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

典型启动方式：

```bash
cd your-project
claude
```

适合 CLI 的任务：

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

> [!WARNING]
> **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。

> [!TIP]
> **什么时候用 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。
- 切换成本低，但远程、脚本、第三方供应商场景不一定最直接。

> [!IMPORTANT]
> **不要把 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：

```bash
claude --teleport
```

或在已有 CLI session 里：

```text
/teleport
```

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

> [!CAUTION]
> **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 页](https://code.claude.com/docs/en/remote-control) 当前说明为准（功能在快速迭代）。普通交互会话可以这样启动：

```bash
claude --remote-control
```

也可以给 session 起名：

```bash
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 分钟。

> [!WARNING]
> **远程控制不是云端执行**：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、权限、仓库范围和输出位置。

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

## 9. 怎么做选择

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

```mermaid
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。

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

<details id="glossary">
<summary><b>本篇术语速查表</b></summary>

- **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 等外部系统。

</details>

## 官方来源

- [Platforms and integrations](https://code.claude.com/docs/en/platforms)
- [Use Claude Code Desktop](https://code.claude.com/docs/en/desktop)
- [Claude Code on the web](https://code.claude.com/docs/en/claude-code-on-the-web)
- [Remote Control](https://code.claude.com/docs/en/remote-control)
- [Claude Code in Slack](https://code.claude.com/docs/en/slack)
- [Claude Code GitHub Actions](https://code.claude.com/docs/en/github-actions)

## 接下来去哪

<Cards>
  <Card href="/docs/claude-code/official/01-core-capabilities/settings" title="配置 Claude Code" description="选好入口后，下一步是理解 settings scope：哪些配置属于个人，哪些属于项目，哪些该由管理员下发。" />
  <Card href="/docs/claude-code/official/00-getting-started/authentication" title="登录与认证（上一篇）" description="如果 Remote Control、Web 或 Slack 不能用，先回到认证篇检查当前生效凭据。" />
  <Card href="/docs/claude-code/understanding/01-what-is-claude-code" title="深度理解：Claude Code 是什么" description="入口选择背后的底层逻辑，是 Claude Code 作为本地编程 Agent 的工作方式。" />
</Cards>

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