Claude Code在VS Code中的真实工作流与四大核心能力

没伞请奔跑i

324人浏览 · 2026-07-15 11:54:57

没伞请奔跑i · 2026-07-15 11:54:57 发布

1. 这不是又一个“安装插件就完事”的教程：Claude Code 在 VS Code 里的真实工作流长什么样？

你搜到的标题是“VS Code + Claude Code 插件使用教程”，但点进来发现，90% 的内容都在教你怎么点开扩展市场、怎么输 Ctrl+Shift+X 、怎么点安装——这根本不是“使用”，这只是“把图标放进编辑器”。真正的使用，是当你在改一个三天没动过的遗留模块时，Claude Code 能帮你三分钟定位到那个藏在 utils/legacy/ 下、被六个不同文件 import 的 transformData() 函数里，第 42 行那个被注释掉但实际还在执行的 if (isDebug) 判断；是你在写 CI 脚本时，它能直接读取 .github/workflows/deploy.yml ，然后生成一条带完整上下文解释的 git commit --amend -m "chore(ci): fix deploy timeout by increasing timeout to 30m #ref: .github/workflows/deploy.yml#L18" ；是你在调试一个前端报错时，它不光告诉你 Cannot read property 'data' of undefined ，还能自动翻出你刚打开的 apiService.ts ，指出第 73 行的 response.data 没做空值校验，并给你补上 ?.data || [] 的 inline diff。

这才是 Claude Code 在 VS Code 里该有的样子。它不是个问答机器人，而是一个嵌入你开发肌肉记忆里的“副驾驶”——你敲代码的手指没停，它的思考就在后台同步加载上下文；你选中一段函数，它的分析已经准备好；你按下 Alt+K ，它立刻把当前文件路径和行号塞进提示框，连空格都不用你多按一下。我试过在同一个项目里同时开着 Cursor、Continue 和 Claude Code，最后只留下 Claude Code，不是因为它“最聪明”，而是因为它最“懂 VS Code 的呼吸节奏”：它的 Spark 图标只在你真正需要时才亮起，它的权限模式让你对每一次文件修改都保有最终决定权，它的会话历史不是冷冰冰的时间戳列表，而是按“今天修复了 auth 流程”“昨天重构了数据层”这样的人类语言自动归类。这篇教程，我们不讲“怎么装”，我们讲“怎么让它真正长在你的手指尖上”。

2. 安装只是起点，真正卡住你的是这四个“看不见的门槛”

很多人装完 Claude Code，点开 Spark 图标，看到登录页，输入账号，点确认——然后就卡住了。面板空白，状态栏的 ✱ 图标一直转圈，或者弹出一句模糊的 “Failed to connect”。这不是插件坏了，而是你撞上了四个绝大多数教程绝口不提、但每个开发者必经的“隐形门槛”。我踩过所有坑，也帮团队里 17 个同事逐个排查过，下面这四步，缺一不可。

2.1 VS Code 版本陷阱：1.98.0 不是建议，是硬性熔断线

官方文档写的是“1.98.0 或更高版本”，但很多人没意识到，这个版本号背后是一次底层通信协议的彻底重写。低于 1.98.0 的 VS Code（比如你公司 IT 部门统一部署的 1.96.2），其 Extension Host 与 Claude Code 扩展之间无法建立 MCP（Model Context Protocol）连接。你看到的“加载中”，其实是 VS Code 在反复尝试用旧协议握手，直到超时放弃。

实操验证法 ：
打开 VS Code，按 Cmd+Shift+P （Mac）或 Ctrl+Shift+P （Win/Linux），输入 Help: About ，回车。看第一行显示的版本号。如果低于 1.98.0 ，别犹豫，立刻去官网下载最新版。注意：不要用 code --version 命令查，这个命令返回的是 CLI 版本，不是 GUI 编辑器版本。很多人的 VS Code 是通过 Homebrew 或 Snap 安装的，CLI 版本可能很新，但 GUI 编辑器还是老的。我见过最典型的案例，是某金融公司开发机上预装的 VS Code 1.95.3，IT 部门说“稳定不升级”，结果整个团队的 AI 辅助功能全部失效，最后靠手动下载 .dmg 文件覆盖安装才解决。

