codex execの使い方!議事録を要約してファイルに保存する手順

定例会議のたびに、議事録から決まったことと宿題を拾い出して共有する作業は手間がかかります。Codexの会話の画面を開いて毎回同じ依頼を打ち込むのも、回数が増えると負担です。
Codex CLIの「codex exec」を使うと、会話の画面を開かずに、1行のコマンドで依頼を1回だけ実行できます。結果はファイルに保存でき、決まった形のJSONで受け取ることも可能です。ただし、普段のCodexとは画面の出方や書き換えの扱いが違うため、手順を知らないと結果が見つからない、ファイルが変わらないといった戸惑いの元です。
この記事では、架空の議事録を使って、codex execで要約を作り、ファイルやJSONに保存するまでの手順を実画面で解説します。
この記事を読めば、議事録の要約のような決まった依頼を、コマンド1行で何度でも回せるようになります。codex execは既定では読み取り専用で動くので、まずは要約をファイルに保存するところから試すのが安全です。
目次
- codex execでできることと普段のcodexとの違い
- 練習用の議事録と作業フォルダを用意する手順
- codex execで議事録を1回だけ要約する手順
- 最後の返事をファイルに保存して原文と照合する手順
- 依頼文や議事録をファイルから渡す手順
- JSON Schemaで決まったことと宿題を取り出す手順
- 前回の続きを頼む手順とファイルの書き換えを許す手順
- codex execがうまく動かないときの対処法
- codex execに関するよくある質問
- まとめ
- 参考リンク
codex execでできることと普段のcodexとの違い
codex execは、Codexに1回だけ依頼して、終わったら自動で終了するコマンドです。普段のcodexとの主な違いは、以下の4つです。
- 会話の画面を開かず、1回の依頼を処理して終わる
- 進み具合は画面に流れ、最後の返事だけが結果として出力される
- 既定では読み取り専用で、ファイルを書き換えない
- Gitで管理しているフォルダでないと、確認のために止まる
codex execは、時刻を決めて自動で動く仕組みではありません。毎朝決まった時刻に動かしたいときは、パソコン側の予約の仕組みと組み合わせる必要があります。
ログインの情報は、普段のCodexと同じものがそのまま使われます。ChatGPTのアカウントでログインしている場合、使用量はChatGPTのプランのCodexの利用枠から引かれる仕組みです。
Claude Codeの「claude -p」も、同じように1回の依頼を処理して終わる使い方です。Claude Codeでの使い方は、Claude Code CLIの記事で解説しています。
Claude Code CLIとは?インストールから使い方・コマンドまで解説
練習用の議事録と作業フォルダを用意する手順
codex execを試す前に、Codex CLIが使える状態かを確かめ、練習用の議事録を置いたフォルダを用意します。練習用の議事録と作業フォルダを用意する手順は、以下の3つです。
- Codex CLIのログインを確かめる
- 作業フォルダに議事録を保存する
- git initでGitのフォルダにする
Codex CLIのログインを確かめる
ターミナルを開いて「codex --version」と「codex login status」を順に入力します。版の番号と「Logged in using ChatGPT」が表示されれば、codex execを使える状態です。
本記事の画面は、Codex CLIの0.166.0で撮りました。新しく入れた場合は、版の番号が違うことがあります。Codex CLIのインストールとログインの手順は、Codexの使い方の記事で解説しています。
Codexの使い方を解説!CLIの導入から日本語での依頼・変更確認まで
作業フォルダに議事録を保存する
練習用のフォルダを作り、架空の議事録を「議事録.txt」として保存します。本記事で使った議事録の中身は、以下の13行です(空行を除く)。
- 定例会議 議事録(架空のサンプル)
- 日時:2026年11月10日(火)10:00〜10:45
- 場所:第2会議室
- 出席:営業部、総務部、情報システム部
- 1. 生成AIの社内研修について
- ・12月に全社員向けの研修を2回行うことに決まった。
- ・研修の資料は総務部が11月20日までに作る。
- ・会場の予約は総務部が11月14日までに行う。
- 2. 問い合わせ対応の手順書について
- ・営業部から、手順書が古く新人が迷うという意見が出た。
- ・情報システム部が11月21日までに改訂案を出す。
- 3. 次回の会議
- ・11月17日(火)10:00から。議題は研修の申込状況。
上の13行をコピーしてから、ターミナルで以下の2つのコマンドを順に入力します。
- 「mkdir -p ~/touchai-demo/codex-exec-demo && cd ~/touchai-demo/codex-exec-demo」で練習用のフォルダを作って移る
- 「pbpaste > 議事録.txt」でコピーした文を議事録.txtに保存する
「pbpaste」は、コピーした文字をそのままファイルに書き出すMacのコマンドです。「cat 議事録.txt」と入力すると、保存した中身を表示できます。
画像では読みやすいように、議題の間に空行を入れて保存しました。空行の有無は、要約の結果には関係ありません。
git initでGitのフォルダにする
codex execは、Gitで管理しているフォルダで動かすのが基本です。練習用のフォルダで「git init」と入力すると、フォルダがGitの管理に入ります。
黄色の「hint:」の行は、Gitの初期のブランチ名についての案内です。練習では読み飛ばしてかまいません。画像の黒い帯は、撮影に使ったパソコンのユーザー名や会話のIDを隠した部分で、以降の画像も同じです。
codex execで議事録を1回だけ要約する手順
codex execの基本は「codex exec」の後ろに依頼の文を「"」で囲んで付けるだけです。議事録を1回だけ要約する手順は、以下の2つです。
- 依頼の文を付けてcodex execを実行する
- 実行の画面の読み方を知る
依頼の文を付けてcodex execを実行する
練習用のフォルダで、以下のコマンドを入力してEnterキーを押します。
- codex exec "議事録.txtを読んで、決まったことと宿題(何を・どの部署が・いつまでに)を箇条書きでまとめてください。議事録に書かれていないことは足さないでください。"
撮影に使ったパソコンには、ほかの作業のためのCodexの設定ファイルがあります。撮影では、いつもの設定を読み込まない「--ignore-user-config」を撮影用のシェルで自動で付けて動かしました。読者の方は付けなくてかまいません。
実行の画面の読み方を知る
Enterキーを押すと、Codexが議事録.txtを読み、要約を出して終了しました。
画面は上から順に、以下の4つの部分に分かれています。
| 画面の部分 | 意味 |
|---|---|
| workdirからreasoning summariesまで | 作業フォルダ・モデル・読み取り専用(read-only)などの設定 |
| user | 送った依頼の文 |
| exec | Codexが実行したコマンドと、その結果 |
| codexとtokens used | 最後の返事と、使った量の目安 |
「sandbox: read-only」の行は、読み取り専用で動いた印です。モデルの欄の「gpt-6.1-sol」と「reasoning effort: none」は、設定ファイルを読み込まないときの撮影の時点の既定で、自分の設定によって変わります。
要約の中身は、議事録の3つの宿題と、研修と次回の会議の2つの決定を正しく拾っていました。返事が終わると、ターミナルは次のコマンドを入力できる状態に戻ります。
最後の返事をファイルに保存して原文と照合する手順
要約を共有するには、最後の返事をファイルに保存すると便利です。最後の返事をファイルに保存して原文と照合する手順は、以下の3つです。
- -oで要約.mdに保存する
- 保存したファイルを開いて原文と照らす
- >でも最後の返事だけを保存できる
-oで要約.mdに保存する
「-o」の後ろにファイル名を付けると、最後の返事が指定したファイルに保存されます。要約を要約.mdに保存するコマンドは、以下のとおりです。
- codex exec -o 要約.md "議事録.txtを読んで、決まったことと宿題(何を・どの部署が・いつまでに)を箇条書きでまとめてください。議事録に書かれていないことは足さないでください。"
Enterキーを押すと、実行の画面が流れ、最後に要約が表示されて終了しました。
-oを付けた場合も、画面の返事の表示は変わりません。表示と同時に、ファイルにも書き出される仕組みです。
保存したファイルを開いて原文と照らす
ターミナルで「ls」と「cat 要約.md」を順に入力すると、要約.mdができたことと中身を確かめられます。
中身の最後に表示される「%」は、ファイルの最後に改行がないことを示すターミナルの印で、ファイルの中身ではありません。
Finderで見たいときは、ターミナルで「open .」と入力すると、今のフォルダがFinderで開きます。要約.mdを選んでスペースキーを押すと、中身をのぞけます。
要約は、元の議事録.txtと並べて照らし合わせてください。本記事の要約では、日付・部署・宿題の数が議事録と一致していました。AIの要約は抜けや言い換えが起こることがあるため、社内に回す前に人が原文と照らすことが大切です。
>でも最後の返事だけを保存できる
codex execは、最後の返事だけを結果として出力します。そのため、コマンドの最後に「> ファイル名」を付けても、最後の返事だけがファイルに入ります。
- codex exec "議事録.txtを読んで、宿題(何を・どの部署が・いつまでに)だけを箇条書きにしてください。" > 宿題.md
画面の進み具合の表示には、最後の返事も含まれていました。-oと「>」のどちらでも、ファイルに入るのは最後の返事だけです。後で紹介する--jsonを付けたときは、最後の返事だけを別のファイルに残せる-oが役に立ちます。
依頼文や議事録をファイルから渡す手順
毎回同じ依頼をするなら、依頼文をファイルに保存しておくと、打ち間違いがなくなります。依頼文や議事録をファイルから渡す手順は、以下の2つです。
- 依頼文をファイルに保存してcodex exec -に渡す
- 議事録をパイプで渡して表にする
依頼文をファイルに保存してcodex exec -に渡す
依頼文を「依頼.txt」として保存します。依頼.txtに書く内容は、以下の4行です。
- 議事録.txtを読んで、次の2つを箇条書きでまとめてください。
- 1. 決まったこと
- 2. 宿題(何を・どの部署が・いつまでに)
- 議事録に書かれていないことは足さないでください。
上の4行をコピーし、ターミナルで「pbpaste > 依頼.txt」と入力して保存します。続けて、以下のコマンドを入力します。
- codex exec -o 要約.md - < 依頼.txt
依頼の文の代わりに置いた「-」は、依頼の文を「<」の後ろのファイルから読むという指定です。実行すると、userの欄に依頼.txtの中身がそのまま入り、2つの見出しに分けた要約が返ってきました。
依頼.txtを直せば、次から同じコマンドで直した依頼を使えます。部署ごとに依頼.txtを分けておくと、議事録の種類に合わせた要約を作り分けられます。
議事録をパイプで渡して表にする
ほかのコマンドの結果を、依頼と一緒に渡すことも可能です。議事録.txtの中身を「|」(パイプ)でcodex execに渡すコマンドは、以下のとおりです。
- cat 議事録.txt | codex exec "この議事録の宿題を、内容・担当・期限の3列の表にしてください。"
依頼の文とパイプの両方があるときは、依頼の文が指示になり、パイプで渡した中身は「stdin」の欄に資料として付きます。画面の最初の「Reading additional input from stdin...」は、パイプで渡された中身を読み込んでいるという表示です。実行すると、宿題が内容・担当・期限の3列の表で返ってきました。
パイプで渡す方法は、ほかのコマンドの出力やログをまとめて読ませたいときに使えます。
JSON Schemaで決まったことと宿題を取り出す手順
要約を表計算ソフトや別の仕組みに渡すなら、毎回同じ形のJSONで受け取れると扱いやすくなります。JSON Schemaで決まったことと宿題を取り出す手順は、以下の3つです。
- schema.jsonを保存する
- --output-schemaを付けて実行する
- 取り出した中身を原文と照らす
schema.jsonを保存する
JSON Schemaは、受け取りたいJSONの形を決めるファイルです。本記事では「決まったこと」の一覧と「内容・担当・期限」を持つ「宿題」の一覧を受け取る形にしました。schema.jsonに書く内容は、以下の6行です。
- {"type": "object", "properties": {
- "決まったこと": {"type": "array", "items": {"type": "string"}},
- "宿題": {"type": "array", "items": {"type": "object", "properties": {
- "内容": {"type": "string"}, "担当": {"type": "string"}, "期限": {"type": "string"}},
- "required": ["内容", "担当", "期限"], "additionalProperties": false}}},
- "required": ["決まったこと", "宿題"], "additionalProperties": false}
6行をまとめてコピーしてから、ターミナルで「pbpaste > schema.json」と入力して保存します。
画像では読みやすいように、項目ごとに改行して保存しました。JSONは改行の位置が自由なので、6行のままでも同じ形として読まれます。
--output-schemaを付けて実行する
schema.jsonで形を決めて宿題.jsonに保存するコマンドは、以下のとおりです。「--output-schema」の後ろにschema.jsonを「-o」の後ろに保存先のファイル名を付けています。
- codex exec --output-schema schema.json -o 宿題.json "議事録.txtから、決まったことと宿題を取り出してください。"
実行が終わったら「cat 宿題.json」で中身を表示してください。
宿題.jsonは、schema.jsonで決めたとおりの「決まったこと」と「宿題」の2つの項目に分かれていました。
取り出した中身を原文と照らす
JSON Schemaで決められるのは、返事の形だけです。中身が正しいかは、原文と照らして確かめる必要があります。
本記事の結果では、議事録に「12月に」としか書かれていない研修の時期が「2026年12月に」となっていました。年はAIが補ったもので、議事録には書かれていません。社内に回す前に、日付や担当の部署を原文と照らしてください。
前回の続きを頼む手順とファイルの書き換えを許す手順
codex execでも、前回の依頼の続きを頼んだり、ファイルの書き換えを許したりできます。前回の続きを頼む手順とファイルの書き換えを許す手順は、以下の2つです。
- codex exec resume --lastで続きを頼む
- 書き換えは--sandbox workspace-writeで許す
codex exec resume --lastで続きを頼む
「codex exec resume --last」の後ろに依頼の文を付けると、今のフォルダで最後に実行したcodex execの続きとして依頼できます。宿題を期限の順に並べ替えてもらうコマンドは、以下のとおりです。
- codex exec resume --last "宿題を期限の早い順に並べ替えてください。"
実行すると、直前に宿題.jsonを作った会話の続きとして、宿題が期限の早い順に並んだ表が返ってきました。会話の記録にも、宿題を取り出した依頼の次に並べ替えの依頼が入っています。
続きの依頼には--output-schemaを付けていないため、返事はJSONではなく表でした。別のフォルダの会話も選びたいときは「--all」を付けます。
書き換えは--sandbox workspace-writeで許す
codex execは既定で読み取り専用のため、ファイルの書き換えを頼んでも書き換えません。書き換えの前後を比べるため、先に「git add 議事録.txt && git commit -q -m "議事録を追加"」で今の議事録をGitに記録しました。初めてGitを使うMacでは、記録の前に名前とメールアドレスの設定を求められることがあります。
議事録.txtへの書き足しを頼んだコマンドは、以下のとおりです。
- codex exec "議事録.txtの最後に「(要約済み)」という1行を書き足してください。"
Codexは「この環境は読み取り専用のため、議事録.txtを変更できませんでした」と答え、ファイルは変わりませんでした。書き換えを許すときは「--sandbox workspace-write」を付けて同じ依頼を送ります。
- codex exec --sandbox workspace-write "議事録.txtの最後に「(要約済み)」という1行を書き足してください。"
今度は「議事録.txtの末尾に「(要約済み)」を1行追記しました。」と返ってきました。途中のpython3の「warning」の行は、読み書きできる場所が限られた状態でコマンドを動かしたときの注意で、書き足しは成功しています。
書き換えた後は「git diff」で変わった行を確かめてください。
緑の「+」の行が、Codexが足した行を表します。ファイル名が「\350\255…」のような記号の列で表示されるのは、日本語のファイル名をGitが記号に置き換えて表示しているためです。
workspace-writeで書き換えられる場所は、実行の画面の「sandbox」の行に表示されます。撮影では「workspace-write [workdir, /tmp, $TMPDIR]」と表示され、作業フォルダ(workdir)と一時的なファイルの置き場所(/tmpと$TMPDIR)が書き換えの対象でした。フォルダの外や、ネットへの接続を許す設定はCodexのサンドボックスの記事で解説しています。
Codexのサンドボックスを徹底解説!自動承認を安全に使う設定も紹介
以前の解説で見かける「--full-auto」は、今のcodex execでは使えなくなっています。書き換えを許すときは「--sandbox workspace-write」を使ってください。
codex execがうまく動かないときの対処法
codex execは、確認の画面を出さずに処理するため、条件が合わないとすぐに止まります。実行を途中で止めたいときは、ターミナルでCtrlキーを押しながらCキーを押します。codex execがうまく動かないときの対処法は、以下の2つです。
- Gitのフォルダでないと止まる
- 読み取り専用では書き換えられない
Gitのフォルダでないと止まる
Gitで管理していないフォルダで試すため、撮影では「mkdir -p ~/touchai-demo/codex-nogit && cd ~/touchai-demo/codex-nogit」で別のフォルダを作って移りました。Gitで管理していないフォルダでcodex execを実行すると「Not inside a trusted directory and --skip-git-repo-check was not specified.」と表示されて止まります。
表示の意味は「信頼したフォルダではなく、--skip-git-repo-checkも指定されていない」です。フォルダで「git init」を実行するか、安全なフォルダだと分かっているときだけ「--skip-git-repo-check」を付けて実行します。
読み取り専用では書き換えられない
依頼したのにファイルが変わらないときは、画面の上の「sandbox」の行を確かめます。「read-only」と表示されていれば、読み取り専用で動いたため書き換えは行われていません。書き換えが必要な依頼だけ「--sandbox workspace-write」を付けて実行してください。
codex execに関するよくある質問
codex execについて、よくある質問と答えをまとめました。
codex execを毎日決まった時刻に動かせますか?
codex execそのものには、時刻を決めて動かす機能はありません。決まった時刻に動かすには、パソコンの予約の仕組みからcodex execのコマンドを呼び出す設定が必要です。自動で動かすときは、書き換えを許す設定を付けたまま放置しないように注意してください。
結果をプログラムで受け取るにはどうしますか?
「--json」を付けると、Codexの動きの1つ1つが1行ずつのJSONで出力されます。撮影で入力したコマンドは、以下のとおりです。
- codex exec --json "議事録.txtの次回の会議の日時だけを答えてください。"
画像の黒い帯は、会話を見分ける番号の行を隠したものです。--jsonの出力には、実行したコマンドや読んだファイルの中身も含まれます。人に見せる前やほかの仕組みに渡す前に、中身を確かめてください。詳しい書き方は、Codex公式ドキュメントの非対話モードのページで確かめられます。
codex execの使用量はどこで確かめますか?
codex execの使用量は、普段のCodexと同じ利用枠から使われます。プランごとの違いは、Codexの料金の記事で解説しています。
Codexの料金を徹底解説!無料でできることとプランの選び方も紹介
まとめ
codex execを使えば、会話の画面を開かずに、議事録の要約のような決まった依頼をコマンド1行で回せます。codex execの使い方の要点は、以下の5つです。
- Gitのフォルダで「codex exec "依頼の文"」と入力する
- -oで最後の返事をファイルに保存する
- 依頼文をファイルにして「codex exec -」で使い回す
- --output-schemaで決まった形のJSONにし、中身は原文と照らす
- 書き換えが必要なときだけ--sandbox workspace-writeを付ける
まずは練習用の議事録で、要約を要約.mdに保存するところまで試してみてください。



