OpenAI の公式の説明(下の「公式のページ」)を、内容を足さずに読みやすい日本語に書き直したものです。公式の翻訳ではなく、OpenAI が作ったものでもありません。公式は予告なく変わるので、使う前に公式のページもご覧ください。
このページで分かること
- 指示に入れておくとよい4つのこと(目標・手がかり・守ること・終わりの条件)と、難しい作業で先に計画を立てさせるやり方
- 毎回同じことを書かずに済ませる道具(AGENTS.md・設定・スキル・Scheduled tasks)を、どの順で使っていくか
- 公式が挙げている、使い始めにありがちな失敗
先に知っておく言葉
- 指示(プロンプト):ChatGPT や Codex に送る質問・指示・目標
- コンテキスト:Codex が作業中に使える情報。ファイル、それまでのやり取り、道具の結果、指示など
- リポジトリ:プログラム一式の置き場所(ふつうの意味)
- 計画(Plan):作業を終えるために Codex が立てる、または進み具合を追う手順
- AGENTS.md:Codex にずっと守ってほしい決まりを書いておくファイル
- config.toml:Codex の設定ファイル
- サンドボックス:Codex が動かす命令が、読んだり書き換えたりできる範囲の囲い
- MCP(Model Context Protocol):Codex を外の道具や情報につなぐための決まった方式
- スキル:指示と、必要ならスクリプトや資料をまとめて、使い回せるようにしたもの
- Scheduled tasks:決めた時刻や決まった間隔で、ChatGPT に指示を動かさせる仕組み
- ワークツリー(worktree):同じリポジトリを、もう1か所に取り出したもの。並行して作業するときに使います
- サブエージェント:作業の一部を受け持つために立ち上げる、手伝い役の Codex
最初の指示に入れる4つのこと
公式は、指示がきれいに書けていなくても Codex は役に立つ、としています。そのうえで、大きいコードや失敗できない作業では、はっきり書くほど結果が安定するとしています。基本として入れる4つは次のとおりです。
- 目標:何を変えたいか、何を作りたいか
- 手がかり:関係するファイル・フォルダ・資料・見本・エラー。ファイルは
@を付けて名前を書くと、手がかりとして指せます - 守ること:従ってほしい決まり・作りの方針・安全のための条件
- 終わりの条件:たとえば、テストが通る、動きが変わる、不具合が起きなくなる、など。何が満たされたら終わりかを書きます
ほかに、公式は次のこともすすめています。
- モデル:アカウントと使う入口で使えるなら GPT-6.1 Sol を選び、考える深さは最初に選ばれているものから始めます。GPT-6 Luna なら High、GPT-6 Astra なら Light(設定ファイルでは low)から始め、作業と結果を見て変えます。目安は、範囲のはっきりした速く済ませたい作業は Low、込み入った変更や不具合調べは Medium か High、長く自分で進めさせる考えどころの多い作業は Extra High です
- 声で伝える:デスクトップアプリでは、打ち込む代わりに音声入力で指示を伝えると、手がかりを早く渡せます
難しい作業は、先に計画を立てさせる
込み入っている・はっきりしない・言葉にしにくい作業では、コードを書き始める前に計画を立てるよう指示します。やり方は次のとおりです。
- Plan mode:公式は、ほとんどの人にいちばん簡単で効き目がある、としています。Codex が情報を集め、分からない所を質問してから計画を作ります。
/planか Shift+Tab で切り替えます - 質問してもらう:やりたいことがぼんやりしているときは、先に自分に質問するよう指示します。思い込みを問いただし、具体的な形にしてもらいます
決まりは AGENTS.md に書いておく
うまくいった指示の型は、毎回書く代わりに AGENTS.md に移します。AGENTS.md は自動で読み込まれます。
- 書くとよいこと:フォルダの構成と大事な場所、動かし方、組み立て・テスト・書き方の点検の命令、作り方の決まり、してはいけないこと、何をもって終わりとし、どう確かめるか
- 置き場所:自分用は
~/.codex、リポジトリ全体用、その中のフォルダ用と、段を分けて置けます。今いる場所に近いほうの決まりが優先されます - 育て方:短く正確に保ちます。決まりは、同じ間違いが続いたときに足します。Codex が同じ間違いを2回したら、ふり返りをさせて AGENTS.md を直します。大きくなったら、話題ごとに別のファイルへ分けて AGENTS.md から指します
設定と、聞かずに進める範囲
- いつも使う自分の設定は
~/.codex/config.tomlに置きます。デスクトップアプリでは Settings > Configuration > Open config.toml から開けます。リポジトリだけの設定は.codex/config.tomlに置きます。CLI・IDE 拡張機能・デスクトップアプリは同じ設定を共有します - 聞かずに進める範囲を決めるつまみは2つです。命令を動かす前に許可を求める場面を決めるもの(approval mode)と、どのフォルダやファイルを読み書きできるかを決めるもの(sandbox mode)です
- 公式のすすめは、慣れないうちは最初の権限のまま狭く保ち、信頼できるリポジトリや決まった作業で、要ることがはっきりしてから広げることです
- 作業する場所の違い・書き込み権限の不足・モデルの初期設定の違い・道具やつなぎ込みの不足など、出来の悪さの多くは準備の問題だ、と公式は書いています。早めに実際の環境に合わせます
変更を確かめさせる
変更させて終わりにせず、必要ならテストを作らせ、確かめを動かし、結果を確認し、受け入れる前に見直させます。何が「よい」かを指示か AGENTS.md で伝えておけば、Codex がこの流れを自分で回せます。
- デスクトップアプリ:差分(変更の一覧)の画面を開いて変更を見られます。行を押して書いた意見は、次の Codex の作業の手がかりになります
/review:変更の点検をさせる命令です。まだ記録していない変更や1つの記録など、点検する相手を選べます
外の情報は MCP でつなぐ
要る情報がリポジトリの外にあるときに使います。デスクトップアプリでは Settings > MCP servers で、自分で足したものとおすすめを見られます。多くの場合、入れるのを Codex に手伝ってもらうこともできます。公式は、最初からすべてをつながず、手作業でよくくり返している所をなくせる1つか2つから始めるよう、すすめています。
くり返す作業はスキルに、決まった作業は Scheduled tasks に
- スキル:長い指示や同じやり取りを毎回くり返さないよう、手順を
SKILL.mdにまとめます。1つのスキルには1つの仕事だけを持たせ、具体的な使い方2〜3個から始めます。説明文には、何をするか・いつ使うか・使う人が実際に言いそうな言葉を書きます。最初の版は$skill-creatorで作り、手元で直してから、広く配るときにプラグインにします - Scheduled tasks:手順が安定したら、デスクトップアプリの Scheduled のページから作ります。プロジェクト・指示・間隔と、専用のワークツリーで動かすか手元で動かすかを選びます。指示からスキルを呼べます。公式の整理では、やり方を決めるのがスキル、いつ動かすかを決めるのが Scheduled tasks です。まだ細かく舵を取る必要がある作業は、先にスキルにします
会話の分け方
- 会話には手がかりや決めたことが積み重なるので、公式は分け方が出来に大きく効くとしています。まとまった1つの仕事ごとに1つの会話にします。同じ問題の続きなら、考えの流れが残るので同じ会話のほうがよいことが多い、としています。分かれ道になったときだけ分けます
- デスクトップアプリでは、会話を上に留めたり、ワークツリーを作ったりできます
- 範囲の決まった作業(調べもの・テスト・仕分けなど)はサブエージェントに任せ、もとの会話は中心の問題に集中させます
公式が挙げている使いどころ
公式のページに書いてある向き・使い方だけを並べます。
- MCP が向くとき:要る情報がリポジトリの外にある/情報がよく変わる/貼り付けた説明より道具を使わせたい/人やプロジェクトをまたいで同じつなぎ方をくり返したい
- スキルが向く仕事:たとえば、更新内容のお知らせの下書き、チェックリストに沿った点検、決まった不具合調べの手順など、くり返す仕事。同じ指示を使い回したり、同じ流れを何度も直したりしているなら、スキルにするとよい、としています
- Scheduled tasks が向く作業:たとえば、最近の変更のまとめ、不具合らしき所の洗い出し、朝会用のまとめ、決まった分析。実行だけでなく、最近の会話を見直してつまずきをまとめ、指示や設定を直していく用途にも使うよう、すすめています
- 使い始めにありがちな失敗:ずっと守る決まりを指示に詰め込む(AGENTS.md かスキルへ)/組み立てやテストの動かし方を伝えず、Codex が結果を確かめられない/手順の多い作業で計画を飛ばす/流れを分かる前にパソコン全体の権限を渡す/ワークツリーを使わずに同じファイルで並行して作業する/手で動かして安定する前に Scheduled tasks にする/1歩ずつ見張る相手として扱い、自分の作業と並行させない/プロジェクト全体を1つの会話で進める
あわせて読む
公式のページ
- Best practices(うまく使うコツ、英語。公式の日本語版はありません)learn.chatgpt.com ↗
確認メモ:2026年10月1日に、上の公式ページ(英語)を開いて、指示に入れる4つのこと・モデルと考える深さの目安・設定ファイルの置き場所・画面の名前を1つずつ突き合わせました。公式のページに更新日の表示は無いため、この日付は「このサイトが確かめた日」です。CLI だけで使う命令(AGENTS.md のひな形を作る /init、/resume・/fork・/compact など)、計画の型(PLANS.md)、/review の点検の相手の細かい種類、点検の決まりのファイル(code_review.md)と GitHub Cloud でのプルリクエストの自動の点検、スキルを置くフォルダの場所、MCP の方式の種類(STDIO と Streamable HTTP)と CLI での足し方、設定の切り替え(プロファイル)や作業ごとの上書き、OpenAI の社内での点検の割合、スキルと Scheduled tasks の向く仕事の例の一部(記録の仕分け・移し替えの計画・CI の失敗の確認など)は、デスクトップアプリで使うのに要らないため載せていません。「リポジトリ」の言い換えは、公式の用語集に無く、ふつうの意味を一言で添えたものです。用語集の「Plan」は Codex が立てる手順のことで、このページの「Plan mode」はそれを先に作らせる切り替えとして書いています。