用途:解决 Claude Code 在 Windows(尤其配合 Git Bash)下因路径格式不当导致的文件操作失败,如 ENOENT: no such file or directory、file not found 等。
主要能力:强调在 Windows 上使用 Edit、Write、Read 工具时必须使用反斜杠路径,例如 D:\repos\project\file.tsx,而非 D:/repos/project/file.tsx;覆盖 MINGW 路径(/c/、/s/ 等)到 Windows 原生路径的转换;处理相对路径、环境变量、含空格路径与 UNC 网络路径;提供错误识别、路径分析与转换重试的工作流。
必要用法:遇到 Git Bash 路径时先转换,如 /s/repos/project/file.tsx 转为 S:\repos\project\file.tsx;需要当前目录时在 Git Bash 运行 pwd -W 获取 Windows 格式路径,再把正斜杠改为反斜杠;相对路径需结合绝对目录补全;含空格路径直接写反斜杠,不在参数中加引号;UNC 路径使用 \server\share\folder\file.txt 形式。
适用场景:用户明确在 Windows 或 Git Bash 环境工作、路径以 /c/ 或 /s/ 开头、工具调用报文件不存在、或需要读写 Windows 文件时主动应用。
限制:资料未提供安装命令、版本要求、收费信息或具体平台兼容性细节;更详细的错误对照表、PowerShell/CMD/WSL/Node/Python 平台说明与高级路径场景位于 references/error-platform-advanced.md,需另行加载。