Pi 接入 DeepSeek V4：极简终端编码框架配置指南

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

安装 Pi

需要 Node.js：

bash

npm install -g @earendil-works/pi-coding-agent

验证安装：

bash

pi --version

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

bash

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

配置 DeepSeek 供应商

Pi 通过 models.json 支持自定义供应商。编辑配置文件：

Linux / macOS：~/.pi/agent/models.json
Windows：%USERPROFILE%\.pi\agent\models.json

json

{
  "providers": {
    "deepseek": {
      "baseUrl": "https://api.deepseek.com",
      "api": "openai-completions",
      "apiKey": "$DEEPSEEK_API_KEY",
      "models": [
        {
          "id": "deepseek-v4-pro",
          "name": "DeepSeek V4 Pro",
          "contextWindow": 1000000,
          "maxTokens": 384000,
          "reasoning": true,
          "cost": {
            "input": 1.74,
            "output": 3.48
          },
          "compat": {
            "requiresReasoningContentOnAssistantMessages": true,
            "thinkingFormat": "deepseek",
            "reasoningEffortMap": {
              "minimal": "high",
              "xhigh": "max"
            }
          }
        },
        {
          "id": "deepseek-v4-flash",
          "name": "DeepSeek V4 Flash",
          "contextWindow": 1000000,
          "maxTokens": 384000,
          "reasoning": true,
          "cost": {
            "input": 0.14,
            "output": 0.28
          },
          "compat": { ... }
        }
      ]
    }
  }
}

设置环境变量：

bash

export DEEPSEEK_API_KEY="<你的 DeepSeek API Key>"

运行并选择模型

bash

cd /path/to/my-project
pi

输入 /model 打开模型切换器，选择 deepseek，然后选择 DeepSeek-V4-Pro 或 DeepSeek-V4-Flash。

字节笔记本

Pi 接入 DeepSeek V4：极简终端编码框架配置指南

安装 Pi

配置 DeepSeek 供应商

运行并选择模型