Index

--- title: 多平台支持 description: Claude Code 可在终端、IDE、桌面应用、浏览器和云端运行，本篇梳理各平台的特点、安装方式和适用场景

本文你会学到：

• Claude Code 的统一底层引擎是什么，为什么跨平台体验一致
• 终端 CLI、VS Code 扩展、JetBrains 插件各自的特色功能
• 桌面应用和 Web 版如何让非终端用户也能用上 Claude Code
• Chrome 扩展和 DevContainer 两个特殊场景
• 无头模式（Headless）如何支撑自动化工作流
• Computer Use 的平台可用性约束和 CLI 与 Desktop 的差异
• Remote Control 在各平台的启动方式、连接手段和移动推送通知

🗂️ 平台全景图¶

Claude Code 的核心是一个 统一引擎 —— 无论你在哪个平台上使用，底层跑的都是同一套 Agentic Loop、同一套工具集、同一套权限系统。区别只在于**外壳**（用户界面）和**集成深度**（与宿主环境的交互程度）。

打个比方：Claude Code 的引擎就像一颗「处理器」，而各平台相当于不同的「主板」——处理器一样，但插在不同的主板上，能发挥的功能侧重点不同。

graph TD
  Engine["统一引擎<br/>Agentic Loop + Tools + 权限"]
  Engine --> CLI["终端 CLI"]
  Engine --> VSC["VS Code 扩展"]
  Engine --> JB["JetBrains 插件"]
  Engine --> Desktop["桌面应用"]
  Engine --> Web["Web 版"]
  Engine --> Chrome["Chrome 扩展"]
  Engine --> CU["Computer Use<br/>（macOS 研究预览）"]
  Engine --> RC["Remote Control<br/>（远程操控本地会话）"]
  Engine --> DevC["DevContainer"]
  Engine --> Headless["无头模式"]

  style Engine fill:transparent,stroke:#539bf5,color:#adbac7,stroke-width:2px
  style CU fill:transparent,stroke:#f57c00,color:#adbac7,stroke-width:1px
  style RC fill:transparent,stroke:#f57c00,color:#adbac7,stroke-width:1px
  style CLI fill:transparent,stroke:#768390,color:#adbac7,stroke-width:1px
  style VSC fill:transparent,stroke:#768390,color:#adbac7,stroke-width:1px
  style JB fill:transparent,stroke:#768390,color:#adbac7,stroke-width:1px
  style Desktop fill:transparent,stroke:#768390,color:#adbac7,stroke-width:1px
  style Web fill:transparent,stroke:#768390,color:#adbac7,stroke-width:1px
  style Chrome fill:transparent,stroke:#768390,color:#adbac7,stroke-width:1px
  style DevC fill:transparent,stroke:#768390,color:#adbac7,stroke-width:1px
  style Headless fill:transparent,stroke:#768390,color:#adbac7,stroke-width:1px

各平台一览¶

跨平台共享什么¶

无论你在哪个平台启动 Claude Code，以下内容都是**共享和同步**的：

• CLAUDE.md 项目配置（全局级 + 项目级）
• MCP 服务器配置
• Settings 和权限偏好
• claude.ai 上的会话历史（通过 Cloud 同步）

这就意味着你可以在 IDEA 里开始一段对话，切到 Web 版继续，最后在终端里收尾 —— 上下文不会丢失。

🖥️ 终端 CLI¶

终端 CLI 是 Claude Code 的**原生形态**，也是功能最完整的版本。所有其他平台本质上都是对 CLI 能力的封装和适配。

安装方式¶

Claude Code 提供多种安装渠道，选择你最顺手的即可：

1

irm https://claude.ai/install.ps1 | iex

1

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

1

winget install Anthropic.ClaudeCode

1

curl -fsSL https://claude.ai/install.sh | bash

1

brew install claude-code

1

npm install -g @anthropic-ai/claude-code

安装完成后，在终端输入 claude 即可启动。

Windows 专属特性¶

Claude Code 在 Windows 上持续改进，以下是近期值得关注的平台增强：

