用Codex从零开发AI充值比价网站：架构设计与工程实践

做 AI 充值比价网站这件事，起因并不复杂：不同 AI 平台按 token、按 credits、按套餐计费的方式不一样，同一个模型在不同渠道的单价差距也很大，想估算一次真实调用到底花多少钱，往往要在多个控制台之间来回切换。真正动手做这个项目后才发现，工作量不在页面，而在数据口径统一、价格更新机制和工具链本身。开发过程中，我主要用 Codex 辅助完成从原型到具体模块的代码编写，整个项目累计消耗的 token 量到了数十亿级别。这篇文章会把项目从需求拆解、环境配置、架构设计、核心实现到上线排错的过程完整整理出来，重点记录 Codex 相关工具链的使用方式、遇到过的报错，以及一个免费比价站点在工程上需要做对哪些事。

1. 需求拆解：为什么做 AI 充值比价网站，以及 Codex 在这里负责什么

1.1 比价网站要解决的现实问题

很多开发者在接入 AI API 时会遇到一类非常现实的问题：同样一个模型，在平台 A 按每 1K token 计价，在平台 B 按模型套餐出售，在平台 C 又按 credits 点数计费。如果把输入、输出、缓存命中、批量折扣这些条件叠加进来，手动对比价格几乎不可能。

比价网站的核心价值，不是简单罗列一堆数字，而是把不同平台的计费口径统一成同一套可对比的指标，比如“每百万输入 token 的价格”“每百万输出 token 的价格”“按小时包套餐折算的单价”。只有口径统一，价格差异才有意义。

做这个项目时，我一开始想的并不是覆盖多少平台，而是先把一条主流程跑通：能从不同渠道拿到原始价格，能通过程序转换成统一口径，能存进数据库，能通过接口提供给页面查询。这四步完成之后，比价网站的地基才算打牢。

1.2 Codex 适合承担哪部分开发工作

Codex 是 OpenAI 提供的编程智能体工具，开发者在终端里用自然语言描述任务，它可以生成代码、修改文件、执行命令并读取结果，是一个适合处理“从想法到代码”的辅助工具。

在这个项目里，我让它承担了三类工作：

• 快速生成项目骨架和基础 API 代码。
• 把“统一计费口径”的需求翻译成可执行的换算函数。
• 在我描述报错日志后，结合项目文件定位问题并给出修改建议。

这里要注意，Codex 不是一个拿来就能自动完成整个项目的黑盒。越是复杂的业务逻辑，越需要开发者自己先拆清楚边界。比如“抓取价格”“换算单位”“筛选排序”这些功能，分开描述比一次丢给它一个完整产品需求要可靠得多。

1.3 先用最小版本验证，再决定要不要扩大数据源

比价网站的坑主要在数据维护，而不是代码量。每接入一个平台，都要确认它的价格页面规则、更新频率、是否有反爬限制以及价格条款是否允许自动抓取。小范围跑通再扩源，能避免一开始就把架构设计得过于复杂。

我把第一阶段的目标限定为：

• 支持 5 到 10 个常见模型。
• 每个模型至少能覆盖 3 个平台的官方价格。
• 价格每天更新一次。
• 页面可以按平台和模型筛选。

这个范围对初期开发已经足够。等稳定运行一段时间后，再考虑增加更多数据源，会比一开始就追求“全网覆盖”稳妥很多。

2. 环境准备：安装 Codex CLI、处理登录态和基础配置

2.1 安装与版本检查

Codex CLI 可以通过 npm 安装，安装前需要确认 Node.js 环境可用。不同时期官方推荐的安装方式可能略有差别，落地前先查看当前版本文档即可。

安装完成后，先执行一次 codex --version 确认命令能正常找到。如果终端能识别 codex 命令，说明安装路径已经进入 PATH。

这里最容易出现的问题，是 Codex CLI 的二进制确实安装成功了，但编辑器插件或另一个应用程序找不到它。常见报错是：

这类信息通常出现在使用桌面端应用或编辑器插件时，插件默认会在固定位置查找 Codex CLI，而实际安装目录不在它的搜索范围内。

解决方式是显式设置 Codex CLI 的路径。比如在 macOS 或 Linux 环境下，先找到实际的二进制路径：

然后把路径写入环境变量，或者写入插件的配置项：

写完后重启终端和编辑器插件，再试一次。这个问题看起来很基础，但实际发生频率很高，而且报错信息不会直接告诉你“当前 PATH 里没有”，而是给出一段容易让人误判的二进制路径提示。

2.2 登录认证与 token exchange 失败排查

Codex CLI 安装完成后，需要在终端登录账号后才能使用。登录命令一般是：

登录过程会打开浏览器完成 OAuth 授权。多数情况下流程顺畅，但项目开发期间我遇到过两类非常典型的登录失败。

第一类是：

含义是授权码换 token 的步骤失败。可能原因包括系统时间不准确、CLI 版本过旧、本地代理拦截了 token 请求，以及账号当前所在区域不在服务开放范围内。排查顺序建议是先校时，再检查网络代理，再确