⌨️ 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 搭好了它。資料活得比這次執行久。

免費端點、首次提交定義欄位、完整歷史一次查詢就拿得到。

建立你的免費端點 →