提示：升级后务必重启 VS Code 全局进程。仅 Reload Window 不够，因为旧的 Extension Host 进程可能还在后台运行。关掉所有 VS Code 窗口，再从 Dock 或开始菜单重新启动。

2.2 登录失败的真相：不是账号问题，是环境变量没继承

你输入 Anthropic 账号，浏览器跳转授权成功，回到 VS Code 却还是显示 “未登录 · 请运行 /login”。这时候，90% 的人会怀疑是不是密码错了、网络被墙了、或者账号没开通权限。其实，根源往往在你的 Shell 环境变量没有被 VS Code 继承。

VS Code 默认启动时，不会加载你 .zshrc 或 .bash_profile 里定义的 PATH 、 ANTHROPIC_API_KEY 等变量。它启动的是一个“干净”的环境。所以，即使你在终端里 echo $ANTHROPIC_API_KEY 能看到密钥，VS Code 里也完全不知道。

两种可靠解法，任选其一 ：

推荐方案（一劳永逸） ：永远用终端启动 VS Code。在你的 iTerm2 或 Terminal 里，cd 进你的项目根目录，然后输入 code . 。这个 code 命令是 VS Code 安装时注册的 CLI，它会把当前 Shell 的所有环境变量原封不动地传给 VS Code 进程。这是最符合开发者工作流的方式，你本来就要在终端里跑 git 、 pnpm 、 docker ，顺手 code . 就行。
备选方案（临时救急） ：如果你必须从 Dock 或桌面图标启动，那就得手动配置。打开 VS Code 设置（ Cmd+, ），搜索 terminal integrated env ，找到 Terminal > Integrated: Env Osx （Mac）或 Terminal > Integrated: Env Windows （Win）。点击右侧的 {} 图标进入 JSON 编辑模式，在大括号内添加：
```
"ANTHROPIC_API_KEY": "your_actual_api_key_here"
```
注意：这里填的是你从 Anthropic Console 复制的完整密钥，不是账号密码。密钥格式是 sk-ant-api03-... 开头的一长串字符。填完保存，重启 VS Code。

注意：绝对不要在 VS Code 的设置 UI 里找“Claude Code API Key”这种字段去填。Claude Code 扩展本身不提供这个设置项，它只认系统环境变量或 Anthropic 账号登录。填错地方只会浪费你半小时。

2.3 Spark 图标消失之谜：不是插件没装好，是“工作区信任”在作祟

你明明装好了插件，也登录成功了，可编辑器右上角就是看不到那个闪亮的 Spark 图标。你点活动栏、点状态栏，全都没反应。这时候，先别急着重装，打开 VS Code 的命令面板（ Cmd+Shift+P ），输入 Developer: Toggle Developer Tools ，回车。切换到 Console 标签页，刷新一下，看看有没有红色报错。大概率你会看到类似 Extension 'anthropic.claude-code' is disabled because the workspace is not trusted 的提示。

这就是 VS Code 的“受限制工作区”（Restricted Mode）在起作用。当你打开一个来自邮件附件、U 盘、或者 GitHub Codespaces 里 clone 下来的陌生项目时，VS Code 会默认将其标记为“不受信任”，并禁用所有需要访问文件系统或网络的扩展，Claude Code 正好全中。

解锁步骤 ：

点击 VS Code 窗口右下角的状态栏，找到写着 Restricted Mode 的区域（通常是个小锁图标）。
点击它，会弹出一个菜单，选择 Trust Workspace and Enable Extensions 。
确认后，VS Code 会自动重载窗口，Spark 图标立刻就会出现在编辑器右上角。

