Codex CLIの入力を整える

Codex CLIへ長い依頼を書いていると、対象ファイルや条件を直すだけでも手間がかかります。この記事では、外部エディターで依頼文を整える方法と、PowerShellのコマンド補完を一時的に試す方法を分けて紹介します。アプリの入力欄ではなくCLIが対象です。

長文は送信前に構造を整える

まず、次のように内容を三つに分けます。入力補助を変える前でも使える方法です。

目的：READMEの導入手順を分かりやすくする
対象：README.mdだけ。コードや設定は変更しない
完了条件：前提、実行場所、成功確認が読み取れること
最初は不足箇所を挙げ、まだ編集しないでください。

送る前にファイル名と「まだ編集しない」の範囲を確認します。前回の依頼の不要な条件が混ざっていないかも読み直してください。

各段階で確認してから、次の操作へ進みます。

図解Codex CLIの入力を整える：進める順番

具体的な依頼と、結果の確かめ方は本文にあります。

入力しやすくする設定と、実際に送る文章の内容確認は別の工程です。

公式資料では、CLIの入力欄で Ctrl+G を押すと外部エディターが開きます。使用するエディターは VISUAL、未設定なら EDITOR で指定します。保存して閉じると、文章が入力欄へ戻ります。CLI customization

利用中のエディターを確認してから設定してください。ここでは普段使っているエディター名を決めつけて一括設定せず、現在の指定を見る例を示します。PowerShellに入力します。

$env:VISUAL
$env:EDITOR

何も出ない場合は、そのPowerShellでは変数が未設定の可能性があります。エディターによって「閉じるまで待つ」ためのオプションが必要です。起動できるだけでなく、保存した文章がCLIへ戻ることまで確認します。

戻った本文を確認してから送信します。エディターを閉じたことを、Codexへ依頼が送信されたことと混同しないでください。Ctrl+Gによる実際の往復操作は本記事では未検証です。

コマンド補完は、PowerShellで codex の引数などを入力しやすくする機能です。Codexに送る日本語を自動で完成する機能ではありません。

最初は専用の練習フォルダーで、既存ファイルと重ならないことを確認して補完スクリプトを作ります。

codex completion powershell > codex-completion.ps1

出力されたファイルを開き、Codexコマンド用の補完登録であることを確認してから、このウィンドウへ読み込みます。

. ./codex-completion.ps1

読み込み後、codex に続けて引数を書き、Tabの候補を確かめます。PowerShellの実行ポリシーで拒否された場合は、無条件にポリシーを変更せず管理方針を確認してください。

今回はプロファイルへ追加しません。動作を戻す際はそのPowerShellを閉じて開き直します。既存のプロファイルでも同じ補完を読み込んでいるなら、そちらの設定も区別して調べます。補完ファイルの生成と構文は編集環境で確認し、実際のTabキー操作は未検証として扱います。

依頼そのものを見直す場合はタスクの伝え方、CLI導入はCLIを始めるへ進みます。