Codexの消費量が気になると、「できるだけ短く頼んだほうが軽いのでは」と考えがちです。
私も最初はそう考えていました。
ただ、実際には短文でも重くなる依頼があります。
逆に、少し長くても軽く進む依頼もあります。
結論から言うと、ポイントは文の短さではありません。
Codexが迷わず動けるように、条件をはっきり渡すことです。
この記事では、OpenAI公式の考え方を土台にしながら、Codexの無駄を減らしやすい依頼文の作り方をやさしく整理します。
Codexの消費量は「文章の長さ」だけでは決まらない
いまのCodexは、依頼を読んで終わりではありません。
ファイルを読み、必要なら編集し、ツールやコマンドを使いながら進みます。
この流れでは、最初の依頼があいまいだと探索範囲が広がります。
探索範囲とは、「どのファイルを見て、どこまで直すか」の範囲です。
範囲が広いほど、確認も往復も増えます。
その結果、消費量も上がりやすくなります。
つまり、重くなりやすい原因は「長文」そのものではなく、「判断に迷うこと」です。
短文でも重くなる依頼と、長めでも軽くなる依頼
短い依頼でも、次のような形だと重くなりやすいです。
- 全体を見て、いい感じに改善して
- バグを直して
- 必要そうなところを全部見て
これらは短いですが、目的も対象も終わり方も不明です。
Codexは広く探す必要が出ます。
一方で、次のような依頼は少し長くても動きやすいです。
src/auth/login.tsとsrc/ui/LoginForm.tsxだけ確認する- ログイン失敗時にエラーメッセージが出ない不具合だけ直す
- API仕様は変更しない
npm test -- loginが通れば完了
この形なら、見る場所とやること、やらないこと、終わり方が最初から決まっています。
そのぶん無駄な探索が減ります。
OpenAI公式の考え方でも、重要なのは明確な文脈と完了条件
OpenAIのCodex向け資料でも、明確な文脈と完了条件が重要だと案内されています。
これは難しい話ではありません。
要するに、次の2つを先に決めるということです。
- 何をやるのか
- どこまでできたら終わりか
この2つが弱いと、Codexは途中で判断を増やしやすくなります。
判断が増えると、確認回数も修正回数も増えます。
だから、消費量を抑えたいときは「短く書く」より「迷わせない」が先です。
Codexが重くなりやすい依頼文の特徴
次の依頼は、実務では特に重くなりやすいです。
「いい感じに」が入っている
「いい感じに」は便利な言葉ですが、条件としては弱いです。
見た目なのか、速度なのか、保守性なのかがわかりません。
対象ファイルが決まっていない
対象がないと、どこまで読むべきかが広がります。
たった一言でも、裏では大きな探索になります。
調査と実装を一度に頼んでいる
「原因を調べて、設計を見直して、必要なら直して」は一見効率的です。
ただ、判断の段階が多く、途中で広がりやすい依頼でもあります。
まず調査、次に実装、と分けたほうが安定します。
完了条件が書かれていない
完了条件がないと、「どこまでやれば終わりか」が人にもAIにもわかりません。
その状態は、作業が長引きやすいです。
Codexを動かしやすくする依頼文の4要素
依頼文は、次の4つがあるだけでかなり整理されます。
1. 目的
何を直すか、何を作るかを1文で書きます。
例: ログイン失敗時にエラーメッセージが表示されない不具合を直す。
2. 対象
見る場所を指定します。
例: src/auth/login.ts と src/ui/LoginForm.tsx のみ確認する。
3. 制約
やってほしくないことを先に書きます。
例: APIは変更しない。デザインは触らない。最小修正にする。
4. 完了条件
どこまでできたら終わりかを書きます。
例: エラー文言が表示される。既存テストが落ちない。追加テスト1件が通る。
この4つがそろうと、依頼はかなり安定します。
そのまま使える依頼文テンプレート
最初は、次の型をそのまま使えば十分です。
> 目的:
> 対象:
> 制約:
> 完了条件:
たとえば、こう書けます。
> 目的: ログイン失敗時の表示不具合を直す
> 対象: src/auth/login.ts と src/ui/LoginForm.tsx
> 制約: APIは変更しない。最小修正にする
> 完了条件: エラーメッセージが正しく表示され、npm test -- login が通る
これだけでも、かなり迷いが減ります。
毎回同じ指示はAGENTS.mdにまとめる
毎回同じことを書くなら、AGENTS.md に寄せるほうが効率的です。
OpenAIのガイドでも、Codexは作業前に AGENTS.md を読む前提で案内されています。
たとえば、次のような内容は AGENTS.md と相性がいいです。
- テスト実行コマンド
- 変更してはいけないディレクトリ
- コーディング規約
- レビュー時に重視する観点
共通ルールを AGENTS.md に出しておけば、毎回の依頼文は短くできます。
しかも、必要な条件は落ちにくくなります。
使用量そのものの見方を先に確認したいときは、Codex使用量の確認方法 を先に開くとつながりやすいです。
結論。Codexの消費量が気になるなら、短くするより迷わせない
Codexの消費量を抑えたいなら、まず見直すべきは文字数ではありません。
依頼の設計です。
大事なのは次の3つです。
- 曖昧な言い方を減らす
- 目的・対象・制約・完了条件を書く
- 共通ルールは
AGENTS.mdにまとめる
この3つを実践すると、無駄な探索と手戻りが減ります。
結果として、Codexは軽く、安定して動きやすくなります。
「短くする」より「枠を決める」。
まずはここから始めるのが実務では効きます。
FAQ
Q1. Codexは短文で依頼したほうがいいですか？
Q2. 最低限どこまで書けばいいですか？
Q3. AGENTS.mdは必須ですか？
Q4. 調査と実装は分けたほうがいいですか？
Q5. CLI とアプリで依頼文の考え方は変わりますか？
Q6. 最初の1本だけ依頼文を直すならどこですか？
まずは 完了条件 です。終わり方が曖昧だと、目的や対象が合っていても作業が伸びやすいです。長い作業なら Codex Appでゴールを設定して完成まで持っていく方法 もつながります。
Q7. Appで3本並行するときも同じ型で書いたほうがいいですか？
はい。同じ型のほうが見比べやすいです。目的 / 対象 / 制約 / 完了条件 をそろえるだけで、どのスレッドが何で止まっているかを追いやすくなります。並列運用の感覚は CodexアプリとCodex CLIの違い もつながります。
Q8. 毎日3本ずつ記事を直すなら、依頼文で最初に固定するのは何ですか？
最初は 今日はこの3本 を固定するのが近いです。そのうえで各本に title / excerpt / 冒頭 / 内部リンク / FAQ のどれを触るか を1個ずつ書くと迷いにくいです。並列の持ち方は CodexアプリとCodex CLIの違い 、残量確認は Codex Usage URLはどこ？使用量を見るページとBillingとの違い もつながります。
Q9. 毎日3本ずつ記事を直すなら、2本目と3本目も同じ深さで頼むべきですか？
同じ深さにしなくて大丈夫です。1本目を少し深く、2本目と3本目を軽くするほうが回しやすい日もあります。残量確認は Codex Usage URLはどこ？使用量を見るページとBillingとの違い 、完了条件まで固定するなら Codex CLIの /goal の使い方。長い作業を「終わるまで進める」新機能 もつながります。
Q10. 毎日3本ずつ記事を直すなら、3本目はどの粒度まで軽くすると回しやすいですか？
FAQ1問か内部リンク1本くらいで十分です。3本目まで同じ重さにしないほうが続きやすいです。残量確認は Codex Usage URLはどこ？使用量を見るページとBillingとの違い 、見た目確認の線は Codexアプリでブラウザ操作を使うなら、内部ブラウザとChromeプラグインをどう選ぶか もつながります。
Q11. 毎日3本ずつ記事を直すなら、3本の依頼文は同じ書き出しでそろえたほうがいいですか？
そろえたほうが見比べやすいです。今日はこの1本で何を直すか の形だけそろえるだけでも十分です。見た目確認の線は Codexアプリでブラウザ操作を使うなら、内部ブラウザとChromeプラグインをどう選ぶか 、残量確認は Codex Usage URLはどこ？使用量を見るページとBillingとの違い もつながります。
Q12. 毎日3本ずつ記事を直すなら、goal 用の文と個別依頼文は分けたほうがいいですか？
分けたほうが見やすいです。最初に goal で全体を置き、そのあと各1本を短く書く形が回しやすいです。見た目確認の線は Codexアプリでブラウザ操作を使うなら、内部ブラウザとChromeプラグインをどう選ぶか 、goal 側の書き方は Codex Appでゴールを設定して完成まで持っていく方法 もつながります。
Q13. 毎日3本ずつ記事を直すなら、3本目だけ依頼文をもっと短くしていいですか？
大丈夫です。3本目は FAQを1問足す のような短い形でも十分回ります。見た目確認の線は Codexアプリでブラウザ操作を使うなら、内部ブラウザとChromeプラグインをどう選ぶか 、goal 側の書き方は Codex Appでゴールを設定して完成まで持っていく方法 もつながります。
Q14. 毎日3本ずつ記事を直すなら、1本目だけ少し深く頼む日は残り2本の依頼文はどこまで省略していいですか？
対象記事 と 今日触る1か所 だけでも十分です。2本目と3本目まで同じ説明量にしないほうが続きやすいです。残量確認は Codex Usage URLはどこ？使用量を見るページとBillingとの違い 、終わり方の置き方は Codex Appでゴールを設定して完成まで持っていく方法 もつながります。
