codex exec で作業を自動で実行する(CSV の集計)

codex exec は、Codex に 1 行のコマンドで作業を任せる使い方です。画面でやりとりせずに最後まで進むので、スクリプト(コマンドをまとめて書いたファイル)や CI(コードを変えるたびにテストなどを自動で動かす仕組み)からも使えます。この記事では、家計簿の CSV を集計して、表のファイルを作ってもらった例で説明します。

codex exec とは

ふだんの codex は、画面で Codex とやりとりしながら進めます。codex exec は、依頼文を付けて実行すると、途中で確認を求めずに最後まで進みます。

標準出力はコマンドの結果が出る通り道、標準エラー出力はエラーや経過が出る別の通り道です。ターミナルではどちらも画面に表示されますが、ファイルに保存するときなどは分けて扱えます。

Git のリポジトリ(Git で管理しているフォルダ)の外では、codex exec は止まります。大事なファイルを壊さないための仕組みです。安全だと分かっているときだけ、--skip-git-repo-check を付けて動かせます。

CSV を集計してもらう

編集部では、家計簿の CSV(expenses.csv)があるフォルダ ~/kakeibo で試しました。CSV は日付・費目・金額・メモの 4 列です。9 行目(見出しの行を 1 行目と数える)だけ、金額が空欄になっています。

日付,費目,金額,メモ
2026-09-01,食費,1280,スーパー
2026-09-02,交通費,420,電車
2026-09-03,食費,860,昼ごはん
2026-09-05,日用品,1980,洗剤など
2026-09-08,食費,3420,まとめ買い
2026-09-12,交通費,1500,バス
2026-09-15,趣味,4800,本
2026-09-25,食費,,金額を書き忘れ
2026-09-20,食費,980,パン屋
2026-10-01,食費,1450,スーパー
2026-10-03,交通費,420,電車
2026-10-04,日用品,690,ティッシュ

できた summary.md

できた summary.md には、「月別・費目別の支出集計」という見出しと、「集計元: expenses.csv。金額の単位は円です。」という説明のあとに、次の表が書かれていました。

表の下には、次の 2 つの注記がありました。

• ※ expenses.csv の 9 行目（2026-09-25、食費）は金額が空欄のため、集計から除外しました。
• ※ 表の 0 は、その月に集計対象の支出がない費目を示します。

編集部で元の CSV と照らし合わせたところ、月ごと・費目ごとの合計はすべて合っていました。金額が空欄の 9 行目は、0 円として数えずに集計から外し、そのことを表の下に書いています。

よく使うオプション

codex exec は、codex e と短く書くこともできます。

結果をファイルに残す・ほかのコマンドとつなぐ

最後の回答だけが標準出力に出るので、tee(画面に出しながらファイルにも書くコマンド)で、そのまま保存できます。次の公式の例は、直近 10 件のコミットからリリースノートを作る依頼です。

codex exec "generate release notes for the last 10 commits" | tee release-notes.md

ほかのコマンドの結果をパイプ(|)で渡すと、依頼の追加の材料になります。次の公式の例は、テストの失敗をまとめて、いちばん小さい直し方を提案してもらう依頼です。

npm test 2>&1 \
  | codex exec "summarize the failing tests and propose the smallest likely fix" \
  | tee test-summary.md

依頼文そのものをファイルからパイプで渡すときは、依頼文の代わりに - を書きます。

cat prompt.txt | codex exec -

続けて頼む

codex exec の会話も保存されます。直前の codex exec の続きを頼むときは、resume --last を使います。次の公式の例では、1 行目で変更のレビューを頼み、2 行目で、見つかった問題を直してもらっています。

codex exec "review the change for race conditions"
codex exec resume --last "fix the race conditions you found"

使うときの注意

• --sandbox danger-full-access は、隔離した CI のランナー(実行用の機械)やコンテナなど、管理された環境の中だけで使います。
• CI で使うときは、API キーをジョブ全体の環境変数に置かないよう、公式のドキュメントが注意しています。同じジョブのビルドのスクリプトなどから読まれるおそれがあるためです。GitHub Actions では、公式の Codex GitHub Action(openai/codex-action)を使います。
• codex exec は、ChatGPT の Plus・Pro・Business・Enterprise・Edu のプランでも、API キーでも使えます。API キーで使ったぶんは、OpenAI の API の料金で請求されます。

次の回では、Codex を VS Code の拡張機能とクラウド(Codex Cloud)で使う方法を説明します。