高手进阶（一）：Claude Code 五端完整选型指南：CLI、VS Code、JetBrains、Desktop App 与 Web 协同配置实战

Windows 10/11 · Claude Code v2.1.x (2026-05) · DeepSeek V4 Pro · VS Code ≥1.98 · JetBrains 2024.3+ · Desktop App 2026.04 · 🔴 高度时效 · 最后更新 2026-05-05

一、这篇教程解决什么问题

一句话定位：前面八篇教程全部在终端里操作 Claude Code。但大多数开发者日常工作在 IDE 里——VS Code、JetBrains、全新的 Desktop App 也都能跑 Claude Code。这篇逐一拆解五端的安装、配置、共享机制和协同工作流，让你在任何界面下都能顺手使用 Claude Code。

跳读指南：如果你已经装了 CLI 并配好了 DeepSeek，直接跳到第三节 VS Code 或第四节 JetBrains。如果只想了解 Desktop App 的新变化，跳到第五节。对各端差异没概念的，务必先看第二节全景对比，这是整篇的导航图。

阅读前提（硬条件，可逐条验证）：

Claude Code CLI 已安装并能正常启动，claude --version 输出正常（参考《新手上路（二）》）
已配置好 ~/.claude/settings.json 中的 API 端点和认证（参考《新手上路（二）》或《高手进阶成本优化篇》）
了解三层 settings.json 配置体系（参考《新手上路（三）》）
使用 Windows 10 或 Windows 11

读完能得到什么：

一张五端全景对比表，一眼看清 CLI / VS Code / JetBrains / Desktop App / Web App 各自该在什么时候用
VS Code 扩展的完整安装 + 配置 + 快捷键指南
JetBrains 插件（IntelliJ / PyCharm / WebStorm）的安装 + PATH 排查 + WSL 特殊配置
Desktop App Windows 版的安装 + 已知限制（第三方模型兼容性）
Web App（claude.ai/code）Remote Control 远程控制配置
五端共享配置的精确机制（哪些文件共享、哪些独立、三层 settings.json 与 IDE 设置之间的优先级）
Auto Mode 在各端的开启方式汇总
5 个真实 Debug 场景的五段式排错
一张五端速查卡，后续任何一端出问题都能对照排查

二、五端全景：先搞清楚每端是什么

在安装任何 IDE 扩展之前，先建立一个全局视图。Claude Code 在 2026 年 5 月有五端可用：

维度	CLI（终端）	VS Code 扩展	JetBrains 插件	Desktop App	Web App
形态	终端命令 `claude`	VS Code 侧边栏面板	IDE 工具窗口	原生桌面应用	浏览器访问
安装方式	`npm install -g` 或原生安装器	VS Code 扩展市场	JetBrains Marketplace	下载 .exe 安装包	无需安装
适合谁	终端老手、CI/CD 脚本	VS Code 用户	IntelliJ/PyCharm/WebStorm 用户	不想装 Node.js 的开发者	轻量使用、远程访问
第三方模型	✅ Bedrock/Vertex/DeepSeek	✅ 与 CLI 共享配置	✅ 与 CLI 共享配置	⚠️ 仅企业版支持 Vertex AI 和网关	❌ 仅 Anthropic API
Auto Mode	✅ `--enable-auto-mode`	✅ 扩展设置中开启	✅ 依赖 CLI 权限	✅ Settings 中开启	❌ 不可用
并行会话	多终端窗口	多标签页	多终端 Tab	侧边栏多会话	单会话
Computer Use	✅ `/mcp` 启用	❌	❌	✅ macOS/Windows	❌
Agent Teams	✅ 实验功能	❌	❌	❌	❌
Headless 模式	✅ `--print` / `-p`	❌	❌	❌	❌

一句话选型

重度终端用户 + CI/CD 集成 → CLI（功能最全，第三方模型支持最好）
VS Code 用户 → VS Code 扩展（安装量 1200 万+，最成熟的 IDE 集成）
JetBrains 用户 → JetBrains 插件（原生 Diff 体验，需 CLI 已安装）
不想碰命令行的开发者 → Desktop App（原生图形界面，多会话拖拽布局）
临时查看/轻量交互 → Web App（浏览器打开即用，支持手机 Remote Control）