提示：这个“信任”操作是针对当前工作区的，不是全局开关。你下次打开另一个新项目，还得再点一次。这是 VS Code 的安全设计，不是 bug。如果你经常处理大量外部代码，可以在设置里搜索 security.workspace.trust.enabled ，把它设为 false 关闭此功能，但仅限于你完全掌控的开发环境。

2.4 权限模式误设：为什么你的代码被“偷偷”改了？

你让 Claude Code “帮我把这段逻辑改成 Promise 链”，它秒回一个漂亮的 diff，你点了“接受”，结果发现 package.json 里多了一行 "type": "module" ， tsconfig.json 也被加了 "esModuleInterop": true 。你根本没让它动这些文件！这问题出在“权限模式”（Permission Mode）上。

Claude Code 默认有四种模式：

default ：每次要改文件前，都弹出一个清晰的 diff 对话框，等你手动点“Accept”或“Reject”。
plan ：它先生成一个 Markdown 计划文档，详细列出要改哪几个文件、每行怎么改、为什么这么改，你可以在文档里加评论，它再执行。
acceptEdits ：它生成 diff 后，自动帮你点“Accept”，不等你确认。
bypassPermissions ：最高危模式，它直接写文件，连 diff 都不给你看。

很多人在第一次使用时，为了“体验流畅”，在提示框底部点了一下模式指示器，切到了 acceptEdits ，然后就忘了。后续所有操作，它都自动执行，你根本来不及审查。

正确做法 ：
永远从 default 模式开始。在提示框底部，你会看到一个写着 default 的小按钮，点击它，确保它高亮显示。等你用熟了，对某个特定任务（比如批量重命名变量）建立了 100% 信任，再临时切到 plan 模式，看它写的计划是否合理。至于 acceptEdits 和 bypassPermissions ，除非你在离线沙箱环境做实验，否则永远不要开启。我在团队规范里写死了一条：任何提交到 Git 的代码，必须经过 default 模式下的手动 diff 审查。

3. 从“能用”到“离不开”：Claude Code 的四大核心能力实战拆解

装好了、登录了、图标也亮了，接下来才是重头戏。Claude Code 的价值，不在于它能回答“React 怎么写 useEffect”，而在于它能把你的 IDE 变成一个“活”的开发环境。下面这四个能力，是我每天高频使用、且其他工具完全无法替代的，每一个都附带真实场景和操作细节。

3.1 @-提及：不是简单的“引用文件”，而是构建你的专属知识图谱

你肯定知道可以输入 @main.ts 让 Claude 读取这个文件。但这只是冰山一角。Claude Code 的 @ 系统，本质是一个动态的、基于你当前项目的“上下文索引器”。它能模糊匹配、能递归扫描、能精准定位到行，甚至能处理你还没打开的文件。

真实场景：重构一个混乱的 API 层
项目里有个 api/ 目录，里面有 userApi.ts , authApi.ts , paymentApi.ts ，还有十几个叫 xxxApi.ts 的文件。你想把所有 GET 请求统一加上 cache: 'no-cache' 选项，但又不确定哪些文件里真有 GET 。传统做法是 grep -r "fetch.*GET" api/ ，再一个个打开。用 Claude Code，三步搞定：

在提示框里输入： @api/ （注意末尾的 / ，这告诉 Claude 这是一个文件夹）。
等待几秒，它会显示“已加载 12 个文件”，并给出一个摘要：“检测到 8 个文件包含 fetch 调用，其中 5 个明确使用 GET 方法”。
接着输入： 请为所有包含 GET 请求的文件，添加 cache: 'no-cache' 选项，并生成一个完整的修改计划。

它会立刻列出 userApi.ts#L23 , authApi.ts#L45 等具体位置，并为你生成一个 plan 模式下的 Markdown 文档，里面每一处修改都带原始代码、目标代码、以及一行解释：“为防止浏览器缓存 GET 响应，强制禁用缓存”。

