Windows下安装pi agent

Windows PowerShell 安装 Pi Coding Agent（pi.dev）

Pi Agent（pi-coding-agent）是 NodeJS 程序，不是 Python 项目，需要 Node.js + Git Bash，下面全部用 PowerShell 指令操作
⚠️ 重要提醒：Pi 会直接在本机执行 shell 命令，不要给高危权限，不要让它随意删文件

1. 打开 PowerShell（推荐 Windows 终端，普通用户即可，不需要管理员）

右键开始菜单 → Windows PowerShell / Windows 终端

2. 官方一键安装脚本（自动装 Node、Git、Pi 本体，推荐）

powershell -c "irm https://pi.dev/install.ps1 | iex"

• 脚本会检测缺少依赖：Node.js、Git；提示时输入y确认安装 Node；Git 选项输入w自动安装 Git Bash（Windows 必须有 bash 才能跑 pi）稀土掘金
• 安装完成后必须关闭当前 PowerShell 窗口，重新新开一个终端，环境变量才生效

3. 验证是否安装成功（新开 PowerShell）

pi --version

输出版本号代表成功。

4. 设置 API Key（PowerShell 环境变量，分临时 / 永久两种）

Pi 读取环境变量识别 API 密钥，不同大模型对应不同环境变量名：

• OpenAI：OPENAI_API_KEY
• DeepSeek：DEEPSEEK_API_KEY
• Anthropic Claude：ANTHROPIC_API_KEY
• Gemini：GEMINI_API_KEY

永久环境变量（推荐长期使用，一次设置永久生效）

# 设置用户级环境变量，不需要管理员
[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY","sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","User")

# 永久版本：GLM-4.7 用 OPENAI_API_KEY
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY","sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","User")

# 临时版本（仅当前 PowerShell 窗口）
$env:OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 验证是否添加成功
$env:DEEPSEEK_API_KEY

设置完成关闭所有终端，重新打开 PowerShell才能加载永久变量

5. 启动 Pi Agent

# 先进入你要让pi操作的项目文件夹，例如D:\code\test
cd D:\code\test

# 直接启动交互终端
pi

进入 Pi 交互界面，Ctrl+L 可以切换模型，选择你配置好的 provider（deepseek/openai 等），直接对话。

7. Pi 内部登录方式（另一种保存 key 的方法，key 写入 auth.json）

启动pi进入交互界面后，输入斜杠命令：

/login

然后在菜单里选择模型服务商，粘贴 API key，会持久保存在本地%USERPROFILE%\.pi\auth.json，不需要每次设置环境变量pi.dev

8. 自定义 OpenAI 兼容 API（例如 DeepSeek、vLLM、ollama 转发，自定义 base url）

新建 / 编辑文件：$HOME\.pi\agent\models.json

# 在powershell打开编辑
notepad $HOME\.pi\agent\models.json

写入配置示例：

{
  "providers": {
    "deepseek": {
      "baseUrl": "https://api.deepseek.com",
      "api": "openai-completions",
      "apiKey": "$DEEPSEEK_API_KEY",
      "compat": {
        "requiresReasoningContentOnAssistantMessages": true,
        "thinkingFormat": "deepseek",
        "supportsDeveloperRole": false
      },
      "models": [
        {
          "id": "deepseek-flash",
          "name": "DeepSeek Flash",
          "contextWindow": 1000000,
          "maxTokens": 384000,
          "reasoning": true,
          "thinkingLevelMap": {
            "off": null,
            "minimal": null,
            "low": "low",
            "medium": null,
            "high": "high",
            "xhigh": "max"
          }
        }
      ]
    }
  }
}

保存后，重启 pi，Ctrl+L就能选 deepseek-coder。