• PowerShell Tool：新增原生的 PowerShell 工具（v2.1.111 新增，逐步推出），通过 CLAUDE_CODE_USE_POWERSHELL_TOOL 环境变量选择加入。启用后 Claude 可以直接在 PowerShell 中执行命令，无需 Bash 适配层，PowerShell 原生命令和管道语法都能原生使用
• Ctrl+Backspace 删除单词：Windows 终端中 Ctrl+Backspace 现在会删除前一个单词（v2.1.113 新增），与其他平台行为一致
• macOS Terminal.app 渲染修复：修复了在不支持同步输出的终端（如 macOS Terminal.app）中启动时出现的渲染乱码问题（v2.1.110 修复）
• WSL 继承 Windows 设置：WSL on Windows 现在可通过 wslInheritsWindowsSettings 策略键继承 Windows 侧的托管设置（v2.1.118 新增），企业环境下无需在 WSL 中重复配置策略
• PowerShell 检测增强：PowerShell 7 的检测机制得到改进（v2.1.126 改进），现在可正确识别通过 Microsoft Store、不带 PATH 的 MSI 安装或 .NET global tool 安装的 PowerShell 7。此前这些安装方式可能无法被检测到，导致 PowerShell 工具不可用
• PowerShell 优先：当 PowerShell 工具启用时，Claude 现在将 PowerShell 作为主 shell 而非默认 Bash（v2.1.126 改进）。这意味着 Windows 用户在使用 PowerShell 工具时，Claude 会优先使用 PowerShell 执行命令，与 Windows 原生开发体验更一致

核心特性¶

CLI 模式提供所有平台中**最完整的特性集**：

何时选择 CLI¶

• 你日常就在终端工作，不想切换到别的界面
• 你需要用脚本驱动 Claude Code（结合无头模式）
• 你需要所有最新特性，不想等扩展适配

📝 VS Code 扩展¶

VS Code 扩展将 Claude Code 嵌入编辑器侧边栏，让你**不用离开 IDE 就能和 Claude 对话**（v2.0.0 作为原生扩展发布）。

安装¶

在 VS Code 扩展商店搜索 "Claude Code"，点击安装即可。如果你的编辑器是 Cursor，操作方式一样。

与 CLI 的区别¶

VS Code 扩展的核心价值在于**与编辑器的深度集成**，它多了以下能力：

典型工作流¶

1. 在编辑器中写代码，遇到问题选中代码
2. 在侧边栏输入 @ 提及相关文件
3. Claude 生成修改方案，你在 diff 视图中审阅
4. 确认后 Claude 应用更改

🔌 JetBrains 插件¶

JetBrains 插件支持 IntelliJ IDEA、PyCharm、WebStorm、GoLand 等 JetBrains 全家桶，让你在熟悉的 Java/Python/前端 IDE 中直接使用 Claude Code。

安装¶

在 JetBrains Marketplace 搜索 "Claude Code"，安装后重启 IDE。

特色功能¶

与 IDEA MCP 的区别¶

如果你已经在用 JetBrains 的 MCP Server（通过 idea MCP 调用 get_symbol_info、build_project 等工具），你可能会疑惑这两个东西的关系：

• JetBrains 插件：把 Claude Code 的完整对话体验嵌入 IDE，你获得的是一个 Agent（能自主思考、多步操作）
• IDEA MCP Server：把 IDE 的能力（代码补全、重构、构建）暴露为 MCP 工具，让 Claude Code **调用**这些能力

两者是**互补关系**：插件提供 UI 入口，MCP 提供 IDE 能力。最佳实践是同时安装插件和配置 MCP Server。

🖼️ 桌面应用¶

Claude Code Desktop 是一个**独立的图形化应用**，为不习惯终端的用户提供了更友好的入口（v2.0.51 发布）。

核心体验¶

桌面应用提供三个标签页：

特色功能¶

何时选择桌面应用¶

• 你不太习惯终端操作，更喜欢图形界面
• 你需要同时处理多个独立任务
• 你想在本地开始一个任务，之后在手机上继续

🌐 Web 版¶

Web 版让你**无需安装任何东西**，直接在浏览器中使用 Claude Code。

访问方式¶

打开 claude.ai/code 即可使用。它实际上运行在 Anthropic 的 Cloud VM 上，所以你的本地机器不需要有开发环境。

工作原理¶

Web 版的核心是 Teleport 技术（v2.0.24 新增）：你的代码会自动上传到 Anthropic 的云端虚拟机，Claude Code 在云端运行，修改后的代码再同步回你的 GitHub 仓库。

这意味着：

• ✅ 你可以处理**不在本地的仓库**（比如 GitHub 上的开源项目）
• ✅ 适合**长时间运行**的任务（不怕关掉电脑）
• ✅ 手机上也能用（通过 Claude iOS App）
• ⚠️ 需要稳定的网络连接
• ⚠️ 首次使用需要授权 GitHub 访问权限

