📖 前置阅读
我在之前的文章，介绍了 Claude Code 在终端中的完整安装与配置流程：
Claude Code 还提供了一个专为编辑器设计的使用路径——以插件形式嵌入 VS Code 或 Cursor 中直接运行。
对于日常在 Cursor 里开发的同学来说，这意味着无需在终端和编辑器之间来回切换：你可以直接在编辑器侧边打开 Claude Code 面板，享受它的 Agent 编程能力，同时保留 Cursor 原有的补全与对话体验。
📋 本文内容概览
本文将完整演示如何在 Cursor 中安装并启用 Claude Code for VS Code 插件，以及如何通过 CC-Switch 的一键同步功能，让插件自动跟随当前激活的供应商配置（如 MiniMax-M2.5 或官方 Claude）——全程不需要手动编辑任何配置文件。
流程概览：
安装插件 → 在 CC-Switch 中开启同步 → 在 Cursor 中打开并验证
📦 在 Cursor 中安装 Claude Code for VS Code 插件
Cursor 基于 VS Code 内核构建，它完全兼容 VS Code 扩展市场中的所有插件。在扩展面板中搜索并安装官方的 Claude Code for VS Code 插件即可。
步骤一：搜索并安装插件
打开 Cursor，点击左侧活动栏的扩展图标（或按 Ctrl+Shift+X），在搜索框中输入 Claude。在搜索结果中找到 「Claude Code for VS Code」（发布者：Anthropic，安装量 690 万+），点击 Install 完成安装。
▲ 在扩展市场中搜索并安装 Claude Code 插件
✅ 安装成功标志
插件卡片右侧会出现 Disable 和 Uninstall 按钮（替换原来的 Install），表示插件已成功安装并激活。右键点击插件条目，可以看到包含 Settings（设置）在内的上下文菜单——这是后续配置的入口，但使用 CC-Switch 时不需要在这里手动修改任何参数。
步骤二：应用到 Claude Code 插件
插件安装完成后，回到 CC-Switch。CC-Switch 内置了一项专为 VS Code / Cursor 插件设计的同步功能——只需在设置中开启一个开关，此后每次在 CC-Switch 中切换供应商时，插件所使用的模型和 API 配置都会自动同步更新，无需手动修改任何 JSON 配置文件或环境变量。
（1）点击 CC-Switch 主界面左上角的齿轮图标进入设置
打开 CC-Switch，在主界面左上角找到齿轮图标（设置按钮），点击进入设置页面。
（2）开启「应用到 Claude Code 插件」开关
进入设置页面后，在「通用」标签下找到 「应用到 Claude Code 插件」 选项，将右侧开关拨到开启状态。
💡 同步原理
开关开启后，CC-Switch 会立即将当前激活供应商的配置写入 Claude Code for VS Code 插件所读取的配置路径。后续每次在 CC-Switch 主界面点击某个供应商的「启用」按钮，插件的模型配置也会同步刷新，真正做到**「一处切换，多处生效」**。
步骤三：验证效果
回到 Cursor，打开 Claude Code 面板，验证插件是否已正确接入当前激活的供应商。
🎯 本步骤的最终判据
在 Cursor 的 Claude Code 面板中提问，能够收到正常回复。
（1）通过编辑器顶部菜单打开 Claude Code 面板
在 Cursor 中，点击右上角的 ...（更多操作）按钮，在弹出的下拉菜单中找到并点击 「Claude Code: Open」，即可在编辑器中打开 Claude Code 交互面板。
⚠️ 提示
如果在菜单中找不到「Claude Code: Open」选项，请确认插件已正确安装且处于启用状态。也可以通过命令面板（
Ctrl+Shift+P）搜索Claude Code: Open来打开。
（2）在 Claude Code 面板中发起对话，验证接入效果
Claude Code 面板在编辑器中打开后，在底部输入框中输入「你用的是什么模型？」并发送。如果能够收到正常回复，说明插件已成功接入 CC-Switch 当前激活的供应商配置。
🎉 配置完成！
至此，在 Cursor 中使用 Claude Code 插件的完整配置流程已全部完成。后续如需切换底层模型（例如从官方 Claude 切换到 MiniMax），只需在 CC-Switch 主界面点击对应供应商的「启用」按钮，插件会自动同步，无需重启 Cursor 或做任何额外操作。
💬 使用体验说明
在 Cursor 中，Claude Code 以独立对话面板的形式运行，与 Cursor 自身的 AI 补全和 Composer 功能相互独立、互不干扰。
你可以同时使用 Cursor 的原生补全能力进行日常快速编辑，在需要执行复杂 Agent 任务（跨文件重构、Git 操作、测试修复等）时切换到 Claude Code 面板，充分发挥两者各自的优势。
