Codex 公式チームによる共有：Codex を最大限に活用する方法

Codex 公式チームからの共有：Codex を最大限に活用する方法

著者：jason (@jxnlco)**

原文：Getting the most out of Codex

多くの開発者がコード編集 AI エージェント (AI Agent) に初めて触れる際、通常は「コードを書く」という一つのタスクしか任せないものです。例えば、コードベースのチェック、差分比較 (diff) の生成、テストの実行、そしてマージリクエスト (pull request) の提出などです。

確かに、コード作成こそが Codex の中核的な強みです。しかし、よく考えてみると、私たちがコンピュータ上で行う仕事の大部分は、本質的にコードと密接に関連しています：ターミナルコマンドの実行、ウェブページの閲覧、アプリケーションプログラミングインターフェース (API) の呼び出し、ドキュメントのエクスポート、各種イベントへの対応、あるいは自動化プロセスのトリガーなどです。Codex がこれらの領域へと拡張され始めると、それはもはや狭義の「コーディングアシスタント」という枠を超え、あらゆるコンピュータ作業をこなす「万能な労働者」へと進化を遂げたように感じられます。

Codex の新機能 は、この変革を現実のものにします。現在の会話スレッド (thread) は、文脈の記憶保持、各種ツールの呼び出し、生成されたファイル (artifacts) の表示が可能であり、異なるプロンプト間でもシームレスにつながります。これにより、毎回会話を終えるたびに「最初からやり直す」必要がなくなります。

Codex の潜在能力を最大限に引き出すには、以下の戦略を組み合わせて活用する必要があります：

• 長期的な記憶を保持できる「永続的な会話スレッド (durable threads)」

• ユーザーが全体を掌握している際に、柔軟に音声入力、タスクの介入 (steering)、およびタスクキューイング (queuing) を活用する

• ブラウザ、コンピュータ操作 (computer-use)、モデルコンテキストプロトコルサーバー (MCP servers, AI がローカルデータやツールに安全に接続するための汎用標準)、および各種コネクタを活用し、Codex の手をコードベースの外へ広げる

• ユーザーが離席している間に、会話スレッドの自動化 (thread automations) と目標指向型機能 (Goals) を活用して作業を継続させる

• サイドパネル (side panel) を使いこなして、生成されたコード、ドキュメント、スライド、その他のファイルを随時レビューする

永続的な会話スレッド (Durable threads)

永続的な会話スレット：Codex の対話フローで長時間実行可能であり、複数回の利用を通じて作業の文脈を常に保持し続けるものです。

これらの永続的な対話を「ピン留め (Pinned threads)」することで、いつでも呼び出せるようにするのが効果的です。これは、繰り返し進める必要があるワークフローにおいて特に強力なツールとなります。例えば：

• 日常の雑務を処理する専属の「チーフ・オブ・スタッフ」用スレッド

• 製品リリースを担当する専用スレッド

• ドキュメントレビューを担当するスレッド

• 外部データを監視する専用スレッド

これらは、会話が終われば消えてしまう一時的なチャットボックスではありません。永続的な作業スペースなのです。時が経っても Codex はこれらの対話に戻ることができ、以前行った決定や個人の好み、現在の進行状況などを記憶しています。この機能がなければ、毎回ゼロから背景情報を再入力する必要が生じます。

ピン留めのショートカット機能により、この操作は極めて実用的なものとなります。Command-1 から Command-9 を押すだけで、保存された専用スレッドに瞬時に戻り、作業を継続できます。

音声入力 (Voice input)

音声入力が優れている理由は、考えを文字として推敲して入力する前に、脳内の最も原始的で粗いアイデアを捉えてくれる点にあります。

Codex には標準で音声入力機能が搭載されています。これは、「口では説明できるが、タイピングは面倒だ」と感じる曖昧なアイデアに対して特に有効です。例えば：

必ず JSON 形式で返してください。translation フィールドのみ。他のフィールド (technical_terms 等) は一切追加しないこと — 余計なフィールドを書こうとして本文翻訳がトークン上限で打ち切られる事故を防ぐため:

{"translation": "翻訳全文"}

「Ben という人が Slack でこの件について言っていたのを覚えています。

詳細は忘れました。

あなたが見つけてきてください。」

自分で検索し、文脈を収集して報告してくれる AI エージェントにとって、これらの数行の言葉だけで十分です。

