Providers 配置
Pi 支持两种认证方式:
- 订阅 Provider:通过 OAuth 认证(Claude Pro/Max、ChatGPT Plus/Pro 等)
- API Key Provider:通过环境变量或认证文件
订阅登录
使用 /login 命令,选择 Provider:
| 订阅 | 说明 |
|---|---|
| Claude Pro/Max | Anthropic |
| ChatGPT Plus/Pro (Codex) | OpenAI |
| GitHub Copilot | GitHub |
| Google Gemini CLI | |
| Google Antigravity | 沙箱环境 |
凭证存储在 ~/.pi/agent/auth.json,自动刷新。
API Key 配置
环境变量
export ANTHROPIC_API_KEY=sk-ant-...
pi
Provider 环境变量对照表
| Provider | 环境变量 |
|---|---|
| Anthropic | ANTHROPIC_API_KEY |
| OpenAI | OPENAI_API_KEY |
| Google Gemini | GEMINI_API_KEY |
| Mistral | MISTRAL_API_KEY |
| Groq | GROQ_API_KEY |
| Cerebras | CEREBRAS_API_KEY |
| xAI | XAI_API_KEY |
| OpenRouter | OPENROUTER_API_KEY |
| Hugging Face | HF_TOKEN |
| Kimi For Coding | KIMI_API_KEY |
| MiniMax | MINIMAX_API_KEY |
认证文件
存储在 ~/.pi/agent/auth.json:
{
"anthropic": { "type": "api_key", "key": "sk-ant-..." },
"openai": { "type": "api_key", "key": "sk-..." },
"google": { "type": "api_key", "key": "..." }
}
文件权限为 0600(仅用户读写)。
Key 格式
| 格式 | 说明 |
|---|---|
| 直接值 | "key": "sk-ant-..." |
| Shell 命令 | "key": "!security find-generic-password -ws 'anthropic'" |
| 命令输出缓存 | 命令输出在整个进程生命周期内缓存 |
Google Provider 特殊说明
- Gemini CLI:通过 Cloud Code Assist 使用标准 Gemini 模型
- Antigravity:沙箱,包含 Gemini 3、Claude、GPT-OSS 模型
- 两者免费,但有速率限制
- 付费 Cloud Code Assist:设置
GOOGLE_CLOUD_PROJECT环境变量