三、VS Code 扩展：最成熟的 IDE 集成

VS Code 扩展是 Claude Code 安装量最大的集成方式（1200 万+ 安装），提供侧边栏聊天面板、内联 Diff、@-mention 文件引用、计划审查等功能。

3.1 安装

前提：VS Code ≥ 1.98.0。检查版本：

code --version
# 应输出 1.98.0 或更高

安装步骤：

打开 VS Code，按 Ctrl+Shift+X 打开扩展面板
搜索 Claude Code，找到 Anthropic 官方发布的扩展（标识：12M+ 安装量）
点击 Install
安装后如果侧边栏没出现 Claude Code 图标，运行 Developer: Reload Window（Ctrl+Shift+P 输入 reload）

也可以直接通过链接安装：

# 在浏览器中打开，会自动跳转到 VS Code
Start-Process "vscode://anthropic.claude-code/open"

3.2 首次启动与登录

点击侧边栏 Claude Code 图标，或 Ctrl+Shift+P → 输入 Claude Code: Open in New Tab
首次使用会弹出登录提示。用 Anthropic 账号登录即可
如果用第三方模型（DeepSeek），登录后扩展自动读取 ~/.claude/settings.json 中的 env 配置

注意：打开 VS Code 时务必打开完整项目文件夹（File → Open Folder），而不是单个文件。Claude Code 需要项目上下文才能正常工作。

3.3 关键设置

Ctrl+, 打开设置 → 搜索 Claude Code，以下三项值得关注：

设置项	默认值	建议
`Use Terminal`	`false`	如果你怀念终端体验，改为 `true` 切换回终端模式
`Auto Approvals`	`default`	可选 `plan`（先审查计划）/ `acceptEdits`（自动接受编辑）
`Panel Location`	`sidebar`	可选 `sidebar` / `editor`（独立标签页）

3.4 快捷键

快捷键	功能
`Ctrl+Shift+P` → `Claude Code`	打开 Claude Code 命令面板
`Ctrl+;`	Side Chat（分叉对话，不影响主会话）
`Ctrl+Shift+L`	将选中文本发送给 Claude
`Ctrl+K, Ctrl+M`	切换权限模式

3.5 与 CLI 的关键区别

内联 Diff：VS Code 扩展直接在编辑器内显示代码差异，不需要切到终端看 diff 输出
@-mention：支持自动补全文件名和符号，比 CLI 的手动输入路径更快
MCP 配置：通过 ~/.claude/settings.json 共享，扩展本身不独立管理 MCP
Agent 功能：Subagents、自定义 Slash Commands、MCP 均可在扩展中使用，但部分功能只能在 CLI 侧配置（如 Hook 脚本）

四、JetBrains 插件：原生 IDE 体验

JetBrains 插件支持 IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm、Android Studio 等全系列 IDE。

4.1 安装

前提：

Claude Code CLI 已安装（插件依赖 CLI 通信）
JetBrains IDE 2024.3 或更高版本

安装步骤：

打开 IDE → Settings → Plugins → Marketplace 标签页
搜索 Claude Code，找到 Claude Code [Beta]（Anthropic 官方发布）
点击 Install，重启 IDE

或者通过 CLI 直接安装：

claude code install-jetbrains

4.2 首次启动

重启 IDE 后，打开 IDE 内置终端（Alt+F12）
在项目根目录运行 claude
首次使用会触发登录流程，用 Anthropic 账号登录
登录后插件自动激活——你会在 IDE 右侧看到 Claude Code 工具窗口

核心规则：必须从 IDE 的集成终端启动 claude，插件功能（Diff 视图、选区共享）才会激活。从外部终端启动不会触发 IDE 集成。

4.3 关键设置

Settings → Tools → Claude Code [Beta]：

