1. Windows 下 Claude Code 接 Playwright-MCP 调用本机 Edge 到底解决什么问题如果你在 Windows 上用 Claude Code想让它帮你做浏览器自动化——打开网页、点击按钮、截图、填表单——大概率会碰到 Playwright-MCP 这个工具。它的默认行为是自动下载一套独立的 Chromium 内核体积 200MB 起步国内网络环境下经常卡在下载环节或者下到一半超时失败。更让人头疼的是即使下载成功你本机明明已经装了 Microsoft Edge却还要多跑一个浏览器内核磁盘和内存都白占。这套方案的核心思路很直接让 Playwright-MCP 跳过自带 Chromium 的下载直接调用你 Windows 上已经安装好的 Edge。配置的关键就一个参数--executable-path指向msedge.exe的完整路径。配好之后Claude Code 通过 MCP 协议驱动 Edge 完成自动化操作不再碰 Playwright 的浏览器二进制包。适合谁看已经在 Windows 10/11 上装了 Node.js LTS 和 Claude Code CLI想用 MCP 做浏览器自动化但被 Chromium 下载卡住的开发者或者你本机 Edge 用得好好的不想再装一套浏览器内核的人。整条链路从环境确认、全局安装、MCP 配置、验证请求到报错排查下面一步步走完。需要说明的是这个方案每次启动的是全新空白 Edge 实例不会复用你日常 Edge 的登录账号和 Cookie。如果你需要带登录态操作文末会给出 CDP 调试端口模式的拓展方案。2. 前置准备TaoToken 与 Windows 环境确认在开始配 MCP 之前先把两件事搞定一是 Claude Code 能正常跑起来二是模型调用通道稳定。我这边一直用 TaoToken 作为 Claude Code 的接入通道它的 API 地址是https://taotoken.net/api官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。如果你还没配好 Claude Code 的模型通道先去控制台拿一个 API Key再按接入文档把环境变量或配置文件写好。2.1 确认 Node.js、npm、Claude Code 版本打开 PowerShell依次执行下面三条命令每条都要有正常版本号输出才算就绪node -v npm -v claude --version如果claude提示「不是内部或外部命令」说明 Claude Code CLI 没装或者没进 PATH。先装 Node.js LTS安装完重启终端再试。Node 版本建议 18 以上npm 跟着 Node 一起装好就行。2.2 设置国内 npm 镜像源Playwright-MCP 是 npm 包国内直连官方源经常慢到超时。先把镜像源切到 npmmirrornpm config set registry https://registry.npmmirror.com设置完可以用npm config get registry确认一下输出应该是https://registry.npmmirror.com/。这一步能明显减少后面全局安装时的等待时间。2.3 确认本机 Edge 路径大多数 Windows 10/11 的 Edge 装在默认位置C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe如果你的 Edge 不在这个路径右键桌面 Edge 快捷方式 → 属性 → 复制「目标」里的完整路径。注意路径里可能带引号复制时把引号去掉只保留C:\...\msedge.exe这一段。后面配置 MCP 时要用到这个路径先记下来。3. 可复制配置全局安装 Playwright-MCP 并指定 Edge这一章是整篇的核心操作区。Windows 下用npx playwright/mcplatest动态拉取很容易出现网络卡死、进程闪退、参数解析异常。所以优先全局安装把 MCP 服务本体固定下来。3.1 全局安装 playwright/mcpnpm install -g playwright/mcp装完之后验证全局命令是否可用playwright-mcp正常的话会输出 MCP 服务的启动信息然后停在那里等待连接。按Ctrl C终止即可。如果这条命令报「不是内部或外部命令」说明全局 bin 目录没进 PATH重新装一遍 Node 或者手动把 npm 全局路径加到系统 PATH。3.2 清除旧的错误 MCP 配置如果你之前配过 playwright 相关的 MCP先删掉旧的避免参数冲突claude mcp remove playwright --scope user如果提示没有这个配置忽略即可说明本来就没配过。3.3 用命令行添加 MCP 配置推荐命令行方式比手改 JSON 稳不容易写错层级和转义。执行claude mcp add playwright --scope user -- playwright-mcp --executable-path C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe这里几个点要注意--scope user表示全局用户级配置对所有项目生效--后面的内容是传给 MCP 服务的实际命令和参数--executable-path后面跟 Edge 的完整路径路径带空格所以用双引号包起来。这条命令执行完Claude Code 的配置文件里就会多出 playwright 这个 MCP 服务。3.4 查看 MCP 连接状态claude mcp list成功的话输出里会包含 playwright状态显示✔ Connected并且能看到 args 里带了 Edge 路径。如果显示红叉或者-32000: MCP error connection closed先别慌往下看第 5 章的排查。注意claude mcp list的探测机制在 Windows 上偶尔会误报短暂显示红叉但实际会话里工具能正常加载。最终以 Claude Code 会话内是否出现mcp__playwright__工具为准。3.5 手动改 .claude.json 的备选方案命令行方式搞不定时可以手动改配置文件。关键点mcpServers必须放在 JSON 根节点和projects同级不要嵌套进projects对象内部。嵌套进去只对单个项目生效容易让人以为配置没生效。{ mcpServers: { playwright: { command: playwright-mcp, args: [ --executable-path, C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe ] } } }Windows 下 JSON 路径的反斜杠必须写成双反斜杠\\否则解析会出错。改完保存把所有 Claude Code 终端关掉重新开 PowerShell 再启动。4. 验证请求从工具加载到 Edge 自动化跑通配置写完不算完得实际跑一遍确认链路通了。新开一个 PowerShell 窗口启动 Claude Code 会话claude进去之后先关掉 auto 自动模式防止 AI 自己写 Node 脚本绕过 MCP 工具auto off4.1 测试一确认 MCP 工具加载成功在会话里让它列出所有可用工具。输出里应该出现大量mcp__playwright__开头的工具比如browser_navigate、browser_click、browser_take_screenshot。看到这些就说明 MCP 加载完成Edge 路径参数也生效了。4.2 测试二完整浏览器自动化给 Claude Code 下一条完整指令比如调用 playwright mcp 工具打开浏览器访问百度搜索MCP协议完成后截图保存到桌面预期现象直接唤起本机 Edge 浏览器窗口不会触发 Chromium 下载自动访问百度、输入关键词、执行搜索截图输出到桌面并返回文件路径。整个过程你能看到 Edge 窗口被自动操作这就是 MCP 在驱动本机 Edge 的直接证据。4.3 测试三简单访问截图再跑一条更简单的验证访问 https://www.bing.com截图保存到桌面如果这条也能正常出图说明导航和截图两个基础能力都通了。到这一步Windows 下 Claude Code 通过 Playwright-MCP 调用本机 Edge 的完整链路就算跑通了。5. 本篇常见错排查-32000、Chromium 下载、Token 超限配 MCP 的过程里下面几个报错出现频率最高逐个说清楚原因和处理方式。5.1 -32000: MCP error connection closed这是最典型的连接报错原因通常有三个playwright/mcp全局包没装好PowerShell 命令参数复制不完整Node 没加入系统 PATH。处理方式是按顺序重来一遍npm install -g playwright/mcp claude mcp remove playwright --scope user claude mcp add playwright --scope user -- playwright-mcp --executable-path C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe重装后如果还报检查playwright-mcp这个命令能不能在 PowerShell 里单独跑起来。跑不起来就是 PATH 问题跟 MCP 配置无关。5.2 仍然尝试下载 Playwright 自带 Chromium说明 MCP 配置里没带上--executable-path或者参数写错了没生效。先删旧配置再重新执行完整的 add 命令然后用claude mcp list确认 args 里确实包含 Edge 路径。只要这个参数在程序就不会去用 Playwright 自带的浏览器目录。5.3 number of input tokens has exceeded max_prompt_tokens会话历史累积太多token 超限了。最简单的处理关掉当前 PowerShell新开一个窗口重新运行claude。旧会话没法修复只能重开。如果经常碰到说明单次任务太重拆成多个小任务分别跑。5.4 AI 自己写 JS 脚本没有调用 MCP 工具这是 auto 模式在作怪AI 觉得写脚本更快就绕过了 MCP。会话里执行auto off关掉自动模式强制它优先调用 MCP 工具。关掉之后它就会老老实实走mcp__playwright__那套工具链。5.5 残留文件清理说明playwright/mcp全局 npm 包要保留它是 MCP 服务本体别卸载。npx 运行产生的临时文件执行完自动销毁无残留。ms-playwright文件夹里只有空占位文件没下载浏览器可以直接删只要配置带了--executable-path程序不会用这个目录。claude mcp remove只删 JSON 配置不会卸载 npm 包。6. 需要登录态CDP 调试端口模式与后续接入上面这套方案每次启动的是全新空白 Edge 实例没有登录状态。如果你要操作需要登录的站点得改用 CDP 调试端口模式复用你手动登录后的 Edge 会话。先用 PowerShell 手动启动带调试端口的 Edge这个窗口不要关 C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe --remote-debugging-port9222 --user-data-dir$env:TEMP\edge_mcp_profile运行后会弹出一个独立 Edge 窗口你可以手动登录需要的账号。然后改 MCP 配置让它连这个调试端口claude mcp remove playwright --scope user claude mcp add playwright --scope user -- playwright-mcp --cdp-endpoint http://127.0.0.1:9222使用限制要记牢每次用之前必须先执行上面那条启动 Edge 的命令Edge 窗口一关MCP 立刻断开。这个模式适合需要登录态的自动化场景日常不需要登录态的话还是用--executable-path那套更省事。如果你还没配好 Claude Code 的模型通道建议先去 TaoToken 控制台拿 API Key再按接入文档把环境配好这样 MCP 配完就能直接跑。需要长期做编码和 Agent 任务的可以看看 Coding Plan模型对话调试则用模型对话页面。整条链路配下来Windows 下 Claude Code 驱动本机 Edge 做自动化就不再被 Chromium 下载卡住了。