Skip to main content

Providers 配置

Pi 支持两种认证方式:

  • 订阅 Provider:通过 OAuth 认证(Claude Pro/Max、ChatGPT Plus/Pro 等)
  • API Key Provider:通过环境变量或认证文件

订阅登录

使用 /login 命令,选择 Provider:

订阅说明
Claude Pro/MaxAnthropic
ChatGPT Plus/Pro (Codex)OpenAI
GitHub CopilotGitHub
Google Gemini CLIGoogle
Google Antigravity沙箱环境

凭证存储在 ~/.pi/agent/auth.json,自动刷新。


API Key 配置

环境变量

export ANTHROPIC_API_KEY=sk-ant-...
pi

Provider 环境变量对照表

Provider环境变量
AnthropicANTHROPIC_API_KEY
OpenAIOPENAI_API_KEY
Google GeminiGEMINI_API_KEY
MistralMISTRAL_API_KEY
GroqGROQ_API_KEY
CerebrasCEREBRAS_API_KEY
xAIXAI_API_KEY
OpenRouterOPENROUTER_API_KEY
Hugging FaceHF_TOKEN
Kimi For CodingKIMI_API_KEY
MiniMaxMINIMAX_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 环境变量

翻译自 pi-coding-agent/docs/providers.md