頭の中に漠然としたアイデアはあるが、まだ完全に形になっていない段階で、それに向かって 2〜3 分間「独り言」のように話しかけ、思考をすべて吐き出すだけでも、驚くほど効果的です。

音声入力の変換も同じ理屈です。手直しされていない会議議事録や、口述された計画草案は、簡潔な要約よりも価値があることが多いのです。なぜなら、那些粗い記録には、あなたの迷う声のトーン、強調したいポイント、そしてまだ語り尽くされていないひらめきが保存されているからです。

任務の介入とキューイング (Steering and queuing)

音声入力を入力し、実行中のタスクに対する直接制御を組み合わせることで、その真価が発揮されます。

タスクが実行されている最中に、もしも

任務の介入 (Steering)：現在のタスクが完了する前に中断し、Codex に新しい方向性を指示すること。

AI が逸脱してしまったことに気づき、壁にぶつかる前に修正したい場合、この機能が役立ちます。例えば、ウェブサイトのレビューを依頼している際、サイドバーで指差しながら直接口頭で作業を中断させることができます：

• 「これをもう少し小さくして」

• 「これらの 2 つの要素間の間隔がおかしい気がする」

• 「この文章に誤りがある」

任務キューイング (Queuing)：Codex が現在のステップを完了した後に、次の作業を割り当てること。

任務キューイングは少し異なります。進行中のタスクを中断するのではなく、新しいタスクを順番待ちの列に追加します。以下のように指示できます：

「この仕事を終えたら、プレビューリンクを Slack に送信して審査者に確認してもらって。」

簡単に言えば、「介入」は Codex が現在行っていることを変更することであり、「キューイング」は次に実行すべきことをスケジュールすることです。これらの機能により、タスク実行中も常に「人間と機械が一体となった」コントロール感を維持できます。

ツールと到達範囲 (Tools and reach)

対話フローに連続的な記憶機能が備わった後、次の課題は「どこまで届くか」という点です。Codex の触角は段階的に外側へ広がっていきます：

• $browser：サイドバーで動作するアプリ内ブラウザ。Codex はここでウェブページをレビューし、直接マークアップできます。

• @chrome：ブラウザのログイン状態を取得し、Chrome に依存したワークフローを処理します。

• @computer：デスクトップのグラフィカルユーザーインターフェース (GUI) を通じてのみ完了できるタスクに特化しています。

$browser はサイドバーでのウェブページレビューに適しており、@chrome はアカウントのログイン状態が必要なブラウザ内作業に適し、@computer はパソコンのデスクトップ上でマウス操作を繰り返す必要があるタスクを処理するために使われます。

MCP サーバーと各種コネクタは、この能力をさらにあなたの全ワークフローに拡張します。Slack 統合や、さまざまな MCP ツールコネクタ、そして MCP ガイド が重要視されるのは、多くの重要なタスクがコード化する以前に、単なるチャットメッセージや受信トレイのメール、あるいはスケジュール上の問題として始まるからです。

スキル (Skills) 機能により、反復的なワークフローを再利用可能になります。一度そのワークフローの有効性が証明されれば、それを スキルとして固定 できます。これにより、Codex は次回からそのプロセスを最初から学習し直すことなく、直接実行できるようになります。

随时随地工作 (Work from anywhere)

随时随地与 Codex 协同工作 的理念，彻底打破了我们“必须坐在电脑前才能干活”的传统限制。一个任务可以在你装满文件、权限和本地环境的 Mac 电脑上启动，然后当你离开工位用手机查看时，它依然在默默推进。

这在很多碎片时间里非常有用。你可以让 Codex 在电脑上跑一个耗时很长的任务，然后自己离开工位去喝杯咖啡。如果在外面时它有问题问你，你可以直接用手机回复、批准它的下一步行动，或者在回座位前就给它指派新的方向。你的本地环境安安静静地待在那里干活，而你的人却可以自由移动。

自动化 (Automations)

自动化功能 能让 Codex 按照你设定的时间表自动干活。如果是需要每天从零开始的任务，比如生成日报或者例行检查代码库，那就用“定时自动化 (scheduled automation)”。但如果需要在一个带有历史记忆的对话中继续推进工作，那就用“对话流自动化 (thread automation)”。

对话流自动化：就像一种定时唤醒的“心跳”机制，它会按照设定的时间表，定期回到同一个 Codex 对话流中继续工作。

把对话流置顶固然好用，但它毕竟还得等你主动回去找它。而“对话流自动化”则可以每隔几分钟或几小时自己去查岗，一直跑到满足某个条件为止，甚至还能根据情况自己调整查岗的频率。

