Codexは、手元のファイルやコードを読み、変更し、確認まで進めるためのAIエージェントです。使い始めに大切なのは、機能を全部覚えることよりも「何を作り、何を変えず、どこまで確認するか」を一つの仕事として伝えることです。
- 1対象を決める
- 2最初の依頼
- 3成果物を開く
- 4結果を確認
Codexで何ができる?最初は小さな成果物から
公式のCodex CLIでは、プロジェクト内のファイルの調査・編集・コマンド実行ができます。作業する環境や接続するツールによって、できることは変わります。この記事では、ローカルの作業フォルダを使う場面を中心に説明します。公式のCLI概要
初回の画面と操作手順は、OpenAI公式クイックスタートで確認できます。
| やりたい仕事 | 最初に渡すもの | 確認するもの |
|---|---|---|
| Webページの改善 | 既存HTML・直したい箇所・参考画面 | 実際の表示とリンク先 |
| 定型文書の下書き | 元資料・読み手・文書の目的 | 固有名詞・数字・出典 |
| 集計処理の作成 | 匿名化したサンプル・列の意味 | 既知の入力と期待する出力 |
| コードの調査 | 対象フォルダ・困っている挙動 | 説明と実ファイルの対応 |
文書作成を頼めることと、特定のアプリを直接操作できることは別です。外部サービスでの送信や更新が必要なら、その接続・権限・確認方法も準備します。
どこから使う?作業環境を選ぶ
現在の公式案内には、ChatGPTデスクトップアプリ内のCodex、CLI、IDE拡張、クラウドの作業環境が載っています。古い解説に出てくる名称や画面と異なることがあるため、導入時には公式クイックスタートを併せて確認してください。
- 画面でフォルダや成果物を見ながら進めたい:デスクトップアプリが候補です。
- 既存の開発用フォルダやコマンドを使いたい:CLIが候補です。
- 普段のコードエディタから離れたくない:IDE拡張を確認します。
- 手元以外の環境で作業させたい:クラウド環境を用意し、対象リポジトリや設定を確認します。
どれを使っても、最初から会社の全資料を読み込ませる必要はありません。対象を一つに絞るほうが、出力の良し悪しと、必要な追加情報が分かります。
デスクトップで最初の依頼を出すまで
- 公式クイックスタートから利用OSに対応するアプリを入手します。
- アプリを開き、利用するChatGPTアカウントでログインします。
- 機密のない練習用フォルダを用意し、そのフォルダを作業場所に選びます。
- ChatGPTの選択メニューからCodexを選び、作業を開始します。
- まず「このフォルダの構成を説明して。まだ変更しないで」と入力します。
画面名は更新で変わるため、見当たらない項目は公式の現行案内で確認してください。CLIから始める場合は、OS別のインストール手順へ進めます。
最初の確認では、Codexが挙げたファイル名を実際のフォルダと照合します。説明が合っていれば、一つの文章やページを対象にした小さな変更へ進みます。アクセスを許可したフォルダが目的の場所かも、この段階で確かめましょう。
最初の使い方:調査・提案・修正・確認
1. 作業用のコピーを用意する
元に戻せるフォルダで始めます。Webページなら、元のHTMLと画像をコピーし、現在の表示を保存してください。Gitを使える場合は作業前の変更状態も確認します。
2. 目的と完了条件を伝える
次の練習用の指示例に、自分の対象ファイルと目的を当てはめます。
このフォルダにある紹介ページを読み、改善してください。
目的:初めて見る人がサービスの対象と次の行動を理解できること。
変更してよいもの:見出し、余白、ボタンの配置。
維持するもの:価格、会社情報、問い合わせ先。
最初に現状を確認してから修正してください。
完了後は、変更点と、画面で確認できたことを分けて報告してください。
3. 作業中に不足を補う
「もっとよくして」だけでは、何を優先すべきか伝わりません。「スマホでは説明が長いので、対象者と申込先が先に見えるように」など、読者の困りごとを具体化します。
4. 完成報告と成果物を見比べる
文章で「修正しました」と返ってきても、表示やリンクが正しいかは別に確認します。変更したファイルを開き、想定する操作を試します。確認できなかった項目は、未確認のまま残します。
初めての依頼を、3種類の仕事に置き換える
「Codexに何を頼めばよいか」が分からない場合は、作業時間よりも、自分が完成物を判断できる題材から選びます。以下は編集部が作った架空の練習例です。外部サービスへの送信や公開は含めていません。
例1:メモから、相手が読める文書へ
meeting.mdから、欠席者向けの共有メモを作ってください。
読み手:この会議に出ていない社内担当者。
構成:決まったこと、担当付きタスク、次回確認すること。
書かれていない担当・期限は未定としてください。
各項目に、元メモのどの記述を使ったか分かる短い根拠を付けてください。
drafts/share-note.mdへ保存し、元メモと照合してください。
確認するのは、文章のきれいさだけではありません。欠席者が「何が確定しているか」「自分の作業があるか」「まだ決まっていないことは何か」を判断できるかを読みます。元メモにない決定が増えていたら、資料に戻って修正します。
例2:小さなCSVから、件数と例外を整理する
練習用CSVを5行用意し、3行を「対応済み」、1行を「未対応」、1行を空欄にします。先に自分で期待値を決めることで、Codexの集計を照合できます。
inquiries.csvを状態別に数えてください。
「対応済み」「未対応」以外と空欄は、未分類へ分けてください。
元データは変更せず、output/counts.csvへ結果を保存してください。
分類した件数と未分類の件数を足し、入力件数と一致するか確認してください。
この条件なら期待値は「対応済み3、未対応1、未分類1、合計5」です。合計だけ一致していても、分類の中身が違う可能性があります。未分類になった行も確認してください。
例3:既存ページを、スマホでも読めるようにする
index.htmlの紹介文と申込導線を確認してください。
困っていること:スマホ幅で本文が横にはみ出し、申込先が見つけにくい。
変えてよいもの:余白、文字の折り返し、要素の配置。
維持するもの:料金、会社情報、リンク先、計測タグ。
変更後に390px幅と1440px幅で表示を確認してください。
ファイルの修正と、実際に確認できた画面の状態を分けて報告してください。
コードを編集できることと、ブラウザを操作できることは別です。画面確認の手段がない環境なら、その制約を明記し、自分で表示を確認します。HTMLファイルの生成だけで「スマホ対応を確認済み」とは判断しません。
依頼の質を上げる、5項目の書き方
| 項目 | 曖昧な依頼 | 確認できる依頼 |
|---|---|---|
| 目的 | よくして | 初めて見る人が対象と申込先を理解できるようにする |
| 入力 | いつもの資料を使って | product-facts.mdと最新版のFAQを参照する |
| 範囲 | 自由に直して | 紹介文と余白を変更し、料金とURLは維持する |
| 出力 | まとめておいて | drafts/summary.mdに3区分で保存する |
| 完了 | いい感じなら終わり | 元資料の数字と照合し、未確認点を残す |
毎回長い仕様書を作る必要はありません。最初に成果物の見本を一つ渡し、「この形で、今回の資料に置き換えて」と依頼できれば十分な場合もあります。反対に、新しい種類の仕事では、目的と判断基準を先に説明した方が修正の往復を減らしやすくなります。
途中の追加指示で、作業をやり直させすぎない
作業中に方向がずれたら、「違う」だけでなく、維持する部分と直す部分を指定します。たとえば「構成はこのままで、対象者の説明を先頭へ。料金の表は変更しない」と伝えると、直す範囲を判断しやすくなります。
新しい要望が出たときも、元の完了条件を忘れないようにします。文書へ図を追加した結果、元資料への参照が消えていないか。見た目を直した結果、リンク先が変わっていないか。追加した変更に対応する確認を一つ加え、すでに確認済みの範囲へ影響するなら再確認します。
「完成した」を判断するために見るもの
- 成果物:指定したファイルやページを自分で開けるか。
- 内容:数字・固有名詞・条件を入力資料と照合できるか。
- 挙動:必要な操作を実際に試し、期待する結果になるか。
- 保存・共有:必要な場所へ保存されたか。共有が依頼に含まれるなら相手のアクセスも確認したか。
- 残件:確認できなかった部分と理由が分かるか。
完成報告は、これらを短く説明できる形が役立ちます。「作った」「画面で確かめた」「公開した」は段階が異なるため、自分が依頼したところまで済んでいるかを判断してください。
うまくいかないときは、情報を足す場所を変える
指示を毎回長く書き足すより、繰り返す前提をAGENTS.mdに、定型作業をSkillsに分けます。外部の情報を取得する必要が出たらMCPを検討します。
- 違うファイルを直す:作業場所と対象を明示する。
- 文章が抽象的:実際の読み手と利用場面を渡す。
- 同じ間違いを繰り返す:短いルールと正しい例を残す。
- 途中で詰まる:エラー・試した操作・実行できない理由を確認する。
料金・利用条件は、契約画面と公式情報で確認する
プランに含まれる機能、使用量、API経由の課金は同じものではありません。導入時に利用するアカウントと方式を決め、公式料金・利用条件で確認してください。会社の運用は法人導入の進め方も参考になります。
よくある質問
非エンジニアでも始められますか?
自然な日本語で仕事を説明できます。ただし、実行するコマンドや変更内容の意味が分からない場合は、その説明を先に求めてください。まずは資料整理や既存ページの小さな修正から始めると確認しやすくなります。
一度頼めば、ずっと自動で仕事が回りますか?
単発の依頼と、定期実行の仕組みは別です。自動運用には入力、実行条件、確認方法、失敗時の扱いを決める必要があります。最初の一件が確認できてから、繰り返しへ広げましょう。





