认证与模型提供方

认证的两种方式

Pi 支持两种接入模型的方式：订阅登录（OAuth）和 API Key（环境变量或认证文件）。

• 订阅提供方走 /login 交互登录
• API Key 提供方走环境变量或认证文件

---

方式一：订阅登录（/login）

在 Pi 里运行：

/login

然后选择一个提供方。内置的订阅登录包括：

• ChatGPT Plus/Pro（Codex）
• Claude Pro/Max
• GitHub Copilot
• xAI（Grok/X 订阅）
• OpenRouter（OAuth 铸造的 API key，从 OpenRouter 额度扣费）
• Radius

想清除凭据用 /logout。令牌存在 ~/.pi/agent/auth.json，过期会自动刷新；OpenRouter 铸造的 key 由你自己控制、不会自动过期。

---

方式二：API Key

DeepSeek 等国内大模型通常用 API Key。启动 Pi 前先设好环境变量：

export ANTHROPIC_API_KEY=sk-ant-...
pi

也可以运行 /login 后选择 API Key 提供方，把 key 存到 ~/.pi/agent/auth.json。

不同模型的 API Key 环境变量名不同（Anthropic、OpenAI、Google 等各有对应），以你所用提供方的文档为准。本站重点讲如何接 DeepSeek 等国内模型。

---

支持的模型提供方

Pi 内置目录支持 15+ 家：Anthropic、OpenAI、Google、Azure、Bedrock、Mistral、Groq、xAI、Hugging Face、OpenRouter，以及通过 Ollama 接本地模型。

• 内置目录随 pi 附带
• 配置过的提供方会刷新更新的目录，并缓存到 ~/.pi/agent/models-store.json 便于离线用

---

验证是否真的接上了

配置好后，跑一次最小测试：

pi -p "你好，请用一句话自我介绍"

-p 是单次问答模式，不进入交互界面，适合快速验证。能正常返回一段话，说明模型接上了。

---

落地练习：接上你的模型

1. 决定用哪种方式：订阅账号（/login）或 API Key（环境变量/认证文件）
2. 配置好你的提供方（国内开发者重点：DeepSeek 等国内模型用 API Key）
3. 跑 pi -p "你好" 验证连通

怎么判断做对了？——pi -p "你好" 能返回一段正常的话，没有报认证/超时错误。

卡住了怎么办？ 报 401/auth/超时 → 检查 key 是否正确、有没有额度、端点是否可达。报模型找不到 → 提供方没配好或目录没刷新。逐项排查。

---

常见坑：凭记忆猜环境变量名

新手最容易犯的错，是凭感觉填环境变量名或端点，不查提供方文档。

不同提供方的 key 名、端点、认证方式都不一样。DeepSeek 有 DeepSeek 的配法，OpenAI 有 OpenAI 的配法。正确做法永远是：去你用的那个提供方的文档查字段名，再填到 Pi 里。

---

小结

1. 两种认证：订阅登录（/login）和 API Key（环境变量/认证文件）
2. 订阅提供方：Codex、Claude、Copilot、Grok、OpenRouter 等
3. 国内大模型（如 DeepSeek）用 API Key
4. pi -p "你好" 验证连通
5. 字段名以提供方文档为准，别猜

下一节，我们启动 Pi，认识它的四个内置工具。