ShiBin's Wiki

Appearance

Published at:

第 4 章：平台生态概览 ​

Claude Code 不是一个单一形态的工具——它横跨终端、IDE、浏览器、桌面应用四种载体，共五种使用方式。理解这些方式的区别和适用场景，是选择正确工具、融入日常工作流的前提。

本章为你梳理完整的平台生态图景，并说明为什么本书以 VSCode 扩展为主要介绍对象。

4.1 五种使用方式对比 ​

Claude Code 目前提供五种使用形态，覆盖从纯命令行到图形界面的全场景：

产品平台安装/访问方式适用场景
Claude Code CLI终端 / SSHnpm install -g @anthropic-ai/claude-code远程服务器、无 GUI 环境、自动化脚本
Claude Code for VSCode ⭐VSCode扩展市场搜索 "Claude Code"日常首选 — IDE 深度集成，Diff 预览，侧边栏对话
JetBrains 插件IntelliJ / PyCharm / WebStorm插件市场搜索 "Claude Code"JetBrains 用户的 IDE 内体验
Web 界面浏览器claude.ai/code快速试用、临时任务、无需安装
Desktop 应用macOS / Windows官网下载独立桌面窗口，无需浏览器

无论选择哪种方式，背后的 Agent 引擎和模型能力是完全一致的。区别只在于交互界面的形式和 IDE 集成的深度。

4.2 Claude Code CLI ​

Claude Code CLI 是 Anthropic 提供的命令行原生交互方式，通过包管理器全局安装后即可在终端中使用。

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

# pnpm
pnpm install -g @anthropic-ai/claude-code

# 启动
claude

适用场景：

  • SSH 远程服务器：在开发机上无 GUI 环境时，CLI 是唯一选择
  • 自动化 & CI/CD：可通过非交互模式集成到脚本和流水线中
  • 习惯终端的开发者：Vim/Neovim/Emacs 用户、tmux 工作流
  • 轻量快速启动：无需打开 IDE，终端中直接 claude 即可开始对话

CLI 与 VSCode 扩展的差异 ​

方面CLIVSCode 扩展
交互界面终端纯文本侧边栏面板 + 编辑器 Diff
Diff 审查纯文本 diff内联双栏 Diff 预览，逐文件 Accept/Reject
文件上下文手动指定或靠对话上下文自动感知打开的文件和选中文本
安装方式npm install -gVSCode 扩展市场安装
视觉反馈无图形化展示代码高亮、诊断波浪线、颜色标记
多文件编辑逐一查看 diff 文本统一预览所有文件变更

CLI 的局限性：

CLI 的能力与 VSCode 扩展完全一致，但交互体验存在天然差距。所有的代码变更以纯文本 diff 呈现，没有并排对比视图，也没有内联的接受/拒绝按钮。在审查多文件大规模重构时，这一限制尤为明显。

然而，CLI 在远程开发和自动化场景中的地位不可替代——当你通过 SSH 连接到一台没有显示器的服务器时，CLI 是唯一的选择；当你需要让 Claude Code 在 CI 流水线中自动修复代码时，非交互模式的 CLI 是最佳方案。

我们的建议： 本地日常开发使用 VSCode 扩展，远程/自动化场景使用 CLI。两者可以根据场景自由切换，数据和配置完全互通。

4.3 Claude Code for VSCode（推荐） ​

VSCode 扩展是目前体验最完整、社区使用率最高的 Claude Code 形态。它在 VSCode 侧边栏中嵌入完整的 Claude Code 终端，并与 VSCode 的 IDE 能力深度融合。

核心交互模式 ​

交互方式操作说明
侧边栏对话Cmd+Shift+L 打开面板主交互区，支持多轮对话、文件 Diff、终端输出
内联编辑Cmd+Shift+I 打开输入框光标处直接输入指令，结果内联展示在代码旁边
右键菜单选中代码 → 右键快速触发 "Ask Claude" "Explain Code" "Fix This" 等
选中即上下文选中代码后提问Claude 自动将选中内容作为上下文，无需手动粘贴

这四种模式覆盖了从"我要深度对话"到"帮我快速改一下这行"的完整需求光谱。大部分日常操作通过快捷键即可完成，不需要离开键盘。