进阶技巧 ：

精准行号引用 ：在编辑器里选中第 15-20 行的代码，按 Alt+K （Win/Linux）或 Option+K （Mac），它会自动插入 @userApi.ts#15-20 。这比你手动打字快十倍，而且绝对不手抖。
PDF 页面级引用 ：如果你的项目文档是 PDF，比如 ARCHITECTURE.pdf ，你可以输入 @ARCHITECTURE.pdf#page=3 ，它只读取第 3 页，而不是整个几百页的文件，速度飞快。
排除敏感文件 ： .env 、 secrets.json 这类文件，你肯定不想让它读。在 VS Code 设置里，搜索 claudeCode.excludePatterns ，添加 [".env", "**/secrets.json"] ，从此它再也不会碰这些文件。

3.2 Checkpoint（检查点）：不是“撤销”，而是“时光机”级别的代码状态管理

Git 的 git checkout 是按 commit 回退，VS Code 的 Ctrl+Z 是按编辑步回退。Claude Code 的 Checkpoint，则是按“AI 的每一次决策”来回退。它记录的不是你敲了什么键，而是 Claude 在哪一步做了什么判断、改了哪些文件。

真实场景：一次失败的自动化重构
你让 Claude Code “把所有 var 声明替换成 const 或 let ”，它执行了，但忘了检查 for (var i = 0; i < arr.length; i++) 这种循环里 i 的作用域，导致 i 被错误地改成了 const ，代码直接报错。这时候，你不需要 git reset --hard ，也不需要手动一行行改回来。

在 Claude Code 的聊天记录里，找到它开始执行替换操作的那条消息。
把鼠标悬停在这条消息上，右上角会出现一个 🕒 图标（Checkpoint 按钮）。
点击它，弹出三个选项：
- 从此处分叉对话 ：保留所有已做的修改，但从此刻开始一个新分支，继续讨论。
- 将代码倒带到此处 ： 这才是你需要的 。它会把所有被修改的文件，瞬间恢复到这条消息之前的状态，就像 Claude 从来没动过它们一样。
- 分叉对话并倒带代码 ：两者结合。

我用这个功能最多的一次，是在一个 2000 行的 Vue 组件里做 Composition API 迁移。Claude Code 第一轮改得不错，第二轮它自作主张把 ref() 改成了 computed() ，逻辑全乱。我点一下 将代码倒带到此处 ，2 秒钟，所有文件回到第一轮修改后的完美状态，然后我直接告诉它：“请只修改 setup() 内部，不要碰 computed 属性”，它立刻照做。整个过程，比 git stash + git pop + 手动修复快得多，也安全得多。

3.3 Terminal 集成：不是“复制粘贴日志”，而是让 Claude 直接“看见”你的终端世界

你调试时， pnpm run dev 启动服务，终端里刷出一堆日志，最后一行是 Error: Cannot find module 'lodash' 。传统做法是，你得把这行错误复制出来，再粘贴到 Claude 的提示框里。但 Claude Code 有个更聪明的办法： @terminal:dev 。

真实场景：快速定位 CI 构建失败原因
你的 GitHub Actions 构建失败了，日志里有一段关键输出：

> pnpm run build
...
src/utils/format.ts:12:10 - error TS2304: Cannot find name 'Intl'.

你本地 VS Code 里，已经打开了一个名为 build 的终端标签页，里面正在跑 pnpm run build 。这时：

在 Claude Code 的提示框里，输入 @terminal:build 。
它会立刻读取这个终端里最近 100 行的输出，并把它作为上下文的一部分。
然后你输入： 上面的 TypeScript 错误是什么意思？如何修复？请直接告诉我需要修改的文件和行号。

它会分析 @terminal:build 的输出，结合你项目里 tsconfig.json 的配置，精准指出： src/utils/format.ts 第 12 行用了 Intl.DateTimeFormat ，但 tsconfig.json 的 lib 里没包含 "es2021.intl" ，所以需要在 tsconfig.json 的 compilerOptions.lib 数组里加上 "es2021.intl" 。

