接入 Pi

Pi（pi-mono）是一个极简且高度可扩展的终端编码框架。它通过 TypeScript 扩展、技能、提示模板和主题来适配你的工作流，支持树状会话结构和 15+ 内置供应商。

1. 安装 Pi

安装 Node.js。

在命令行界面，执行以下命令安装 Pi：

npm install -g @mariozechner/pi-coding-agent

安装结束后，执行以下命令，若显示版本号则安装成功：

pi --version

注意： Linux / macOS 用户也可以通过官方脚本安装：

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

2. 配置 PingToken 供应商

Pi 通过 models.json 支持自定义供应商。将 PingToken 添加为 OpenAI 兼容供应商：

Linux / macOS： ~/.pi/agent/models.json

Windows： %USERPROFILE%\.pi\agent\models.json

{
    "providers": {
        "pingtoken": {
            "baseUrl": "https://pingtoken.cn/api/v1",
            "api": "openai-completions",
            "apiKey": "$PINGTOKEN_API_KEY",
            "models": [
                {
                    "id": "deepseek-v4-pro",
                    "name": "DeepSeek V4 Pro",
                    "contextWindow": 1000000,
                    "maxTokens": 384000,
                    "input": ["text"],
                    "reasoning": true,
                    "cost": {
                        "input": 1.74,
                        "output": 3.48,
                        "cacheRead": 0.145,
                        "cacheWrite": 0
                    },
                    "compat": {
                        "requiresReasoningContentOnAssistantMessages": true,
                        "thinkingFormat": "deepseek",
                        "reasoningEffortMap": {
                            "minimal": "high",
                            "low": "high",
                            "medium": "high",
                            "high": "high",
                            "xhigh": "max"
                        }
                    }
                },
                {
                    "id": "deepseek-v4-flash",
                    "name": "DeepSeek V4 Flash",
                    "contextWindow": 1000000,
                    "maxTokens": 384000,
                    "input": ["text"],
                    "reasoning": true,
                    "cost": {
                        "input": 0.14,
                        "output": 0.28,
                        "cacheRead": 0.028,
                        "cacheWrite": 0
                    },
                    "compat": {
                        "requiresReasoningContentOnAssistantMessages": true,
                        "thinkingFormat": "deepseek",
                        "reasoningEffortMap": {
                            "minimal": "high",
                            "low": "high",
                            "medium": "high",
                            "high": "high",
                            "xhigh": "max"
                        }
                    }
                }
            ]
        }
    }
}

设置环境变量：

Linux / Mac 用户：

export PINGTOKEN_API_KEY="<你的 PingToken API Token>"

Windows 用户：

$env:PINGTOKEN_API_KEY="<你的 PingToken API Token>"

从 控制台 → Token 管理 获取 API Token。

3. 运行并选择模型

进入项目目录并执行 pi 命令：

cd /path/to/my-project

pi

输入 /model 打开模型切换器。

选择 pingtoken，然后选择 DeepSeek-V4-Pro 或 DeepSeek-V4-Flash。

开始使用你的极简终端编码框架。