Codexアプリを実務で使うための応用編。プロジェクトとフォルダ管理、Local/Worktree/Cloud、skills、plugins、MCP、hooks、rules、automations、設定、隠れ機能、公式アップデート確認先までを実例中心に整理。
準備編で「開く、頼む、確認する」まで進んだ人向けに、ここでは実際の運用を組みます。プロジェクトの分け方、フォルダの置き方、AGENTS.md、.codex/config.toml、skills、plugins、MCP、hooks、rules、automations、レビュー、ブラウザ確認、公式更新の追い方までを、仕事で使う前提でまとめます。
公式確認: OpenAI Developers Codex Docs、 Codex公式サイト、 Codex for work、 Codex Changelog、 Feature Maturity、 Codex for every role, tool, and workflow を参照。新機能の一次確認先として X: @OpenAI、 X: @OpenAIDevs、 OpenAI News、 openai/codex Releases も掲載します。
上の動画は実践編の要点を短く見せるスライド動画です。講師が長尺で収録する場合は、以下の台本に沿って各章を画面共有し、プロジェクトフォルダ、設定ファイル、レビュー画面、ブラウザ確認の順に見せます。
毎回の依頼文を長くするのではなく、プロジェクトにルールを置き、繰り返す作業をskillにし、危険な作業をhooks/rulesで止め、定期作業をautomationに回します。
C:\VSCode\Project\
ai-hub\
AGENTS.md # このプロジェクトのCodex向けルール
.codex\
config.toml # プロジェクト固有のCodex設定
hooks.json # 共有する自動チェック
rules\
default.rules # 許可、確認、禁止するコマンド
.agents\
skills\
lecture-builder\
SKILL.md # 受講資料を作る手順
publish-check\
SKILL.md # 公開前チェックの手順
plugins\
marketplace.json # repo内のpluginカタログ
content\
lectures\ # 編集ソース
assets\ # 画像、PDF、動画素材
site\
build_site.py # ビルド
dist\ # 生成物
docs\
operations\ # 運用手順
outputs\
reports\ # 定期出力
.env # 秘密情報。見せない、コミットしない
AIハブ、みんなのWA、N-Designのように事業ごとにProjectを分けます。違う事業の秘密情報や方針が混ざらないようにします。
「受講資料を作る」「公開前レビュー」「Vercelデプロイ確認」のように、会話の目的を分けます。あとで検索しやすくなります。
トップページ刷新、管理画面変更、依存関係更新などはWorktreeに逃がします。Localで作業中の状態を壊さず試せます。
| 層 | 置き場所 | 何を書くか | 実例 |
|---|---|---|---|
| Prompt / Thread | 今の会話 | 一回限りの条件、今日だけの判断、止めたい範囲 | 「今回は公開しない」「まず調査だけ」「日本語で説明」 |
| AGENTS.md | repo rootや下位フォルダ | 毎回守るプロジェクトルール、ビルド、検証、禁止事項 | 「site/build_site.pyで再ビルド」「本番確認URLを報告」 |
| .codex/config.toml | projectまたはuser | model、reasoning、sandbox、approval、MCP、feature flags | workspace-write、on-request、web_search、memories |
| skills | .agents/skills or ~/.agents/skills | 繰り返し使う作業手順 | 受講資料作成、PRレビュー、週次レポート |
| plugins | Plugin Directory / marketplace | skills、apps、MCP serversをまとめた道具箱 | Google Drive、Figma、Canva、GitHub、Data Analytics |
| MCP | config.toml or plugin | 外部ツール、DB、ブラウザ、社内ツールへの接続 | OpenAI Docs MCP、Figma MCP、Playwright MCP、Sentry MCP |
| hooks | hooks.json or config.toml | 作業前後に自動で走るチェック | PreToolUseで危険コマンド検査、Stopで完了ログ |
| rules | .codex/rules/*.rules or ~/.codex/rules | sandbox外コマンドのallow / prompt / forbidden | gh pr viewはprompt、rmはforbidden |
| automations | Codex sidebar | 定期実行、監視、リマインド、同じthreadへの戻り | 毎週金曜の進捗要約、PR状態確認、サイト更新確認 |
| memories | ~/.codex/memories | 過去の作業から引き継ぐ傾向、好み、注意点 | 「この人は日本語説明を好む」「このrepoはVercel本番確認まで」 |
| 用語 | 講習での説明 | 使う場面 |
|---|---|---|
| Codex app | デスクトップで複数のCodex作業を並行管理する中心画面。 | 日常の実務、レビュー、ブラウザ確認、automation管理。 |
| Codex CLI | terminal-firstのCodex。コマンドで実行、設定、確認する。 | 開発者がCLIで高速に作業する時。 |
| IDE Extension | VS Codeなどのエディタと連動するCodex。 | 開いているファイルの文脈を使って直す時。 |
| Codex web / Cloud | Webやcloud environmentでリモートに実行するCodex。 | 手元PCから切り離して作業する時。 |
| Project | Codexが作業するフォルダ単位。 | 事業、アプリ、資料集ごとに分ける。 |
| Thread | ChatGPTのchatに近い、1つの作業会話。 | 目的ごとに分けて履歴検索する。 |
| Local | 現在のプロジェクトフォルダを直接使うmode。 | すぐ確認したい小さな作業。 |
| Worktree | Git worktreeを使う別作業場。 | 大きな変更、並行作業、automation。 |
| Cloud | remote/cloud environmentで実行するmode。 | セットアップ済み環境で実行したい時。 |
| Handoff | threadをLocalとWorktreeの間で移す流れ。 | 背景で作った変更を手元に持ってくる。 |
| Codex-managed worktree | Codexが軽量に作る使い捨て寄りのworktree。 | 1スレッド1作業場で試す。 |
| Permanent worktree | 長く使うworktreeをプロジェクト化したもの。 | 継続的な検証環境や別ブランチ作業。 |
| Detached HEAD | worktreeがまだブランチ名を持たず、特定commit上で作業している状態。 | Codexが複数worktreeを作る時の初期状態。 |
| Review pane | Git diffを見て、stage/revert/commentできる画面。 | 採用判断、差分確認、公開前レビュー。 |
| Diff panel | 変更差分を見るパネル。 | 変更内容の読み合わせ。 |
| Inline comments | diffの行に直接つける修正指示。 | 「ここだけ直して」を精密に伝える。 |
| Stage / Unstage / Revert | 採用、採用解除、取り消し。 | 一部だけ採用したい時。 |
| Commit / Push / PR | 変更を履歴に残し、GitHubへ送り、Pull Requestを作る。 | 公開前の通常開発フロー。 |
| Integrated terminal | thread内の組み込みterminal。 | build、test、git status、dev server。 |
| Local environments | worktree用setup scriptsやactionsを定義する設定。 | npm install、build、dev server起動をボタン化。 |
| Setup scripts | worktree作成時に自動実行する環境準備。 | 依存関係install、初期build。 |
| Actions | よく使うコマンドをCodexアプリ上部のボタンにする。 | Run、Test、Build、Preview。 |
| In-app browser | Codex内ブラウザ。ログイン不要ページの確認向け。 | localhost、file preview、公開ページ確認。 |
| Browser use | Codexがin-app browserをクリック、入力、スクショ確認する機能。 | 表示崩れ再現、画面操作テスト。 |
| Browser comments | 画面上の場所にコメントをつける機能。 | ボタン、カード、グラフの具体的修正。 |
| Chrome extension | ログイン済みChromeをCodexが使うための拡張。 | Gmail、Salesforce、会員画面、社内ツール。 |
| Computer Use | Windows/macOSアプリを見て、クリックし、入力する機能。 | GUIだけで再現する不具合、デスクトップアプリ確認。 |
| Appshots | macOSの前面ウィンドウをCodex threadへ送る機能。 | 画面の状態を見せて相談する。 |
| Command menu | Cmd/Ctrl+Kなどで開くコマンドメニュー。 | 設定、pet、reload skills、各種操作。 |
| Slash commands | /で呼ぶ操作コマンド。 | /plan、/goal、/review、/status、/mcp、/feedback。 |
| /plan | 複数手順の計画モード。 | 大きな作業を始める前。 |
| /goal | 持続的な完了目標を設定する。 | 長い作業を完了条件まで走らせる。 |
| /review | コードレビューを開始する。 | 未コミット変更やPR差分の確認。 |
| /status | thread ID、context、rate limitsなどを確認。 | 長い作業の状態確認。 |
| /mcp | MCP serverの接続状態を確認。 | FigmaやDocs接続が動かない時。 |
| /feedback | ログ付きでフィードバックを送る。 | Codex自体の不具合報告。 |
| $skill | skillを明示起動する書き方。 | $skill-creator、$imagegen、$my-skill。 |
| @plugin | pluginやconnectorを明示して使う書き方。 | @Chrome、@Browser、@Canvaなど。 |
| Steer | Codex実行中に途中で軌道修正する操作。 | 「やっぱり削除でなく書き換えにして」。 |
| Voice dictation | 声でpromptを入力する機能。 | 長い依頼を話して入力。 |
| Floating pop-out window | 会話を別ウィンドウに出す機能。 | ブラウザやエディタ横に置く。 |
| Deep links | codex://でCodex内の画面を開くURL。 | codex://settings、codex://skills、codex://automations。 |
| Codex pets | 進行中作業を見せる任意の小さな表示。 | バックグラウンド作業の状態確認。 |
| Profile | 活動insights、tokens、streaksなどを見る設定領域。 | 利用状況を確認する。 |
| Personalization | Friendly / Pragmatic / Noneやcustom instructions。 | 話し方と個人ルールの調整。 |
| Context-aware suggestions | 戻るべき作業候補を出す機能。 | 中断した仕事の再開。 |
| Archived threads | アーカイブ済みthread一覧。 | 過去作業の復元。 |
| Memories | 過去threadから有用な文脈を引き継ぐ機能。 | 好み、注意点、技術スタックの再利用。 |
| Chronicle | 画面文脈からmemoryを補助するresearch preview。 | 対応環境で最近の作業文脈を拾う。 |
| Automations | 定期実行や監視をCodexに任せる機能。 | 毎朝brief、週次報告、PR確認。 |
| Triage | automation結果の受信箱。 | 新しい発見があったrunを確認。 |
| Standalone automation | 毎回独立して走るautomation。 | 週次レポート、複数project監視。 |
| Project automation | 特定projectで走るautomation。 | サイト更新確認、依存関係チェック。 |
| Thread automation | 同じthreadへ戻るheartbeat型automation。 | デプロイ待ち、PRチェック、長いレビュー。 |
| Custom schedule / cron | 任意の実行スケジュール。 | 毎週月曜9時、毎日17時など。 |
| AGENTS.md | Codexが作業前に読むproject guidance。 | 毎回守るルール、検証、公開条件。 |
| AGENTS.override.md | 一時的または近い階層の上書き指示。 | 特定フォルダだけルールを変える。 |
| project_doc_fallback_filenames | AGENTS.md以外の名前を指示ファイルとして読む設定。 | TEAM_GUIDE.mdを使っているrepo。 |
| config.toml | Codexの主要設定ファイル。 | model、sandbox、approval、MCP、feature flags。 |
| CODEX_HOME | Codexの設定、認証、state、memoriesの基準フォルダ。 | 個人用とautomation用のprofile分離。 |
| Project trust | project-local .codexを読み込んでよいかの信頼判断。 | 安全なrepoだけproject hooks/configを有効化。 |
| Profiles | 名前付き設定layer。 | deep-review、fast-scanなどを切り替える。 |
| Feature flags | optional/experimental機能のON/OFF。 | hooks、memories、multi_agent、undoなど。 |
| Sandbox | Codexがコマンド実行時に触れる範囲。 | 安全に自動作業させる。 |
| read-only | 読むだけのsandbox mode。 | 調査、レビュー、初見repo。 |
| workspace-write | workspace内を書ける標準的mode。 | 通常の実装作業。 |
| danger-full-access | sandbox制限を外す強いmode。 | 理解している高度作業だけ。 |
| Approval policy | いつCodexが許可を求めるか。 | untrusted、on-request、never。 |
| approvals_reviewer | 許可判断を誰が見るか。 | userまたはauto_review。 |
| Auto-review | 承認要求をreviewer agentに回す仕組み。 | 低中リスクの承認を自動評価。 |
| Permissions | read/write/deny、network、profilesでアクセスを定義。 | .env deny、docs read、workspace write。 |
| rules | コマンドprefixのallow/prompt/forbidden。 | 安全なghコマンドだけ許可。 |
| prefix_rule | rulesで使うコマンドprefix定義。 | ["gh","pr","view"]をpromptにする。 |
| hooks | agent loopの節目に自作scriptを差し込む仕組み。 | 秘密情報検査、検証、ログ、memory作成。 |
| PreToolUse | tool使用前のhook event。 | 危険コマンドを事前確認。 |
| PermissionRequest | 許可要求時のhook event。 | 承認理由を検査。 |
| PostToolUse | tool使用後のhook event。 | 結果ログや追加検査。 |
| UserPromptSubmit | ユーザーprompt送信時のhook event。 | 秘密情報貼り付け防止。 |
| Stop | turn停止時のhook event。 | 完了ログ、継続判断。 |
| PreCompact / PostCompact | context圧縮前後のhook event。 | 長期作業の記録補助。 |
| SubagentStart / SubagentStop | subagent開始/終了時のhook event。 | 並行調査のログ管理。 |
| Skills | Codexが再利用する作業手順。 | SKILL.md、scripts、references。 |
| Progressive disclosure | 必要になるまでskill本体を読まない仕組み。 | contextを節約する。 |
| Explicit invocation | $skill-nameで明示的に呼ぶ。 | 確実に特定skillを使う。 |
| Implicit invocation | descriptionに合う時にCodexがskillを選ぶ。 | 自然文で作業を頼む。 |
| agents/openai.yaml | skillのUI表示、policy、dependenciesを補足するmetadata。 | アイコン、default prompt、MCP依存。 |
| Plugins | skills、apps、MCP serversをまとめる配布単位。 | チームやworkspaceに共有。 |
| Plugin Directory | Codex app内のplugin一覧。 | Curated by OpenAI、Shared with you、Created by you。 |
| Marketplace | plugin catalog。 | repoや個人でplugin配布。 |
| Apps / Connectors | GitHub、Gmail、Google Driveなどの認証済み接続。 | 私的データや業務ツールを扱う。 |
| MCP servers | Model Context Protocolで外部tool/contextをつなぐserver。 | Figma、Docs、Playwright、Sentry。 |
| STDIO server | ローカルコマンドとして起動するMCP server。 | npxで起動するdeveloper docs serverなど。 |
| Streamable HTTP server | URLで接続するMCP server。 | remote MCP、OAuth連携。 |
| OAuth / bearer token | MCPやappの認証方式。 | Google、Figma、社内ツール。 |
| Server instructions | MCP serverが返す全体指示。 | tool利用の順序や制約。 |
| Web search | Codexのfirst-party web search。 | cached / live / disabledを使い分ける。 |
| Image generation | thread内で画像生成や編集を行う機能。 | UI素材、バナー、背景、placeholder。 |
| Subagents | 並行して別agentに調査やレビューを任せる機能。 | セキュリティ、テスト、保守性を分担。 |
| Main agent | 判断と統合をする中心agent。 | 最終方針と成果物をまとめる。 |
| Agent thread | subagent側のthread。 | 並行調査の詳細確認。 |
| Sites | Codexで作ったinteractive website/appをURL共有する新機能。 | workspace向けdashboard、planner、hub。 |
| Annotations | 作成物の一部を指して修正する仕組み。 | site、documents、spreadsheets、slidesの局所修正。 |
| Feature Maturity | 機能のExperimental / Beta / Stableなどの成熟度。 | 本番運用に使う前の確認。 |
| Changelog | Codexの変更履歴。 | 受講資料の更新、機能追加確認。 |
| plugin/connector | 使う理由 | 実務プロンプト例 |
|---|---|---|
| GitHub | PR、issue、review、CI確認。 | @GitHub このPRの未対応コメントを確認し、修正候補を重大度順に出して。 |
| Google Drive | Docs、Sheets、Slidesの社内資料を使う。 | @Google Drive 最新の講習メモを探し、今週のスライドに使える項目をまとめて。 |
| Gmail | メール文脈を使った返信や要約。 | @Gmail 今日の未返信メールから、返信が必要なものだけ下書きして。 |
| Google Calendar | 予定、会議準備、日次brief。 | @Google Calendar 明日の予定を見て、準備が必要な会議だけ箇条書きにして。 |
| Figma | デザイン読み取り、画面案、プロトタイプ。 | @Figma この画面案を営業資料向けに整理して、実装時のUI注意点を出して。 |
| Canva | SNS投稿、資料、ブランド素材。 | @Canva この受講内容からInstagram用告知画像を3案作って。 |
| Browser | localhostやfile previewを確認。 | @Browser http://localhost:3000 を開いて、モバイル表示の崩れを確認して。 |
| Chrome | ログイン済みChromeが必要なサイト。 | @Chrome 管理画面にログイン済みの状態で、この設定ページの表示を確認して。 |
| Computer Use | Windows/macOSアプリのGUI操作。 | @Computer このデスクトップアプリを開き、設定画面の文言崩れを確認して。 |
| OpenAI Developers | OpenAI公式docs確認。 | @OpenAI Developers Codexのhooksとrulesの違いを公式docsで確認して。 |
| Vercel | Next.js、deploy、環境変数、ログ確認。 | @Vercel 本番deployの失敗理由を確認し、修正箇所を特定して。 |
| Supabase | DB schema、SQL、Storage、RLS。 | @Supabase このテーブルのRLSを読んで、管理画面の更新権限を確認して。 |
| Shopify | Admin GraphQL、Liquid、Hydrogen、POS。 | @Shopify 商品メタフィールドのGraphQL更新案を公式docsに沿って作って。 |
| 公式plugin | 何を任せるか | 実例 |
|---|---|---|
| Data analytics | 分析、原因調査、KPI、dashboard、report。 | 売上CSV、GA4、GSC、メモを渡して、週次KPIレポートを作る。 |
| Creative production | 広告、商品画像、campaign board、制作案。 | 新講習の告知文、画像案、SNS投稿をまとめる。 |
| Sales | 商談準備、follow-up、優先顧客、forecast。 | 顧客メモとメール履歴から、次回提案の論点を作る。 |
| Product design | プロトタイプ、user flow、画面改善、Figma連携。 | 管理画面のスクショから、改善案と実装タスクを作る。 |
| Public equity investing | 上場企業調査、決算分析、投資仮説。 | 決算資料とニュースを読んで、投資仮説の変化を整理する。 |
| Investment banking | M&A、pitch、比較会社、diligence。 | 買収候補リストから、初期pitch資料の構成を作る。 |
UserPromptSubmitでAPIキーらしき文字列を検出し、貼り付けを止める。PreToolUseで危険な削除コマンドを検査する。Stopで「確認したこと」をログに残す。
毎回使う安全なコマンドはrulesでpromptまたはallowに寄せます。危険なコマンドはforbiddenにします。rulesは「外へ出るコマンド」の門番です。
| 種類 | 使う時 | プロンプト例 |
|---|---|---|
| Thread automation | 同じ会話で継続確認したい。 | このthreadに30分後戻って、Vercel deployが完了しているか確認し、失敗ならログを見て次の修正案を出して。 |
| Standalone automation | 毎回独立してよい定期作業。 | 毎週金曜17時に、今週の受講資料変更、未完了タスク、次週の候補を短い週報にしてTriageへ出して。 |
| Project automation | 特定projectを定期確認する。 | 毎朝8時にこのAIハブprojectを確認し、受講資料、トップページ、AI Watch出力に新しい差分があれば要約して。 |
| Skill-driven automation | 形式を固定したい。 | 毎週月曜に $publish-check を使い、site/distの主要ページと公式更新URLの確認結果をレポートして。 |
| 設定/機能 | 見落としがちな価値 | 使い方 |
|---|---|---|
| Prevent sleep while running | 長い作業中にPC sleepで止まる事故を減らす。 | Settings > General。 |
| Detail level | 作業ログを詳しく見るか、会話をすっきりさせるかを選ぶ。 | 初心者はDefault、検証時はCoding mode。 |
| Keyboard Shortcuts | よく使う操作を覚えると作業が速い。 | Command menu、toggle terminal、find in thread。 |
| Git settings | branch naming、force push、commit/PR文の生成方針を揃える。 | チームで命名ルールを固定。 |
| Browser use allowlist/blocklist | Codexが触ってよいサイトを制御する。 | localhostは許可、機密サイトは必要時だけ。 |
| Computer Use allowlist | どのアプリをCodexに触らせるか管理する。 | 信頼するアプリだけAlways allow。 |
| Personalization | Friendly / Pragmatic / Noneで話し方を調整。 | 実務ではPragmaticが向く。 |
| Custom instructions | 個人の既定指示を入れる。 | ただしプロジェクト必須ルールはAGENTS.mdへ。 |
| Context-aware suggestions | 再開すべき作業を提案してくれる。 | 中断が多い運用で有効。 |
| Memories | 過去の傾向を引き継ぐ。 | ONにする前に、秘密情報を入れない運用にする。 |
| Archived threads | 閉じた会話を戻せる。 | 過去の受講資料作成threadを探す。 |
| Deep links | Codex画面へ直接移動するURL。 | codex://settings、codex://skills、codex://automations。 |
| codex://plugins/install | plugin install flowを開く。 | チーム導入資料にリンクを貼る。 |
| codex://threads/new?prompt=&path= | 特定folderとpromptで新規threadを開始。 | 講習の演習リンクを作る。 |
| Appshots hotkey | 前面アプリをすぐCodexへ共有。 | macOSで画面状態を説明する手間を減らす。 |
| Codex pets | 進行中のCodex状態を小さく表示。 | background taskを見失わない。 |
| 確認先 | URL | 見るタイミング |
|---|---|---|
| Codex公式サイト | https://openai.com/codex/ | 全体像、対応OS、代表機能を説明する前。 |
| OpenAI Academy Codex | https://openai.com/academy/codex-for-work/ | 非エンジニア向けの実務例を探す時。 |
| OpenAI Developers Codex Docs | https://developers.openai.com/codex | 設定名、機能名、公式用語を確認する時。 |
| Codex Changelog | https://developers.openai.com/codex/changelog | 受講資料を更新する時、新機能を確認する時。 |
| Feature Maturity | https://developers.openai.com/codex/feature-maturity | Experimental / Beta / Stableを判断する時。 |
| Codex role/plugin発表 | https://openai.com/index/codex-for-every-role-tool-workflow/ | role-specific plugins、Sites、annotationsを説明する時。 |
| X: OpenAI | https://x.com/OpenAI | OpenAI全体の大きな発表を追う時。 |
| X: OpenAI Developers | https://x.com/OpenAIDevs | Codex、API、SDK、開発者向け更新を追う時。 |
| OpenAI News | https://openai.com/news/ | 製品横断の公式発表を追う時。 |
| openai/codex Releases | https://github.com/openai/codex/releases | CLIやオープンソース側のreleaseを追う時。 |