MODULE 01 · STEP 03

登录账号，让 Pi 能回答你

Pi 提供交互界面和文件工具，真正生成回复的是你选择的模型服务。所以安装完 Pi 后，还需要连接一个你已经可以使用的服务。

开始前，你需要已经拥有一种可用凭据：官方当前支持的订阅登录，或对应模型服务已启用的 API Key。只有聊天产品账号、不含 API 使用额度的账号，未必能在 Pi 中调用模型。订阅登录可能打开浏览器；API Key 路线通常由模型服务商按使用量计费。

先确认费用，再登录

订阅不等于 API，能登录也不等于调用免费。 不同 Provider 的订阅认证、套餐额度、额外用量和 API 余额规则不同；有些路线即使使用订阅账号授权，第三方 Harness 中的调用仍可能进入单独计费。不要根据聊天产品页面上的“已订阅”推断 Pi 中的费用。

Windows 用户

如果你刚完成 Windows 中文安装路径，本课和后续课程中的“普通终端”都指 Git Bash。下面的 ~/Downloads/pi-practice 请换成你已建立的 ~/pi-practice；Pi 编辑区里的 /login、/model 等命令不变。

先选模型访问方式：官方 API 与订阅

以下价格和接入方式核验于 2026 年 9 月 14 日。四种选择适合不同需求，选一种能跑通练习的即可；模型名单、价格、额度和活动可能变化，付款前再打开对应官方页面核对。

推荐说明： 这些是我根据入门成本和 Pi 接入方式整理的个人选择，与下列服务商没有赞助、返佣或其他利益关系；文中的链接均指向官方页面，不含我的邀请链接。

DeepSeek 官方 API · 按量计费

适合想先用一个国内模型、按实际用量付费的读者。到 DeepSeek 官方平台开通 API、创建 Key 并确认余额；Pi 内置 deepseek Provider，可在 /login 中选择 DeepSeek 输入官方 Key，再用 /model 查看当前可选模型。Pi 官方接入说明列出 DEEPSEEK_API_KEY。这不是包月订阅：调用按输入、输出 Token 扣费，缓存是否命中、模型以及高峰/低峰时段都会影响价格。DeepSeek 官方价格表会更新，首次测试前先看当前余额和计费规则。

ChatGPT Plus · $20/月

适合主要想用 OpenAI 的 Codex 模型，同时也使用 ChatGPT 的读者。OpenAI 官方价格为 $20/月。Pi 支持在 /login 中选择 ChatGPT Plus/Pro (Codex)，但可选模型以当前账号和 Pi 的模型列表为准；不能写成“GPT 全系列都能在 Pi 中使用”。Plus 也不包含单独计费的 OpenAI API 用量。查看 Pi 接入说明

OpenCode Go · $10/月

适合想以较低月费使用多种编码模型的读者。Go 官方说明列出 $10/月；Pi 内置 opencode-go Provider，用 Go 的 API Key 登录。当前名单有 GLM、Kimi、Qwen、DeepSeek、MiniMax、MiMo，也有 GPT、Grok 等，不能概括为“全是国内模型”。不同模型的月度用量上限不同；5 小时和每周窗口分别最多使用该模型月限额的 20% 和 50%。查看 Pi 接入说明

Command Code GOAT · $10/月

适合愿意配置自定义 Provider、想在多种模型间切换的读者。GOAT 官方说明列出 $10/月；其 Provider API 可使用套餐内模型和额度。Pi 没有预设的 GOAT 登录项，需要按 Pi 自定义模型说明接入兼容 API。名单同时包括国内开放模型与部分 GPT、Gemini、Grok 等模型。官方列出 5 小时 $14、每周 $35 的用量窗口；每月具体可用量还要看所选模型。

怎么选： 想用国内模型且只按实际用量付费，先看 DeepSeek 官方 API；想使用 OpenAI 的 Codex 模型并同时使用 ChatGPT，先看 ChatGPT Plus；想以较低月费试用多种编码模型，再看 OpenCode Go；愿意自己配置接口、也需要 GOAT 模型名单时，最后考虑 Command Code GOAT。“可以高强度使用”只表示部分套餐有一定用量空间，不表示无限调用；按量付费的 API 则应自行留意余额与消费。第一次试用仍要查看账户里的额度和是否开启额外付费。

OpenCode Go 的“邀请他人可得 $5”目前没有在其公开的 Go 官方说明中找到固定活动条款，因此不计入上述价格或额度。若你的账户显示邀请活动，请以当时后台列出的奖励类型、领取条件和有效期为准；使用额度奖励不等于月费减免。

1. 选择一种登录方式

先用下面这张表决定自己走哪条路。不要因为列表中某个模型看起来更强，就临时开通一项还没理解的付费服务。

你已经拥有的访问方式	在 Pi 中的入口	开始前必须确认
Pi 官方当前列出的受支持订阅	对应 Provider 的订阅/OAuth 登录	订阅等级是否符合要求；Pi 中的调用使用套餐额度、额外用量还是其他余额
已订阅并取得 API Key，或已有 API 余额；Pi 内置该 Provider	在 /login 中选择对应 Provider 的 API Key	Key 属于哪个账户；计费方式、余额或限额；怎样撤销 Key
套餐提供兼容 API，但 Pi 未内置该 Provider（如 GOAT）	先看 Pi 自定义模型说明；本课的登录菜单没有现成入口	套餐是否开放 API、怎样配置 Key、模型是否在套餐内以及用量限制
只有普通聊天产品账号	先不要继续	该账号是否真的包含 Pi 支持的模型访问方式
两者都没有或无法确认	先不要继续	先阅读 Provider 当前说明，不为完成教程盲目充值