设置项	说明
`Claude command`	自定义 Claude 启动命令。WSL 用户需设为 `wsl -d Ubuntu -- bash -lic "claude"`
`Suppress notification for Claude command not found`	如果 CLI 不在 PATH 中，勾选以消除提示
`Enable automatic updates`	自动检查并安装插件更新

如果 ESC 键无法中断 Claude Code 操作：

Settings → Tools → Terminal
取消选中 Move focus to the editor with Escape，或删除 Switch focus to Editor 快捷键

4.4 WSL 用户特别注意

如果你在 WSL2 中运行 Claude Code，IDE 运行在 Windows 宿主机上，需要额外配置：

插件必须安装在 Windows 宿主机的 IDE 中（不是远程）
在插件设置中，Claude command 设为：wsl -d Ubuntu -- bash -lic "claude"（替换 Ubuntu 为你的发行版名）
如果 IDE 检测不到 WSL 中的 Claude，在 %USERPROFILE%\.wslconfig 中添加：

[wsl2]
networkingMode=mirrored

然后重启 WSL：wsl --shutdown

4.5 与 VS Code 扩展的关键区别

维度	VS Code 扩展	JetBrains 插件
Diff 查看	内联 Diff（编辑器内）	原生 Diff 查看器（JetBrains 自带）
安装依赖	独立运行	必须先装 CLI
文件引用	@-mention 自动补全	选区自动共享给 Claude
成熟度	1200 万+ 安装，生产可用	Beta 阶段
WSL 体验	较顺畅	需要手动配置网络

五、Desktop App：不用终端的 Claude Code

2026 年 4 月 14 日重设计的 Desktop App 是最新、变化最大的端——从 Web 套壳变成原生二进制应用，自带侧边栏会话管理、拖拽式布局、集成终端和内嵌文件编辑器。

5.1 安装

前提：Windows 10 1809+ 或 Windows 11，需安装 Git for Windows。

下载地址：https://claude.com/download（选择 Windows x64 或 ARM64 版本）

# 安装后验证
# 从开始菜单启动 Claude，登录 Anthropic 账号
# 点击 Code 标签页进入 Claude Code

首次启动如果提示 "Git is required"，安装 Git for Windows 后重启 Desktop App。

5.2 Desktop App 的独特功能

以下功能是 Desktop App 独有的，CLI 和其他 IDE 扩展都没有：

功能	说明
侧边栏多会话	同时运行多个 Claude Code 会话，在侧边栏切换
拖拽式布局	终端、Diff 查看器、预览面板自由排列
内嵌终端	在 App 内跑测试、构建，不用切窗口
内嵌文件编辑器	直接打开文件做轻量编辑
Side Chat (`Ctrl+;`)	分叉对话，不影响主会话上下文
文件附件	拖拽图片和 PDF 到对话中
Session Isolation	自动创建 Git Worktree 隔离每个会话

5.3 Desktop App 的限制（必读）

Desktop App 和 CLI 不是等价替换，以下限制需要在选型时考虑：

限制	说明
第三方模型	Desktop 默认连接 Anthropic API。企业版可配 Vertex AI 和网关。DeepSeek 用户在 Desktop 上无法直接用 API Key 路由——这是最大的功能差异
无 Agent Teams	多智能体编排功能仅 CLI 和 Agent SDK 可用
无 Headless 模式	`--print` / `-p` 不可用，不能嵌入脚本或 CI/CD
无 Linux 版	Desktop App 仅 macOS 和 Windows
Computer Use 需订阅	Pro 或 Max 计划才可用

DeepSeek 用户注意：Desktop App 的认证走 OAuth（Anthropic 账号），不读取 ANTHROPIC_AUTH_TOKEN 环境变量。官方文档明确：API Key 认证变量适用于 CLI 会话，Desktop 使用 OAuth。如果主力用 DeepSeek，Desktop App 目前不适合作为主要工作端——建议用 VS Code 扩展或 CLI。

5.4 Auto Mode 与 Computer Use