关键细节 ：

@terminal:xxx 里的 xxx ，就是你终端标签页的标题。你可以在终端里右键 -> Rename Terminal ，把它改成有意义的名字，比如 dev , test , build ，这样引用起来一目了然。
它读取的是“当前可见”的终端输出，不是历史记录。所以确保你的错误日志还在终端窗口里，没被滚屏刷掉。
这个功能完美解决了“环境差异”问题。CI 里报错，本地不报，往往是因为 CI 的 Node 版本、环境变量不同。 @terminal:ci （如果你在本地开了个模拟 CI 的终端）能让你直接把那个“不同环境”的输出喂给 Claude。

3.4 MCP Server（模型上下文协议）：不是“调用 API”，而是让 Claude 成为你 IDE 的“原生居民”

MCP 是 Claude Code 最底层、也最强大的能力。它让 Claude 不再是一个“外部服务”，而是 VS Code 的一部分。通过 MCP，Claude 可以直接调用 VS Code 的内部 API，比如读取你当前打开的 Jupyter Notebook 的单元格、执行 Python 代码、获取语言服务器的诊断信息（也就是 VS Code 问题面板里的红绿波浪线）。

真实场景：在 Jupyter Notebook 里做实时数据分析
你有一个 analysis.ipynb ，里面已经跑通了数据清洗，现在想让 Claude 帮你写一个机器学习模型。你不用切到终端，不用复制数据，不用导出 CSV。

确保你的 Jupyter 扩展（ ms-toolsai.jupyter ）已安装并启用。
在 analysis.ipynb 里，选中你清洗好的 df DataFrame（比如一个包含 1000 行销售数据的 pandas DataFrame）。
打开 Claude Code 面板，输入： @notebook:analysis.ipynb#cell=2 （假设你的数据在第二个 cell 里）。
然后输入： 请基于这个 DataFrame，训练一个随机森林模型来预测销售额，并画出特征重要性图。

Claude Code 会通过 MCP 协议，直接向 VS Code 的 Jupyter 内核发送指令，要求它执行 model.fit(X, y) 和 plt.show() 。执行前，VS Code 会弹出一个 Quick Pick 确认框，问你“是否允许 Claude Code 在当前 notebook 中执行代码？”，你点“是”，代码立刻运行，图表直接显示在 notebook 里。

为什么这比“调用 OpenAI API”强？

零数据泄露 ：所有数据都在你的本地 Jupyter 内核里，从不离开你的电脑。
零上下文丢失 ：它看到的不是你复制粘贴的几行代码，而是整个 notebook 的运行时状态，包括所有已定义的变量、导入的库、甚至你上次运行的 plt.rcParams 设置。
无缝集成 ：生成的图表不是一张图片发给你，而是直接插入到 notebook 的下一个 cell 里，和你自己写的代码完全一样。

我用这个功能做过一个完整的客户行为分析报告，从数据清洗、特征工程、模型训练到可视化，全部在一个 notebook 里完成，Claude Code 就像我的一个超级助手，全程没离开过 VS Code。

4. 避坑指南：那些官方文档不会告诉你、但会让你抓狂的 7 个细节

再好的工具，也有它的“脾气”。Claude Code 的文档写得非常全面，但它刻意回避了一些会让新手瞬间崩溃的细节。我把这些“暗礁”全列出来，配上我的解决方案，帮你省下至少 20 小时的无效排查时间。

4.1 “Computer Use” 功能不可用？先检查 Chrome 版本和扩展

“Computer Use” 是 Claude Code 的一个预览功能，能让它直接控制你的 Chrome 浏览器，比如自动打开 localhost:3000 、检查控制台错误、填写表单。但很多人装完插件，输入 @browser go to localhost:3000 ，却得到 Browser automation is not available 的错误。