IDE 深度集成能力 ​

VSCode 扩展的核心优势在于将 AI 能力嵌入你已有的开发环境中，而非让你去适应一个新的工具：

  • 内联 Diff 预览：所有代码修改以双栏 Diff 形式呈现，逐文件审查，一键 Accept/Reject。这是 VSCode 扩展相比 CLI 最显著的体验提升——你能直观地看到每一行修改了什么、为什么修改。
  • 终端集成：Claude 执行命令的输出实时显示在 VSCode 终端中，支持中断和重试。不需要在多个窗口之间切换。
  • 文件感知：自动感知当前打开的文件、光标位置、选中文本，无需手动指定上下文。这减少了大量"告诉 AI 我在看什么文件"的冗余对话。
  • 诊断信息感知：能读取 VSCode 的错误提示、警告、lint 结果，辅助定位和修复问题。TypeScript/Python/ESLint 等诊断信息自动成为 Claude 的上下文。
  • 快捷键体系：完整的键盘绑定，常用操作无需离开键盘。不需要抬手摸鼠标。
  • 跨文件编辑预览：多文件变更统一展示在一个列表中，你可以先纵览全部改动再逐文件决定是否接受。这在重构场景中极为实用。

为什么 VSCode 扩展是最佳选择？ ​

CLI:          对话在终端，Diff 在终端 —— 纯文本，但缺少图形化审查
VSCode 扩展:   对话在侧边栏，Diff 在编辑器 —— 可视化变更，所见即所得

对于代码审查、多文件重构、UI 开发等需要可视化反馈的场景，VSCode 扩展的 Diff 视图远胜于终端的纯文本 diff。你能在编辑器中直接看到变动的上下文——周围的代码、语法高亮、缩进——而不是一堆 + - 号。

更重要的是，VSCode 扩展不需要你改变工作习惯。你仍然在你熟悉的编辑器中写代码，Claude 作为一个侧边栏中的"同事"随时待命——你不需要切换到终端，不需要复制粘贴代码片段，不需要手动整理上下文。

本书以 VSCode 扩展为主要介绍对象，大部分功能（对话、工具系统、权限模型、MCP 等）在不同平台间完全通用。对于平台特有的差异，我们会在对应章节中明确标注。

4.4 快捷键一览 ​

掌握快捷键是提升效率的关键。以下是 VSCode 扩展中常用操作的按键对照：

操作MacWindows / Linux
打开/聚焦侧边栏Cmd+Shift+LCtrl+Shift+L
内联编辑Cmd+Shift+ICtrl+Shift+I
提交新消息EnterEnter
换行（不提交）Shift+EnterShift+Enter
中断 AI 响应Ctrl+CCtrl+C
打开快捷键设置Cmd+K Cmd+SCtrl+K Ctrl+S
全屏侧边栏Ctrl+Shift+JCtrl+Shift+J
选中代码 → 问 ClaudeCmd+ICtrl+I
审批上一个 DiffCmd+EnterCtrl+Enter
拒绝当前变更Cmd+DeleteCtrl+Delete
切换主题 (深色/浅色)Cmd+K Cmd+TCtrl+K Ctrl+T
打开设置Cmd+,Ctrl+,

自定义快捷键：

你可以通过 VSCode 的 Keyboard Shortcuts 设置页面（Cmd+K Cmd+S 打开）搜索 "Claude" 来自定义所有快捷键绑定。如果你习惯 Vim 键位或其他快捷键方案，可以在此页面自由调整。

社区推荐的额外绑定：

部分开发者会额外绑定一些高频操作，供参考：

  • Cmd+Shift+A → 打开 Claude 侧边栏（替代默认的 Cmd+Shift+L，与其他扩展保持一致）
  • Cmd+Shift+Enter → 接受所有 Diff（一次性批准全部变更，适用于信任度较高的简单修改）

这些不是默认绑定，需要你手动添加。是否设置取决于你的个人习惯。

4.5 JetBrains 插件 ​

面向 IntelliJ IDEA / PyCharm / WebStorm 用户，Claude Code 同样提供了 JetBrains 平台的原生插件。

