Pi Coding Agent 配置 koalaapi 教程

一、安装 Pi

打开 Pi 官网，点击 Copy 复制安装命令。

启动 PowerShell，粘贴并执行安装命令，然后按照终端提示完成安装。

二、验证安装

安装完成后，打开一个新的 PowerShell 窗口，执行以下命令：

pi -v

终端显示 Pi 版本号，即表示安装成功。

三、配置 KoalaAPI

找到以下目录，将 [你的电脑用户名] 替换为当前 Windows 用户名：

C:\Users\[你的电脑用户名]\.pi\agent

如果目录不存在，请先创建目录。然后在该目录下新建 models.json 文件，并填入以下配置：

{
  "providers": {
    "koalaapi": {
      "name": "koalaapi",
      "baseUrl": "https://www.koalaapi.com/v1",
      "apiKey": "sk-****",
      "api": "openai-completions",
      "models": [
        {
          "id": "gpt-5.6-sol",
          "name": "gpt-5.6-sol",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        },
        {
          "id": "claude-opus-5",
          "name": "claude-opus-5",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        },
        {
          "id": "claude-opus-4-7",
          "name": "claude-opus-4-7",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        }
      ]
    }
  }
}

配置时请注意：

将 apiKey 替换为在 koalaapi 控制台创建的 API 密钥。示例中的 sk-**** 仅用于占位，请勿直接使用。

models 中的 id 和 name 应填写 koalaapi 模型广场中实际可用的模型名称。

多模态模型的 input 填写 ["text", "image"]；仅支持文本的模型填写 ["text"]。

contextWindow 填写模型支持的最大上下文长度，maxTokens 根据实际使用需求填写，且不要超过模型限制。

修改 JSON 后请确认英文引号、逗号和括号完整，否则 Pi 无法读取配置。

四、选择模型并开始对话

保存 models.json 后，打开 PowerShell，执行：

pi

进入 Pi CLI 后，输入 /model 并按回车。选择刚刚配置的 koalaapi 模型，再按回车即可开始对话。

Pi Coding Agent 配置 koalaapi 教程

一、安装 Pi#

二、验证安装#

三、配置 KoalaAPI#

四、选择模型并开始对话#

一、安装 Pi

二、验证安装

三、配置 KoalaAPI

四、选择模型并开始对话