Pi Providers — 多 LLM Provider 接入体系

Pi 通过 pi-ai 提供统一的多 Provider LLM API。所有内置 Provider 仅包含支持工具调用（function calling）的模型。

Provider Catalog

OAuth 订阅（无需 API Key）

Provider	说明
Anthropic Claude Pro/Max	`/login` OAuth 登录
OpenAI Codex（ChatGPT Plus/Pro）	OAuth
GitHub Copilot	OAuth
Google Vertex AI	OAuth（Gemini via Vertex AI）

API Key 认证

Provider	备注
Anthropic	`ANTHROPIC_API_KEY`
OpenAI	`OPENAI_API_KEY`
Ant Ling	API Key
Azure OpenAI (Responses)	独立配置
DeepSeek	API Key
NVIDIA NIM	API Key
Google Gemini	API Key
Amazon Bedrock	AWS 凭证
Mistral	API Key
Groq	API Key
Cerebras	API Key
xAI	API Key
OpenRouter	API Key
Vercel AI Gateway	API Key
Cloudflare AI Gateway	API Key
Cloudflare Workers AI	API Key
Hugging Face	API Key
Fireworks	支持 OpenAI 和 Anthropic 兼容 API
Together AI	API Key
Moonshot AI	API Key；中国区有单独 provider
Kimi For Coding	Moonshot AI 订阅端点，使用 Anthropic-compatible API
MiniMax	API Key；中国区有单独 provider
ZAI Coding Plan (Global)	API Key；中国区有单独 provider
Xiaomi MiMo	默认 API 计费端点；另有 `cn`/`ams`/`sgp` 三个区域 Token Plan provider
OpenCode Zen	API Key
OpenCode Go	API Key

兼容 API（任意 OpenAI 协议实现）

Ollama、vLLM、LM Studio 等任何实现 OpenAI API 的本地或自托管服务，均可通过 ~/.pi/agent/models.json 直接配置，无需代码。

Auth 形态说明

OAuth 订阅：通过 /login 完成 OAuth 授权，凭证保存在 ~/.pi/agent/auth.json，无需持有 API Key
API Key：通过环境变量或 ~/.pi/agent/auth.json（/login 保存）提供
AWS Bedrock：使用标准 AWS 凭证链（环境变量、~/.aws/credentials、IAM Role）
OAuth + API Key 双模：部分 Provider（如 Vertex AI）同时支持两种方式

Auth 解析优先级：CLI --api-key > 环境变量 > auth.json 保存的凭证。

自定义 Provider

在 ~/.pi/agent/models.json 中添加说 OpenAI/Anthropic/Google 方言的兼容 Provider：

{
  "providers": [
    {
      "name": "my-ollama",
      "type": "openai",
      "baseUrl": "http://localhost:11434/v1",
      "models": ["llama3.2", "qwen2.5-coder"]
    }
  ]
}

对于需要 OAuth 或完全自定义 API 行为的 Provider，使用 extensions 的 pi.registerProvider() 实现。详见 packages/coding-agent/docs/custom-provider.md。

模型切换

交互模式：Ctrl+L 打开模型选择器，Ctrl+P 循环切换预设模型列表
CLI：--provider <name> + --model <pattern> 指定，支持 provider/model-id 格式
可附加 :<thinking> 后缀，如 anthropic/claude-opus-4-5:high

Thinking/Reasoning

pi-ai 对所有支持 reasoning 的模型提供统一接口：

pi --thinking medium   # 全局 thinking level
pi --model anthropic/claude-opus-4-5:high  # 模型级指定

Levels：off / minimal / low / medium / high / xhigh

Wiki AI

目录