Pi 官方文档

Windows

Windows 安装

Pi 在 Windows 上默认使用 Git Bash。检查的位置(按顺序)如下:

  1. 来自 ~/.pi/agent/settings.json 的自定义路径
  2. Git Bash (C:\Program Files\Git\bin\bash.exe)
  3. PATH 上的 bash.exe(Cygwin、MSYS2、WSL)

对大多数用户来说,Git for Windows 就足够了。

PowerShell 工具

可选的 powershell 工具会在可用时通过 pwsh.exe 运行命令,否则使用 Windows PowerShell。它会以 -NoProfile -NonInteractive -ExecutionPolicy Bypass 参数启动 PowerShell。不过,管理员强制执行的策略仍可能优先生效。

使用 defaultTools 可以替换面向模型的 bash 工具:

{
  "defaultTools": ["read", "powershell", "edit", "write"]
}

也可以同时启用两者,以便比较行为:

{
  "defaultTools": ["read", "bash", "powershell", "edit", "write"]
}

编辑器中的 !!! 命令仍然使用 Bash。

自定义 Bash 路径

{
  "shellPath": "C:\\cygwin64\\bin\\bash.exe"
}

Pi 官方文档中文整理 · 官方原文已更新,译文待同步

本文基于官方 MIT 文档翻译整理,不代表 pi.dev 官方中文站。同步 commit:1defa151,同步时间:2026/8/27

查看官方原文