Auto Mode：在 Settings → Claude Code → 开启 "Allow auto mode"。需要 Max/Team/Enterprise 订阅 + Claude Opus 4.7
Computer Use：Settings → General → 开启 Computer Use 开关。需要 Pro 或 Max 订阅。Windows 上开启后立即可用，Claude 可以操控桌面应用

六、Web App：浏览器即用 + Remote Control

Web App（claude.ai/code）是最轻量的入口，无需安装任何东西。核心使用场景：临时查看会话、Remote Control 远程控制手机。

6.1 访问方式

浏览器打开 https://claude.ai/code，登录 Anthropic 账号即可。功能和 CLI 基本一致，但运行在云端基础设施上。

6.2 Remote Control：用手机控制桌面 Claude Code

这是 Web App 最独特的用法——在 CLI 或 Desktop App 中启动 Remote Control，生成一个二维码：

# 在 CLI 中启动 Remote Control
claude remote-control
# 终端输出二维码和会话链接

用手机扫描二维码，浏览器打开 claude.ai/code，即可从手机上查看会话状态、发送消息——适合离开电脑后检查进度。

Remote Control 的 Bridge WebSocket 连接硬编码指向 Anthropic 服务器（wss://bridge.claudeusercontent.com），即使用第三方模型也需要 Anthropic 账号。

6.3 Web App 的限制

仅支持 Anthropic API，无第三方模型
无 MCP 本地服务器，使用 Connectors（云端 MCP 集成）
不能访问本地文件系统
单会话模式，无并行

七、五端共享配置机制：搞懂什么共享、什么独立

这是五端协同使用最容易出错的地方。以下是精确的共享机制：

7.1 共享的文件（所有端共用）

文件/目录	共享范围	说明
`~/.claude/settings.json`	全五端	用户级配置：API 端点、env 变量、MCP 服务器、Hooks
`<项目根>/.claude/settings.local.json`	全五端	项目级配置，覆盖用户级
`<项目根>/CLAUDE.md`	全五端	项目上下文指令
`~/.claude/CLAUDE.md`	全五端	用户级全局指令
`~/.claude/agents/`	全五端	自定义 Subagent 定义
`~/.claude/commands/`	全五端	自定义 Slash Commands

7.2 独立配置（仅各自有效）

配置	作用范围	说明
VS Code `Settings → Extensions → Claude Code`	仅 VS Code	面板位置、终端模式、自动审批
JetBrains `Settings → Tools → Claude Code [Beta]`	仅 JetBrains	Claude 命令路径、自动更新
Desktop App `Settings → Claude Code`	仅 Desktop	Auto Mode 开关、Bypass 权限
VS Code `keybindings.json`	仅 VS Code	快捷键自定义
JetBrains `Settings → Terminal`	仅 JetBrains	ESC 键行为

7.3 优先级链

当同一配置存在多个来源时，优先级如下：

项目级 settings.local.json  >  用户级 settings.json  >  IDE 设置  >  默认值

举例：你在 settings.json 中配了 ANTHROPIC_BASE_URL 指向 DeepSeek，打开 VS Code 扩展时自动读取此环境变量——不需要在 VS Code 中重新配置。

7.4 权限控制的独立性

一个常见的坑：CLI 的权限模式和 VS Code 扩展的权限模式是两个独立通道。

CLI 中 /permission-mode auto 不影响 VS Code 扩展
VS Code 中 Settings → Auto Approvals 不影响 CLI
Desktop App 中 Settings → "Allow bypass permissions mode" 仅对 Desktop App 生效

实践建议：在 CLI 中做重型/危险操作（配 --enable-auto-mode），在 Desktop App 中做审查和发布，在 VS Code 中做日常编码。各端的权限策略按场景独立配置。

八、多端协同工作流：三种实战模式

模式 #1：CLI 重型操作 + Desktop 审查发布

CLI: claude --enable-auto-mode        ← 大范围重构、批量迁移
Desktop App: 侧边栏打开同项目        ← 审查 diff、手动微调、提交
Web App: claude.ai/code               ← 手机查看进度

模式 #2：VS Code 日常 + CLI 深度任务

