pi 接入

1. 前提条件

• 已注册并获取本平台 API Key。已登录的话，到接入中心选 pi，复制已填好 Key 和模型的一条命令，在终端运行即可。
• 已安装 pi：

  npm i -g @mariozechner/pi-coding-agent

2. 推荐方式：codesw 一条命令配置

codesw 是不墨官方的模型供应商切换 CLI，直接写入 pi 自己的配置文件，不做任何代理或中转。在终端运行（把 你的Key 换成 API Keys 页面的 Key）：

npx -y @bumocc/codesw use pi bumo.ai claude-sonnet-5-5 --key 你的Key

codesw 会写入 ~/.pi/agent/models.json（新增 bumo.ai 供应商和模型列表）和 ~/.pi/agent/settings.json（设为默认供应商和模型），只改它负责的几项，您原有的其他配置都会保留。写完后会用这把 Key 和模型自动测一次连通：Key 无效、模型不存在、余额不足会分别提示怎么改；之后随时可以运行 npx -y @bumocc/codesw test pi 复测。

想换模型，把命令里的 claude-sonnet-5-5 换成模型列表里的其他模型 ID 再运行一次即可；也可以直接运行 npx -y @bumocc/codesw 进入交互模式，按提示选「pi」→「Bumo Router」→ 模型。

3. 启动

pi

---

附：手动配置（备选）

把下面内容保存为 ~/.pi/agent/models.json（已有文件就合并 providers 里这一项）：

{
  "providers": {
    "router": {
      "baseUrl": "https://router.bumo.ai/v1",
      "api": "openai-completions",
      "apiKey": "YOUR_API_KEY",
      "headers": { "X-Title": "pi coding agent" },
      "models": [{ "id": "claude-sonnet-5-5" }]
    }
  }
}

然后指定供应商和模型启动：

pi --provider router --model claude-sonnet-5-5

请将 YOUR_API_KEY 替换为您的平台 API Key。