Windows 配置 Claude Code MCP 的三个坑
一名掘金作者在 Windows 11、Claude Code 2.1.318 上使用官方 @modelcontextprotocol/server-filesystem 测试时,复现了三个 MCP 连接问题。解决方案包括在 Windows PowerShell 5.1 中为“--”加引号、避免 Git Bash 转换“cmd /c”的路径,以及为指定 MCP 服务将新版 Node.js 目录置于 PATH 前面。作者建议运行“claude mcp list”,核对实际命令并查看服务是否已连接。
该文为 Claude Code 的常见 Windows 配置故障提供了可操作的排查方法,但结论仅基于一名作者的环境,且未测试 PowerShell 7。
网上的 Claude Code + MCP 教程很多,但我在 Windows 上照着做,好几次都卡在"命令明明一样,就是连不上",这是最让人绝望的,每个字母都认真核对后都还是不行。下面三个坑是我这两天在自己电脑上一个个复现出来的,每个都给出能直接用的解决办法。 先说结论:Windows PowerShell 像一坨屎
测试环境:Windows 11,Claude Code 2.1.318,Node.js 26 / 20.20.2,系统自带的 Windows PowerShell 5.1,Git Bash。测试用的 MCP 是官方的 @modelcontextprotocol/server-filesystem。
先说一个通用的排查办法:配完之后跑一下
claude mcp list
每个服务后面会显示 ✔ Connected 或 ✘ Failed to connect。重点看它显示的那条命令和你输入的是不是一样——下面第 2 个坑就是靠这个发现的。
坑 1:PowerShell 里 -- 被"吃掉",报 unknown option '-y'
教程里的标准写法:
#Claude Code#@modelcontextprotocol/server-filesystem#Node.js#Windows PowerShell 5.1#Git Bash