在接入前，先完成三个检查：

1. 说清自己使用的是“订阅认证”还是“API Key”，不能只说“我有账号”。
2. 在对应服务商账户中确认计费或额度状态；上面的价格只是注明核验日期的选择参考，不代替付款页和账户余额。
3. 把本课停止条件设为一次无文件连通测试。没有确认费用前，不开始长任务，也不连续切换多个模型试跑。

如果你上一课后已经退出 Pi，先在终端重新进入练习目录。

cd ~/Downloads/pi-practice
pwd
pi

如果你在第 1 课使用了其他练习目录名，先把命令中的 pi-practice 替换掉。确认 pwd 以你实际的练习目录名结尾。使用 Pi 内置 Provider 的读者，进入 Pi 后输入：

/login

这条 /login 要输入在 Pi 底部的编辑区，不是退回普通终端后输入。输入完按 Return。菜单出现后，用上下方向键移动选中项，按 Return 确认，按 Esc 返回上一层或取消。

截图记录的是 Pi 0.80.10，停在选择入口，没有继续提交账号或凭据。Pi 1.1.0 的全屏菜单还会显示 Radius 入口；前两项账号与 API Key 的选择方式相同。蓝色箭头表示当前选中项；你可以在账号登录与 API Key 两条路线之间移动。任何真实 Key、验证码和账号信息都不应进入教程截图。

按界面提示选择一条路线，并只完成刚才确认过的那一种。

• 已有受支持的订阅，选择对应服务，按浏览器授权流程完成登录。浏览器授权成功只能证明凭据已返回，不能证明后续调用不产生费用。
• 已有 API Key，选择对应服务，只在 Pi 本机登录界面中输入。API Key 是调用凭据，不是免费额度；实际费用和限制由该 Key 所属账户决定。

如果任何步骤要求把 Key 写进项目文件、聊天输入区、截图或普通终端命令历史，按 Esc 取消，不继续粘贴。本课只接受 Pi 的本机认证入口或官方明确说明的环境配置方式。

某些登录方式会自动打开浏览器。在浏览器中确认完成后，回到原来的终端窗口。终端中重新出现 Pi 的输入区，才表示登录流程已经返回。不要因为浏览器显示“成功”就关闭整个终端。

官方当前支持的订阅、API Key 和提供商规则会变化，请以 Pi Providers 为准，并继续查看所选服务商的计费说明。某个聊天产品账号存在，不代表它一定包含 Pi 所需的模型访问权限。

不要公开凭据

不要把真实 API Key 贴进聊天、教程、截图或 GitHub 仓库。如果怀疑密钥已泄露，立即到服务商后台撤销旧密钥并创建新密钥。

2. 选择当前账号可用的模型

接入完成后，输入：

/model

用上下方向键移动，按 Return 选中模型。列表关闭并回到编辑区后，查看底部状态栏，确认当前模型名已经显示。

选择器只显示当前已配置 Provider 可用的模型。截图中的列表会随账号和时间变化；绿色勾与蓝色箭头帮助确认当前项，选中后仍要回到底部状态栏复核模型名。

如果希望下次启动继续使用它，在模型选择器中按 Ctrl+S 保存为启动默认值。不要把教程中的某个模型名称当成唯一正确答案，模型的名称、可用性和计费都会变化。

3. 做一次无文件操作的连通测试

回到编辑区，提交这句话：

只回复“Pi 已连接”。不要读取、创建、修改文件，也不要运行命令。

粘贴到 Pi 底部编辑区后按 Return。界面可能会先显示正在思考或等待网络，这时不要重复提交。等到模型真正返回文字，并且底部编辑区再次可输入，才是这轮结束。

看到完整的“Pi 已连接”回复才算通过。泛泛的欢迎语、只看到“登录成功”提示，都不能证明当前模型完成了这次真实调用。

如果 Pi 准备读写文件或运行命令，按 Esc 中止。这次测试不需要任何工具。

没有收到回复

• 看不到可用模型，内置 Provider 先回到 /login 检查认证；自定义 Provider 先检查模型配置。
• 选完模型但状态栏没有变化，先取消当前操作，重新打开 /model 核对；不要连续切换多个提供商。
• 测试请求长时间不返回，先按 Esc 停止这一轮，保留状态栏模型名和错误文字，再检查网络与该服务状态。
• 出现 unauthorized、余额或额度错误，保留原始文字，检查当前账号权限。
• 浏览器授权后没有回到 Pi，取消本次登录，确认浏览器中的账号后再重试。
• 不知道错误在哪里，从第一行错误到底部输入区整段复制，但要先遮住 API Key、邮箱和私人路径。

本课验收

• 能明确说出本次使用的是订阅认证还是 API Key，并已查看对应账户的额度或计费状态。
• 已通过 /login 完成认证，或已配置一种可用的自定义 Provider。
• 底部状态栏显示当前模型。
• 测试准确回复“Pi 已连接”，且没有工具调用。

下一课，在正确的目录中准备工作 →

本次实机复查 · 2026-10-12

在独立配置和练习目录中，用 Pi 1.1.0 打开 /login 与 /model 菜单，再用本机已有的 DeepSeek 环境凭据收到「连接正常」，事件记录中没有工具调用。没有重新进行 OAuth 授权或录入 API Key，不能据此更新这些流程的历史核验日期；上面的价格与套餐日期也保持不变。