Codex : 究極のやさしい導入ガイド

このチュートリアルは初心者や部分的にしか知識がない方向けです。図解を多用した徹底ガイドで、Codex をすぐに使い始めるために必要なすべてを説明します。 Codex は、プログラミングやコンピュータタスクのための AI エージェントです。簡単に言えば、「コードに関する質問に答える」だけでなく、プロジェクト内のファイルを読み取り、コードを修正し、コマンドを実行し、バグを修正し、テストを書き、コードレビューを行い、さらにはさまざまなツール間での反復作業を支援します。OpenAI は公式に「実際の作業を委任できる AI エージェント」と説明しています。 それでは、早速使い方を見ていきましょう。 # 会話 !Image ## 新規プロジェクトの作成 / 既存プロジェクトを開く サイドバーのこの部分（図参照）にフォルダアイコンがあります。クリックすると、2 つのオプションが表示されます。 !Image - 新規空白プロジェクトを作成 これはデフォルトの Codex パスに新しいプロジェクトを作成します。この方法はあまりおすすめしません。 - 既存のフォルダを使用 こちらをおすすめします。既存のプロジェクトを開くだけでなく、例えば Codex に PPT 関連のプロジェクトにアクセスさせたい場合は、ここで PPT フォルダを開くことができます。また、空白のプロジェクトで新しい作業を始めたい場合も、システムのファイルエクスプローラで事前にフォルダを作成し、それを Codex で開くことをおすすめします。そうすることで、プロジェクトが見つけられなくなるなどのトラブルを回避できます。 ## モデルと速度 プロジェクトに入ったら、チャットバーでモデル、推論レベル、速度を選択できます（図参照）。 !Image モデルについては皆さんご存知だと思うので、詳しく説明しません。 推論レベルとは、Codex がタスクを完了する際に費やす推論・計画能力の量を指します。 速度とは、生成速度のことです（高速は現在 1.5 倍消費します）。 どのタスクでも GPT-5.5 + Ultra High + デフォルト速度の組み合わせをおすすめします。 この組み合わせが最も安定しており、消費も許容範囲です。もちろん、状況に応じて低いレベルで簡単なタスクを実行することも可能ですが、「どのレベルを使うか判断する」という行為自体がエネルギーを消費し、低いレベルの不安定性が手戻りを招く可能性があります。そのため、GPT-5.5 + Ultra High + デフォルト速度の組み合わせを固定するのが最善だと考えています。 ## 権限 チャットバーのここ（図参照）をクリックして、Codex の権限範囲を制御します。 !Image これら 3 つは Codex の権限・承認モードです。主な違いは、ファイルを自動的に変更できるか、コマンドを自動的に実行できるか、いつあなたに確認を求めるかです。 デフォルトの権限は保守的です。Codex はファイルの変更や特定のコマンドの実行など、重要な操作の前に確認が必要です。安全ですが、頻繁にポップアップ確認が表示されます。 自動レビューは中間の立場です。Codex が確認が必要な操作に遭遇したとき、「自動レビュー」はまず安全かどうかを判断し、安全なものは自動的に許可し、不確実または危険なものはあなたに確認します。デフォルトより便利ですが、自動判断は絶対に信頼できるわけではありません。 フルアクセスは最も開放的です。Codex の動作をできるだけ妨げず、ファイルの読み書きやコマンドの実行をより自由に行えるようにし、より広範囲の操作が可能になる可能性があります。 アドバイス： - Codex を使い始めたばかりの場合：「自動レビュー」を選択 - 重要なプロジェクトや会社のコードを扱う場合：「デフォルト」または「自動レビュー」を選択 - 「フルアクセス」は、一時的なデモ、テストリポジトリ、またはいつでも復元できるプロジェクトでのみ使用 - キー、プライベートファイル、または本番環境の設定を含むディレクトリではフルアクセスを有効にしないでください ## Plan Mode !Image Plan Mode を使用すると、Codex はコードを変更する前にソリューションを検討できます。 有効にすると、通常は最初に以下のことを行います。 1. プロジェクトのコンテキストを読み取る：ワークスペース内のファイル、プロジェクト構造、関連コードを確認します。 2. あなたの目標を理解する：あなたが実際に達成したいことを確認します。 3. 実行計画を提案する：変更する予定のファイル、手順、潜在的なリスクを伝えます。 4. 必要に応じて質問する：要件が不明確な場合、またはデータベース・インターフェース・依存関係に影響する場合は、まず確認します。 5. 計画が明確になったら実装する：最初からめちゃくちゃな変更を行うことを防ぎます。 適しているケース： - 複数のファイルを変更する - 新機能を追加する - プロジェクトをリファクタリングする - バグの原因が明らかでない - どう進めればよいかわからない - プロジェクトが重要で、勝手に変更されたくない 簡単に言うと：小さなことは直接行い、大きなことは Plan Mode を使いましょう。 ## レビュー !Image 各会話の変更内容と出力が表示され、直接確認または元に戻すことができます。 通常は特に気にする必要はありません。確認すべき特定のものがない限りは。問題があれば、Codex に変更を依頼するだけです。 !Image 一部の環境情報が表示されます。ローカルに GitHub CLI を設定することをおすすめします。開発者は Railway/Vercel や Sentry の CLI も設定できます。 これにより、はるかにスムーズな体験が得られます。 ## いくつかのヒント !Image よく使う会話ウィンドウや未完了の会話ウィンドウをここにピン留めして、次回すぐにアクセスできます。 !Image 音声入力は非常に便利です。今ではプロンプトの半分を音声で入力しています。 !Image ここでサイドバーまたは下部ウィンドウを開いて、ファイル、ターミナル、または Web サイトにアクセスできます。 Codex にコードを変更させながら、ここでブラウザを開いて結果を確認できます。あるいは、プロンプトのリファレンスブックを開いて手順に沿って進めることもできます。作業中に PPT を表示したり、映画を観たりすることも可能です。 !Image プロジェクトフォルダをここで開くと、ファイルが非常に見つけやすくなります。 # スキルとプラグイン プラグイン = 能力をインストールすること。 スキル = その能力を使用する具体的な方法。 ## プラグイン !Image 図の位置をクリックしてプラグインを開きます。詳細に説明するのは複雑なので、プラグインはインストール・拡張パッケージのようなものだと覚えておいてください。インストールすると、Codex は Chrome、スプレッドシート、プレゼンテーション、Slack などの特定の能力を獲得します。 おすすめ：Chrome、プレゼンテーション、スプレッドシート、ドキュメント。 その他は開発ニーズに応じて選択してください。 使用する際は、ここで明示的に選択します。 !Image ## スキル スキルは、プラグイン内またはローカルに設定された具体的なワークフローや指示マニュアルです。特定のタスクに遭遇したときに Codex がどの手順を踏むか、どのスクリプトを使用するか、どのテンプレートを参照するかを指示します。 スキルは GitHub から取得したり、Codex のおすすめからインストールしたり、自分で作成したりできます。 GitHub では通常、次のように行います：（GitHub のリンクを貼り付けて）、このスキルをプルしてグローバルスキルとして登録してください。 自分でスキルを作成するには、このエントリ（図参照）を使用します。作成をクリックするとプロンプトが表示されるので、要件を追加できます。 !Image スキルを使用する方法はいくつかあります。1 つ目は、スキル設定に基づく暗黙的なトリガーです。スキルに「XX の状況で使用する」と設定されており、その状況が発生すると、Codex は「OK、XX スキルを使用します」と言います。 もう 1 つは明示的な使用です。入力ボックスに "$" を入力すると !Image スキルのリストが表示されます。該当するスキルを見つけてクリックするか、最初の数文字を入力してマッチさせ、Codex に「このスキルを使って！」と指示します。 特に強調したいスキルがあります：image gen です！！ これは gpt-image-2 の機能を Codex にシームレスに統合します。つまり、Codex にローカルの設計仕様やコンテンツを確認させ、プロンプトを計画し、Codex 内で直接画像を生成できます。 また、生成した画像をすぐにコードに埋め込んだり記事に挿入したりするなど、すぐに利用することもでき、摩擦を大幅に減らせます！ ## まとめ Codex には自動化やワークツリーなど他にも多くの機能がありますが、ここでは説明しません。ぜひ皆さんで探検してみてください！ この記事が皆さんの役に立てば幸いです。