1. Codexとは：AIエージェントの基本とChatGPTとの違い [0]

Codexは、PCに直接アクセスしてファイルを読み書きし、タスクを自動実行するAIエージェントであり、ChatGPTのようなチャットボットとは根本的に異なる。

1.1. AIツールの二種類とCodexの位置づけ [0]

  1. ウェブ版チャットボット [10]
    1. ChatGPTやClaudeなどが該当し、ブラウザ内で動作する。[11]
    2. ファイルのアップロード、ダウンロード、整理、最終処理はユーザー自身が行う必要がある。[3]
    3. PCに直接アクセスできないため、ユーザーが手動で作業を完結させる必要がある。[3]
  2. AIエージェント [4]
    1. Codexが該当し、PC内に常駐して動作する。[4]
    2. ユーザーが作業環境を与え、許可された範囲内でファイルの読み書き、ツールの実行、成果物の生成を自律的に行う。[4]
    3. ユーザーによるアップロード、ダウンロード、コピー＆ペーストといった手動作業が不要である。[13]
  3. Codexと類似のAIエージェント [14]
    1. Claude CodeやClaude Coworkも同様のAIエージェントである。[16]
    2. Codexは無料版があり、ChatGPTアカウントがあれば利用できるため、Claude Codeのユーザーにも試しやすい。[17]
    3. 個人的な使用感として、CodexはClaudeのアプリ版よりも使い勝手が良く、費用対効果も高い。[18]

1.2. Codexのインターフェース概要 [19]

  1. 三列構成の直感的なデザイン [19]
    1. 左側：会話とプロジェクトの管理を行う。[20]
    2. 中央：コマンドを入力する。[20]
    3. 右側：結果の確認とプレビューを行う。[20]
  2. 左側の機能 [21]
    1. 履歴、タスクリスト、プロジェクトフォルダ、プラグイン、設定が含まれる。[21]
    2. 通常の質問は新規会話で対応するが、プロジェクト内のタスクはプロジェクトフォルダから新規会話を開始する。[22]
    3. これにより、Codexは正しいフォルダ、適切なコンテキスト、およびAgents markdownを読み込むことができる。[23]
  3. 中央の機能 [25]
    1. ChatGPTと同様に、テキスト入力または音声入力でCodexとコミュニケーションをとる。[25]
    2. 音声入力は、AIとの協業において非常に便利であり、作業効率を向上させる。[26]
    3. 「@」を入力するとプロジェクト内の特定のファイルを添付でき、「/」を入力するとステータス確認やスキルの指定ができる。[28]
    4. 「分岐（Fork）」機能は、Codexの応答から同じ会話を複製し、異なる選択肢を試すことができる。[30]
      1. これは、ビデオゲームのセーブポイントのように、重要な決定前に会話を保存し、後で異なるパスを試すのに役立つ。[32]
  4. 右側の機能 [33]
    1. ドキュメント、フォルダ構造、生成されたウェブページやHTMLレポートをプレビューできる。[33]
    2. ウェブページプレビューの視覚的注釈機能は非常に便利である。[33]
    3. プレビュー画面で要素をクリックし、会話ボックスで「このタイトルを大きく」「この画像を交換」「このブロックを削除」などと指示するだけで、Codexが基盤となるコードを修正し、更新された結果を表示する。[34]
    4. これにより、ユーザーはコードを書く必要がなく、抽象的な説明なしに視覚的に変更を指示できる。[36]

2. Codexを使いこなすための4つの基本原則 [37]

Codexを効果的に活用するためには、プロジェクト、権限、コンテキスト、Agents markdownという4つの基本原則を理解し、適切に設定することが不可欠である。

