Pi 一键配置安装教程

一条命令安装 Pi，并同时接入AI驿站 的 Claude 和 GPT。默认模型 claude-opus-5-5，推理强度中档（medium）。

1. 运行一键配置命令

macOS / Linux

curl -fsSL https://docs.aizhan.space/sh/pi.sh | bash

Windows PowerShell

irm https://sh.api.aizhan.space/pi.ps1 | iex

菜单：1 安装 Pi、2 配置AI驿站 (Claude + GPT)、3 一键全部安装（第一次用选这个）。

2. 前置：Node.js 22+

Pi 通过 npm 安装（@earendil-works/pi-coding-agent），需要 Node.js 22.19 或更新版本：安装 Node.js。默认 npm 源失败时脚本会自动切换国内镜像。

关于两把 Key

Claude 和 GPT 在官网是不同的令牌分组。脚本会先让你选择要配置的模型家族（1 Claude + GPT（回车默认）/ 2 仅 Claude / 3 仅 GPT），然后依次输入：

1. Claude 分组 API Key
2. GPT 分组 API Key（直接回车 = 与 Claude Key 相同）

每把 Key 都会先用 /v1/models 验证，并拉取这个分组下可用的模型列表一起写进配置。

报错 "Requests from the ... framework are not supported"

说明你的 Claude Key 所在令牌分组只允许 Claude 官方客户端使用。请到 api.aizhan.space 在允许第三方工具的分组下新建令牌，然后重新运行脚本选「2) 配置」。

3. 脚本会写哪些文件

配置目录：~/.pi/agent/（各系统相同，Windows 为 %USERPROFILE%\.pi\agent\；设置了 PI_CODING_AGENT_DIR 时以它为准）。

models.json（供应商与模型）：

{
  "providers": {
    "aizhan-claude": {
      "name": "AI驿站 Claude",
      "baseUrl": "https://api.aizhan.space",
      "api": "anthropic-messages",
      "apiKey": "sk-你的Claude Key",
      "models": [
        { "id": "claude-opus-5-5", "name": "Claude Opus 5.5", "reasoning": true,
          "input": ["text", "image"], "contextWindow": 1000000, "maxTokens": 128000 }
      ]
    },
    "aizhan-gpt": {
      "name": "AI驿站 GPT",
      "baseUrl": "https://api.aizhan.space/v1",
      "api": "openai-responses",
      "apiKey": "sk-你的GPT Key",
      "models": [
        { "id": "gpt-6.1-sol", "name": "GPT-6.1 Sol", "reasoning": true,
          "input": ["text", "image"], "contextWindow": 1050000, "maxTokens": 128000 }
      ]
    }
  }
}

settings.json（默认值）：

{
  "defaultProvider": "aizhan-claude",
  "defaultModel": "claude-opus-5-5",
  "defaultThinkingLevel": "medium"
}

• 两个文件里你原有的其他配置都会保留，改动前自动备份为 *.bak.时间戳。auth.json（Pi 自己的登录信息）不会被修改。

4. 验证与使用

pi -p "Reply with exactly: OK"
pi -p --provider aizhan-gpt --model gpt-6.1-sol "Reply with exactly: OK"

• 启动交互：pi
• 会话中切换：输入 /model 选择（Ctrl+S 设为默认），/thinking 调整推理强度

5. 回滚

把 models.json.bak.时间戳、settings.json.bak.时间戳 改回原文件名即可。