pi 终端 AI 编程助手安装指南

什么是 pi

pi 是一个极简的终端 AI 编程助手（coding agent），直接在项目目录里运行，读写真实文件、执行 bash 命令。 它不内置"计划模式"或"子 agent"，专注做好一件事：让你在终端里和 AI 一起写代码。

可以通过 TypeScript 扩展（Extensions）、技能（Skills）、提示模板、主题自定义行为，不需要 fork 源码。 支持 Anthropic、OpenAI、Gemini 等主流 provider，也支持自定义 API 端点。

安装

需要 Node.js 环境，通过 npm 全局安装。

#!/bin/bash
# package name 可能随版本更新，以 pi.dev 官网为准
npm install -g @earendil-works/pi-coding-agent

# 验证安装
pi --version

# 日后更新
pi update --self

认证配置

内置 Provider（订阅或 API Key）

支持 Anthropic Claude Pro/Max、OpenAI ChatGPT Plus、GitHub Copilot 订阅，以及 Anthropic、OpenAI、Gemini 等 API Key。 进入 pi 后执行 /login 选择 provider 完成认证：

# 进入 pi 后输入
/login

自定义 API（代理 / 本地模型）

如果使用代理或本地模型（Ollama、vLLM、LM Studio 等），在 ~/.pi/agent/models.json 中配置 provider 和模型。支持 openai-completions、 anthropic-messages、 google-generative-ai 三种 API 格式：

// ~/.pi/agent/models.json
{
  "providers": {
    "my-provider": {
      "name": "My Provider",
      "baseUrl": "https://api.example.com",
      "api": "anthropic-messages",
      "apiKey": "sk-...",
      "models": [
        {
          "id": "some-model-id",
          "name": "My Model",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 8192,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        }
      ]
    }
  }
}

该文件在每次打开 /model 时自动重新加载，无需重启 pi。

使用

交互模式

进入项目目录后运行 pi，进入全交互式对话界面：

# 进入项目目录，启动交互模式
cd my-project
pi

# 带初始消息启动（仍是交互模式）
pi "帮我重构这个函数"

Print 模式（-p）

加 -p 后 pi 进入非交互的命令行模式，输出结果后直接退出，适合脚本或管道：

# print 模式：输出结果后直接退出（非交互）
pi -p "总结一下这个项目的结构"

# 配合管道使用
cat README.md | pi -p "总结这段文本"

会话记录

pi 把每次对话保存为 .jsonl 文件，按项目路径分类存放在：

~/.pi/agent/sessions/

用 pi -c 继续上次会话， pi -r 浏览并选择历史会话。 在 pi 内用 /tree 可以跳到会话树的任意节点继续，支持多分支。