2.1. プロジェクト：作業範囲の明確化 [41]

  1. プロジェクトの定義 [41]
    1. Codexを呼び出すフォルダが、そのプロジェクトの作業領域となる。[42]
    2. Codexはこの範囲内でのみファイルの読み書き、追加、削除を行う。[42]
    3. 例として、オフラインセミナーの準備では、「セミナー準備」というフォルダを作成し、活動説明、参加者リスト、講演者紹介、画像素材、過去のプレゼンテンプレートなどを格納する。[43]
  2. 作業範囲の限定の重要性 [44]
    1. AIにPC全体を任せるのではなく、特定の範囲を区切って作業させることで、効率が向上する。[44]
    2. ファイルを処理させる際は、キーワード検索だけでなく、フォルダをドラッグ＆ドロップするか、完全なパスを貼り付けるか、「@」機能で指定する。[45]
    3. これにより、CodexがPC全体を検索する無駄を省き、処理速度を上げ、トークン消費を抑えることができる。[46]
  3. コンテキストエンジニアリングとしてのファイル整理 [48]
    1. プロジェクトフォルダ内のファイル整理は、コンテキストエンジニアリングと呼ばれる。[48]
    2. ファイルを適切に分類し、明確な名前を付けることで、AIだけでなく、新しく参加した人間も容易に情報を見つけられるようになる。[49]
    3. AIエージェントの時代において、この整理の重要性はさらに高まる。[50]

2.2. 権限：AIのアクセスレベル管理 [51]

  1. 権限モードの種類 [51]
    1. 承認要求モード（デフォルト）：最も保守的なモードで、ファイルの読み取りと議論のみを許可する。ファイルの変更やコマンド実行には、ユーザーの承認が必要である。[52]
    2. 承認待ちモード（一般的）：指定された作業フォルダ内では、ファイルの読み書き、コマンド実行を自律的に行う。フォルダ外のファイルやインターネット接続が必要な場合は、ユーザーに確認を求める。[53]
    3. 完全アクセスモード：AIに完全なアクセス権を与え、インターネット接続やPC全体へのアクセスも許可し、ユーザーへの確認は行わない。[54]
      1. CLIでは「YOLOモード（You Only Live Once）」とも呼ばれる。[55]
      2. 初心者には推奨されない。[55]
  2. 権限管理の注意点 [56]
    1. 権限が高いほどユーザーの手間は省けるが、AIが意図しない動作をした場合のリスクも高まる。[56]
    2. 最初は保守的な権限設定から始め、AIからの承認要求に慣れてきたら、段階的に権限レベルを上げていくのが賢明である。[57]
    3. 慣れてきたら完全アクセスモードを使用しつつ、Agents markdownで「元のタイトルファイルを削除しない」などの不可逆な操作を制限することで、リスクを軽減できる。[57]
    4. ただし、自然言語による制限には限界があるため、注意が必要である。[58]

2.3. コンテキスト：AIの視野と焦点 [59]

  1. コンテキストの定義 [59]
    1. AIが読み取れる情報の範囲を指し、ユーザーとの会話履歴や提供されたドキュメントなどが含まれる。[59]
    2. コンテキストが多いほどAIは多くの情報を参照できるが、多すぎると思考空間が圧迫され、焦点がぼやける可能性がある。[59]
  2. コンテキスト管理の重要性 [60]
    1. アシスタントに一度に多くの情報やタスクを与えすぎると、重要な点を見落とす可能性がある。[60]
    2. 一つのタスクが完了したら、Codexに現在の状態を要約させ、新しいセッションを開始するか、「/compact」コマンドでコンテキストを圧縮し、AIの「頭をクリア」にする。[61]
  3. コンテキスト使用量の監視 [62]
    1. Codexのインターフェースには、現在のコンテキスト使用量が表示される（円グラフやパーセンテージ）。[63]
    2. 筆者の習慣として、使用量が80%程度になったら手動で圧縮する。[64]
    3. 100%に達して自動圧縮されると、重要な情報が失われるリスクがあるため、手動での管理が推奨される。[64]

