
codex execの使い方|Codexを画面なしで自動実行する方法と、--json・--output-schema・resumeの実測【Windows・2026年10月】
Codex で毎回同じ作業を頼むなら、画面を開いて打つより、スクリプトから呼べたほうが楽です。そこで使うのが codex exec です。ただ、実際に使おうとすると、いくつか疑問が出てきます。
答えは、どこに出てくるのか。スクリプトで受け取るには、どうすればよいのか
答えを、決まった形(JSON)で返させることはできるのか
失敗したとき、使用量の上限に当たったとき、終了コードはどうなるのか
この記事は、この3つに、Windows の実機で動かした結果で答えます。最後に、記事の本文から題名の案を3つ作る Python のスクリプトを、動かした結果つきで載せます。
私は Claude Code と Codex を毎日使って、教材づくり、note や Gumroad への出品、画像づくりを自動化している個人です。この記事は、私の環境で動かした結果が材料です。全文無料です。
測った条件を書いておきます。Windows 11、Codex CLI 0.162.0-alpha.17.2(VS Code の拡張に入っている codex.exe)、2026年10月23日です。ChatGPT のアカウントでログインしています。モデルは、設定ファイルに書いてある gpt-6.1-sol、推論の強さ(reasoning effort)は low です。ここで書く時間や数字は、この環境のものです。
この記事で分かること
codex exec の基本の形と、出力のどこに答えが出るか
既定の権限(サンドボックス)と、この PC で動かなかったときの直し方
--json・--output-schema・-o・標準入力の使い方と、実際の出力
終了コードの見方(0 でも仕事が終わったとは限らない)
resume での会話のつなぎ方と、--ephemeral の効果
題名を3つ作るスクリプト(全文)と、動かした結果
試していないこと
先に結論
codex exec "依頼" で動きます。答えだけが標準出力に出て、ヘッダーと経過は標準エラーに出ます。> result.txt とすれば、答えだけをファイルにできます
既定は read-only(読むだけ)で、承認は never です。起動時のヘッダーに出ます。ファイルを書かせるなら -s workspace-write を付けます
この PC では、既定の設定でコマンドの起動が setup refresh had errors で失敗し、書き込みもできませんでした。-c 'windows.sandbox="unelevated"' を付けると動きました
--json を付けると、1行1イベントの JSON で返ります。最後の turn.completed に、トークンの数が入っています
--output-schema で答えの形を決めると、10回中10回、その形で返りました。ただし、スキーマに additionalProperties: false が無いと、終了コード1で止まります
終了コード 0 は、起動と通信が成功した、という意味です。仕事ができなかった(ファイルを読めなかった)のに、終了コード 0 になった例がありました
使用量の上限に当たると、終了コード 1 と、You've hit your usage limit の文が出ます。私は、この記事の実験の途中で当たりました
exec resume --last で、前の会話の続きができます。--ephemeral を付けると、会話の記録のファイルは増えませんでした

