このページの内容
要点
- Codexをインストールし、プロジェクトで
codexを実行して、ChatGPTでログインします。 - 小さなタスクを頼み、変更を確認して、採用するか取り消します。
- ルールは
AGENTS.mdに書いておくと、Codexが毎回それに従います。
Codexとは？
RocketLauncherはソフトウェア会社で、CodexとClaude Codeの両方を使っています。CodexはOpenAIのコーディングエージェントです。やりたいことを普通の言葉で伝えると、プロジェクトを読み、計画を立て、ファイルを編集し、コマンドも実行できます。使える場所はいくつかあります。
- ターミナルで使う CLI。
- VS Code、Cursor、Windsurf向けの IDE拡張機能。XcodeとJetBrains系のIDEには標準対応があります。
- デスクトップアプリ。
- Web版のCodex。タスクを預けて、あとで結果を確認できます。
このガイドではCLIを使います。一度覚えれば、ほかの場所でも同じように使えるからです。ほかの資料は Codexのハブ にまとめています。
必要なもの
- ターミナルが使えるパソコン。Windowsの場合は、Windowsアプリ、Windowsのサンドボックス、WSLが使えます。最新の方法はOpenAIのドキュメントを見てください。
- ChatGPTアカウント。Codexが含まれるプランと利用量は、時期によって変わります。最新のCodexの料金ページを確認してください。
- プロジェクトのフォルダ。できればgitで管理しているもの。
インストールと起動
- OpenAIの最新のCodex CLIのページを開き、お使いの環境のインストールコマンドをコピーします。macOSとLinuxでは1行のスクリプトです。Windows、npm、Homebrewの方法も載っています。
- ターミナルを開いて、プロジェクトのフォルダに移動します。
codexを実行します。- 初回は Sign in with ChatGPT を選びます。ほかのログイン方法でも構いません。
- プロンプトが出るまで待ちます。これで準備は完了です。
APIキーをチャットに貼ったり、gitにコミットしたりしないでください。キーは環境変数に置きます。
最初のタスク
- 先に作業をコミットします。タスクの前後にgitで区切りを作っておくと、何でも元に戻せます。
- まずは読むだけの依頼から始めます。例：「このプロジェクトについて教えてください。」
- 答えを読みます。Codexが構成を正しく理解しているか確認します。
- 小さな変更を頼みます。「READMEに、テストの実行方法を説明する節を追加してください。」
- Codexの提案を確認します。編集を承認するか、別のやり方を頼みます。
- テストやビルドを実行してもらい、結果を読みます。
- 問題なければコミットします。
タスクは小さく
小さなタスクのほうが、良い結果になります。「アプリ全体を改善して」より、「請求書ページの日付の形式を直して」のほうがうまくいきます。大きなタスクのときは、先にCodexに計画を出してもらい、1歩ずつ進めます。
Codexにできることを管理する
/permissions コマンドで、確認なしでファイルを編集したりコマンドを実行したりしてよい場面を選びます。安全な進め方は次のとおりです。
- 最初は、編集もコマンドも毎回確認してもらいます。
- タスクに慣れたら、プロジェクトフォルダ内の編集は許可します。
- ネットワークに触れるもの、ファイルを削除するもの、デプロイするコマンドは、手動で承認します。
AGENTS.mdを設定する
AGENTS.md は、プロジェクトのルートに置くmarkdownファイルです。コーディングエージェントに、このリポジトリでの作業の仕方を伝えます。Codexは作業を始める前にこれを読みます。
- Codexで
/initを実行します。ひな形のAGENTS.mdが作られます。 - 編集します。短く、具体的に書きます。
- コミットして、チーム全員が同じルールを使えるようにします。
書いておくと良い内容：
- インストール、ビルド、テストの方法。正確なコマンドで書きます。
- コードスタイルのルールと、触ってはいけないフォルダ。
- 使わない言葉やパターン。
- 「完了」の意味。たとえば「テストが通り、lintにエラーがない」。
この形式はほかのツールも読みます。リポジトリに AGENTS.md があれば、Claude Codeも使えます。両方のツールで1つのファイルを使っているチームも多いです。
エディタでCodexを使う
VS Code、Cursor、Windsurfでは、Codex拡張機能をインストールして、Codexのアイコンをクリックします。コマンドパレットから "Codex: Open Codex Sidebar" を実行しても開けます。ログインしてチャットを始めましょう。開いているファイルや選択範囲をプロンプトに加えられます。差分はその場で確認できます。大きな作業はWeb版のCodexに送れます。
うまくいくプロンプト
- 「このプロジェクトのログインの仕組みを説明してください。ファイルは変更しないでください。」
- 「お問い合わせフォームを追加する計画を書いてください。触るファイルも挙げてください。」
- 「請求書モジュールの失敗しているテストを直して、もう一度テストを実行してください。」
- 「直前のコミットを見て、バグやテストの不足がないか確認してください。」
良いプロンプトには、目的、コードの場所、結果の確かめ方が入っています。Codexが違う方向に進んだら、止めて、意図を伝え、やり直します。直前の変更を元に戻すよう頼むこともできます。
よくある失敗
- 1つのプロンプトに大きすぎるタスクを入れる。
- gitを使わず、元に戻せなくなる。
- コマンドを読まずに、すべて承認する。
- AGENTS.mdを空のままにして、毎回同じルールをプロンプトに書く。
GoHighLevelでサービスにする
Codexで、地域のお店向けに小さなものを作る人は多いです。たとえば予約ページ、リードフォーム、フォローアップの自動化などです。そしてそれをGoHighLevelで動かします。Codexはコードを書いて直すのを手伝い、GoHighLevelは連絡先、メッセージ、カレンダー、支払いを担当します。Claude Code + GoHighLevel キット で全体の流れを紹介しています。同じ手順がCodexでも使えます。ほかの 作って売るキット も見られます。収入は約束しません。結果は、あなたの仕事とお客様しだいです。