根本原因 ：

你的 Chrome 浏览器版本太低。官方要求 Chrome 120+，但实测，Chrome 124 才能稳定工作。
你没安装或没启用 “Claude in Chrome” 这个独立的 Chrome 扩展。Claude Code VS Code 插件和 Chrome 扩展是两个东西，必须都装。

解决步骤 ：

打开 Chrome，地址栏输入 chrome://version ，看版本号。如果不是 124 或更高，立刻更新。
打开 Chrome 网上应用店，搜索 “Claude in Chrome”，安装官方扩展。
安装后，点击 Chrome 右上角的拼图图标，找到 “Claude in Chrome”，确保它旁边的小开关是蓝色的（已启用）。
回到 VS Code，在 Claude Code 面板里输入 /plugins ，在 Plugins 列表里找到 computer-use ，确保它是已启用状态（开关是蓝色的）。

注意： computer-use plugin 默认是禁用的，你必须手动启用。它不会在你安装 VS Code 插件时自动激活。

4.2 插件市场（Marketplaces）里找不到想要的 Plugin？试试 GitHub 直链

Claude Code 的插件市场（Marketplaces）默认只连官方源。但很多强大、实用的第三方 plugin，比如 vscode-git-history 的深度集成版、 sql-lint 的 Claude 适配版，都托管在个人 GitHub 仓库里。你不能在 Marketplace UI 里搜索到它们。

正确安装法 ：

找到那个 plugin 的 GitHub 仓库地址，比如 https://github.com/username/codex-git-helper 。
在 VS Code 里，打开 Claude Code 面板，输入 /plugins 。
切换到 Marketplaces 标签页。
在 “Add marketplace” 输入框里， 直接粘贴这个 GitHub URL ，然后点旁边的 + 号。
点击右上角的 Refresh 图标，等待几秒，你就能在 Plugins 标签页里看到这个新 marketplaces 下的所有 plugin 了。

我用这个方法装过 codex-dockerfile-linter ，它能直接分析你的 Dockerfile ，指出 FROM alpine:latest 这种不安全的写法，并给出 FROM alpine:3.20 的精确版本建议，比 Docker Desktop 自带的 linter 强太多。

4.3 “Spark 图标在边栏不显示”？不是 Bug，是位置设置被你悄悄改了

你发现活动栏（左侧边栏）里没有 Spark 图标，只有资源管理器、搜索、源代码管理那些图标。你去设置里翻了半天，也没找到“显示 Spark 图标”的开关。其实，这是你无意中把 Claude Code 面板拖到了“编辑器区域”（也就是和你的代码文件并排的 tab 里），VS Code 的设计逻辑是： 只有当 Claude Code 面板停靠在“主边栏”或“次级边栏”时，它的图标才会出现在活动栏里 。

找回图标 ：

确保你已经打开了一个 Claude Code 面板（哪怕是个空的）。
把鼠标移到这个面板的顶部标题栏（写着 “Claude Code” 的那条灰色横条）。
按住鼠标左键，把它往左拖，一直拖到 VS Code 窗口的最左边边缘，直到出现一个半透明的蓝色边框。
松开鼠标，面板就会自动吸附到主边栏（和资源管理器同一侧）。
此时，活动栏里立刻就会出现那个熟悉的 Spark 图标。

提示：你也可以把它拖到右边边缘，吸附到“次级边栏”，这样它就和你的调试面板、问题面板并排，适合大屏幕开发。

4.4 快捷键 `Cmd+Esc` 在 macOS 上失效？系统快捷键在“抢”你的键

在 macOS Sonoma（14.x）及更高版本，系统自带的“游戏覆盖”（Game Overlay）功能，默认绑定了 Cmd+Esc 这个组合键，用来呼出游戏性能监控面板。这个系统级快捷键，会在按键到达 VS Code 之前就把它截获，所以你的 Cmd+Esc 切换焦点永远不生效。