基本の形
いちばん短い形は、これです。
codex exec "このフォルダの名前を、1行で答えてください。"実行すると、ターミナルには、次のようなものが出ます。
標準エラー(画面では見えますが、別の流れです):OpenAI Codex v0.162.0-alpha.17.2 から始まるヘッダーと、途中の経過。ヘッダーには、workdir(作業フォルダ)、model、provider、approval、sandbox、reasoning effort、session id などが並びます
標準出力:Codex の最後の答えだけ
つまり、codex exec "…" > answer.txt とすれば、answer.txt には答えの文だけが入ります。スクリプトで受け取るときは、この性質が便利です。
私の環境では、ヘッダーはこう出ました。
workdir: C:\Users\(ユーザー名)\AppData\Local\Temp\試験フォルダ
model: gpt-6.1-sol
provider: openai
approval: never
sandbox: read-only
reasoning effort: low
reasoning summaries: none
session id: (会話のID)exec は、人に確認を取る画面がないので、承認は never、つまり「聞かずに、許された範囲だけやる」になっています。許される範囲は、sandbox の行で決まります。くわしくは、「Codexの承認モードとサンドボックスの設定」の記事に書きました。
なお、Git のフォルダの外で動かすと、Not inside a trusted directory and --skip-git-repo-check was not specified. と言われて、終了コード 1 で止まりました。Git のフォルダでない場所で使うときは、--skip-git-repo-check を付けます。
権限:ファイルを書かせるとき
-s(--sandbox)で、権限を決めます。選べる値は、read-only・workspace-write・danger-full-access の3つです。
read-only:読むだけ。既定です
workspace-write:作業フォルダの中なら書ける
danger-full-access:制限なし。外側で別の守りがあるとき以外は、使いません
「このフォルダに hello.txt を作って」と頼んで、試しました。
既定(read-only)では、書けない
既定のままだと、「読み取り専用のため作成できませんでした」という答えでした。ただし、経過を見ると、この PC では、書き込みを止められる以前に、コマンドの起動そのものが失敗していました(次の節)。read-only が書き込みを止めるかどうかは、コマンドが動く状態では、試していません。
この PC で出たエラー
-s workspace-write を付けても、最初は書けませんでした。経過に、次のエラーが出ていました(書き込みは apply patch の失敗でした)。
Failed to create unified exec process: helper_unknown_error: setup refresh had errorsコマンドを動かす段階で、失敗しています。私の設定ファイル(~/.codex/config.toml)には、[windows] の下に sandbox = "elevated" と書いてありました。原因が、この設定にあるのかは、確かめていません。
直し方として、-c(設定をその場で上書き)で、windows.sandbox を unelevated にしました。
codex exec -s workspace-write -c 'windows.sandbox="unelevated"' --skip-git-repo-check "このフォルダに hello.txt を作って、中に「こんにちは」とだけ書いてください。"こうすると、コマンドが動き、hello.txt ができて、中身は「こんにちは」でした(14秒)。同じ症状が出る方は、試してみてください。ただし、unelevated が、元の設定と同じ強さで守ってくれるのかは、確かめていません。私は、一時フォルダの中の作業だけで使いました。
機械で読む:--json
--json を付けると、標準出力が、1行1イベントの JSON(JSONL)になります。「a.txt の行数を数えて、数字だけ答えてください」と頼んで、出力を見ました(コマンドを動かす依頼なので、この PC では、上の -s workspace-write -c 'windows.sandbox="unelevated"' を付けました)。
イベントの種類と、数は次のとおりでした。
thread.started:1回
turn.started:1回
item.started:2回
item.completed:3回
turn.completed:1回
item の中身は、2種類でした。command_execution(Codex が動かしたコマンド)が、開始と完了で2回ずつ、agent_message(答えの文)が1回です。
最後の turn.completed に、トークンの数が入っています。このときは、こうでした。
{"type":"turn.completed","usage":{"input_tokens":52306,"cached_input_tokens":48384,"cache_write_input_tokens":0,"output_tokens":112,"reasoning_output_tokens":13}}コマンドを動かした回(2回)は、入力が 52,306 トークン(うちキャッシュ 48,384)でした。何も動かさない「1から5までの数字を、カンマ区切りで1行に書いてください」では、入力が 17,099 トークン、出力が 13 トークンでした。頼みが数語でも、約1.7万トークンが毎回載るようです。
読み取りは、1行ずつ JSON として読めば済みます。Python なら、次のようになります。
for line in stdout.splitlines():
e = json.loads(line)
if e["type"] == "item.completed" and e["item"]["type"] == "agent_message":
answer = e["item"]["text"]答えの形を決める:--output-schema
答えを JSON の形で受け取りたいときは、JSON スキーマのファイルを作って、--output-schema に渡します。
{
"type": "object",
"properties": {
"title": {"type": "string"},
"difficulty": {"type": "string", "enum": ["easy", "normal", "hard"]},
"steps": {"type": "array", "items": {"type": "string"}, "minItems": 3, "maxItems": 3}
},
"required": ["title", "difficulty", "steps"],
"additionalProperties": false
}codex exec --output-schema schema.json "「味噌汁を作る」という作業を、title・difficulty・steps(3つ)にまとめてください。"標準出力には、スキーマどおりの JSON が出ます。同じ依頼を10回くり返して、形が合っているかを確かめました(キーがちょうど3つ、difficulty が3つの値のどれか、steps がちょうど3つ)。10回中10回、合っていました。1回あたり 7.0〜8.8 秒でした。なお、途中で使用量の上限に当たったので、最初の2回と、上限が戻ってからの8回に分けて、合計10回です。
つまずき:additionalProperties
additionalProperties: false の無いスキーマ(a という文字列だけを持つ、最小のもの)で、動かしました。終了コードは 1 で、次のエラーでした。
Invalid schema for response_format 'codex_output_schema': 'schema.additionalProperties' is required to be supplied and to be false when strict is true.additionalProperties: false は、必ず書きます。私の試験では、required に全部のキーを入れていました。入れ子のオブジェクトにも、同じ指定が要るのかは、試していません。
最後の答えをファイルに:-o
-o(--output-last-message)で、最後の答えをファイルに書けます。「日本の首都を、都市名だけで答えてください」で試すと、標準出力にも出て、指定のファイルにも「東京」が入りました。答えをファイルで受け取りたい、標準出力の流れと分けたい、というときに使えます。
標準入力から渡す
長い依頼文や、ファイルの中身を渡すときは、標準入力が使えます。2つの形を試しました。
プロンプトを - にする:依頼文のすべてを、標準入力から渡す。「1+1 はいくつですか。数字だけ答えてください。」を渡すと、答えは「2」でした
プロンプトと標準入力の、両方を使う:依頼は引数で、材料は標準入力で渡す。「次の文章を、10文字以内の題名にしてください」と引数に書き、標準入力に文章を渡すと、「画面不要のAI作業」と返りました。標準入力の内容は、<stdin> のブロックとして、依頼の後ろに足されるそうです(ヘルプの説明です)
標準エラーに Reading additional input from stdin... と出ることがあります。スクリプトからは、- を使うか、標準入力を空にして呼ぶのが確実です(標準入力を開いたままにしたときの動きは、試していません)。
終了コードの見方
ここは、自動化で大事な所です。試した結果は、次のとおりです。
終了コード 1 になったもの
存在しないモデル名(-m):「The 'no-such-model-xyz' model is not supported when using Codex with a ChatGPT account.」
存在しない作業フォルダ(-C):「指定されたファイルが見つかりません。 (os error 2)」
存在しないスキーマのファイル:「Failed to read output schema file …」
Git のフォルダの外で、--skip-git-repo-check なし
スキーマの書き方の誤り(上の additionalProperties)
使用量の上限:「You've hit your usage limit. … try again at 1:17 AM.」
終了コード 0 になったもの
普通に答えが返った
仕事が、できなかったのに 0:ファイルを読めなかった回でも、終了コードは 0 でした(答えの文に「確認できませんでした」と書かれていました)
つまり、終了コード 0 は、「起動して、答えが返ってきた」という意味です。仕事が成功したかどうかは、終了コードでは分かりません。自動化では、答えの中身(たとえば --output-schema で ok のような項目を持たせる)や、作ったファイルの有無を、スクリプトの側で確かめる必要があります。
使用量の上限は、この記事の実験の途中で、実際に当たりました。短い依頼を11回ほど出したところで、当たりました。同じ時間帯に、同じアカウントで、画像づくりなどの重い作業が別に動いていました。そのため、短い依頼が何回で当たるのかは分かりません。自動化で回数が多いときは、終了コード 1 と、標準エラーの文を、ログに残してください。
会話をつなぐ:resume
前の会話の続きをするには、codex exec resume です。
「合言葉は『みかん』です。覚えてください。『了解』とだけ答えて。」→「了解」
codex exec resume --last --skip-git-repo-check "合言葉は何でしたか。合言葉だけ答えて。" → 「みかん」(10.9秒。Git のフォルダの外なので --skip-git-repo-check を付けました)
--last は、直前の会話です。会話の ID を指定することもできます。
つまずきが1つありました。exec resume には、-s(サンドボックス)のオプションが渡せません。error: unexpected argument '-s' found と言われて、終了コード 2 になりました。権限は、前の会話の設定が引き継がれるのだと思います(私は確かめていません)。
会話を残さない:--ephemeral
--ephemeral を付けると、会話の記録をディスクに残しません。~/.codex/sessions の下のファイルの数で確かめました。普通に1回動かすと 1,024 個から 1,025 個に増え、--ephemeral で1回動かしても 1,025 個のままでした。毎回の記録が要らない定期実行には、合っています。ただし、resume はできなくなります。
例:題名の案を3つ作るスクリプト
ここまでをまとめて、記事の本文から題名の案を3つ作る Python のスクリプトを書きました。標準入力から依頼を渡し、答えの形をスキーマで決め、-o でファイルに受け取り、失敗したら終了コードを見て止めます。
"""記事の本文から題名の案を3つ作る。codex exec を画面なしで呼び、答えを JSON で受け取る
使い方: python codex_titles.py 記事.txt
"""
import json
import os
import shutil
import subprocess
import sys
import tempfile
from pathlib import Path
CODEX = os.environ.get("CODEX_BIN") or shutil.which("codex")
SCHEMA = {
"type": "object",
"properties": {
"titles": {"type": "array", "items": {"type": "string"}, "minItems": 3, "maxItems": 3},
"best": {"type": "integer", "minimum": 1, "maximum": 3},
},
"required": ["titles", "best"],
"additionalProperties": False,
}
def ask(text):
if not CODEX:
sys.exit("codex が見つかりません。環境変数 CODEX_BIN に codex の場所を書いてください")
with tempfile.TemporaryDirectory() as tmp:
tmp = Path(tmp)
(tmp / "schema.json").write_text(json.dumps(SCHEMA, ensure_ascii=False), encoding="utf-8")
prompt = ("次の記事の題名の案を、検索されやすい語を先頭に置いて3つ作ってください。"
"それぞれ40字以内にします。best は、いちばん良い案の番号(1〜3)です。\n\n" + text)
cmd = [CODEX, "exec", "--skip-git-repo-check", "--ephemeral", "-s", "read-only",
"-C", str(tmp), "--output-schema", str(tmp / "schema.json"),
"-o", str(tmp / "last.json"), "-"]
r = subprocess.run(cmd, input=prompt, capture_output=True, text=True, encoding="utf-8", timeout=180)
if r.returncode != 0:
sys.exit(f"codex が失敗しました(終了コード {r.returncode}):\n{r.stderr[-400:]}")
data = json.loads((tmp / "last.json").read_text(encoding="utf-8"))
return data
if __name__ == "__main__":
body = Path(sys.argv[1]).read_text(encoding="utf-8")
d = ask(body)
for i, t in enumerate(d["titles"], 1):
mark = "★" if i == d["best"] else " "
warn = " ← 40字を超えています" if len(t) > 40 else ""
print(f"{mark} {i}. {t}({len(t)}字){warn}")作業フォルダ(-C)は、毎回作る空の一時フォルダにして、作業の起点だけを絞っています。ただし、-s read-only でも、パソコンの中のほかのファイルは読めます(Codex の会話の記録で、読み取りの権限が確認できました)。秘密のファイルを読ませたくないときは、-C だけに頼らず、置き場所を考えてください。
私の環境で、この前に書いた記事(Claude Code の /compact の記事)の要約の文(約170字)を渡して動かした結果です(7.7秒、終了コード 0)。
★ 1. Claude Codeの会話が長いと費用は増える?20往復で検証(32字)
2. Claude Codeの費用を検証:/compactでどう変わる?(33字)
3. Claude Codeの会話要約で費用減、失われる情報は?(29字)2回動かして、どちらも3つの案が、40字以内で返りました(9.4秒、7.7秒)。案の良し悪しは、人が決めてください。AI の出した題名は、検索語が入っているか、中身と合っているかを、自分の目で確かめるのがよいと、私は考えています。
動かす前に、CODEX_BIN(Windows なら、codex.exe のある場所)を設定するか、codex に PATH を通してください。CODEX_BIN の場所が間違っていると、Python の FileNotFoundError で止まります。
時間と使用量の目安
私の環境での数字です。
短い依頼:1回あたり 5〜12秒ほど(4.8〜11.8秒)。スキーマつきの10回は 7.0〜8.8 秒
土台:入力が 17,100〜17,700 トークンほど(頼みが数語でも)
推論の強さ:同じ問題(「1から200までの整数のうち、3でも5でも割り切れない数は何個」。正解は107)を、-c model_reasoning_effort="low" と "high" で2回ずつ試すと、全部正解でした。推論のトークンは low が 16、high が 20〜25 で、時間は low が 7.6〜11.5 秒、high が 9.6〜11.8 秒でした。この簡単な問題では、差ははっきりしませんでした
Codex の使用量は、ChatGPT のアカウントの枠で数えられます。Claude Code の枠とは別の数え方で、何回で上限に当たるかは、私は測り切れていません。
Claude Code の claude -p との違い
同じように画面なしで動かす、Claude Code の claude -p との違いを、使った感じで並べます(claude -p は、「Claude Codeを自動実行する方法」の記事に書きました)。
機械で読む形:Claude Code は --output-format json、Codex は --json(1行1イベント)
答えの形を決める:Claude Code は --json-schema、Codex は --output-schema(ファイルを渡す)
権限:Claude Code は --permission-mode と許可・禁止のルール、Codex は -s の3つのモード
会話をつなぐ:Claude Code は --resume ID、Codex は exec resume --last
終了コード:どちらも、仕事の成否は別に確かめる必要がある
注意点と限界
測ったのは、Windows 11 と Codex CLI 0.162.0-alpha.17.2 の1つの環境です。版が違うと、オプションや出力が変わることがあります
exec のヘルプに載っていても、試していないものがあります。主なものは、次のとおりです:review・fork・--add-dir・--worktree・-i(画像)・-p(プロファイル)・--oss・--ignore-user-config・--ignore-rules
スキーマは、浅いオブジェクトだけを試しました。深い入れ子や、oneOf のような複雑な形は、試していません
windows.sandbox="unelevated" が、元の設定と同じ強さで守るのかは、確かめていません
使用量の上限は、1回当たっただけで、回数の目安は分かりません
この記事のスクリプトは、題名の案を作るだけの小さなものです。実際に使うときは、依頼文と、結果を確かめる処理を、自分の用途に合わせて足してください
まとめ
codex exec "依頼"。答えは標準出力、ヘッダーと経過は標準エラー。既定は read-only で承認は never
書かせるなら -s workspace-write。この PC では -c 'windows.sandbox="unelevated"' が必要だった
機械で読むなら --json、形を決めるなら --output-schema(additionalProperties: false が必須)、答えをファイルにするなら -o
終了コード 0 は「答えが返った」だけ。仕事の成否は、答えの中身で確かめる
続きは exec resume --last、記録を残さないなら --ephemeral
次の一歩は、codex exec --skip-git-repo-check -s read-only "今日の日付を聞かれたら何と答えますか" のような短い依頼を、1回だけ動かして、標準出力と標準エラーの違いを見ることです。1分で、できます。
次に読む
Codexの承認モードとサンドボックスの設定(無料):approval_policy・sandbox_mode と config.toml
Claude Codeを自動実行する方法(無料):claude -p の使い方・JSON出力・上限の決め方
Codexの使い方・始め方入門(無料):インストールから最初の依頼まで
CodexとClaude Codeの違いを比較(無料):使い分けと併用のしかた
Claude Code・Codex エラー全網羅パック(¥9,800):Windowsで動かない・フック・自動実行を症状別に
Claude Codeを“社員”にする自動実行ボードの設計図(¥1,280):自動実行を回す仕組みの設計
このアカウントをフォローすると、Claude Code や Codex の新しい手順の記事が届きます。ぜひフォローしてください。
この先で分かること(今後の有料記事)
codex exec を、毎日決まった時刻に動かして、失敗を検出するスクリプトの全文
画像づくりを codex exec で量産するときの、依頼文の書き方と失敗の直し方
使用量の上限に当たったときの、再開のしかた
まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。テンプレートや指示文をまとめて使いたい方はご覧ください。