跳转到主要内容

Pi 是什么

Pi 是面向终端的开源极简编程代理。它从 models.json 读取自定义端点,每个模型都可以使用不同的 API 协议。这套配置把 Capriole AI 作为一个提供商添加到该文件中。

前置条件

开始前请确保你已经拥有以下内容。

安装

使用官方安装脚本安装 Pi。
也可以使用 npm 安装(需要 Node.js 22.19 或更高版本)。

配置

模型验证

使用下方配置,Pi 1.3.0 经 Capriole AI 调用“支持的模型”一节中的每个模型,都通过了文件读取、文件写入和最终答案检查。 创建或更新 ~/.pi/agent/models.json。
然后在 ~/.pi/agent/settings.json 中把 Capriole AI 设为默认。
各项设置的作用如下。
  • 提供商的 api 是 openai-completions,因此 Grok、GLM 和 Kimi 使用 Chat Completions。GPT 模型用 openai-responses 覆盖它,Claude 模型则用 anthropic-messages 和不含 /v1 的 baseUrl 覆盖它。
  • $CAPRIOLE_AI_API_KEY 从环境变量读取你的 API Key。
  • authHeader: true 让每种协议都以 Bearer Token 形式发送 Key。没有它时,Claude 模型会在 x-api-key 请求头中发送 Key,而 Capriole AI 不接受这种方式。
  • forceAdaptiveThinking 让 Claude 模型使用自适应思考。Opus 5.5 会拒绝固定的思考预算。
  • contextWindow 和 maxTokens 告诉 Pi 每个模型的限制。

运行 Pi

设置 API Key,然后在项目目录中启动 Pi。
使用 /model 切换模型。如需非交互式运行,请使用 print 模式。

支持的模型

openai-latest 和 claude-latest 始终指向各自系列中我们最新的旗舰模型。

故障排除

为什么 Capriole AI 模型没有出现在 /model 中

Pi 在能解析自定义模型的 API Key 之前会隐藏该模型。启动 Pi 前,请在同一个 Shell 中导出 CAPRIOLE_AI_API_KEY。

为什么 Pi 返回身份验证错误

确认提供商设置了 "authHeader": true。

为什么 Opus 5.5 因 requires adaptive thinking 失败

确认 Claude 模型条目包含 "compat": { "forceAdaptiveThinking": true }。

为什么 Claude 请求因 Unsupported Claude Messages model 失败

使用 anthropic-messages 的 Claude 模型需要不带前缀的 Claude ID,例如 claude-opus-5-5。带 anthropic/ 前缀的 ID 用于 Chat Completions。

说明

  • 如需添加其他 Capriole AI 模型,请复制同一系列中某个模型的条目并修改 ID。GET https://api.caprioletech.com/v1/models 会列出所有模型 ID。
  • 官方参考资料包括 Pi、Pi 文档、选择模型和 Pi 配置。
最后修改于 2026年10月20日