デスクトップ版、CLI、Skills、AGENTS.md、Record & Replay------日常的に頻繁に使うテクニックから高度な設定まで、Codexを「使える」状態から「あなたを理解する」状態へと進化させましょう。
目次
- 一、はじめに:デスクトップ版こそが大多数の人にとっての主戦場
- [二、デスクトップ版 Codex:箱から出してすぐに使えるグラフィカルなワークベンチ](#二、デスクトップ版 Codex:箱から出してすぐに使えるグラフィカルなワークベンチ)
- [三、CLI版 Codex:ターミナルギークのための高度な武器](#三、CLI版 Codex:ターミナルギークのための高度な武器)
- [四、AGENTS.md 作成ガイド:Codexにあなたを本当に理解させる](#四、AGENTS.md 作成ガイド:Codexにあなたを本当に理解させる)
- [五、Skillsエコシステム:どこで探すか、どう選ぶか、どう取捨選択するか](#五、Skillsエコシステム:どこで探すか、どう選ぶか、どう取捨選択するか)
- [六、Record & Replay:Mac ユーザーのための「一度録画すれば一生使える」](#六、Record & Replay:Mac ユーザーのための「一度録画すれば一生使える」)
- 七、日常的な活用テクニックとショートカットキー
- 八、まとめ
一、はじめに:デスクトップ版こそが大多数の人の主戦場
OpenAI Codex には現在、3つの形態があります:デスクトップアプリ (macOS + Windows)、CLI (ターミナルコマンドライン)、IDE 拡張機能 (VS Code など)の3つの形態があります。2026年2月にデスクトップ版が正式リリースされ、3月にはWindows版が登場しました――それ以来、グラフィカルなデスクトップアプリが、大多数の開発者にとっての主力エントリポイントとなっています。
本記事では、デスクトップ版をデフォルトの視点として内容を構成するとともに、CLIユーザー向けに別途1章を設けています。どの形態を使用する場合でも、中核となる機能(Skills、AGENTS.md、MCP、Automations)は共通しています。
現在の最新モデル:GPT-5.5(2026年4月23日リリース)。デスクトップ版とCLIの両方で利用可能です。CodexはGPT-5.3-CodexおよびGPT-5.3-Codex-Spark(後者は1000+ token/sの速度を実現)にも対応しています。
2. デスクトップ版 Codex:箱から出してすぐに使えるグラフィカルなワークベンチ
デスクトップ版のコンセプトは「すべてをクリック操作で」------設定ファイルを手動で編集する必要はほとんどありません。左下のアバター/歯車アイコンをクリック → Settings を選択すれば、すべての設定がGUI上で行えます。
2.1 デスクトップ版 Settings の概要
| 設定カテゴリ | 主要なオプション | 推奨設定 |
|---|---|---|
| General | 実行中のスリープ防止 | ✅ オン------長時間かかるタスク中にPCがスリープ状態になると、Codexが中断されます |
| General | Detail level | Coding modeを選択------Codexが具体的にどのコマンドを実行したかを確認できます |
| General | Follow-up behavior | オン------Codexがタスクを完了した後、「他に何かお手伝いしましょうか?」と自動的に尋ねます |
| Configuration | Approval policy | On request------ファイルの変更やコマンドの実行に関わる場合、同意を求める |
| Configuration | Sandbox mode | Workspace write------Codexはワークスペース内で自由に読み書きできますが、外部へは出られません |
| 設定 | モデル | 選択 GPT-5.5(Pro/Maxユーザー)、日常使用時は「High」の推論強度 |
| パーソナライゼーション | パーソナリティ | Pragmatic(簡潔で率直)または Friendly(より親しみやすい) |
| パーソナライゼーション | カスタム指示 | 最も重要な項目------下記 2.2 参照 |
| 外観 | テーマ | ライト/ダーク/システム、および色覚障害者に配慮したテーマ |
| 外観 | アバター | フローティングアバターを設定可能。Codexがバックグラウンドでタスクを実行している間、デスクトップ上に表示されます |
2.2 パーソナライゼーション------カスタム指示を簡潔かつ効率的に記述する方法
デスクトップ版へのアクセス方法:設定 → パーソナライゼーション → カスタム指示。
ここに記述した内容は、~/.codex/AGENTS.md(グローバルレベル)に書き込まれ、このマシン上のすべてのプロジェクトのすべてのセッションに影響を与えます。そのため、真に汎用的なルールのみを記載してください。
簡潔かつ効率的なための基本原則:
| ❌ 以下のように記述しないでください | ✅ 以下のように記述してください |
|---|---|
| 「できるだけ高品質で、ベストプラクティスに沿ったコードを書くようにしてください」 | 「TypeScriptの厳格モード、anyの使用禁止;Reactの関数コンポーネント + Hooks」 |
| 「細部に至るまで真剣に取り組む」 | 「コードの修正後、自動的に pnpm typecheck && pnpm lint を実行する」 |
| 「適切なエラー処理方法を使用する」 | 「API 層では統一して Result<T, AppError> パターンを使用し、生の例外をスローしない」 |
| 長文のアーキテクチャドキュメント | プロジェクトの docs/ ディレクトリに配置し、必要に応じて @docs/arch.md で参照する |
実用的なグローバルカスタムディレクティブの例:
## コミュニケーション
- 回答は中国語で、コードのコメントは英語で
- まず解決策の概要(2~3文)を提示し、その後でコードを書く
- アーキテクチャの決定に関わる場合は、選択肢とトレードオフを列挙し、私に選択させる
## コーディング規約
- TypeScriptの厳格モードを使用し、`any`は禁止
- TODOコメントは書かない------完全に実装するか、PRの説明欄に記載する
- 新しい依存関係をインストールする前に必ず私に確認する
- コード内に秘密鍵やトークンをハードコーディングしてはならない
## セキュリティ
- .env および production の設定ファイルは変更しない
- データベースのマイグレーションに関わる場合は、必ず事前に確認すること
覚えやすいフレーズ :カスタムコマンドは AI へのラブレターではなく、あなたが AI に提示する操作リストです。各項目は検証可能であるべき------「完了後にコマンドを実行して、それがルールに準拠しているか確認できるか?」
2.3 デスクトップ版独自の機能:プラグイン、オートメーション、マルチエージェント
デスクトップ版には、CLIにはない、あるいは操作感が大きく異なる機能がいくつかあります:
| 機能 | 用途 | エントランス |
|---|---|---|
| プラグイン | Skills、MCPサーバー、アプリ連携(GitHub、Slack、Notionなど90以上のプラグイン)のワンクリックインストール | 左サイドバーの「Plugins」アイコン |
| Automations | スケジュールされたタスク――例えば毎日9:00にCodexでPRをチェックし、日次レポートを生成 | 左サイドバーの「Automations」アイコン |
| マルチエージェント並行処理 | 複数のエージェントを同時に実行し、異なるタスクを処理 | チャットを作成するだけで自動的に割り当てられます |
| Projects | プロジェクトごとにセッションを整理し、それぞれのコンテキストと設定は独立しています | 左サイドバーの「Projects」 |
| 組み込みターミナル | 各スレッドに独立したターミナルがあり、テストの実行や開発サーバーの起動時にウィンドウを切り替える必要がありません | スレッド内の「Terminal」タブ |
3. CLI版Codex:ターミナル愛好家のための高度なツール
ターミナル操作を好む場合(またはCI/スクリプト内でCodexを使用する必要がある場合)、CLI版ではよりきめ細かな制御が可能です。
3.1 基本的な起動方法
codex # 対話型 TUI を起動
codex 「このプロジェクトを解析」 # 初期プロンプト付きで起動
codex exec 「型をチェック」 # 非対話モード、1回実行後に終了
codex update # 最新版に更新
3.2 CLI のよく使われる引数
| 引数 | 略記 | 機能 | 例 |
|---|---|---|---|
--model |
-m |
モデルの指定 | codex -m gpt-5.5 |
--sandbox |
-s |
サンドボックス設定 | codex -s workspace-write |
--ask-for-approval |
-a |
承認のタイミング | codex -a on-request |
--full-auto |
workspace-write + on-requestワンクリックでの組み合わせ |
codex --full-auto |
|
--image |
-i |
画像の添付 | codex -i error.png 「これを修正」 |
--search |
リアルタイムのオンライン検索を有効化 | codex --search 「最新のAPIを検索」 |
|
--profile |
-p |
プリセット設定(Profile)を読み込む | codex -p review |
--cd |
-C |
作業ディレクトリを指定 | codex -C ./packages/api |
--add-dir |
追加の作業ディレクトリを追加 | codex --add-dir ../shared-lib |
| 書いてはいけない内容 | 理由 | 正しい方法 |
|---|---|---|
| 長文ドキュメント、API リファレンス | コンテキストウィンドウを占有し、ほとんどの場合使用されない | docs/に配置し、必要な場合は @docs/api.md を参照 |
| 秘密鍵とトークン | セキュリティ上のリスクがあり、Gitにコミットされる可能性がある | .envに配置し、Codexによる読み取りを権限設定で禁止する |
| フォーマット規則 (インデント/引用符など) | ツールに自動実行させ、AIに頼らずに遵守させるべき | Prettier/ESLint + Hooks による自動フォーマット |
| 「細部まで真剣に取り組む」といった空虚な言葉 | トークンを消費するだけで実質的な制約なし | 検証可能なコマンドに変更:「 修正後に pnpm typecheck を実行する" |
4.3 上級編:AGENTS.md を継続的に進化させる
「同じミスを2回犯したらルールを追加する」 ----- -Codexで一度ミスを犯したら、セッション中に指摘する。同じミスを二度繰り返したら、
AGENTS.mdに書き込む。
ただし、定期的な整理が必要です------毎月一度見直しを行い、古くなったものや不要になったエントリを削除します。40行の AGENTS.md は、200行のものよりも効果的です。
5. Skills エコシステム:どこで探すか、どう選ぶか、どう取捨選択するか
Skills は Codex の「プラグイン」です――Markdown 形式の再利用可能なコマンドパッケージであり、Codex の起動時にメタデータが自動的に検出され、必要な時にのみ完全な内容が読み込まれます。デスクトップ版と CLI は、同じ Skills ディレクトリ (~/.codex/skills/)を共有しています。
5.1 Skills の基本概念
~/.codex/skills/ ← 個人用 Skills(グローバルで利用可能)
└── my-skill/
└── SKILL.md ← 必須:name、description、トリガー条件、実行手順
└── scripts/ ← オプション:補助スクリプト
└── references/ ← オプション:参考資料
.codex/skills/ ← プロジェクトのスキル(リポジトリを通じてチームと共有)
スキルはプログレッシブ・ディスカバリーを採用しています:起動時には name + description(メタデータ)のみを読み込み、タスクが一致した場合にのみ完全なコマンドを取得します。たとえ50個のスキルをインストールしていても、実際にコンテキストを占有するのはアクティブになっている1~2個だけです。
5.2 Skillsはどこで探せばいい?(一つずつ検証済み)
| プラットフォーム | URL | 説明 |
|---|---|---|
| CocoLoop(中国語) | hub.cocoloop.cn | 中国語対応、CLSセキュリティ評価付き、サードパーティ製スキルストア |
| Firecrawl 厳選 | firecrawl.dev/blog/best-codex-skills | 詳細なレビュー + インストールコマンド + 使用例を含む、2026年まで継続的に更新 |
| Composio トップ10 | composio.dev/content/top-codex-skills | 実際の使用事例でテスト済みの10のスキル |
| LobeHub | lobehub.com/skills | 500以上のスキル、明確な分類、エージェントを横断して汎用的に利用可能 |
| FAOS Marketplace | faosx.ai/ オープンソース | 526個の無料スキル、Apache 2.0ライセンス、エンジニアリング/プロダクト/成長/データを網羅 |
| OpenAI公式チャネル | デスクトップ版のプラグインパネルから検索・インストール | 最も安全、公式審査済み |
| インストーラー方式 td> | セッション内で $skill-installer <名称> |
公式推奨:$skill-installer gh-fix-ci |
| npx 方式 | npx skills add <repo> --skill <name> |
CLI 共通:npx skills add mattpocock/skills --skill handoff |
5.3 検証済みで、長期的に利用価値のあるスキル
以下のスキルは、複数の独立した情報源(Composio、Firecrawl、コミュニティによる評価、YouTubeでの実測)によって検証されています:
| Skill | 用途 | インストール方法 | 推奨理由 |
|---|---|---|---|
| grill-me | ソクラテス式質問法を用いて、あなたの提案に対して60連発の質問を投げかけます | npx skills add mattpocock/skills --skill grill-me |
コードを書く前に要件を明確にし、「完成してから理解が間違っていたことに気づく」という事態を回避 |
| handoff | 現在の会話を引き継ぎドキュメントにまとめ | npx skills add mattpocock/skills --skill handoff |
コンテキストが満杯?ワンクリックでドキュメントを生成し、新しいセッションをシームレスに継続 |
| frontend-design | 「AIによる大量生産」とは異なるフロントエンドUIを生成 | npx skills add vercel-labs/agent-skills --skill frontend-design |
画一的なAIスラップスタイルを回避、週間インストール数11万以上 |
| Firecrawl | オンライン検索 + スクレイピング + クローリング + ブラウザ操作 | npx -y firecrawl-cli@latest init --all --browser |
調査時に最新のドキュメントを確認し、トレーニングデータに頼って当て推量をしない |
| gh-fix-ci | GitHub ActionsのCI失敗を診断・修正 | $skill-installer gh-fix-ci |
CIが失敗しても、自分でログを確認する必要はありません |
| yeet | ワンクリックで stage → commit → push → PR 作成 | $skill-installer yeet |
4回の手動操作を省略 |
| gh-address-comments | PRレビューのコメントを読み取り、一括で修正 | $skill-installer gh-address-comments |
レビューのコメントを一つずつ処理するのは面倒、一括で解決 |
| excalidraw | テキスト記述をフローチャート/アーキテクチャ図に変換 | npx skills add excalidraw/claude-code --skill excalidraw |
「さっき話し合ったマイクロサービスアーキテクチャを図に描いて」 |
| superpowers | サブエージェント駆動の完全な開発ワークフロー | デスクトップ版のプラグインパネルから検索・インストール | TDD + エージェントによるレビュー + 反復開発で、Codexにプロジェクトの骨格を構築 |
| skill-creator | Codexに組み込み:新しいSkillの作成を支援 | インストール不要、直接 $skill-creator |
要件を説明するだけで、完全な SKILL.md |
ミニドラマ :30分間、Codexと決済モジュールのアーキテクチャについて議論し、熱く語り合った。翌日、続きをしようとして開いてみると――コンテキストが満杯になっていた。handoff をインストールした後、
handoffと入力するだけで、すべての意思決定、ToDo、技術選定の理由を含む引き継ぎドキュメントが自動生成され、新しいセッションを開けばそのまま続きから始められ、まるで中断したことがないかのようです。
5.4 Skillsをインストールしすぎた場合はどうすればいいですか?
Skillsは多ければ多いほど良いというわけではありません。15~20個の、本当に頻繁に使用するスキルに絞ることで、最高の体験が得られます。
残す/削除する4つの基準:
| 基準 | 判断ロジック |
|---|---|
| 使用頻度 | 1週間に1回も使わないものは削除 |
| 機能の重複 | 2つのSkillがほぼ同じことを行う場合、より正確な方を残す |
| 組み込み機能で代替可能 | Codexの新バージョンではネイティブ対応されている可能性がある(例:2025年のweb-searchスキルは、2026年には標準搭載済み) |
| メンテナンスの活発度 | 6ヶ月間更新されていないものは、APIが変更されている可能性がある |
実践 :毎月、セッション内で
/skillsと入力し、インストール済みのすべてのスキルを一覧表示させ、一つずつ確認する――名前が聞き慣れないものは即座に削除する。
六、Record & Replay: Macユーザーにとって「一度録画すれば一生使える」
6.1 これは何?
2026年6月18日にリリースされた、CodexのmacOSデスクトップ版限定機能。一言で言えば:Mac上で操作を行うと、Codexがそれを観察・学習し、再利用可能な自動化スキルに変換します。
- ? リリース日:2026年6月18日
- ? プラットフォーム:macOSデスクトップ版限定(Windows / CLIは現時点では未対応)
- ? 地域制限: 欧州経済領域(EEA)、英国、スイスでは現在利用不可
- ? サブスクリプション:ChatGPT Plus(月額20ドル)から
- ? 前提条件:Computer Use + Google Chrome 拡張機能を有効にする必要があります
6.2 どのようなシーンに最適か?
| ✅ 適している | ❌ 適していない |
|---|---|
| 毎月繰り返される経費精算プロセス | 手順が毎回異なる探索的なタスク |
| 固定レポートの定期的なダウンロード | 金融上の機密操作を伴うプロセス |
| テンプレートに基づく動画・記事の公開 | 多量の手作業による判断を要する意思決定 |
| GitHub Issueの標準化された作成 | 1回限りの操作 |
6.3 操作手順
- Codex macOS アプリを開きます
- 左側のサイドバーにある Plugins へ移動し、+ をクリック → Record a skill を選択
- 提案されたプロンプトを確認し、コンテキストを追加して送信
- Codex が画面録画の権限をリクエスト → 承認
- ワークフローのデモを開始(普段通り操作してください)
- 完了したらメニューバーの停止ボタンをクリックするか、「完了しました」と声に出して伝えてください
- Codex が録画を分析 → SKILL.mdを自動生成(編集可能!)
重要なポイント :Record & Replayが生成するのは「ピクセル単位のマクロ記録」ではなく、セマンティックレベルの意図記述------それは、どの座標をクリックしたかを記録するのではなく、あなたが何を達成したいかを理解します。つまり、次回インターフェースのレイアウトが変わっても、それに適応できるということです。
6.4 録画後の編集
生成された SKILL.md は手動で自由に修正可能です------手順の調整、検証条件の追加、入力パラメータの変更など。本質的には単なるテキストファイルであり、手書きの Skill と何ら変わりはありません。ただ、「作成者」があなたの録画データに置き換わっているだけです。
7. 日常的な使用テクニックとショートカットキー
7.1 デスクトップ版/CLI共通のスラッシュコマンド
セッション内で / と入力すると、コマンドパネルが起動します:
| コマンド | 機能 | シナリオ |
|---|---|---|
/model |
モデルを切り替える | 簡単なタスクには軽量モデルを切り替えて、トークンを節約 |
/new |
新しいセッションを開始 | 別のタスクに切り替える |
/resume |
過去の会話を復元 | 昨日のリファクタリングを続行 |
/fork |
現在のポイントから新しい会話を分岐 | 「この案は不確実なので、分岐させて試してみる」 |
/compact |
会話履歴を圧縮 | コンテキストが満杯になりそう |
/side |
質問を素早くバイパス | APIの使い方を調べる。メインの会話に干渉しない |
/status |
現在のモデル、ポリシー、トークン使用量を確認 | 状況を把握 |
/copy |
Codexの直近の完全な出力をコピー | |
/clear |
画面をクリア(新しい会話は作成しない) | |
/skills |
インストール済みのすべてのSkillを一覧表示 | |
/theme |
配色の切り替え | 色覚障害に配慮したテーマに対応 |
7.2 3種類のプレフィックス
| プレフィックス | 機能 | 例 |
|---|---|---|
/ |
スラッシュコマンドまたはカスタムプロンプトの呼び出し | /model gpt-5.5 |
! |
ダイアログをバイパスしてシェルコマンドを直接実行 | ! npm test |
@ |
ファイル/ディレクトリの参照(Glob 対応) | @src/services/UserService.ts |
ヒント :プロンプトで「npm test を実行して結果を分析してください」と記述するのではなく、
!をプレフィックスとしてコマンドを実行するようにしましょう。前者の場合、Codexは直接出力を読み取りますが、後者の場合は対話プロセスを経由するため、トークンを多く消費してしまいます。
7.3 汎用ショートカットキー
| ショートカットキー | 機能 |
|---|---|
EscEsc |
空の入力欄で Esc をダブルクリック:前のメッセージを編集します。さらに押すと以前のメッセージに遡り、Enter を押すとその地点から分岐します |
Ctrl+O |
Codexの最新の完全な出力をコピー |
Ctrl+L |
画面をクリア(会話履歴は保持) |
Tab |
Codexの実行中にTabキーを押す:次のメッセージを入力待ち列に追加 |
Ctrl+C |
現在の生成を中断 |
Ctrl+D |
セッション(CLI)を終了 |
Cmd+, |
デスクトップ版の Settings を開く |
Alt+, / Alt+. |
推論強度を下げる/上げる |
7.4 プロンプトの3つのテクニック
① まずCodexにインタビューしてもらう
プロジェクトにユーザー権限システムを追加したいのですが、詳細はまだ明確になっていません。まずは私に質問して、要件を明確にしてから着手してください。
② 複雑なタスクはまず計画を立てる
UserServiceをリファクタリングする必要があります。まずRFC形式の計画を作成します:戦略の分割、ファイル構造、各ステップのリスクポイント。私が確認してから実行します。
③ 「完了」の基準を定義する
UserProfile コンポーネントを最適化:不要な再レンダリングを削減し、ファーストビューの読み込み時間を 1 秒未満に短縮。既存の 12 個のテストをすべて通過させた。
8. まとめ
Codexの真価はモデルそのものにあるのではなく、それを「育て上げる」ためにどれだけの労力を費やしたかにある。30分かけてAGENTS.mdを作成し、Skillsを選定し、Settingsを調整した開発者は、「箱から出してすぐ使える」状態のユーザーよりも3倍以上効率的になる可能性がある。
優先順位リスト(投入対効果順):
| 優先度 | 投入 | 所要時間 | リターン |
|---|---|---|---|
| ? | デスクトップ版 Settings → Personalization → Custom instructions | 15分 | 会話のたびに恩恵を受ける |
| ? | プロジェクトを作成 AGENTS.md(技術スタック + 検証コマンド + コーディング規約) |
20分 | チームで共有、一度作成すれば継続して利用可能 |
| ? | 設定 → 構成:承認ポリシーとサンドボックスモードを適切に設定 | 5分 | 権限に関するトラブルを回避 |
| 4 | 5~8個の中核となるスキル(handoff、grill-me、firecrawlなど)をインストール | 15分 | 主要なシナリオで効率が倍増 |
| 5 | (Macユーザー)Record & Replayで反復タスクを2つ記録 | 1つあたり10分 | 毎週の機械的な操作時間を削減 |
| 6 | (CLIユーザー)プロファイルを2~3個作成 + config.tomlを最適化 | 10分 | シナリオ切り替えも慌てずに |
| 7 | 毎月Skillsを整理 + AGENTS.mdを見直す | 15分/月 | 設定の劣化を防ぐ |
あなたはツールを購入したのではなく、仮想の同僚を育てているのです。そこに費やした1分1分が、将来のセッションで何倍にもなって返ってきます。
本記事は、Codexの2026年7月時点の最新バージョン(デスクトップアプリ+CLI)に基づいています。現在のデフォルトモデルはGPT-5.5です。一部の機能(Record & Replayなど)には地域やプラットフォームによる制限があります。サードパーティ製のSkillsはコミュニティの開発者によって提供されており、インストール前にセキュリティ評価をご確認ください。詳細については、OpenAI Codexの公式ドキュメントをご参照ください。