比如，你的“幕僚长”对话流可以每 30 分钟跑一次：

每 30 分钟，去查一下我的 Slack 和 Gmail 里有没有需要处理但还没回的消息。

帮我排个优先级。

如果有人向我提问，尽可能深入地去查资料，然后帮我起草一份回复，但不要直接发送。

当你回到电脑前时，那些最耗时耗力的“收集背景资料”的工作往往已经做完了。作为人类，你只需要做最后拍板发出去的决定。

对话流自动化也非常适合用来处理“反馈循环”。它可以默默盯着你在代码合并请求、Google 文档或是 Slack 里的评论，趁你不在的时候自动推进后续的修改工作。

想象一个制作动画的场景：审核人在 Slack 里发了一个视频。对话流自动化可以定时检查讨论进度，一旦有修改意见进来，它就自动渲染一版新的，然后在原贴里艾特审核人并回复新视频。如果某个软件的集成接口没法自动完成最终的上传，它甚至能调动“电脑桌面自动化”通过图形界面把最后一步走完。

这个完整的闭环跨越了接收反馈的 Slack、负责渲染的代码库，以及负责最终上传的桌面自动化工具。

目标设定 (Goals)

当一个任务有一个清晰的终点线，并且 AI 智能体可以不断朝着那个终点努力时，目标 (Goals) 的威力就彻底爆发了。

目标：运行时间更长的 Codex 任务，有一个明确的终点线，AI 会在一段时间内持续向它冲刺。

一个糟糕的目标**是这样定的：

**

把这个 Markdown 文件里的计划实现一下。

一个优秀的目标**必须有一个可以被衡量的成功标准。

比如，一位工程师想把一个内部工具从 Python 语言迁移到 Rust 语言，他可以建好新目录，设定好目标，并画一条明确的终点线：

直到所有单元测试全部通过，这个新版本的开发才算完成。

目標設定とは、実質的に「継続的な実行」と「検証器 (verifier)」を結びつけることです。人間であるあなたが、望む結果、停止の条件、そして Codex がゴールに近づいているかどうかを判断するシグナルを定義します。

優れた検証器には以下のようなものがあります：

• 完全なテストケースのセット
• ベンチマーク性能テスト
• 安定して再現可能なバグ
• 検証マトリックス
• 常に実行されるべきエンドツーエンドのワークフロー

野心を持つことは確かに重要ですが、検証メカニズムを伴わない野心は、単なる願望に過ぎません。

側面パネル (The side panel)

側面パネル機能 を使うと、生成された成果物をチャットウィンドウと並べて常に表示できます。ファイルをエクスポートして、異なるソフトウェア間で苦しみながら切り替える必要はもうありません。その場で直接レビューが可能です。生成される成果物はコードである場合もあれば、スライド、PDF ファイル、ウェブページ、表計算、あるいはその他あらゆる生成物である場合もあります。

この機能は特に以下の 4 つの作業に優れています：

• 生成されたファイル (artifacts) の確認
• 修正が必要な箇所のマーキング
• ウェブインターフェースの操作
• コードやファイルの変更点のレビュー

側面パネルを使えば、ユーザーは Markdown ドキュメント、表計算、データテーブル、一般的なドキュメント、スライドをその場で直接表示できます。既存のワークフローを中断することなく、直接チェックし、マーキングを行い、ファイルを修正できます。

スライドや PDF は、チャットウィンドウの隣にすっきりと表示され、いつでも検閲や修正が可能です。

アプリ内ブラウザ により、Codex はレンダリングされたウェブページを直接確認し、操作し、さらにその上でユーザーが行ったマーキングに直接応答することが可能になります。ウェブページやファイルに対するコメントはすべてこのワークフローの閉じたループ内に留まり、以前のように個別の引き継ぎタスクに分割して扱う必要はありません。

ウェブページは出力結果であると同時に、操作可能なコントロールパネルにもなります。Codex はページを作成し、側面パネルでそれを開き、自らチェックし、バグを修正し、その場で同じものを継続的に反復・最適化できます。

以下のようなシナリオでは、側面パネルとの組み合わせが特に効果的です：

• 軽量な静的表示用に単一の index.html ファイルを使用する
• Storybook を実行してユーザーインターフェース (UI) コンポーネントをレビューする
• Remotion Studio を使用してコード生成によるアニメーションを作成する
• ブラウザで再生されるスライドプレゼンテーション
• データ分析フロー用のデータアプリ (data apps)

