第一部分，安装与入门

身份验证与凭据管理

使用 /login 完成订阅登录或 API Key 配置，并理解 auth.json 与环境变量的优先级。

基础 / 9 分钟 / 第 3 篇

订阅与 API Key 两条路径

交互模式输入 /login 可以选择 ChatGPT Plus 或 Pro、Claude Pro 或 Max、GitHub Copilot 等订阅 Provider，也可以为 API Provider 保存密钥。

凭据默认存放在 ~/.pi/agent/auth.json。自动化环境更适合从环境变量或密钥系统注入，不要把 auth.json、环境文件或真实密钥提交到仓库。

text
/login
/logout
bash
export OPENAI_API_KEY="从密钥系统注入"
pi --provider openai

凭据治理

  • 个人交互登录与服务自动化使用不同凭据。
  • 为开发、测试和生产使用不同项目与限额。
  • 日志和导出的 Session 不得包含完整密钥。
  • 离职、泄露或长期未使用时立即撤销凭据。
  • 远程环境使用短期令牌和最小权限。

官方资料

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁，命令、包名和接口以官方最新文档为准。

Pi 源代码和官方文档采用 MIT License。Copyright (c) 2025 Mario Zechner。本站保留原版权与许可声明，完整文本见 MIT License。