Pi 接入猫云

Pi 可通过自定义模型文件连接 OpenAI 兼容网关。本页按当前 earendil-works/pi 文档编写，不沿用旧仓库的密钥解析假设；本站尚未逐个工具链验收。1

1. 准备与安装

当前官方安装命令如下；已有 Pi 可跳过：2

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

创建猫云密钥，核对余额、分组和模型广场的完整 ID。备份 ~/.pi/agent/models.json；已有 providers 时只新增 nekocloud，不要覆盖其他提供商。配置在启动 Pi 的用户环境中，远端项目应检查远端配置。

2. 最小配置

终端设置变量，再编辑上述文件；以下是完整合法 JSON：

export NEKOCLOUD_API_KEY="REPLACE_WITH_API_KEY"

{
  "providers": {
    "nekocloud": {
      "baseUrl": "https://api.nekocloud.vip/v1",
      "api": "openai-completions",
      "apiKey": "${NEKOCLOUD_API_KEY}",
      "models": [
        {
          "id": "REPLACE_WITH_MODEL_ID"
        }
      ]
    }
  }
}

字段	含义
providers.nekocloud	自定义提供商名称
baseUrl	猫云 OpenAI 基础地址
api	openai-completions 即 Chat Completions
apiKey	${NEKOCLOUD_API_KEY} 解析环境变量
models[].id	发给 API 的完整模型 ID

当前版本支持 $VAR 和 ${VAR}；裸写 NEKOCLOUD_API_KEY 会被当成字面密钥，不是变量名。1 本例不填写价格、上下文或输出上限：客户端默认元数据不是本站模型承诺，长任务前须核实，不能把默认零估价当免费。

3. 选择与重载

在测试项目中启动，只开放只读工具：2

pi --provider nekocloud --model REPLACE_WITH_MODEL_ID --tools read,grep,find,ls

/model 每次打开都会重载 models.json；修改文件无需重启，但更改环境变量后要从同一终端重新启动 Pi。1 确认选择器中的提供商和 ID；不要把 /reload 当环境刷新。未经确认不启用图像、推理或 Responses 协议。

4. 只读验证与安全

测试可能收费，先自行确认。发送一句问候，再要求调用 read 读取 README、引用原句总结；检查工具真实结果和最终回答，并核对文件无变化。只读工具列表不约束第三方扩展，首次验证不要加载不可信项目扩展。2 用 /session 或底部 token 统计与猫云用量记录的时间、模型、token 对照；本地费用是元数据估算，不是账单。2

Key、备份和会话不要上传仓库或分享；实际录入建议隐藏输入再导出。401 查变量是否可用，404 查模型与路径，400 查协议；只有确认具体不兼容字段后才按官方说明调整 compat，不要盲目关闭能力检查。

官方来源

• 1 — 当前自定义模型配置
• 2 — 安装、工具和会话命令