永久解决方案 ：

打开 macOS “系统设置” → “键盘” → “键盘快捷键” → “游戏控制器”。
找到 “游戏覆盖” 这一项，把它前面的勾去掉。
关闭设置， Cmd+Esc 立刻恢复正常。

临时替代方案（不推荐长期用） ：
如果你不想关掉系统功能，可以在 VS Code 里重绑定。按 Cmd+K Cmd+S 打开快捷键编辑器，搜索 Claude Code: Focus input ，双击它，然后按你想要的新组合键，比如 Cmd+Shift+Esc 。但记住，这会改变你和其他人共享的快捷键习惯，容易混淆。

4.5 “Claude Code 从不响应”？先看终端里有没有 `claude` 进程在吃 CPU

有时候，Claude Code 面板一片空白，状态栏的 ✱ 图标疯狂旋转，但就是没反应。你检查了网络、重启了 VS Code、甚至重装了插件，都没用。这时候，打开你的系统活动监视器（Mac）或任务管理器（Win），搜索进程名 claude 。

常见情况 ：

你之前在终端里运行过 claude CLI，它可能因为某个错误卡死了，但进程还在后台运行，占着端口和内存。
VS Code 的 Extension Host 进程和 claude CLI 进程发生了冲突。

清理命令 ：

Mac/Linux ：在终端里运行 pkill -f claude 。这会杀死所有名字里带 claude 的进程。
Windows ：在 PowerShell 里运行 Get-Process | Where-Object {$_.ProcessName -like "*claude*"} | Stop-Process 。

杀掉进程后，重启 VS Code，一切恢复正常。这是我帮同事解决的最多的问题，平均每周遇到 3 次。

4.6 “无法将 ‘pnpm’ 项识别为 cmdlet”？VS Code 没继承你的 Shell PATH

这个错误，和前面的登录失败是同一个根因：VS Code 启动时没加载你的 Shell 配置。 pnpm 是通过 corepack 或 npm install -g pnpm 安装的，它的可执行文件路径（比如 /Users/you/.local/share/pnpm/pnpm ）被加到了你的 .zshrc 的 PATH 里。但 VS Code 不知道。

终极解决法（一劳永逸） ：
永远用 code . 从终端启动 VS Code。这是唯一 100% 可靠的方法。
临时解决法（救急） ：
在 VS Code 设置里，搜索 terminal integrated default profile ，找到 Terminal > Integrated > Default Profile: Osx （Mac）或 Windows （Win），把它改成你日常用的 Shell，比如 zsh 或 pwsh 。然后重启 VS Code 的集成终端（ Ctrl+Shift+P → Terminal: Kill the Active Terminal Instance ，再 Terminal: Create New Terminal ）。

4.7 “Claude Code 桌面版”和 VS Code 插件，到底该用哪个？

官方提供了 Claude Code 桌面版（一个独立的 .app ），很多人会困惑：我已经有 VS Code 了，还要装桌面版吗？答案是： 99% 的情况下，不需要 。

VS Code 插件 ：深度集成，能读取你的代码、终端、Jupyter、Git 状态，能修改文件，能调用 MCP。它是“生产环境”。
桌面版 ：就是一个网页版（claude.ai）的封装壳，功能和网页版完全一样，没有 MCP，不能访问你的本地文件，不能和你的开发流程联动。它是“备用浏览器”。

我只在一种情况下用桌面版：当我需要在一台没有安装 VS Code 的电脑（比如客户的演示机）上，快速展示 Claude Code 的能力。除此之外，所有开发工作，都只用 VS Code 插件。桌面版的存在，更多是为了品牌统一，而不是功能补充。

5. 从入门到精通：我的个人工作流优化清单（附可直接复制的配置）

用 Claude Code 三个月后，我总结了一套属于自己的、高度个性化的高效工作流。它不是照搬官方最佳实践，而是我根据每天的真实痛点，一点点打磨出来的。下面这份清单，你可以直接抄作业，我已经把所有配置项、快捷键、操作习惯都列清楚了。

