配置 DeepSeek API 到 Pi Agent
Pi Agent 是轻量级终端自主编码代理。本文提供在 Pi Agent 中配置 DeepSeek 官方 Provider 的完整步骤，包含 models.json 语法与验证方法。
本页内容
准备工作
确认已安装 pi 命令行工具，并从 DeepSeek 开放平台 获取有效的 API Key。
第 1 步
编辑 models.json 配置文件
定位并打开 models.json 配置文件（不存在则新建）：
- macOS / Linux：
~/.pi/agent/models.json - Windows：
%USERPROFILE%\.pi\agent\models.json
添加 DeepSeek 提供商：
{
"providers": {
"deepseek": {
"baseUrl": "https://api.deepseek.com",
"api": "openai-completions",
"apiKey": "$DEEPSEEK_API_KEY"
}
}
}第 2 步
设置 API Key 凭据
在当前 shell 配置文件（~/.zshrc 或 ~/.bashrc）中导出环境变量：
export DEEPSEEK_API_KEY="sk-你的DeepSeek_API_Key"Windows PowerShell 用户可执行：
$env:DEEPSEEK_API_KEY="sk-你的DeepSeek_API_Key"或者将密钥保存在 ~/.pi/agent/auth.json 中：
{
"deepseek": {
"type": "api_key",
"key": "sk-你的DeepSeek_API_Key"
}
}第 3 步
启动与模型切换
- 在终端中运行
pi。 - 按
Ctrl+P或输入/model打开选择器。 - 选择 deepseek 提供商下的 deepseek-chat 或 deepseek-reasoner。
- 发送只读测试指令：
请回复“DeepSeek 已接入 Pi Agent”，不要修改任何文件。状态栏余额监控
安装社区扩展即可在终端状态栏实时显示 API 余额：
pi install git:github.com/carlos-reynosa/pi-deepseek-balance-status常见排错清单
MISSING_CREDENTIAL / 缺少凭据
确认 DEEPSEEK_API_KEY 在启动 pi 前已 export，或已保存至 auth.json。
Connection Refused / 端点格式错误
检查 baseUrl 是否为完整 URL https://api.deepseek.com，确保包含 https:// 且末尾无多余斜杠。
402 Insufficient Balance
DeepSeek 平台账户余额不足，请前往开放平台充值。