Pi + JoinGonka Gateway — 基于低成本推理的终端代理

Pi 是一个极简主义的终端编码代理，是 2026 年增长最快的开源工具之一。提供商在 ~/.pi/agent/models.json 中以声明式描述，任何支持 OpenAI Completions 或 Anthropic Messages 的 endpoint 均可使用 — 这意味着 JoinGonka Gateway 可以通过这两种方式连接。Gonka 去中心化网络模型的成本比供应商牌价低数百倍，且初始 10M tokens 是免费的。

快速路径：安装程序

最简单的方案是使用我们的安装器：

npx @joingonka/setup --tool pi

它会在 ~/.pi/agent/models.json 中配置带有当前网络模型的提供商，并在 ~/.pi/agent/settings.json 中设置默认模型（不会覆盖用户自定义的选择），并通过实时请求验证网关是否接受密钥和模型。密钥以明文形式存储在具有 0600 权限的配置文件中 — 无需导出环境变量。

手动配置：在 models.json 中设置提供商

在注册时获取 jg-… 密钥，并将其添加到 ~/.pi/agent/models.json 中：

`baseUrl`	`https://gate.joingonka.ai/v1`
`api`	`openai-completions`
`apiKey`	你的 `jg-…` 密钥（直接填入）。Pi 同时理解 `$VAR`/`${VAR}` 链接和 `!命令`，但直接填入无需导出变量 — 请保持文件权限为 `0600`
`models`	数组: `id`, `name`, `contextWindow`, `maxTokens`

网络模型的正确数值：deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768；moonshotai/Kimi-K2.6 和 MiniMaxAI/MiniMax-M2.7 — maxTokens 8192。Pi 的默认值 (128000/16384) 与实际网络限额不符，因此请显式设置这两个字段。默认模型存储在另一个文件中 — ~/.pi/agent/settings.json，即 defaultProvider 和 defaultModel 字段。验证：pi --list-models 应显示已添加的模型。

Anthropic 路径作为备选

网关同样支持 Anthropic Messages：使用 api: "anthropic-messages" 和 baseUrl: "https://gate.joingonka.ai"（无需 /v1/messages 路径，客户端会自动添加）。对于日常工作，OpenAI 路径已足够；如果您的 Pi 扩展程序针对 Messages 格式进行了调整，则 Anthropic 选项很有用。

安全声明

默认情况下，Pi 没有完整的权限层：该代理在终端执行命令时不会像更复杂的工具那样进行分步确认。请在沙盒中运行它 — 例如在容器或单独的用户帐户中 — 特别是在处理自主的多步骤任务时。这是 Pi 本身的特性，而非网关的问题。

如何选择模型及定价

所有三个网络模型均支持 tool calling 和 streaming。对于长会话和大型仓库，推荐使用 DeepSeek V4 Flash（拥有最长的网络上下文，输出高达 32768）。Kimi K2.6 在多步代理工作方面表现出色，而 MiniMax M2.7 是一个通用的选择。采用统一费率，实时价格请查看网关价格表。

Pi 通过在 ~/.pi/agent/models.json 中添加一条记录连接到 JoinGonka Gateway：baseUrl gate.joingonka.ai/v1，api openai-completions，直接填入密钥，并配置真实的 contextWindow/maxTokens。更快捷的方法是：npx @joingonka/setup --tool pi。在沙盒中运行 agent，并从 10M 免费 Token 开始使用。

← Zed + JoinGonka Gateway — 编辑器中的低成本推理

想了解更多？

探索其他章节或立即开始赚取 GNK。

pi.cta.text →