何时选择 Web 版¶

• 你在别人的电脑上临时需要使用
• 你想处理一个只存在于 GitHub 上的项目
• 你需要跑一个长时间任务，不想占用本地资源

🧩 Chrome 扩展¶

本节从**平台视角**概述 Chrome 扩展的定位和核心能力。详细的安装步骤、可用工具列表、工作流示例和故障排除，参见 第三方集成 — Chrome 扩展 章节。

Chrome 扩展是一个**比较特殊的存在**（v2.0.72 推出 Beta 版） —— 它不是为了在浏览器里写代码，而是为了让 Claude Code 能够**控制和调试 Web 应用**。

核心能力¶

Chrome 扩展通过 Native Messaging 协议与本地运行的 Claude Code CLI 通信，从而实现：

使用场景¶

一个典型场景：你的前端项目有一个交互 bug（按钮点击后没反应），你可以：

1. 启动 Chrome 扩展
2. 告诉 Claude Code："打开 localhost:3000，点击提交按钮，看看发生了什么"
3. Claude Code 通过扩展控制浏览器，观察实际行为，分析问题

注意事项¶

• Chrome 扩展**不是独立运行**的，它需要本地同时运行 Claude Code CLI
• Chrome 扩展支持 macOS、Windows 和 Linux（Computer Use 详见下方章节，仅 macOS）
• 它本质上是一种**浏览器自动化**能力，类比 Selenium/Playwright，但由 AI 驱动

🖥️ Computer Use 的平台可用性¶

Computer Use 是 Claude Code 中一项让 Claude 直接操控你电脑界面的能力（点击、输入、截图），在「第三方集成」笔记中已经介绍了它的应用分级控制、安全机制和工作流。这里从**平台视角**补充可用性信息。

可用性约束¶

Computer Use 目前是一个 macOS 研究预览版，有明确的平台和使用限制：

如果你在 /mcp 中看不到 computer-use 服务器，逐一排查上表中的条件即可定位原因。运行 claude --version 检查版本，/status 确认订阅。

CLI 与 Desktop 的差异¶

Computer Use 的底层引擎在 CLI 和 Desktop 应用之间是共享的，但 Desktop 提供了一些 CLI 尚不具备的图形化控制：

安全机制的平台特有行为¶

从平台运行时的角度看，Computer Use 有两个值得注意的行为：

• 锁文件机制：Computer Use 活跃时持有机器范围的锁，同一时间只有一个 Claude Code 会话可以控制你的机器。如果另一个会话已持有锁，新尝试会失败并提示哪个会话正在使用。进程崩溃后锁会自动释放。
• 全局转义：在任何地方按 Esc 会中止 Computer Use，且按键事件被系统消耗，不会被应用接收。这防止了通过屏幕内容的提示注入利用 Esc 关闭对话框。

更详细的分级控制表、安全哨兵机制和工作流示例，参见「第三方集成」笔记中的 Computer Use 章节。

📡 Remote Control 的平台支持¶

Remote Control 让你在手机、平板或另一台电脑上继续操控本地运行的 Claude Code 会话。它与「Web 版」不同——Remote Control 中 Claude 始终在你**本地机器**上运行，手机和浏览器只是一个远程窗口。

可用性¶

各平台的启动方式¶

Remote Control 在 CLI 和 VS Code 中有不同的启动体验：

远程连接方式¶

一旦 Remote Control 会话处于活跃状态，你有三种方式从另一台设备连接：

• 会话 URL：在任意浏览器中打开，直接跳转到 claude.ai/code 上的会话
• QR 码：CLI 模式下按空格键切换 QR 码显示，用 Claude 移动应用扫描即可打开（CLI 专属功能，VS Code 不支持）
• 会话列表：打开 claude.ai/code 或 Claude 应用，在线的 Remote Control 会话会显示绿色计算机图标

移动推送通知（v2.1.110+）¶

当 Remote Control 处于活动状态时，Claude 可以向你的手机发送推送通知。Claude 会自主判断何时推送（通常在长时间任务完成或需要你做决定时），你也可以在提示中主动请求（例如 notify me when the tests finish）。

推送通知的设置步骤：

1. 下载 Claude 移动应用（iOS / Android）
2. 使用与 Claude Code 相同的账户登录
3. 接受操作系统的通知权限
4. 在 Claude Code 中运行 /config，启用「当 Claude 决定时推送」

与 Web 版的关键区别¶