插件的体验与 VSCode 扩展高度相似——侧边栏对话面板、内联 Diff 预览、右键菜单集成——核心交互模式一一对应。如果你日常使用 JetBrains IDE 进行 Java/Kotlin/Python 开发，安装插件后即可获得与 VSCode 扩展几乎一致的 AI 编程体验。

安装方式：在 JetBrains 插件市场中搜索 "Claude Code"，点击安装并重启 IDE。

注意： 本书的截图和操作说明以 VSCode 扩展为基准，但 JetBrains 插件的功能逻辑与之对应。JetBrains 用户可以将文中描述的交互方式自然地映射到插件的对应功能上。

4.6 Web 界面 ​

Web 界面是 Claude Code 的零摩擦力入口——访问 claude.ai/code 即可直接使用，无需安装任何软件。

适用场景：

  • 首次体验：想快速感受 Claude Code 的能力，不想走安装流程
  • 临时任务：在别人的电脑上、在公共机器上，需要临时解决一个问题
  • 演示与教学：给同事或团队成员快速演示 Claude Code 的工作方式
  • 非开发场景：让设计师、产品经理等非开发者也能体验 AI 编程

Web 界面的功能是 CLI/VSCode 扩展的子集——它提供完整的对话能力和代码生成能力，但不具备文件系统操作、终端命令执行等高级 Agent 能力。它更接近一个"带 Agent 特性的对话界面"而非完整的编程代理。

4.7 Desktop 应用 ​

Claude Code Desktop 是一个独立的桌面应用程序，支持 macOS 和 Windows 平台。

它的定位介于 Web 界面和 IDE 扩展之间：

  • 相比 Web 界面：不需要浏览器，独立窗口运行，拥有更好的系统集成（原生通知、全局快捷键等）
  • 相比 VSCode 扩展：不绑定特定编辑器，适合使用不同编辑器（或不用编辑器）的场景

Desktop 应用的安装包可从 Anthropic 官网下载。对于 macOS 用户，它提供与 macOS 系统风格一致的独立窗口体验；对于 Windows 用户，它同样提供原生 Windows 界面。

谁适合使用 Desktop 应用？

  • 不想安装 VSCode 但想要图形界面的用户
  • 需要在多个编辑器之间切换工作，不想绑定单一 IDE 的用户
  • 偏好独立应用而非浏览器标签页的用户

4.8 平台选择建议 ​

面对五种使用方式，最实用的策略不是"选一个最好的"，而是根据场景灵活选择。

决策指南 ​

场景推荐平台原因
日常开发VSCode 扩展IDE 深度集成，Diff 可视化，文件自动感知
远程服务器CLI无 GUI 环境下的唯一选择
CI/CD 自动化CLI 非交互模式脚本集成，无人值守运行
快速试用Web 界面零安装，即刻体验
JetBrains 用户JetBrains 插件原生体验，无需切换编辑器
多编辑器用户Desktop 应用不绑定单一 IDE
终端重度用户CLI与 tmux/vim 工作流无缝融合
演示/教学Web 界面无需环境准备，打开即用

一个实用的组合策略 ​

我们建议大多数开发者采用 "VSCode 扩展 + CLI"双工具组合：

  • VSCode 扩展承载日常编码工作——代码编辑、重构、Debug、Code Review
  • CLI 处理特殊场景——远程服务器操作、CI/CD 脚本、终端内的快速问答

这两种方式共享同一套配置文件（~/.claude/settings.json、.claude/settings.json、CLAUDE.md 等）和 API 密钥，切换无感，不需要重复配置。

如果你明确偏好 JetBrains 生态，把 VSCode 扩展替换为 JetBrains 插件即可，策略完全相同。

章节小结： 本章覆盖了 Claude Code 的全部五种使用方式。核心原则是——CLI 负责"无 GUI 场景"，VSCode 扩展负责"最佳日常体验"，Web 界面负责"零摩擦入门"。

下一章，我们将进入实战操作：如何使用 Claude Code 进行对话、理解代码、以及建立高效的上下文交流模式。

Copyright © 2017-2026 Shi Bin