- このページで分かること
- 実践ログ化で大事なこと
- 記事化する流れ
- 実践ログ化テンプレート
- やってはいけないこと
- 公開前チェックリスト
- 関連ページ
このページで分かること
Codexの作業報告は、その場の完了確認だけでなく、実践ログ型ガイドの記事素材にもなります。ただし、自動公開はせず、人間が確認し、一般化し、匿名化してから公開する必要があります。
実践ログ化で大事なこと
- 作業報告をそのまま公開しない
- 実ドメイン名や案件名を出さない
- 内部の保存場所を出さない
- 秘密情報を出さない
- 作業パターンとして一般化する
- 読者が使える指示文とチェックリストに直す
記事化する流れ
報告書を読む
変更内容、確認結果、未確認事項を見る。
転用可否を判断する
一般化して役立つ作業か確認する。
伏せる情報を消す
固有名詞や内部情報を一般化する。
指示文に変える
次回使える依頼文へ整える。
チェックリスト化する
読者が再利用できる確認項目にする。
実践ログ化テンプレート
転用可否:
理由:
記事タイトル案:
一般化した作業内容:
公開してよい表現:
伏せるべき情報:
使ってはいけない表現:
次回使える指示文テンプレート:
確認チェックリスト:
関連ページ:
記事化する場合のURL案:
注意点:「日記」と「実践ログ」の分かれ目
同じ作業記録でも、読者に価値があるかどうかは書き方で決まります。分かれ目は「読んだ人が自分の作業に持ち帰れるものがあるか」です。
| 日記になってしまう書き方 | 実践ログになる書き方 | |
|---|---|---|
| 出来事 | 「今日は404エラーを直した」 | 「404の原因は大文字小文字の違いだった。同じ症状ならまずここを疑う」 |
| 手順 | 「Codexに頼んだらやってくれた」 | 「この指示文で頼んだら1回で通った」と実際の指示文を載せる |
| 失敗 | 「うまくいかなくて大変だった」 | 「この指示だと範囲が広がりすぎた。絞る書き方に変えたら安定した」 |
| 結論 | 「無事終わってよかった」 | 「次回も使えるチェックリストはこの5項目」 |
コツは、書く前に「この記事を読んだ人が、明日の自分の作業で何をコピーできるか」を1つ決めることです。コピーできるもの(指示文、チェックリスト、原因の切り分け表)が1つもない記事は、内容がどれだけ詳しくても日記側に落ちます。逆に、短い記事でもコピーできるものが1つあれば実践ログとして成立します。
やってはいけないこと
- 作業報告をそのまま貼る
- 内部情報を残す
- 秘密情報の有無を確認しない
- 結果保証の表現にする
- 読者が再利用できない日記で終える
公開前チェックリスト
- 匿名化した
- 一般化した
- 伏せる情報を消した
- 禁止表現を確認した
- 指示文テンプレートがある
- 確認チェックリストがある
- 関連ページへリンクした
- 人間が確認した
Codex の機能で作業の記録を残す
実践ログの材料は、作業が終わってから思い出して書くより、作業中に残る記録から拾うほうが正確です。Codex CLI には、記録を残す・続きから再開する仕組みがあります。公式の説明で確かめた範囲を、用途ごとに並べます。
| したいこと | 使うもの(公式の説明) | ログ化での使い道 |
|---|---|---|
| 作業の流れを機械で読める形で残す | codex exec --json:状態が変わるたびに1行ずつの JSON(改行区切り)で出力する | どの順で何をしたかを、あとで並べ直す材料にする |
| 前の作業の続きをする | codex exec resume --last:今いるフォルダの最新のセッションを選ぶ。--all を付けると全部のセッションから探す | 同じ作業の記録を1本につなげる |
| 同じ所から別のやり方を試す | codex exec fork <SESSION_ID>:保存したセッションを新しいセッションに写す | 2つのやり方の結果を比べる記事の材料にする |
| 対話で続きをする | codex resume:IDで指定するか、最新の会話を再開する | 人が見ながら進めた作業の記録をつなげる |
codex exec は、公式の説明では、人の操作なしで終わる作業(スクリプトや CI のような使い方)のためのコマンドです。記録をそのまま記事に貼るのではなく、ここから「やったこと」「確かめたこと」「止まった所」を拾って、上の実践ログ化テンプレートに書き直します。
記録を記事にする前に伏せるもの
| 記録に出やすいもの | なぜ伏せるか | 書き換え方 |
|---|---|---|
| 自分のパソコンのフォルダの場所(ユーザー名を含む) | 名前や環境が分かってしまう | ~/project のような一般的な形に直す |
| APIキー・token・.env の中身 | 貼った時点で漏れたのと同じになる | 記事には一切書かない。記録に残っていたらキーを作り直す |
| お客様のサイト名や URL | 依頼主の情報になる | 「あるサイト」「example.com」に置き換える |
| エラーの全文 | 長いほど上の3つが混ざりやすい | 原因の分かる1〜2行だけを残す |
出典:OpenAI 公式「Codex CLI のコマンド」(2026年11月6日に確認)。画面やコマンドは変わることがあるため、使う前に公式のページをご確認ください。
最後の報告をファイルに決まった形で残す
記録の材料を集めるだけでなく、Codexの最後の報告そのものをファイルにする方法もあります。codex exec の公式の説明では、進み具合は標準エラーに流れ、最後のメッセージだけが標準出力に出ます。ログに使える指定は次のとおりです。
| 指定 | 公式の説明 | ログでの使い方 |
|---|---|---|
-o / --output-last-message | 最後のメッセージをファイルに書き、標準出力にも出す | 報告を1作業1ファイルで残す |
--output-schema | JSON Schemaに合う形で最終の応答を求める | 「変更したファイル」「未確認」などの項目を固定する |
--ephemeral | セッションの記録ファイルをディスクに残さない | 記録を材料にしたい作業では付けない |
公式の例は、--output-schema でスキーマのファイルを渡し、-o で結果のファイルを指す形です。項目を決めておけば、作業ごとのログが同じ並びになり、あとで比べやすくなります。
ログの一部を材料に渡すこともできます。標準入力で内容を渡し、あわせて依頼文を書くと、依頼文が指示、渡した内容が追加の文脈として扱われます。
出典:OpenAI Codex ドキュメント Non-interactive mode(2026年11月6日に確認)。右の列は当サイトの使い方の例です。
編集部の作業記録を時系列で確認
2026年11月8日の記録では、最初にCodex CLI 0.167.0をnpmで導入し、ChatGPT Plusのログインを使いました。プラン欄はplusと表示されました。同日の0時から11時台に、編集部の道具からCodexを94回呼び、1回あたりの中央値は27.6秒でした。担当させたのは、ほかのAIが出した校正指摘とサイトの実ファイルを照合する役です。指摘された文がファイル内にあるかを判定させ、その判定から、21の会場ページにあった出典の会場名の誤りを見つけて直しました。
同じ日にはGroq、Gemini、Copilot、OpenRouter、Ollamaも道具から使いましたが、Codexはファイルを開いて確かめる役に置きました。昼前に5時間枠が99%となり、上限を知らせる表示が出た後、2026年11月8日14時すぎまで利用できませんでした。そのとき週の枠は15%でした。94回の内訳は記録にないため不明です。