VS Code: 写代码、生成功能、小范围修改
CLI: Agent Teams 并行开发、Hook 脚本、CI/CD 集成

模式 #3：纯 Desktop App 流（新手推荐）

Desktop App: 安装后直接使用          ← 不碰终端
内置终端: 跑测试                      ← App 内完成
Side Chat: Ctrl+; 分叉审查            ← 不污染主会话

九、Debug 场景

Debug #1 — VS Code 安装扩展后侧边栏不显示 Claude Code 图标

报错现象

VS Code 扩展列表显示 Claude Code 已安装，但侧边栏没有 Claude Code 图标，Ctrl+Shift+P 中也搜不到 Claude Code 命令。

根因

Claude Code VS Code 扩展要求 VS Code ≥ 1.98.0。低版本 VS Code 可以成功安装扩展，但扩展激活时会因为 API 不兼容而静默失败，不显示任何错误提示。

一览对比表

对比维度	修复前	修复后
VS Code 版本	< 1.98.0	≥ 1.98.0
扩展激活状态	静默失败	正常激活
Claude Code 图标	不显示	侧边栏显示

代码修复

检查版本：

code --version
# 如果输出 < 1.98.0，升级 VS Code

升级后：

# VS Code → Help → Check for Updates
# 或下载最新版覆盖安装

重启 VS Code 后运行 Developer: Reload Window（Ctrl+Shift+P → 输入 reload）。

验证

侧边栏出现 Claude Code 图标（一个 ✱ 星号图标）
Ctrl+Shift+P → 输入 Claude Code，能看到 Open in New Tab 等命令
点击图标或运行命令，弹出登录提示

Debug #2 — JetBrains 插件已安装但 `claude` 提示 "No available IDEs detected"

报错日志

$ claude
No available IDEs detected

根因

Claude Code CLI 通过本机端口与 JetBrains 插件通信。当 CLI 运行在 WSL2 中、IDE 运行在 Windows 宿主上时，WSL2 的 NAT 网络导致 CLI 无法连接到宿主机的 IDE 端口，插件功能（Diff 视图、选区共享）全部不可用。

一览对比表

对比维度	修复前	修复后
WSL2 网络模式	NAT（默认）	Mirrored（镜像宿主机网络）
CLI ↔ IDE 通信	不通	正常连接
Diff 视图	终端文本模式	IDE 原生 Diff 查看器

代码修复

在 %USERPROFILE%\.wslconfig 中添加：

[wsl2]
networkingMode=mirrored

然后重启 WSL：

wsl --shutdown

重新打开 WSL 终端，进入项目目录运行 claude。如果仍不行，确认插件设置中的 Claude command 为 wsl -d <发行版名> -- bash -lic "claude"。

验证

claude 启动后不再显示 "No available IDEs detected"
让 Claude 修改代码，diff 自动在 IDE 的 Diff 查看器中打开
在 IDE 中选中代码，Claude 自动感知当前选区

Debug #3 — Desktop App 启动 Code 标签页提示 "Git is required"

报错现象

Desktop App 安装成功，登录正常，但点击 Code 标签页时显示 Git is required，无法进入 Claude Code。

根因

Desktop App 依赖 Git 进行会话隔离（自动创建 Git Worktree）。即使你的项目不用 Git，Desktop App 也需要 Git for Windows 才能启动 Code 标签页。这不是 bug——这是架构设计决定的依赖。

一览对比表

对比维度	修复前	修复后
Git 安装状态	未安装	Git for Windows 已安装
Desktop Code 标签页	`Git is required` 报错	正常进入
自动 Worktree 隔离	不可用	自动创建

代码修复

下载 Git for Windows：https://git-scm.com/download/win
安装时选择默认选项即可
安装完成后重启 Desktop App（不是刷新，是完全退出再启动）

验证

重启 Desktop App → 点击 Code 标签页 → 正常进入 Claude Code 界面
创建新会话时，Desktop App 自动创建 Git Worktree，路径在项目 .claude/worktrees/ 下

Debug #4 — Desktop App 配 DeepSeek 不生效