2.4. Agents markdown：プロジェクトのルールブック [65]

  1. Agents markdownの役割 [65]
    1. プロジェクトの「ルールブック」として機能し、Claude CodeのClaude markdownに相当する。[65]
    2. プロジェクトフォルダ内に配置することで、Codexはセッション開始時にこのファイルを読み込み、最高指導原則として扱う。[67]
    3. 例として、「繁体字中国語で出力する」「元のファイルを削除しない」「変更前に説明する」「参加者リストはExcelで出力し、処理概要を添付する」といったルールを記述できる。[67]
    4. これにより、Codexはユーザーの好みや注意点を理解し、より適切な成果物を生成する。[69]
  2. Agents markdownの記述に関する注意点 [70]
    1. ファイルに多くの情報やSOPを詰め込みすぎると、逆効果になる。[70]
    2. セッション開始ごとにファイル全体を読み込むため、ルールが多すぎるとAIの思考空間が圧迫され、回答品質が低下する。[70]
    3. 毎回必要な最低限の背景情報とルールのみを記述し、長い操作手順はSkillとして作成し、必要に応じて呼び出すのが良い方法である。[72]
    4. 最初から空白のファイルに悩む必要はなく、Codexにこれまでの協力に基づいてAgents markdownを生成させることも可能である。[73]
  3. Agents markdownとMemoryの違い [74]
    1. Agents markdownは、ユーザーが手動で記述する「従業員規則」であり、プロジェクト固有のルール（命名規則、出力形式、禁止事項など）を定義する。[74]
    2. Memoryは、AIがユーザーとの協力過程で自律的に記録する「観察メモ」であり、ユーザーの好みなどを記憶する。[74]
    3. Memoryの利点は、AIがユーザーをより深く理解することだが、欠点として、一時的な試みを長期的な習慣と誤解する可能性がある。[75]
    4. Memoryは定期的に確認し、不要な情報を削除する必要がある。[76]
    5. したがって、個人の長期的な好みはMemoryに任せ、プロジェクト固有のルールや注意点はAgents markdownに記述することで、Codexはユーザーの意図した範囲内で正確に作業を行うことができる。[78]

3. Codexの実践的な活用方法 [79]

Codexは、日常の煩雑なタスクを効率的に処理し、作業の自動化を可能にする。

3.1. 日常業務の自動化と効率化 [79]

  1. フォルダのスキャンと整理 [80]
    1. Codexにフォルダをスキャンさせ、ファイルの内容と役割を把握させる。[82]
    2. ファイル名の変更を依頼し、例えば「final」のような曖昧な名前を「202606_セミナー活動説明」のように明確な名前に統一させる。[82]
    3. 曖昧なファイル名は作業の混乱を招くため、Codexに整理させることで、その後の作業がスムーズになる。[84]
  2. 表の整理とデータ処理 [87]
    1. Codexにタスクの「目的」を明確に伝えることで、より適切な結果が得られる。[87]
    2. 例として、「確認メールを送るためのリストを整理してほしい」と伝えることで、Codexはメールアドレスや出欠状況を優先的に配置する。[88]
    3. 参加者リストから氏名、部署、メールアドレス、出欠、食事の要望など、重要な情報のみを抽出したExcelファイルを作成させる。[88]
    4. 処理後には、変更点、データ欠損、補足が必要な情報などをまとめた「処理日誌」の作成を依頼する。[89]
    5. この記録は、Codexの作業内容を検証し、品質を確保するために不可欠である。[91]
    6. 整理されたExcelデータは、Gmailと連携して確認メールの一括送信や、参加者の備考欄を読み取って個別の質問にカスタマイズされた返信を作成するのに活用できる。[92]
  3. プレゼンテーションの作成とウェブページの計画 [93]
    1. 活動説明や講演者紹介に基づいて、プレゼンテーションの構成案（活動背景、プロセス、講演者紹介、登録情報、注意事項など）を作成させる。[94]
    2. 複雑なタスクにはPlanning Modeを使用し、ウェブサイト作成のようなタスクでは、最初から「ウェブサイトを作ってほしい」と依頼するのではなく、まず計画を立てさせる。[95]
    3. さらに、CodexにPM（プロジェクトマネージャー）の役割を演じさせ、不明確な点について質問させることで、ウェブサイトの仕様を明確にする。[97]
    4. Codexは最新の画像生成モデル「image2」を使用して、活動のメインビジュアル、プレゼンカバー、講演者カードなどを生成できる。[98]
    5. 生成されたウェブページが意図と異なる場合でも、前述の視覚的注釈機能を使用し、プレビュー画面で直接要素をクリックして「一番上の横棒を拡大」「タイトルの余分な文字を削除」「ボタンを少し上に移動」などと指示するだけで修正できる。[98]
    6. このように、コードを書かずに視覚的に指示する作業はVibe Codingと呼ばれる。[99]

