Pi Coding Agent 通过模型提供商连接语言模型。Provider 表示访问模型的服务入口与适配方式，Model 表示该入口下选择的具体模型。Pi 负责组织任务与工具，所选模型负责生成响应及工具调用。
本文按 2026 年 9 月 18 日可查的官方资料说明；命令、配置和默认行为应结合所安装版本核对。
认证、模型目录与实际调用
提供商文档说明了 OAuth、API Key 和部分云服务认证方式。交互模式使用 /login 选择提供商并完成支持的认证流程；API Key 也可通过相应环境变量配置。
应分别判断三个状态：模型是否在目录中、是否配置了相应凭据、请求是否真正成功。模型名称出现在配置中，并不能证明服务端权限、额度和网络均可用。认证失败时，应依据实际错误检查提供商和凭据，而不是反复切换提示词。
选择和切换
/model 用于选择模型；启动参数也可指定 --provider 和 --model。同名模型可能经由不同服务入口提供，因此记录运行环境时，提供商与模型 ID 都有意义。具体命令见使用说明。
切换模型后，任务仍依赖可传递的上下文，但新模型的行为可能不同。例如，它可能选择不同工具、需要更明确的参数说明，或者无法处理某些输入类型。统一接口不保证不同模型的工具可靠性和输出风格一致。
推理设置与模型能力
Pi 提供推理强度相关设置，但实际支持范围由模型和提供商决定。不能仅凭界面上存在设置项就认定某模型拥有对应能力，也不能把更高强度直接当作正确率保证。
使用者更应观察任务结果：是否找到相关证据、工具参数是否正确、测试结果是否支持结论。速度、上下文容量与任务适配程度需要在具体场景中比较。
自定义模型
自定义模型文档说明如何通过 ~/.pi/agent/models.json 接入兼容服务，例如本地模型服务器或代理。配置通常涉及服务地址、API 类型和模型 ID；需要时还应明确输入类型、上下文窗口等属性。
声明一个较大的上下文窗口不会扩大模型服务的真实容量。接口兼容也不表示所有细节一致，工具调用和流式行为仍需按所用服务验证。对于不符合现有接口的服务，可进一步查阅官方的自定义 Provider 扩展方式。
信息流向
使用远程模型时，请求中的消息及工具返回内容会发往相应服务。使用本地模型则需要确认实际服务地址、运行方式和所加载扩展。判断“是否本地处理”应检查整条调用路径，而不只看模型名称。