Pi

Pi 是一个轻量的命令行编程助手，通过 models.json 添加自定义提供方接入本站。

• 协议：OpenAI 兼容（Chat Completions）
• 地址：https://tokenfunc.com/v1
• 模型：任意，例如 claude-sonnet-4-5

1. 安装 Pi

   macOS / Linux

   curl -fsSL https://pi.dev/install.sh | sh

   Windows

   powershell -c "irm https://pi.dev/install.ps1 | iex"

   npm

   # 需要 Node.js 22.19 及以上
   npm install -g --ignore-scripts @earendil-works/pi-coding-agent

   安装后运行 pi --version 确认。Windows 上需要先安装 Git for Windows。

2. 添加自定义提供方

   把下面的内容写进 Pi 的模型配置文件，文件不存在就新建：

   ~/.pi/agent/models.json

   {
     "$schema": "https://pi.dev/schemas/models.schema.json",
     "providers": {
       "tokenfunc": {
         "baseUrl": "https://tokenfunc.com/v1",
         "api": "openai-completions",
         "apiKey": "sk-xxxxxxxxxxxxxxxx",
         "models": [
           { "id": "claude-sonnet-4-5", "contextWindow": 200000, "maxTokens": 32000 }
         ]
       }
     }
   }

   • contextWindow 和 maxTokens 按所选模型的实际能力填写。
   • 想用多个模型，就在 models 数组里多加几项。
   • apiKey 也可以写成 "$TOKENFUNC_API_KEY"，从环境变量读取，避免密钥明文留在文件里。

3. 选择模型并验证

   # 列出本站提供方下的模型
   pi --list-models tokenfunc
   
   # 发一条测试消息
   pi --model tokenfunc/claude-sonnet-4-5 -p "reply ok"

   收到回复即接入成功。日常使用时，在 Pi 里输入 /model 选择模型，按 Ctrl+S 设为默认。

常见问题