详细的 Remote Control CLI 标志、连接配置和故障排除，参见「第三方集成」笔记中的 Channel 与其他集成方式对比 章节。

📦 DevContainer 支持¶

DevContainer（Development Container）让你在 **Docker 容器**中运行 Claude Code，实现开发环境的完全隔离。

为什么需要 DevContainer¶

想象你有三个项目：一个用 Node.js 18，一个用 Node.js 20，还有一个用 Python 3.12。每次切换项目都需要调整环境，一不小心就会版本冲突。

DevContainer 的解决方式是：每个项目一个独立的 Docker 容器，容器内包含该项目所需的一切依赖。Claude Code 在容器内运行，自然也就用上了正确的环境。

如何使用¶

在你的项目根目录下创建 .devcontainer/devcontainer.json，定义容器配置，然后：

1. 在 VS Code 中打开项目
2. VS Code 提示 "Reopen in Container" 时点击确认
3. Claude Code 自动在容器内启动

Claude Code 能自动检测 DevContainer 环境，无需额外配置。

典型配置¶

1
2
3
4
5
6
7
8
9

{
  "name": "My Project",
  "image": "mcr.microsoft.com/devcontainers/typescript-node:20",
  "customizations": {
    "vscode": {
      "extensions": ["anthropic.claude-code"]
    }
  }
}

适用场景¶

• 团队协作：确保所有成员使用**完全一致**的开发环境
• 多项目切换：不同项目的依赖互不干扰
• CI/CD 对齐：本地环境和 CI 环境保持一致

⚙️ 无头模式（Headless）¶

无头模式是 Claude Code 的**非交互运行方式**，主要用于自动化场景。你不会看到对话界面，Claude Code 直接接收指令、执行任务、返回结果。

核心概念¶

所有其他平台都是**交互式**的——你来我往地对话。而无头模式是**批处理式**的——给一个输入，等一个输出。

使用方式¶

无头模式有两种运行形态：

管道模式通过 -p 参数将 prompt 直接传入，适合简单任务：

1
2
3
4
5
6
7
8

# 让 Claude Code 分析一个文件的代码质量
claude -p "审查 src/utils/parser.ts 的代码质量，给出改进建议"

# 将结果输出为 JSON 格式，方便后续处理
claude -p "列出项目中所有 TODO 注释" --output-format json

# 指定输出到文件
claude -p "为这个 API 写单元测试" --output-file tests/api.test.ts

Agent SDK 提供 Python 和 TypeScript 两个 SDK 包，让你用编程语言直接调用 Claude Code，适合复杂的多步自动化工作流。

• TypeScript SDK：npm install @anthropic-ai/claude-code，通过 query() 函数发起会话
• Python SDK：pip install claude-code-sdk，同样提供 query() 函数

两个 SDK 均支持流式响应、权限控制、工具白名单等完整的无头模式能力。详细的 SDK API 用法参见 Sub-agents 笔记。

关键参数¶

--bare 模式¶

当你需要在 CI 或脚本中获得**一致、可复现**的结果时，--bare 是首选。它跳过 Hooks、Skills、Plugins、MCP 服务器、自动记忆和 CLAUDE.md 的自动发现——只有你显式传入的标志才会生效。队友的 ~/.claude 中的 Hook 或项目的 .mcp.json 中的 MCP 服务器都不会运行。

--bare 模式下，Claude 仍可访问 Bash、文件读取和文件编辑这三个基础工具。如果需要额外上下文，通过标志显式传入：

1
2

# 裸模式下运行一次性任务，预批准 Read 工具避免权限弹窗
claude --bare -p "Summarize this file" --allowedTools "Read"

⚠️ --bare 跳过 OAuth 和钥匙链读取。认证必须来自 ANTHROPIC_API_KEY 环境变量或 --settings 传入的 JSON 中的 apiKeyHelper。Bedrock、Vertex 和 Foundry 使用各自常规的提供商凭证。

结构化输出¶

使用 --output-format json 配合 --json-schema 可以让 Claude Code 返回符合特定 Schema 的结构化数据，适合在脚本中进一步处理：

1
2
3
4

# 提取 auth.py 中的函数名称，返回字符串数组
claude -p "Extract the main function names from auth.py" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'

响应中结构化数据在 structured_output 字段，会话元数据（会话 ID、用量统计等）也在 JSON 中。配合 jq 提取特定字段：

1
2
3
4
5
6
7
8