5.1 我的 VS Code 设置（settings.json）精简版

我把所有和 Claude Code 相关的设置，都集中在这个 JSON 片段里。复制粘贴到你的 VS Code settings.json （ Cmd+, → 右上角 {} 图标）里即可：

{
  // 【核心】让 Claude Code 面板默认停靠在次级边栏（右侧），不影响主边栏
  "claudeCode.preferredLocation": "sidebar",
  // 【安全】永远用 manual approval 模式，绝不自动改代码
  "claudeCode.initialPermissionMode": "default",
  // 【效率】自动保存文件，避免 Claude 读到脏数据
  "claudeCode.autosave": true,
  // 【兼容】尊重 .gitignore，不把 node_modules 之类的东西喂给 Claude
  "claudeCode.respectGitIgnore": true,
  // 【调试】开启详细日志，出问题时第一时间看
  "claudeCode.logLevel": "debug",
  // 【环境】强制让 Claude 使用项目根目录下的 Python 环境（如果你用 Python）
  "claudeCode.usePythonEnvironment": true,
  // 【排除】绝对不许 Claude 读取这些敏感文件
  "claudeCode.excludePatterns": [
    ".env",
    "**/secrets.json",
    "**/credentials.json",
    "**/private.key"
  ]
}

5.2 我的每日必用快捷键组合（已验证无冲突）

功能	Mac 快捷键	Win/Linux 快捷键	说明
快速打开 Claude Code 面板	`Cmd+Shift+X`	`Ctrl+Shift+X`	这是打开扩展市场的快捷键，但在我这里，它永远是第一个想到的入口，因为我知道 Claude Code 就在那里。
在当前文件里插入 @-提及	`Option+K`	`Alt+K`	这是我按得最多的一个键，没有之一。选中代码， `Alt+K` ，路径和行号自动填充。
切换 Claude 和编辑器焦点	`Cmd+Esc`	`Ctrl+Esc`	确保你的系统没占用这个键，这是在代码和 AI 之间无缝切换的生命线。
开始新对话（不关闭旧的）	`Cmd+Shift+Esc`	`Ctrl+Shift+Esc`	在边栏里打开一个全新的 Claude 面板，和旧的并存，适合并行处理多个任务。
查看 Claude 日志（出问题时）	`Cmd+Shift+P` → `Claude Code: Show Logs`	`Ctrl+Shift+P` → `Claude Code: Show Logs`	当一切都不对劲时，这是你唯一的救命稻草。

5.3 我的“三步启动法”：每次打开 VS Code 后的固定动作

第一步：检查工作区信任 。右下角状态栏，看到 Restricted Mode ，立刻点它，选 Trust Workspace 。这是所有功能的前提。
第二步：打开终端，运行 pnpm run dev （或你的启动命令） 。让 @terminal:dev 有内容可读。
第三步：打开 Claude Code 面板，输入 /usage 。这个命令会显示你今天的 token 使用量、模型调用次数、以及一个简短的“今日小贴士”。我把它当成晨会，快速了解 Claude 的状态。

5.4 我的“避坑心法”：三条铁律

铁律一：永远相信 diff，永不信任自动 。Claude Code 生成的任何修改，我都会在 default 模式下，逐行看它的 diff。哪怕只改了一行，我也要点开对比，确认它没动不该动的地方。这是底线。
铁律二：敏感操作，必走 plan 模式 。涉及到修改 package.json 、 tsconfig.json 、 .gitignore 这类影响全局的文件，我一定会先切到 plan 模式，让它生成一个 Markdown 计划，我通读一遍，确认无误后，再手动执行。
铁律三：环境即代码，Claude 即环境 。我把 ~/.claude/settings.json 加入了我的 dotfiles 仓库，和我的 VS Code 设置、