⌨️ Codex CLI + Data API

Codex CLI 交付得飞快。
结果都去哪了?

跑测试、做基准、爬数据、搞构建——Codex 干完活,把输出写进一个再没人看的沙箱文件。一个接口,让每次运行都变成一条存下来、可查询的记录。

跑得漂亮,没人记账

Codex 执行得漂亮。只是没人记分。

Codex CLI 擅长一次性工作:跑个基准、爬个网站、搭个小工具、做个实验。产出落在工作目录里的某个文件——results.txt、output.json、某张表格——线索到这就断了。想拿这周的运行和上周比比,你得在目录间 grep。问「我们之前试过什么?」,诚实的答案是:活下来的那些。

一个共享存储接口把闭环补上。每次运行把结果 POST 到同一个 FormLM URL——字段首次提交时自动创建,没有 schema 要维护——查询 API 把运行历史变成一张表,下一个任务里 Codex 读得回来、推理得动。Codex 写的脚本、跑的命令、构建的页面都能用,因为接口就是纯 HTTP,没有 SDK。

Codex CLI 使用 FormLM Data API
Data API 实操演示——发布、POST、读回数据

接入 Codex 的两条路

URL 管数据,MCP 服务器管完整控制。
路线 A · 零安装

把接口写进任务里。末尾带上 ?help,URL 贴进 Codex 的提示词。接口返回一份 Markdown 文档,列出每个字段、方法与示例——Codex 读完就写出正确的 POST 调用,不用你规定格式:

# 把这段放进你的 Codex 任务
"把每次基准测试的结果记到这个 API:
 https://formlm.me/api/v3/share/YOUR_TOKEN?help
 先读文档,每次跑完就提交结果。"

# Codex 拉取 schema、对上字段名、
# POST 每次运行——没有胶水代码要你审。
路线 B · 完整 MCP

把 formlm-cli 注册为 MCP 服务器,Codex 就多了八个工具:建表单、定义字段、发布、快照、查询。Codex 的配置是 TOML 不是 JSON——唯一一段长得不一样的平台配置。先 npm install -g @formlm/cli 装 CLI,再编辑 ~/.codex/config.toml,然后重启 Codex:

# ~/.codex/config.toml
[mcp_servers.formlm]
command = "formlm-cli"
args = ["mcp"

# macOS/Linux 上可选但推荐:
# Codex 启动服务器时可能不带你的完整 PATH
[mcp_servers.formlm.env]
PATH = "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"

登录一次就够:从 formlm.me → 账号设置复制访问令牌,终端里跑 formlm-cli auth login --token <your-token>,token 会一直留着(验证码和 Google 注册的账号没有密码——访问令牌,或终端里 formlm-cli auth login 的邮箱验证码方式,都能登录)——或者给 CI 机器、一次性环境设 FORMLM_TOKEN 环境变量。完整的 CLI 教程在开发者专区。

实际用起来什么样

一个接口、每次运行、全部可查。
# 写入——Codex 记下刚跑完的一次基准测试
$ curl -X POST https://formlm.me/api/v3/share/YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "run_id": "bench-2026-09-30-a",
      "latency_p95_ms": 412,
      "throughput": 9830,
      "notes": "index added on user_id"
    },
    "meta": {"source": "codex-run"}
  }'

# 读取——下一个任务带着完整历史开跑
$ curl https://formlm.me/api/v3/share/YOUR_TOKEN/query?page=1&size=50

接口是纯 HTTP,没有 SDK 版本锁要折腾,CLI 调用也没有 CORS 预检——脚本直接 POST。记录在 FormLM 界面里看得见、能导出 CSV,运行历史属于你,不属于 Codex 的工作目录。

常见问题

怎么把 FormLM MCP 服务器加进 Codex CLI?

编辑 ~/.codex/config.toml,加一段 [mcp_servers.formlm],command = "formlm-cli"、args = ["mcp"]。Codex 读的是 TOML 不是 JSON,所以这段长得跟 Claude、Cursor 的配置不一样。保存后重启 Codex。

Codex 在沙箱里够得着接口吗?

够得着。Codex CLI 调 HTTP 有网络权限,而且 CORS 只是浏览器规则——脚本和 CLI 工具直接 POST,连预检请求都没有。只有跑在浏览器里的页面才需要 CORS 头,FormLM 那边也发。

Codex 每次运行都要登录吗?

不用。从 formlm.me → 账号设置复制访问令牌,跑一次 formlm-cli auth login --token <your-token>,token 就留在机器上了。验证码和 Google 注册的账号没有密码——用访问令牌,或在终端跑 formlm-cli auth login 选「邮箱验证码」直接登录。或者把 FORMLM_TOKEN 设成环境变量——CI 和一次性环境特别适用。

之后 Codex 能把数据读回来吗?

能。query 接口按页返回每条存储记录的 JSON,summary 接口返回聚合统计。让 Codex 去取、去分析先前运行记下的东西——运行日志变成一张它能推理的结果表。

在其他 Agent 上使用

同一个接口处处通用。各平台的接入指南:

Codex 搭好了它。数据活得比这次运行久。

免费接口、首次提交定义字段、完整历史一次查询就拿得到。

创建你的免费接口 →