知识库章节 ▾

导航

▸ 从这里开始 按角色

类别

工具 52
词汇表 12

工具

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

Pi 是一款极简的终端编码代理，是 2026 年增长最快的开源工具之一。其中的提供商以声明式方式在 ~/.pi/agent/models.json 中定义，任何使用 OpenAI Completions 或 Anthropic Messages 协议的端点均可适用——即 JoinGonka Gateway 可以通过两种路径连接。去中心化 Gonka 网络模型的成本比厂商显卡价格低数百倍，且初始的 3M 令牌免费。

Pi 本身通过 npm 安装：npm install -g --ignore-scripts @earendil-works/pi-coding-agent。包名已更改：项目已迁移至 earendil-works/pi 仓库，旧包 @mariozechner/pi-coding-agent 已弃用并不再更新。如果您仍以旧名称安装了 Pi，请重新安装；迁移后配置目录 ~/.pi/agent 保持不变。

快速路径：安装程序

最快捷的方法是使用我们的安装程序：

npx @joingonka/setup --tool pi

它将在 ~/.pi/agent/models.json 中配置带有当前网络模型的提供商，并在 ~/.pi/agent/settings.json 中设置默认模型（它不会覆盖您自己选择的模型——只能通过明确的 --model minimax|deepseek|glm 标志进行更改），并通过实时请求验证网关是否接受密钥和模型。如果使用 PI_CODING_AGENT_DIR 变量迁移了配置目录，安装程序也会写入该位置。密钥以 明文 形式存储在具有 0600 权限的配置中——无需导出环境变量。

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

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

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKey你的 jg-… 密钥字面量。Pi 也支持 $VAR/${VAR} 引用和 !command，但字面量无需导出变量即可工作——请将文件权限设为 0600
models数组：id、name、contextWindow、maxTokens

网络中模型的正确取值：deepseek-ai/DeepSeek-V4-Flash-0731——contextWindow 380000，maxTokens 32768；MiniMaxAI/MiniMax-M2.7——contextWindow 200000，maxTokens 8192；zai-org/GLM-5.3-Flash——contextWindow 390000，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）。MiniMax M2.7 是通用选项，GLM-5.3 Flash 是拥有最长网络上下文（390K）的推理模型：它会在回答前进行思考，所以不要降低其 maxTokens。费用统一，实时价格请查看 网关价格列表。

如果 Pi 的极简主义无法满足需求，可以看看它的分支 omp (Oh My Pi)：它遵循了声明式提供者的理念，但增加了模型角色、语言服务器和子代理。它们的配置文件不同，因此 omp 需要单独设置。

Pi 通过在 ~/.pi/agent/models.json 中添加一条记录即可连接到 JoinGonka Gateway：baseUrl gate.joingonka.ai/v1，api openai-completions，直接填入密钥，以及带有真实 contextWindow/maxTokens 的模型。更快捷的方法是使用 npx @joingonka/setup --tool pi。在沙盒中启动代理，从免费启动代币开始使用。
← Zed + JoinGonka Gateway — 编辑器中的低成本推理 Codex CLI：使用自己的密钥代替订阅 →

想了解更多？

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

获取免费令牌 →