# 提取文本结果
claude -p "Summarize this project" --output-format json | jq -r '.result'

# 提取结构化输出
claude -p "Extract function names from auth.py" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}' \
  | jq '.structured_output'

流式响应¶

使用 --output-format stream-json 配合 --verbose 和 --include-partial-messages 可以实时接收生成的 token。每行是一个 JSON 事件对象：

1

claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages

用 jq 过滤文本增量，只显示流式文本：

1
2

claude -p "Write a poem" --output-format stream-json --verbose --include-partial-messages | \
  jq -rj 'select(.type == "stream_event" and .event.delta.type? == "text_delta") | .event.delta.text'

流式响应中包含多种系统事件，用于监控会话状态：

system/init 是流中的第一个事件，包含 plugins（成功加载的插件）和 plugin_errors（加载失败）。用 plugin_errors 在 CI 中检测插件是否正确加载，失败时中止构建。

自定义系统提示¶

使用 --append-system-prompt 在保持 Claude Code 默认行为的同时追加指令，适合定制化的自动化任务：

1
2
3
4

# 将 PR diff 传给 Claude，以安全工程师角色审查漏洞
gh pr diff "$1" | claude -p \
  --append-system-prompt "You are a security engineer. Review for vulnerabilities." \
  --output-format json

如果需要完全替换默认系统提示（而非追加），使用 --system-prompt。

会话延续¶

无头模式支持跨调用延续对话，实现多步骤自动化：

1
2
3
4
5
6

# 第一次请求
claude -p "Review this codebase for performance issues"

# 继续最近一次对话
claude -p "Now focus on the database queries" --continue
claude -p "Generate a summary of all issues found" --continue

运行多个对话时，捕获会话 ID 以恢复特定会话：

1
2
3
4
5

# 捕获会话 ID
session_id=$(claude -p "Start a review" --output-format json | jq -r '.session_id')

# 恢复指定会话
claude -p "Continue that review" --resume "$session_id"

典型自动化场景¶

权限处理¶

无头模式下 Claude Code 无法弹出交互式权限确认，需要预先配置权限策略。

指定允许的工具：

1
2
3
4
5
6
7

# 允许 Claude 使用 Bash 和文件操作，无需确认
claude -p "Run the test suite and fix any failures" \
  --allowedTools "Bash,Read,Edit"

# 使用权限规则语法精确控制命令范围
claude -p "Create an appropriate commit" \
  --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"

💡 Bash(git diff *) 中的尾部 * 启用前缀匹配——空格在 * 之前很重要。没有空格的 Bash(git diff*) 也会匹配 git diff-index 等命令。

设置权限模式：

1
2

# 使用 acceptEdits 模式让 Claude 直接写入文件
claude -p "Apply the lint fixes" --permission-mode acceptEdits

⚠️ 安全提示：在生产 CI 环境中，务必通过 --allowedTools 或 --permission-mode dontAsk 限制工具范围，避免 Claude Code 意外执行破坏性操作。

📝 平台选择指南¶

最后用一个决策流程帮你在实际工作中快速选择：

graph TD
  Start{你需要做什么？} --> A{需要自动化？}
  A -->|是| B["无头模式<br/>（Agent SDK / 管道模式）"]
  A -->|否| C{需要操控<br/>桌面 GUI？}
  C -->|是| D["Computer Use<br/>（macOS 研究预览）"]
  C -->|否| E{需要调试 Web 应用？}
  E -->|是| F["Chrome 扩展"]
  E -->|否| G{需要离开工位<br/>继续任务？}
  G -->|是| H["Remote Control"]
  G -->|否| I{需要环境隔离？}
  I -->|是| J["DevContainer"]
  I -->|否| K{你日常用什么 IDE？}
  K -->|VS Code / Cursor| L["VS Code 扩展"]
  K -->|IDEA / PyCharm| M["JetBrains 插件"]
  K -->|没有偏好 / 终端党| N{本地有开发环境吗？}
  N -->|有| O["终端 CLI"]
  N -->|没有 / 不在电脑旁| P["Web 版<br/>（claude.ai/code）"]

💡 核心原则：选你最顺手的平台就好。Claude Code 的能力是跨平台一致的，不存在"某个平台能用而另一个不能用"的功能。平台的区别只在于**交互体验**和**集成深度**——选择能让你最高效地描述需求、审阅结果的那一个。需要注意，Computer Use 目前仅限 macOS 研究预览，而 Remote Control 和 Chrome 扩展则支持更广泛的平台。