第 6 课：提供商、模型与思考等级

驱动 pi 的模型是可插拔的——pi 是你指向的任何模型外面的壳。本课讲如何选择和切换模型，以及如何控制它们"思考"的深度。

提供商：模型从哪里来

Pi 支持三种认证方式：

订阅（通过 /login）：Anthropic Claude Pro/Max、OpenAI ChatGPT Plus/Pro（Codex）、GitHub Copilot。

API 密钥（通过 /login 或环境变量）：Anthropic、OpenAI、Google Gemini、DeepSeek、Groq、Cerebras、Mistral、xAI、OpenRouter、NVIDIA NIM、Amazon Bedrock、Hugging Face、Fireworks、Together AI 等 15 个以上。典型配置：

export ANTHROPIC_API_KEY=sk-ant-...
pi

本地模型：pi 支持 llama.cpp 路由服务器——用 /login llama.cpp 配置，用 /llama 管理下载和加载，然后用 /model 选择已加载的模型。非常适合离线或隐私敏感的工作。

如果某个提供商说 OpenAI、Anthropic 或 Google 协议，你可以通过 ~/.pi/agent/models.json 添加——或者用扩展构建一个完全自定义的提供商（第 9 课）。

选择模型

最快的方式：Ctrl+L 打开模型选择器，或输入 /model。从 CLI：

pi --provider openai --model gpt-4o "Refactor this"
pi --model openai/gpt-4o "Refactor this"          # 同上，带前缀
pi --model sonnet:high "Solve this"                # 思考等级简写
pi --list-models anthropic                         # 查看可用模型

限定模型与循环切换

你可以限制循环切换时出现的模型：

pi --models "claude-*,gpt-4o"    # 只用这些进行 Ctrl+P 循环

• Ctrl+P / Shift+Ctrl+P 在限定模型中前后循环
• /scoped-models 打开选择器，启用/禁用模型并排序（Ctrl+S 保存到设置）

实用模式：限定一个便宜快速的模型 + 一个聪明模型，用 Ctrl+P 来回切换。

思考等级

许多模型支持扩展思考（extended thinking）。Pi 把它们映射为等级：off、minimal、low、medium、high、xhigh、max。

• Shift+Tab 在会话中循环切换思考等级
• /settings 持久设置
• --thinking <level> 从 CLI 设置

编辑器的边框颜色反映当前等级——一个快速的视觉提示。注意消息区的思考块；Ctrl+T 折叠/展开它们，Ctrl+O 对工具输出做同样的事。

什么时候用什么：
- off / minimal — 琐碎查询、快速总结；更便宜更快
- low / medium — 日常编码，默认区间
- high / xhigh / max — 棘手的调试、架构决策、大型改动的代码审查；更多 token、更慢，但推理质量明显更高

一个不错的默认工作流：日常用 medium，卡住时升到 high，"当前 git 分支是什么？"这类问题降到 minimal。

成本与上下文意识

底部栏实时显示 token 用量和费用——↑ 输入、↓ 输出、缓存读写、上下文用量。高思考等级烧 token 很快（思考 token 也算）。边实验边观察底部栏，培养对这种权衡的直觉。

---

作业： 按 Ctrl+L 浏览你提供商的模型列表。按几次 Shift+Tab 观察编辑器边框变化。然后用 high 思考等级给 pi 一个真正困难的问题，看看答案质量是否提升。