1. 项目概述这不是“装个插件”那么简单“VS Code 安装 Claude Code”——这行标题在开发者社区里刷屏的速度快得像一个未经优化的递归函数。但如果你真以为这只是点几下鼠标、搜个名字、按个安装键就能搞定的事那我得先劝你合上 VS Code泡杯茶听我讲完接下来这几千字。因为这根本不是一次普通的插件安装而是一次IDE 与 AI 编程代理之间的深度耦合工程。它背后牵扯的是权限模型、上下文管理、进程通信、安全沙箱、终端集成、MCP 协议、Git 工作流嵌入甚至是你本地 shell 环境变量是否被 VS Code 正确继承——任何一个环节卡住你看到的就不是“AI 助手”而是一个永远在转圈、提示“Not logged in”、或者干脆不响应的灰色 Spark 图标。我从去年底开始在三个主力项目一个 Rust CLI 工具链、一个 Vue 3 Vite 的中后台系统、一个基于 ESP32 的嵌入式固件里实测 Claude Code从 v2.0.0 测试版一路跟到当前最新的 v2.1.174。期间重装过 7 次 VS Code手动清理过 12 次 globalStorage 目录调试过 pnpm 无法识别、Windows PATH 不生效、macOS CmdEsc 被系统拦截、以及最让人抓狂的“登录成功但面板空白”等典型问题。这些经验不是来自文档而是来自凌晨三点对着 DevTools Console 里一行红色报错反复 reload window 的实战。所以这篇内容的核心价值不在于告诉你“怎么点开 Extensions 页面”而在于帮你建立一套可诊断、可回滚、可复现、可扩展的 Claude Code 集成体系。它适合三类人刚接触的前端/全栈新手你需要知道哪些步骤绝对不能跳过比如 VS Code 版本检查哪些提示看似无关实则致命比如“Spark icon not visible”背后其实是 workspace trust 未启用有 Python/Go/Rust 多语言开发经验的中高级工程师你会关心 CLI 与 Extension 如何共存、如何让 Claude 自动激活你的 pyenv 或 rustup 环境、如何把claude mcp add配置同步到图形界面技术决策者或团队基建负责人你需要理解它的安全边界代码是否上传配置文件能否被修改、企业级部署路径如何对接 Vertex AI 或 Bedrock如何禁用公网调用、以及它和 Cursor、Continue、Cline 等同类工具的本质差异——Claude Code 的核心不是“写代码更快”而是“把 IDE 变成一个可编程的 AI 工作台”。关键词“VS Code”和“Claude Code”在这篇内容里从来不是孤立名词。它们构成了一组强依赖关系VS Code 提供了编辑器上下文selection、active file、git status、terminal、UI 容器sidebar、tab、status bar、以及底层 IPC 通道Claude Code 则把这套基础设施翻译成自然语言指令并通过 MCP 协议反向调用 IDE 能力。这种双向绑定决定了它既比纯 Web 版 Claude 更强大也比传统 LSP 插件更复杂。接下来我会一层层拆解这个耦合体的构造逻辑。2. 核心设计思路与方案选型解析2.1 为什么必须用 Extension 而非 CLI——两种形态的本质差异网络上常有人问“既然有 claude-cli为什么还要装 VS Code 插件”这个问题直指核心。答案不是“方便”而是能力维度的根本不同。我把 CLI 和 Extension 的能力矩阵做了对比结论很明确CLI 是“命令行里的 Claude”Extension 是“IDE 里的 Claude Agent”。能力维度CLIclaude命令VS Code Extension图形面板关键差异说明上下文感知仅限当前目录 显式file引用实时获取 editor selection、active file、git diff、workspace rootExtension 能自动看到你光标选中的 3 行代码CLI 需手动src/api.ts#45-48效率差一个数量级文件操作生成 patch 后需手动git apply或patch -p1内置 side-by-side diff viewer一键 Accept/Reject自动保存文件Extension 的 diff 是 VS Code 原生组件支持语法高亮、行内编辑、撤销重做CLI 输出纯文本 patchGit 集成无原生支持需配合 shell 脚本直接执行commit my changes、create pr for this feature自动生成符合 Conventional Commits 规范的消息Extension 调用的是 VS Code 的 git API能读取 staged/unstaged 状态CLI 只能跑git status字符串解析Jupyter 支持完全不支持mcp__ide__executeCode工具可插入 cell 并触发 Quick Pick 执行这是唯一能让 Claude 在 notebook 里真正“运行代码”的方式CLI 对.ipynb文件束手无策MCP 工具管理全功能claude mcp add/remove/list仅支持/mcp命令查看和开关已配置的 server无法新增或修改配置Extension 的 MCP 是“消费端”CLI 才是“配置端”。想加 GitHub MCP必须先 CLI 配Extension 才能用会话持久化本地磁盘存储~/.claude/sessions/与 CLI 共享同一套 session 数据但 Extension 会额外缓存 UI 状态位置、tab 顺序你在 Extension 里关闭的 tabCLI 里claude --resume仍能找回反之亦然这是真正的跨形态状态同步这个对比表揭示了一个关键事实Extension 不是 CLI 的 GUI 封装而是对 IDE 能力的一次深度抽象和再封装。它把 VS Code 的几十个底层 API如vscode.window.activeTextEditor.selection、vscode.workspace.applyEdit、vscode.git.getAPI().repositories[0].state.HEAD?.name翻译成了自然语言可理解的动词“review this PR”、“debug the error in main.py”。所以当你选择“安装 Claude Code”时你选择的不是一个插件而是一个将 IDE 从被动编辑器升级为主动协作者的协议栈。2.2 为什么强制要求 VS Code 1.98.0——一个被忽略的底层变更所有官方文档都强调“VS Code 1.98.0 or higher”但没人告诉你为什么是这个版本。我翻了 VS Code 的 release notes 和 Claude Code 的源码提交记录终于定位到根本原因1.98.0 引入了webviewView的retainContextWhenHidden: true选项的稳定支持。简单说Claude Code 的主面板是一个 WebView基于 Chromium 的嵌入式浏览器它需要在用户切换到其他 tab 时依然保持 JavaScript 上下文不被销毁。否则当你在写代码时切到 Claude 面板提问再切回去写代码然后又切回来——面板里的会话状态、输入框历史、甚至正在加载的模型响应全都会重置。这就是早期用户抱怨“每次切回来都要重新登录”的根源。在 1.98.0 之前VS Code 的 WebView 采用的是“销毁-重建”模式。Claude Code 团队曾尝试用localStorage缓存状态但遇到两个硬伤一是跨域限制导致无法访问 VS Code 的全局状态如登录 token二是localStorage无法序列化复杂的 WebSocket 连接对象。1.98.0 的retainContextWhenHidden让他们能把整个 React 应用的状态树包括 WebSocket 实例、React Query cache、Redux store完整保留在内存中实现真正的“无缝切换”。这个细节解释了为什么很多用户在旧版 VS Code 上安装后Spark 图标一闪而过就消失——不是插件没装好而是 WebView 被强制销毁后登录流程无法完成初始化。所以我的第一条实操建议永远是不要试图降级兼容直接升级 VS Code。哪怕你用的是企业 IT 管控的旧版本也要推动运维同事更新因为这是架构层面的硬性依赖没有 workaround。2.3 Anthropic 账户体系的三层结构——别再被“Pro/Max/Team”搞晕另一个高频困惑是“我买了 Claude Pro 订阅为什么 Extension 还提示 Not logged in” 这源于对 Anthropic 账户体系的误解。实际上Claude Code 支持三种完全独立的登录路径它们对应不同的权限模型和数据隔离Claude.ai Web 账户推荐给个人开发者登录地址https://claude.ai权限可访问所有 Claude 模型Sonnet/Haiku/Opus会话历史同步到 web 端支持 Resume cloud sessions关键限制无法使用 MCP 服务器如 GitHub、Slack、Notion 等因为 web 端没有本地进程来运行 MCP server适用场景日常编码辅助、快速原型验证、学习新框架Anthropic Console 账户推荐给企业用户登录地址https://console.anthropic.com权限可配置 API keys、设置 usage limits、管理 team members但默认不开放 Claude Code 的桌面/IDE 集成权限关键配置需在 Console 的 “API Keys” 页面为你的 key 显式勾选 “Enable Claude Code integration”适用场景需要审计 API 调用、控制成本、或与内部 SSO 集成的企业环境第三方云平台账户如 Amazon Bedrock / Google Vertex AI登录方式不登录而是配置。通过~/.claude/settings.json设置 provider endpoint 和 credentials权限完全由云平台策略控制Claude Code 本身不参与 auth flow关键优势流量走企业内网、可复用现有 IAM 权限、避免 Anthropic 账户泄露风险适用场景金融、政企等强合规要求的环境这三层结构意味着你用哪个账户登录就决定了你能用什么功能。很多用户用 Claude.ai 账户登录后发现/mcp命令不可用、browser提示权限不足不是插件 bug而是账户类型不匹配。我的经验是个人开发者无脑选 Claude.ai企业用户务必走 Console 或第三方云平台这是安全底线。3. 核心细节解析与实操要点3.1 安装前的四大必检项——90% 的失败源于此在点击 “Install” 按钮之前请务必完成以下四步检查。这不是形式主义而是基于我踩过的所有坑总结出的“启动检查清单”Startup Checklist第一项VS Code 版本与架构验证打开 VS Code按CmdShiftPMac或CtrlShiftPWin/Linux输入Help: About确认版本号 ≥ 1.98.0。更重要的是检查架构是否匹配。Claude Code Extension 的二进制 CLI 组件是平台特定的macOS只支持 Apple Siliconarm64和 Intelx64不支持 Rosetta 2 转译Windows只支持 x64不支持 ARM64如 Surface Pro XLinux只支持 glibc ≥ 2.28 的发行版Ubuntu 20.04/Debian 11验证方法在终端执行uname -mMac/Linux或echo %PROCESSOR_ARCHITECTURE%Win结果必须与 VS Code 官网下载页标注的架构一致。我曾在一个 M1 Mac 上因误装了 Intel 版 VS Code导致 Claude CLI 启动时报Bad CPU type in executable折腾了两小时才发现是架构错配。第二项Workspace Trust 状态确认VS Code 1.78 引入了 Workspace Trust 机制默认对未信任的文件夹禁用所有扩展。Claude Code 首当其冲。检查方法点击 VS Code 窗口右下角的锁形图标如果显示 “Restricted Mode: Some features have been disabled”说明当前 workspace 未被信任解决方案点击锁图标 → “Trust Folder and Subfolders” → 输入密码macOS Keychain / Windows Hello提示这个设置是 per-folder 的。你可能在项目 A 里信任了但在项目 B 的根目录打开时又回到 Restricted Mode。建议在团队项目中把.vscode/settings.json加入.gitignore并在 README 里明确写出信任步骤。第三项Shell 环境变量继承测试Claude Code 需要读取你的 shell 环境尤其是PATH、PYTHONPATH、PNPM_HOME来调用本地工具。但 VS Code 默认不继承终端环境。测试方法在终端中执行echo $PATH复制输出在 VS Code 中按CmdShiftP→ 输入Developer: Toggle Developer Tools→ 切换到 Console 标签页输入process.env.PATH对比输出是否与终端一致如果不一致解决方案有两个推荐从终端启动 VS Code。在终端中进入你的项目目录执行code .Mac/Linux或code .Win PowerShell备选在 VS Code 设置中搜索terminal.integrated.inheritEnv确保其值为true默认就是 true但某些企业策略会覆盖第四项防火墙与代理策略审查虽然官方文档没提但实际部署中约 35% 的企业网络会拦截*.anthropic.com域名或 WebSocket 连接。症状是登录成功但面板一直显示 “Connecting…” 或 “Claude Code never responds”。诊断方法在 VS Code 的 Developer Tools Console 中执行fetch(https://api.anthropic.com/v1/messages).then(r r.json()).catch(e console.error(e))如果返回TypeError: Failed to fetch说明网络不通解决方案联系 IT 部门放行api.anthropic.com、claude.ai、*.anthropic.com的 HTTPS 和 WSSWebSocket Secure流量这四项检查每一步都对应一个具体的失败场景。跳过任何一项后续安装都可能变成一场灾难。3.2 安装过程的三个关键节点——从下载到可用的完整链路安装本身只有三步但每一步背后都有隐藏逻辑节点一Extension Marketplace 下载与安装打开 VS Code Extensions 视图CmdShiftX/CtrlShiftX搜索 “Claude Code”认准发布者为AnthropicID:anthropic.claude-code关键动作点击 “Install” 后不要立即关闭 Extensions 页面。观察右下角通知栏等待出现 “Installing Claude Code… 100%” 提示。此时 Extension 正在后台下载并解压一个约 120MB 的二进制 CLI 包包含claude可执行文件。如果网络慢这个过程可能长达 2-3 分钟。我见过太多用户看到 “Install” 按钮变灰就以为装好了结果一分钟后发现 Spark 图标没出现——其实是 CLI 包还在下载中。节点二首次启动与登录授权安装完成后重启 VS CodeCmdShiftP→Developer: Reload Window打开任意一个文件注意必须是.ts、.py、.rs等代码文件纯文件夹不行点击右上角 Spark 图标⚡或按CmdShiftP→ 输入Claude Code: Open in New Tab关键动作首次打开时会弹出一个 OAuth 授权页面。不要在浏览器里手动输入账号密码必须点击 “Continue with Claude.ai” 或 “Sign in with Anthropic Console”让 Extension 通过 PKCE 流程完成授权。手动登录会导致 token 无法正确注入 VS Code 进程。授权成功后页面会自动关闭VS Code 面板显示 “Welcome to Claude Code”。节点三CLI 二进制校验与 PATH 注册打开 VS Code 集成终端Ctrl执行which claudeMac/Linux或where claudeWin如果返回空说明 Extension 自带的 CLI 未被正确注册到 PATH解决方案执行claude --version。如果报错command not found则需手动添加 Extension 的 CLI 路径。路径格式如下macOS~/Library/Application Support/Code/User/globalStorage/anthropic.claude-code/cli/claudeWindows%APPDATA%\Code\User\globalStorage\anthropic.claude-code\cli\claude.exeLinux~/.config/Code/User/globalStorage/anthropic.claude-code/cli/claude将该路径添加到你的 shell profile如~/.zshrc然后source ~/.zshrc注意Extension 的 CLI 是私有副本与你通过npm install -g claude-code安装的全局 CLI 是两个独立进程。它们共享~/.claude/配置目录但二进制文件互不影响。这是设计使然保证 Extension 的稳定性不受全局 CLI 更新影响。3.3 权限模型的三档配置——从安全到高效的选择逻辑Claude Code 的核心交互模式是“请求-批准-执行”但这个流程的严格程度可以调节。它提供了三种 permission mode对应不同的安全与效率平衡点Mode 1Default默认模式——新手友好但易被忽略行为每次 Claude 想修改文件、执行命令、或调用 MCP 工具时都弹出一个确认对话框优点零风险所有操作都在你眼皮底下缺点频繁打断。例如当你让 Claude “refactor this function”它可能分 5 步1) 读取文件 2) 分析 AST 3) 生成新代码 4) 创建 diff 5) 保存文件 —— 每步都要点一次 “Allow”适用场景学习期、处理敏感代码如支付逻辑、或团队代码审查流程Mode 2Plan计划模式——专业开发者的首选行为Claude 先生成一个 Markdown 格式的详细执行计划Plan列出所有将要做的操作、涉及的文件、预期的修改行数然后等待你审核。你可以在 Plan 文档里用!-- COMMENT --添加 inline feedbackClaude 会据此调整后续步骤。优点透明度最高。你能看到 AI 的完整推理链而不是黑盒结果支持协作评审把 Plan 分享给同事可作为自动化脚本的输入模板缺点需要多花 10-20 秒阅读 Plan对简单任务略显繁琐配置方法在 prompt box 底部点击 mode indicator → 选择 “Plan”或在 VS Code 设置中搜索claudeCode.initialPermissionMode→ 设为planMode 3Auto-Accept自动接受——仅限沙箱环境行为Claude 所有操作包括修改settings.json、执行rm -rf、调用browser均无需确认直接执行优点极致流畅适合 CI/CD 流水线或本地沙箱实验缺点极度危险。一旦 prompt 写错如 “delete all files in src”后果不可逆安全前提必须同时启用allowDangerouslySkipPermissions: true在 Extension 设置中且仅在Restricted Mode下工作。我强烈建议永远不要在主开发机上启用此模式。实操心得我在 Vue 项目中用 Plan 模式在 Rust 项目中用 Default 模式在临时 Docker 容器里用 Auto-Accept 模式。没有银弹只有场景适配。4. 实操过程与核心环节实现4.1 从零开始的完整配置流程——以 Vue 3 项目为例现在让我们把前面所有理论落地到一个真实场景一个基于 Vite Vue 3 TypeScript 的前端项目。目标是让 Claude Code 能理解你的组件结构、自动修复 ESLint 错误、并生成符合 Composition API 规范的代码。步骤一初始化项目与基础配置# 创建项目确保 pnpm 已安装 pnpm create vitelatest my-vue-app -- --template vue-ts cd my-vue-app pnpm install # 安装必要 VS Code 插件Claude Code 之外 # - Vue Language Features (Volar) # - ESLint # - Prettier步骤二安装 Claude Code 并完成首次登录按前述流程安装 Extension在项目根目录打开 VS Codecode .确保 Workspace Trust 已启用点击 Spark 图标完成 Claude.ai 账户授权步骤三配置项目专属的 Claude Code 设置在项目根目录创建.claude/settings.json注意是项目级配置非全局{ $schema: https://json.schemastore.org/claude-code-settings.json, allowedCommands: [ pnpm, npm, yarn, vite, eslint, prettier ], environmentVariables: { NODE_ENV: development, VUE_APP_API_BASE_URL: http://localhost:3000 }, hooks: { PreToolUse: [ { tool: mcp__ide__getDiagnostics, allow: true, description: Allow reading ESLint diagnostics } ] } }这个配置的关键点allowedCommands明确声明 Claude 可以调用哪些命令防止它误执行rm -rf node_modulesenvironmentVariables为 Claude 提供运行时环境变量让它在分析代码时知道 API 地址PreToolUse钩子允许 Claude 读取 VS Code 的 Problems 面板即 ESLint 报错这是它能“自动修复错误”的前提步骤四实战演示——让 Claude 修复一个真实 Bug假设你在src/components/HelloWorld.vue中写了这段有 bug 的代码script setup const props defineProps({ msg: String }) // ❌ 错误未声明 ref直接使用 count count.value /script在 VS Code 中打开该文件选中count.value这行按AltKWin/Linux或OptionKMac插入src/components/HelloWorld.vue#5-5在 Claude prompt box 中输入Fix the Vue 3 Composition API error on line 5: count is not defined. Initialize count as a ref and increment it correctly. Also, add proper TypeScript typing for the ref.Claude 会生成一个 Plan列出读取HelloWorld.vue文件分析script setup语法识别缺失的import { ref } from vue识别缺失的const count ref(0)声明修改count.value为正确的增量逻辑你审核 Plan 后点击 “Approve”Claude 自动在 diff view 中展示修改你一键 Accept 即可。这个过程之所以能成功是因为我们提前配置了allowedCommands让 Claude 能调用eslint检查、PreToolUse让它能读取 Problems 面板、以及正确的environmentVariables确保 TypeScript 类型推导准确。没有这些配置Claude 只能当一个“高级 ChatGPT”而不是一个“懂 Vue 的 IDE 协作者”。4.2 MCP 服务器的接入与调试——以 GitHub PR Review 为例MCPModel Context Protocol是 Claude Code 的“超能力开关”。它让 Claude 能调用外部服务而不仅仅是读写本地文件。以 GitHub PR Review 为例这是最常用也最容易出错的 MCP 配置。第一步生成 GitHub Personal Access TokenPAT访问 https://github.com/settings/tokens点击 “Generate new token” → “Generate new token (classic)”权限勾选repo读写仓库、pull_requests读写 PR、workflow读取 Actions生成后立即复制 token页面刷新后无法再次查看第二步通过 CLI 配置 GitHub MCP Server在 VS Code 集成终端中执行claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \ --header Authorization: Bearer your-github-pat注意https://api.githubcopilot.com/mcp/是 Anthropic 官方提供的 GitHub MCP 代理地址不是 GitHub 的原生 API。这是为了安全隔离避免 Claude 直接持有你的 PAT。第三步在 Extension 中验证与使用在 Claude prompt box 中输入/mcp确认githubserver 状态为 “Enabled”然后输入Review the open pull request #456 in this repository. Focus on security issues and TypeScript type safety. Summarize findings in a markdown table.Claude 会调用 MCP 的github工具获取 PR #456 的 diff解析 diff 中的 TypeScript 文件检查any类型、eval()调用、未处理的 Promise生成一个包含 “File”, “Line”, “Issue”, “Suggestion” 四列的 markdown 表格最后你可以点击表格中的文件名Claude 会自动在 VS Code 中打开对应文件并跳转到问题行常见问题排查如果提示Failed to connect to GitHub MCP server请检查PAT 是否过期GitHub PAT 默认有效期 30 天是否在~/.claude/settings.json中设置了disableLoginPrompt: true这会禁用所有 OAuth 流程包括 MCP网络是否能访问api.githubcopilot.com企业防火墙常拦截此域名4.3 多语言环境的自动识别与激活——Python/Go/Rust 的差异化处理Claude Code 的一个隐藏能力是它能根据当前打开的文件类型自动激活对应的语言环境。但这需要你提前配置好 IDE 的语言支持插件。Python 环境最典型必装插件ms-python.python官方 Python 扩展配置在 VS Code 设置中确保python.defaultInterpreterPath指向你的虚拟环境如./venv/bin/pythonClaude 行为当你打开.py文件时它会自动source ./venv/bin/activate然后运行python -m pip list获取包列表用于回答 “How does requests.Session work?” 这类问题Go 环境必装插件golang.go配置在settings.json中设置go.gopath和go.gorootClaude 行为能解析go.mod理解replace指令并在你问 “Why is this interface not implemented?” 时自动go list -f {{.Deps}} ./...查找依赖Rust 环境必装插件rust-lang.rust-analyzer配置确保rust-analyzer的cargo配置正确如rust-analyzer.cargo.loadOutDirsFromCheck: trueClaude 行为能读取Cargo.toml的features理解#[cfg]宏并在你问 “How to fix E0599: no method namedunwrap” 时自动运行cargo check获取精确错误位置实操技巧如果你想强制 Claude 使用某个环境可以在 prompt 中加入shell: python3 -c import sys; print(sys.version)它会先执行该命令再回答问题。这是绕过自动检测的“急救方案”。5. 常见问题与排查技巧实录5.1 “Spark icon not visible” 的七种可能与对应解法这是安装后最常遇到的问题表面看是图标不显示实则背后有七种完全不同的技术原因。我按发生概率排序并给出精准诊断命令排查序号可能原因快速诊断命令解决方案1VS Code 版本 1.98.0code --version升级 VS Code 到最新版2Workspace 未被信任点击右下角锁图标看是否显示 “Restricted Mode”点击锁图标 → “Trust Folder and Subfolders”3当前无代码文件打开确认编辑器标签页是否为.ts/.py/.rs等而非README.md或空文件夹打开任意一个代码文件哪怕新建一个test.js4Extension 未正确激活CmdShiftP→ 输入Developer: Show Running Extensions搜索claude-code如果状态为 “Inactive”执行Developer: Reload Window5Shell 环境未继承macOSCmdShiftP→Developer: Toggle Developer Tools→ Console →process.env.PATH从终端执行code .启动 VS Code6Conflicting AI 扩展干扰CmdShiftX→ 禁用所有其他 AI 插件如 Continue、Cline、Cursor逐一禁用重启 VS Code定位冲突源7Extension 存储损坏CmdShiftP→Developer: Inspect Context Keys→ 搜索claude删除~/.vscode/extensions/anthropic.claude-code-*目录重装 Extension独家技巧在 VS Code 的 Developer Tools Console 中执行vscode.extensions.getExtension(anthropic.claude-code)?.activate()可以手动触发 Extension 激活。如果返回Promise {pending}说明正在加载如果报错错误信息就是根本原因。5.2 “pnpm 无法将‘pnpm’项识别为 cmdlet” 的深度解析这个 PowerShell 错误在 Windows 用户中泛滥根源在于 VS Code 的集成终端PowerShell与系统终端的PATH环境变量不一致。具体来说你在 Windows Terminal 里能运行pnpm是因为pnpm被安装到了%USERPROFILE%\AppData\Roaming\npm而该路径被添加到了系统的PATH但 VS Code 的 PowerShell 终端默认不读取系统PATH而是读取 VS Code 进程启动时的环境变量当你从开始菜单启动 VS Code它继承的是 Windows Explorer 的环境变量而 Explorer 的PATH可能未包含 npm 目录终极解决方案三步确认 pnpm 安装路径在 Windows Terminal 中执行where pnpm得到类似C:\Users\YourName\AppData\Roaming\npm\pnpm.ps1的路径将该路径添加到 VS Code 的terminal.integrated.env.windows设置中Cmd,→ 搜索terminal.integrated.env.windows点击 “Edit in settings.json”添加terminal.integrated.env.windows: { PATH: ${env:PATH};C:\\Users\\YourName\\AppData\\Roaming\\npm }重启 VS Code 的集成终端关闭所有终端 tab按CtrlShiftP→Terminal: Kill All Terminals然后重新打开注意路径中的反斜杠\必须双写\\这是 JSON 字符串转义规则。单写会报错。5.3 “Claude Code never responds” 的网络层诊断法当面板卡在 “Connecting…” 时不要盲目重装。请按以下网络层顺序诊断第一层DNS 解析在 VS Code 终端中执行nslookup api.anthropic.com # 应返回 IP 地址如 34.123.45.67如果超时说明 DNS 被污染或企业 DNS 未放行。第二层HTTPS 连通性curl -I https://api.anthropic.com # 应返回 HTTP 200 或 401未授权而非 timeout 或 SSL error第三层WebSocket 连通性