开源编程工具 Pi 1.0 实测：接国产模型跑活，账单几分钱

想用 AI 帮忙写代码，却卡在境外订阅付不了款、手里又拿着国内大模型平台的 key 不知往哪填——这是不少开发者的真实处境。开源编程工具 Pi 升级到 1.0 之后，接入 DeepSeek 等国产模型跑完整任务已经完全可行，而且成本低到几分钱。本文根据 B 站 UP 主的实测，把升级、配置和接入国产模型的全过程捋一遍。

一条命令完成升级，但要留意包名已更换

升级 Pi 本身只需要在终端敲一行 npm install 命令，两分钟就能装完。这里的 npm 是安装这类命令行工具的包管理器，install 后面跟的就是包名。

需要特别注意两点。第一是 Node 版本——Node 是让这类工具能够运行的底层环境，至少需要 22.19 版本，实测机器用的是 24.11 可以正常运行。第二个坑在包名上：旧包挂在作者个人账号下，官方已经标注为废弃（deprecated），新包名前缀换成了公司名。如果搜错，很可能装回旧版本。

装完后敲一下版本号，如果从 0.85 变成了 1.1，就说明升级成功了。

npm（Node Package Manager）是 JavaScript 生态中最主流的包管理器，随 Node.js 一同安装。开发者通过它安装、更新和管理命令行工具或代码库。npm install -g <包名> 中的 -g 参数表示全局安装，安装后可以在系统任意目录直接调用该工具，不加 -g 则只在当前项目目录生效。包名前缀通常以 @组织名/ 开头，例如从个人账号下的 pi 迁移到公司账号下的 @company/pi，这是 npm 生态中常见的组织迁移方式。在 npm 官网搜索时，旧包页面会有明显的 "deprecated" 警告标识，点进去一般能看到官方推荐的新包名跳转链接。

装完第一天先调这三样设置

Pi 1.0 在默认行为上做了几处改动，装完先把这三样调好，使用体验会顺很多。

界面模式

1.0 起默认改成了全屏界面。全屏模式会接管终端原本的滚动历史，导致你翻不到之前看过的记录。作者本人在社区帖子里回应过，说这是为了修复 Windows 终端的一些毛病，但老模式不会被取消。如果不习惯，在配置文件里把界面模式从 fullscreen 改成 regular，滚动条就回来了。

默认模型

同一个配置文件里有两行关键配置：一行指定默认用哪家平台，一行指定默认用哪个模型。想临时切换，启动时加一句参数即可，进入界面后按快捷键也能切。

默认思考档位

状态栏会显示当前的思考档位。如果默认停在最高档，连小任务都会按最高档去思考，白白多花时间。建议按模型支持的档位调低一点，日常任务不必每次都想那么深。

接入 DeepSeek 等国产模型：填一个环境变量

接入国产模型的 key 要单独走一步。官方文档里有一张环境变量对照表，一个变量名对应一家平台，想用哪家就在终端里 export 哪家的 key。

对照表里除了国外那几家，还列了一整排国内能直接注册、直接充值的平台，排在前面的就是 DeepSeek^广告（深度求索），只需填一个变量名就够。后面还有月付套餐、Kimi、MiniMax、阿里的通义千问^广告、小米的模型等，国内能走的渠道基本都列上了。

export 是 Unix/macOS 终端（Bash/Zsh）中设置环境变量的命令，格式为 export 变量名=值。环境变量是操作系统级别的键值对，运行在同一终端会话里的程序都能读取到它们，Pi 就是通过这种方式拿到你的 API key 并转发给对应平台。需要注意的是，直接在终端敲 export 只在当前会话有效，关掉终端窗口后就消失了。如果希望永久生效，需要把这行命令追加到 ~/.zshrc 或 ~/.bashrc 等 Shell 配置文件里，下次开终端自动加载。Windows 用户对应的操作是在"系统属性→环境变量"里添加，或在 PowerShell 中使用 $env:变量名='值'。

跑一个真实任务：30 秒搞定，账单几分钱

光看名单不算数，UP 主在 Mac 上新建了一个空目录，让 Pi 写一个 FizzBuzz 程序再写测试跑通。FizzBuzz 是面试常见的小题：数到能被 3 整除输出 Fizz、能被 5 整除输出 Buzz。

实测分两个渠道各跑一遍：

• 套餐渠道挂 DeepSeek 模型：30 秒完成，Pi 自己读目录、理解任务、写两个文件、跑测试全过。整单约消耗 16000 个 token（token 是模型读写内容的计量单位），用量算进套餐额度，没有额外扣费。
• DeepSeek 官方按量 key：同样的任务 9 秒完成，测试一样通过。实际账单是 0.0064 美元，折合人民币五分钱不到。

官方按量渠道还带 prompt 缓存——缓存能让模型记住刚看过的内容，后续步骤不重复计费，所以任务越往后越便宜。所有花费和用量都挂在界面状态栏上，随时看得见。

Token 是大语言模型处理文本的基本计量单位，可以理解为"词片段"——一个英文单词通常对应 1-2 个 token，一个中文汉字约对应 1-2 个 token。模型收费按输入 token 和输出 token 分别计价，输入通常比输出便宜。Prompt 缓存（Prompt Caching）是近年主流平台推出的降费机制：当模型在同一会话中多次处理相似的前缀内容（如系统提示词或已有代码文件），平台会把这部分计算结果缓存起来，后续命中缓存的 token 只收取极低的缓存读取费，甚至免费。对于 Pi 这类需要反复读取项目文件的编程工具，缓存命中率较高，实际账单往往远低于按完整 token 数估算的金额。

边界与注意事项

实测结论要讲清楚边界。这个 FizzBuzz 小活能证明的是：Pi 能接上国产模型、能跑得动、而且便宜。但它证明不了国产模型跟最贵的旗舰模型一样聪明，大型复杂任务该花的钱还是得花。

另外几点细节值得记住：

• 官方按量计费的 key 要走官方渠道注册充值，不要买二手。
• 国内镜像站是否同步了这个新包，UP 主没有查到，但官方源直连可以正常安装。
• Pi 的斜杠命令并非万能。UP 主敲了一个查用量的命令，它被当成一句话让模型去翻文档了——倒是顺手把用量查出来了。

快速上手清单

把能照着做的步骤捋一遍：

1. 一条 npm install 命令升级，记得换成新包名；
2. 进配置文件调好界面模式、默认模型、默认思考档位这三样；
3. 单独把一个国内平台的 key export 进终端；
4. 扔一个真实任务给它跑一遍验证。

对于被境外订阅挡在门外的开发者，Pi 1.0 加国产模型 key 这套组合，提供了一条成本极低的可行路径。