単なる index.html ファイル一つで、サーバー構築なしでも楽しめるインタラクティブな小アプリに変身します。さらに、会話フローの自動化により、これらの静的ファイルは時間とともに静かに更新されていくため、戻ってきた時には常に最新の進捗が待っています。

共有メモリ (Shared memory)

長時間実行される対話フローが単一のチャットの枠を超えて記憶を共有できるようになると、その役割は飛躍的に向上します。

共有メモリ (Shared memory)：単一の会話外に保存された永続的なコンテキストであり、これにより将来の作業は明確で追跡可能な情報に基づいて継続して進められます。

より確実な方法としては、これらの永続的な対話フローを「Obsidian 知識ベース (vault)」に「アンカー（固定）」することです。つまり、純粋なテキストファイルを格納するフォルダを作成するだけです。これはシンプルで直感的であり、いつでも確認・修正・移動が可能で、長期間の保存も可能です。チームはこのフォルダを、Git、Dropbox、Google Drive、あるいは他の同期ツールなど、好きなクラウドストレージに配置することができます。

あなたの知識ベースは以下のような構造になるかもしれません：

vault/

├── TODO.md

├── people/

├── projects/

├── agent/

└── notes/

最外層のディレクトリには、AGENTS.md ファイルを配置できます。ここでは Codex に対してルールを設定します：人員、プロジェクト、意思決定、およびタスクに関する新しい情報を把握した際、この知識ベースをどのように更新すべきかを定義するのです。

特定の知識ベース構造を硬直してそのままコピーする必要はありません。あなたが行うべきは、AI エージェントに「教える」ことです。永続的なコンテキスト（文脈）はどこに置くのか、どのコンテキストを保持すべきなのか、そしていつファイルを変更しないようにすべきなのかを明確にするのです。

実用的な AGENTS.md ガイドには、以下のように記述できます：

• ~/vault をあなたの長期の作業記憶領域として扱うこと。

• 笔记（ノート）は整理整頓し、断片的な記録が散らからないようにすること。

• タスク、人員、プロジェクト、日々のサマリー、ドラフトを正確に分類して保存すること。

• 決定事項、行き詰まり、責任者、日付、有用なリンクなどを適切に保存すること。

• 実質的な新進展がない限り、知識ベース内のファイルを安易に変更しないこと。

コードリポジトリはコードを格納する場所です。一方、この知識ベースは、継続的に更新されるコンテキスト（文脈）を格納するためのものです：誰が関与しているか、何が変更されたか、どこでつまずいているか、次に誰が引き継ぐのか、そして 2 回のチャットセッションの間に途切れると完全に消失してしまうような詳細情報などです。

重要なコンテキストは、単に一度きりのチャットの文字記録の中に閉じ込めておくべきではありません。それらを記述し、次の対話フローがすぐに引き継げる場所に配置してください。

Codex 自体も、「設定 > パーソナライズ > メモリ」において公式の メモリ機能 を提供しています。これらはシステム標準のローカルメモ帳のようなもので、あなたの個人的な好みや頻繁に使用するワークフロー、そしてよくある失敗パターンを記憶するために使われます。ただし、この機能はあなたが明確に記述したコンテキスト（文脈）を補助するものであり、それを代替するものではありません。Chronicle メモリコンポーネント も同様の考え方に基づいており、Codex があなたの最近の画面で起こった出来事から記憶を抽出・構築するのを支援します。

コードから外側へ (From code outward)

Codex はもともとコード作成を本業としていますが、現在ではコードに付随する多くの周辺業務も、この同一システム内で完結できるようになりました：MCP サーバー、ウェブインターフェース、デスクトップ制御、対話フローの自動化、あるいはサイドバーで直接レビューできるファイルなどです。

これは、私たちが Codex を制御する方法を根本的に変えました。「タスク介入」によって動作を途中から中断でき、「タスクキューイング（待機列）」によって次のステップを適切に手配できます。「対話フローの自動化」により、あなたが不在でもシステムが稼働し続けます。また「目標設定」によって明確なゴールラインを描き、Codex がどこに向かって突き進むべきかを理解させます。

現在の Codex は、完全なワークフローを担うことができます：指示の聴取からタスクの実行、そして最終的なファイルレビューまで。これらの業務がすでにコードリポジトリの範囲を超えていても、Codex は依然として余裕を持ってこなすことができるのです。