3.2. 能力拡張：Skill、プラグイン、自動化 [100]

  1. Skill（スキル） [101]
    1. Skillは、ユーザーが定義した一連のSOP（標準作業手順）である。[102]
    2. 毎回Codexに手順を説明する代わりに、一度確立された満足のいく方法を保存しておくことができる。[102]
    3. 例として、「セミナー準備」スキルには、参加者データの読み込み、リスト整理、招待メールの作成、準備状況レポートの生成、活動後の振り返り要約の作成などが含まれる。[103]
    4. これにより、次回同様のイベントを開催する際に、手順を再説明する手間が省ける。[104]
  2. プラグイン [106]
    1. プラグインは、Codexがサードパーティのアプリケーションと連携し、直接使用できるようにする機能である。[106]
    2. 左側のサイドバーからプラグインを検索し、ワンクリックで接続できる。[107]
    3. 例えば、Gmailと接続すればメールの検索や下書き作成が可能になり、Google Driveと接続すればクラウドファイルの読み書きや特定のファイルの変更ができる。[107]
  3. 自動化 [109]
    1. 毎日決まった時間に実行するタスクをCodexに任せる機能である。[109]
    2. 例として、毎朝9時に参加登録フォームを自動チェックし、新しい登録があればExcelファイルを更新する、または未返信の人にカスタマイズされたフォローアップメールを作成する。[109]
    3. 小さなタスクでもAIに任せることで、日々の雑務に費やされる時間と精神的コストを削減できる。[110]
    4. 自動化は、ユーザーの思考を解放し、定型的な作業をAIに任せるためのものである。[111]

4. Codexを家庭教師として活用する [112]

Codexは単なるアシスタントではなく、ユーザーの知識やスキルを向上させる「家庭教師」としても機能する。

4.1. 学習とスキルアップのパートナー [112]

  1. AIを家庭教師として活用する [112]
    1. Codexは、技術者でなくても利用できるツールであり、単なるアシスタント以上の価値を持つ。[112]
    2. プログラミング経験のない運用担当者も、Codexを「随時利用できる家庭教師」として活用している。[113]
  2. 複雑なSkillの理解と改善 [114]
    1. 他の人が作成した複雑なSkillの使い方がわからない場合、CodexにそのSkillの内容、トリガー条件、そして自身の日常業務内容を説明し、Skillを自分に合わせて改善する方法を尋ねることができる。[114]
  3. 新しいツールの導入と学習 [116]
    1. 新しいツールを導入する際、以前はGitHubのREADMEを読んだり、多くのチュートリアルを試したりする必要があった。[116]
    2. 現在は、Codexにツールのインストールを依頼し、その手順を段階的に教えてもらい、注意点やヒントをまとめた表を作成させることができる。[116]
    3. プログラミングの知識がなくても、Codexに作業をさせながら説明させることで、Vibe Codingを通じて学習を進めることができる。[117]

4.2. AIエージェントの育成と協業 [118]

  1. AIエージェントの管理者としての役割 [118]
    1. ユーザーはAIエージェントの管理者であり、タスクを投げたら完璧な結果が返ってくると思い込んではならない。[118]
    2. 新しい同僚を指導するように、まず背景情報と目標を明確に伝え、Codexの計画を確認し、最終的な成果を検証する必要がある。[119]
    3. Codexが間違った場合、「気に入らない、やり直せ」とだけ伝えるのではなく、何が間違っていたのか、なぜ間違っていたのか、次回同様の状況でどう判断すべきかを具体的に教える。[120]
    4. このように指導することで、Codexはユーザーの作業方法を理解する真のパートナーとなり、毎回ゼロから推測するのではなく、継続的に学習し、改善される作業システムとなる。[122]
  2. Codex活用のまとめ [125]
    1. Codexの理解：Codexは、作業環境にアクセスし、ファイルを直接操作できるAIエージェントである。[126]
    2. 基本原則の習得：プロジェクト、権限、コンテキスト、Agents markdownの4つの基本原則を理解することが、あらゆるAIエージェントツールを使いこなす上で不可欠である。[128]
    3. 日常業務への適用：ローカルファイル、表、ウェブページ、メール、プレゼンテーションなど、日常のタスクからCodexの利用を開始する。[130]
    4. 能力の拡張：慣れてきたら、独自のSkillを構築し、常用するプラグインを連携させ、日々の雑務を自動化する。[131]
    5. 家庭教師としての活用：Codexはアシスタントだけでなく、家庭教師でもある。できることは任せ、できないことは教えてもらい、学んだ上で実行させる。[132]