01 /
安装 Pi Agent
Pi 是一个终端里的个人编码 Agent。先安装官方 CLI，再进入需要操作的代码项目目录。
安装
在终端执行：
npmbash
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version开始前准备
- 在 Mengbi Router 个人控制台创建 API Key。
- 确认模型目录中存在 gpt-5.6-sol。
- 官方项目：https://github.com/earendil-works/pi；官方文档：https://pi.dev/docs/latest。
NotePi 会在当前项目目录中读取和修改文件。需要更强的文件、进程或网络隔离时，请在容器或其他沙箱中运行。
02 /
配置 Mengbi Router
Pi 通过 models.json 注册自定义 Provider。Mengbi Router 使用 OpenAI Chat Completions 兼容协议。
创建 models.json
在 macOS/Linux 的 ~/.pi/agent/models.json 写入下面内容；Windows 使用用户目录下的 .pi/agent/models.json。
JSONjson
{
"providers": {
"mengbi": {
"name": "Mengbi Router",
"baseUrl": "https://router-api.mengbi-ai.net/v1",
"apiKey": "$MENGBI_ROUTER_API_KEY",
"api": "openai-completions",
"models": [
{
"id": "gpt-5.6-sol",
"name": "GPT-5.6 Sol",
"reasoning": true,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 128000,
"maxTokens": 16384
}
]
}
}
}设置 API Key
在启动 Pi 的同一个终端中设置 Key：
macOS / Linuxbash
export MENGBI_ROUTER_API_KEY="sk-mengbi-xxxxxx"
pi --provider mengbi --model gpt-5.6-solWindows PowerShellpowershell
$env:MENGBI_ROUTER_API_KEY="sk-mengbi-xxxxxx"
pi --provider mengbi --model gpt-5.6-sol费用显示说明
models.json 里的 cost 只影响 Pi 本地的模型信息展示，示例设为 0 不代表 Mengbi Router 免费。实际扣费以 Router 当前实际折扣价格和个人控制台账单为准。
Note不要把真实 API Key 写入 models.json、项目文件或 Git 仓库；这里只保留 $MENGBI_ROUTER_API_KEY 环境变量引用。
03 /
验证与排查
确认 Provider、模型和 API Key 都被 Pi 读取后，再开始编码任务。
列出 Mengbi 模型
在终端执行：
终端bash
pi --list-models --provider mengbi第一次运行
进入项目目录后执行 pi，选择 gpt-5.6-sol，发送一条简单任务，例如“列出当前项目的目录结构”。能正常返回结果即表示接入完成。
- 模型列表为空：确认 models.json 位于 ~/.pi/agent/models.json，并检查 JSON 逗号和括号。
- 提示未配置 Key：确认当前终端已经设置 MENGBI_ROUTER_API_KEY，再重新启动 Pi。
- 出现 404：确认 baseUrl 保留 /v1，api 使用 openai-completions，不要把 /chat/completions 再拼到 baseUrl。
- 提示模型不存在：模型 ID 必须完整写成 gpt-5.6-sol，并以 Mengbi Router 模型目录为准。