报错现象

在 ~/.claude/settings.json 中配置了 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 指向 DeepSeek，CLI 中 /status 显示路由正确，但 Desktop App 仍然使用 Anthropic 模型。

根因

Desktop App 的认证体系走 OAuth（Anthropic 账号登录），不读取 ANTHROPIC_AUTH_TOKEN 环境变量。Anthropic 官方文档明确：API Key 认证变量（ANTHROPIC_AUTH_TOKEN）适用于 CLI 会话，Desktop 使用 OAuth。这是两条完全独立的认证通道。

此外，Desktop App 默认连接 Anthropic API，仅企业版可通过 managed settings 配置 Vertex AI 和网关提供商。对于 DeepSeek 等第三方 API 端点，Desktop App 没有官方支持路径。

一览对比表

对比维度	CLI	Desktop App
认证方式	API Key（环境变量）	OAuth（Anthropic 账号）
第三方模型支持	DeepSeek/Bedrock/Vertex/Foundry	仅企业版 Vertex AI 和网关
DeepSeek 可用性	✅ 完全可用	❌ 无官方支持

解决方案

方案 A：用 VS Code 扩展代替 Desktop App

VS Code 扩展读取 settings.json 中的 env 配置，DeepSeek 路由在 VS Code 中正常工作：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek-API-Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]"
  }
}

方案 B：Desktop App 用于审查，CLI 用于编码

保持 Desktop App 登录 Anthropic 账号（用于审查 diff、手动微调），CLI 配 DeepSeek 用于实际编码。两者可以同时打开同一项目。

验证

CLI 中运行 claude → /status → 确认模型显示为 DeepSeek
VS Code 扩展 → 打开 Claude Code 面板 → /status → 确认模型与 CLI 一致
Desktop App → Settings → 确认使用 Anthropic 账号登录（不期望它读 DeepSeek 配置）

Debug #5 — VS Code 扩展读不到 MCP 服务器配置

报错现象

CLI 中 /mcp 显示所有 MCP 服务器正常连接，但 VS Code 扩展中 /mcp 显示 0 个服务器或缺少某些服务器。

根因

VS Code 扩展和 CLI 共享 ~/.claude/settings.json 中的 MCP 配置，但 MCP 服务器是进程级别的——每个 Claude Code 会话独立启动 MCP 进程。如果 VS Code 扩展的工作目录和 CLI 不同，或者 VS Code 的 Node.js 版本与 MCP 服务器要求不兼容，MCP 连接就会失败。

常见原因：

MCP 服务器配置使用了相对路径，VS Code 的工作目录解析不同
VS Code 继承的 PATH 环境变量与终端不同，找不到 MCP 服务器可执行文件
多个会话同时启动同一 MCP 服务器导致端口冲突

一览对比表

对比维度	修复前	修复后
MCP 配置路径写法	相对路径	绝对路径（`C:\Users\<用户名>\...`）
`/mcp` 输出	0 个服务器	与 CLI 一致
MCP 工具可用性	无	全部可用

代码修复

检查 MCP 服务器配置中的路径是否为绝对路径：

文件：C:\Users\<用户名>\.claude\settings.json

// 修复前——相对路径在 VS Code 中可能解析失败
{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["./my-mcp-server/index.js"]
    }
  }
}

// 修复后——使用绝对路径
{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["C:/Users/<用户名>/my-mcp-server/index.js"]
    }
  }
}

如果 MCP 服务器依赖特定 Node.js 版本，在 VS Code 设置中指定 Node.js 路径：

Ctrl+, → Extensions → Claude Code → Claude Process Wrapper → 设为 C:\Program Files\nodejs\node.exe

验证

重启 VS Code，打开 Claude Code 面板
输入 /mcp，确认服务器数量和 CLI 中一致
每个服务器旁边显示已连接的工具数量

十、日常维护

10.1 各端更新方式

