Pi Agent 配置(Grok 4.5)
Pi(coding agent)支持通过 ~/.pi/agent/models.json 添加自定义 OpenAI 兼容 Provider。把 baseUrl 指到中转站即可使用 grok-4.5。
推荐参数
Grok 4.5:硬上限约 500k,实用请 ≤ 约 200k。 超过约 200k 会明显降智。contextWindow 请写 200000,不要默认填 500000。
1. 安装与准备 Key
安装(以官方文档为准):
设置 Key:
2. 编辑 ~/.pi/agent/models.json
Windows 路径:
macOS / Linux:
推荐配置(Chat Completions)
方案 B:Responses API
若你希望走 OpenAI Responses 路径:
兼容性以当前 Pi 版本与中转站支持为准;出问题先退回 openai-completions。
方案 C:Key 写进 auth.json
也可不用 models.json 里的 apiKey,改存:
或在会话里 /login 后选择对应 provider 粘贴 Key。
apiKey 支持 $ENV、${ENV}、以及 !command 命令取值(详见 Pi 官方 Providers 文档)。
3. 启动并选择模型
会话内:
选中 arona 下的 grok-4.5。也可:
models.json 在打开 /model 时会重新加载,改配置后一般不必重启整个进程。
注意事项
baseUrl 需要带 /v1
- 自定义 provider 必须有鉴权:
apiKey / auth.json / --api-key 三选一,否则模型可能加载了但在 /model 里不可用
- 若本地/代理对
developer 角色不兼容,可在 provider 上加:
- 配置目录可用环境变量覆盖:
PI_CODING_AGENT_DIR
常见问题
1. /model 列表没有 arona
- 确认
models.json 路径与 JSON 语法
- 确认
providers.arona.baseUrl / api / models[].id 齐全
- 再打开一次
/model 触发重载
2. 模型显示了但不可用 / 提示缺 Key
- 设置
ARONA_API_KEY 环境变量,或 apiKey / auth.json / --api-key
- Key 不要用明文写进可提交的仓库
3. 401 / 404
- 401:Key 错误或未传到请求
- 404:
baseUrl 少了 /v1,或路径被拼错
相关文档