端	更新命令	说明
CLI（原生安装）	自动后台更新	可通过 `CLAUDE_CODE_UPDATE_CHANNEL=stable` 切到稳定通道
CLI（npm）	`npm update -g @anthropic-ai/claude-code`	手动更新
VS Code 扩展	自动更新	或手动 `Ctrl+Shift+X` → 检查更新
JetBrains 插件	自动更新（需在设置中开启）	Settings → Tools → Claude Code [Beta] → Enable automatic updates
Desktop App	自动更新	或 `https://claude.com/download` 下载最新版
Web App	无需更新	始终最新

10.2 启停命令

# CLI 启动
claude                          # 交互模式
claude -p "一句话任务"           # Headless 单次执行
claude --resume                 # 恢复上次会话

# CLI 退出
/exit                           # 或在提示符下 Ctrl+C

# VS Code
# 关闭标签页 = 结束会话
# 侧边栏右键会话 → Close Session

# Desktop App
# 侧边栏右键会话 → Close Session
# 窗口关闭 = App 仍在后台运行，从系统托盘退出

10.3 日志位置

端	日志路径
CLI	`C:\Users\<用户名>\.claude\debug\`
VS Code	VS Code → Output → 下拉选 "Claude Code"
JetBrains	IDE → Help → Show Log in Explorer
Desktop App	`%APPDATA%\Claude\logs\`
Web App	不适用（云端运行）

关键搜索词：error、timeout、disconnected、MCP、401、403

十一、速查卡

11.1 五端选型速查

我要...	用这端
命令行重度用户、CI/CD 自动化	CLI
VS Code 日常编码	VS Code 扩展
IntelliJ/PyCharm 日常编码	JetBrains 插件
不用终端、多会话并行	Desktop App
手机查看进度、临时交互	Web App
DeepSeek 用户主力开发	CLI 或 VS Code 扩展
Computer Use 操控桌面	Desktop App（Pro/Max）
Agent Teams 多智能体协作	CLI（实验功能）
Headless 脚本/CI 集成	CLI（`-p` 模式）

11.2 关键路径汇总

文件/目录	路径
用户级 settings	`C:\Users\<用户名>\.claude\settings.json`
项目级 settings	`<项目根>\.claude\settings.local.json`
CLAUDE.md（用户级）	`C:\Users\<用户名>\.claude\CLAUDE.md`
CLAUDE.md（项目级）	`<项目根>\CLAUDE.md`
Subagent 定义	`C:\Users\<用户名>\.claude\agents\`
CLI 日志	`C:\Users\<用户名>\.claude\debug\`
Desktop App 日志	`%APPDATA%\Claude\logs\`
WSL 配置	`%USERPROFILE%\.wslconfig`

11.3 常见报错 → 解决方案

报错	解决
VS Code 扩展无图标	升级到 VS Code ≥ 1.98.0 → Debug #1
"No available IDEs detected" (JetBrains)	WSL: 设 `networkingMode=mirrored` → Debug #2
Desktop "Git is required"	安装 Git for Windows，重启 App → Debug #3
Desktop App 配 DeepSeek 不生效	换用 VS Code 扩展或 CLI → Debug #4
VS Code 读不到 MCP	改用绝对路径，检查 PATH → Debug #5
JetBrains 插件不激活	从 IDE 集成终端启动 `claude`，不要用外部终端
VS Code 扩展一直 "Not logged in"	`Ctrl+Shift+P` → `Claude Code: Open in New Tab` → 重新登录

十二、扩展阅读

本系列相关文章：

新手上路（二）： Claude Code 装完先别用！Windows 初始化 6 步流水线 + 4个高频报错排查 - 掘金 — CLI 安装和 settings.json 初始配置
新手上路（三）：Claude Code Skills 装了一堆没用？20+ 个 Skill 横向对比 + 三套组合方案，按需抄 - 掘金— 三层 settings.json 体系详解
新手上路（四）：MCP 协议实战：让 Claude Code 从代码编辑器升级为全栈开发代理的分水岭Claude Cod - 掘金 — MCP 服务器配置，与本文 MCP 共享配置章节联动
高手进阶成本优化篇：API 套餐几天就见底？Claude Code + DeepSeek V4 Token 管理深度解析与成本控制 - 掘金 — DeepSeek 环境变量配置详解
高手进阶（二）：Routines 云端自动化（即将发布） — 与 Desktop App 的 Scheduled Tasks 对比

参考文献

Claude Code for VS Code - Visual Studio Marketplace — VS Code 扩展官方页面，安装量和版本要求
Use Claude Code in VS Code - Claude Code Docs — VS Code 扩展官方文档，设置项和快捷键
Claude Code overview - Claude Code Docs — 五端全景概述
JetBrains IDEs - Claude Code Docs — JetBrains 插件官方文档，WSL 配置
Claude Code × JetBrains Complete Guide - Claude Lab — JetBrains 插件第三方使用指南
Get started with the desktop app - Claude Code Docs — Desktop App 官方快速入门
Use Claude Code Desktop - Claude Code Docs — Desktop App 完整功能参考，CLI 对比表
Redesigning Claude Code on desktop for parallel agents — Desktop App 2026 年 4 月重设计公告
How to Use DeepSeek in Claude Code - DeepSeek V4 Hub — DeepSeek 与 Claude Code 集成指南，CLI-first 路线说明
DeepSeek + Claude Code: Agent Integration Guide - AnyCap — DeepSeek V4 兼容性边界说明
Advanced setup - Claude Code Docs — 安装方式汇总（原生/npm/Homebrew/WinGet）
Claude Code [Beta] Plugin for JetBrains IDEs — JetBrains Marketplace 插件页面

高手进阶（一）：Claude Code 五端完整选型指南：CLI、VS Code、JetBrains、Desktop App 与 Web 协同配置实战

一、这篇教程解决什么问题

二、五端全景：先搞清楚每端是什么

一句话选型

三、VS Code 扩展：最成熟的 IDE 集成

3.1 安装

3.2 首次启动与登录

3.3 关键设置

3.4 快捷键

3.5 与 CLI 的关键区别

四、JetBrains 插件：原生 IDE 体验

4.1 安装

4.2 首次启动

4.3 关键设置

4.4 WSL 用户特别注意

4.5 与 VS Code 扩展的关键区别

五、Desktop App：不用终端的 Claude Code

5.1 安装

5.2 Desktop App 的独特功能

5.3 Desktop App 的限制（必读）

5.4 Auto Mode 与 Computer Use

六、Web App：浏览器即用 + Remote Control

6.1 访问方式

6.2 Remote Control：用手机控制桌面 Claude Code

6.3 Web App 的限制

七、五端共享配置机制：搞懂什么共享、什么独立

7.1 共享的文件（所有端共用）

7.2 独立配置（仅各自有效）

7.3 优先级链

7.4 权限控制的独立性

八、多端协同工作流：三种实战模式

模式 #1：CLI 重型操作 + Desktop 审查发布

模式 #2：VS Code 日常 + CLI 深度任务

模式 #3：纯 Desktop App 流（新手推荐）

九、Debug 场景

Debug #1 — VS Code 安装扩展后侧边栏不显示 Claude Code 图标

报错现象

根因

一览对比表

代码修复

验证

Debug #2 — JetBrains 插件已安装但 claude 提示 "No available IDEs detected"

报错日志

根因

一览对比表

代码修复

验证

Debug #3 — Desktop App 启动 Code 标签页提示 "Git is required"

报错现象

根因

一览对比表

代码修复

验证

Debug #4 — Desktop App 配 DeepSeek 不生效

报错现象

根因

一览对比表

解决方案

验证

Debug #5 — VS Code 扩展读不到 MCP 服务器配置

报错现象

根因

一览对比表

代码修复

验证

十、日常维护

10.1 各端更新方式

10.2 启停命令

10.3 日志位置

十一、速查卡

11.1 五端选型速查

11.2 关键路径汇总

11.3 常见报错 → 解决方案

十二、扩展阅读

参考文献

Debug #2 — JetBrains 插件已安装但 `claude` 提示 "No available IDEs detected"