メインコンテンツへスキップ
見出し画像

【中級でつまづいた人のための】Codexは結局何者?迷ったときに戻る、プロジェクト・推論・Skillsの基本

    Codexを使い始めたものの、途中でこんな疑問が出てきたことはありませんか?

    「ChatGPTとは何が違うのか」

    「推論はどのように選べばいいのか」

    「Skillsやプラグインを入れると、何が変わるのか」

    「どこまで説明すれば、思ったものを作ってくれるのか」

    自分も、Codexを使いながら何度も調べ直しました。

    アプリを作れることは分かる。

    コードを書いてくれることも分かる。

    でも、使える機能が増えるほど、Codexが結局何をするものなのか分かりにくくなります。

    この記事では、Codexを使っていて分からないことが起きたときに、戻って確認したことを書いていきます。

    この記事を読んだら、

    Codexへ何を伝えるべきか。

    どの設定を選ぶべきか。

    何ができて、どこから先は確認が必要なのか。

    といった迷ったときの判断基準を作れることが目的です。


    最初に結論:Codexは「コードを書くチャット」ではない

    初心者向けに一言でいうと、Codexは、

    ファイルを読み、必要な変更を考え、コードや資料を作り、実行結果まで確認する作業エージェント

    です。

    ChatGPTとの会話に近い画面で指示できますが、回答文を返すだけではありません。

    そのため、Codexへ依頼するときは、

    「質問に答えてもらう」

    というより、

    「目的を伝えて、完成まで作業してもらう」

    と考えた方が分かりやすいです。

    これらの基礎的な内容は、私がはじめてCodeXに触れた時にも記事にしているため、振り返りたいときはそちらも参照してみてください。


    ChatGPTとCodexは、何が違うのか

    ChatGPTでも、コードを書いてもらうことはできます。

    ただ、Codexはコードを画面に表示するだけではありません。

    実際の作業フォルダを読み、ファイルを変更し、動作確認まで進めることを前提にしています。

    ChatGPTが向いているのは、次のような作業です。

    • 質問や相談

    • 文章作成

    • 情報整理

    • 調査

    • アイデア出し

    • コード案の作成

    一方、Codexが向いているのは、次のような作業です。

    • プロジェクト内のコードを読む

    • ファイルへ変更を反映する

    • コマンドを実行する

    • エラーの原因を調べる

    • テストする

    • 複数のファイルをまとめて修正する

    文章作成や相談だけなら、ChatGPTで十分な場面もあります。

    一方で、

    「このフォルダにあるファイルを修正して、動くところまで確認してほしい」

    という作業では、Codexの方が向いています。


    1.Codexも、情報を明確に伝えるほど早く進む

    Codexは、短い文章でも作業できます。

    たとえば、テトリス風のゲームを作ったあとに、

    ブロックの色を黄色にしてください。
    
    落下速度を少し遅くしてください。
    

    と頼めば、変更すべきファイルを探し、該当箇所を修正してくれます。

    コードが書かれている場所や関数名を、自分で指定しなくても進められることがあります。

    ただし、何を作りたいのかが曖昧な場合は、Codexも正しい完成形を決められません。

    これはChatGPTと同じです。

    最低限、次の内容を伝えると進みやすくなります。

    • 何を作りたいか

    • 誰が使うか

    • 何を解決したいか

    • 必ず必要な機能

    • 今回は作らない機能

    • 完成と判断する条件

    長い指示を書くことより、目的と完成条件を明確にすることの方が重要です。


    コードの知識より、目的を説明する力が重要なこともある

    自分が聞いた事例では、エンジニアとコピーライターがCodexを使い、同じようにアプリ作成へ挑戦したところ、コピーライターの方が早く完成したケースがありました。

    これは、コピーライターの方が開発技術に詳しかったという意味ではありません。

    欲しい画面。

    ユーザーに取ってほしい行動。

    表示する言葉。

    完成したときの状態。

    これらを具体的に説明できたことが、作業の速さにつながったと考えられます。

    Codexはコードを補えます。

    しかし、利用者が本当に作りたいものまでは、何も伝えずに決められません。

    非エンジニアでも、

    「この機能がほしい」

    だけでなく、

    • なぜ必要なのか

    • 誰が使うのか

    • 使ったあと、どうなってほしいのか

    を説明できれば、Codexと作業を進められます。


    2.プロジェクトは、初心者向けにいえば「作業させるフォルダ」

    Codexを開くと、最初にプロジェクトを選びます。

    初心者向けには、

    プロジェクト=Codexに作業してもらうフォルダ

    と考えると分かりやすいです。

    たとえば、次のフォルダを選んだとします。

    C:\Users\ユーザー名\Documents\tetris-game
    

    フォルダの中に、次のようなファイルが入っています。

    tetris-game
    ├─ index.html
    ├─ style.css
    ├─ script.js
    └─ images
    

    Codexは、この中にあるHTML、CSS、JavaScript、画像などを確認して作業します。

    この状態で、

    ブロックの色を黄色にしてください。
    

    と頼むと、Codexは該当するファイルを探して変更します。

    ただし、プロジェクトは完全にフォルダと同じ意味ではありません。

    Codexアプリ上では、1つのプロジェクト内に複数のチャット、つまりスレッドを作れます。

    たとえば、同じテトリス風ゲームでも、次のように作業を分けられます。

    • テトリスを作るスレッド

    • 不具合を直すスレッド

    • デザインを改善するスレッド

    • スマートフォン対応を進めるスレッド

    作業対象となるフォルダを中心に、複数の作業を分けて進める単位がプロジェクトです。


    プロジェクトとスレッドを分ける基準

    成果物そのものが別の場合は、プロジェクトを分けます。

    たとえば、次の3つは別プロジェクトにした方が整理しやすいです。

    • note自動投稿ツール

    • ホットペッパービューティーの記事管理

    • テトリス風ゲーム

    一方で、同じアプリの機能追加やデザイン修正であれば、同じプロジェクト内でスレッドを分けられます。

    判断基準は、次のとおりです。

    まったく別のアプリを作る場合

    →プロジェクトを分ける

    同じアプリの別機能を作る場合

    →同じプロジェクト内でスレッドを分ける

    前の会話を引き継いで修正する場合

    →同じスレッドを続ける

    別の方法を最初から検討したい場合

    →新しいスレッドを作る

    前のやり取りが長くなりすぎたり、別の目的が混ざったりした場合も、新しいスレッドへ分けた方が整理しやすくなります。


    3.Codexは、知っているものなら短い指示でも作れる

    Codexに、

    テトリス風のゲームを作ってください。
    

    と伝えると、多くの場合は、一般的に知られているテトリスのルールをもとに作業を始められます。

    たとえば、次のような内容です。

    • 上からブロックが落ちる

    • ブロックを左右に動かす

    • ブロックを回転できる

    • 横一列がそろうと消える

    • 上まで積み上がるとゲームが終了する

    こうした広く知られている内容は、毎回すべて説明しなくても、ある程度の共通認識があります。

    ただし、想像している完成形が必ず同じとは限りません。

    たとえば、次のような部分は追加で指定した方が確実です。

    • 速度は徐々に上がるのか

    • スコア表示が必要か

    • 次のブロックを表示するのか

    • スマートフォンでも操作するのか

    • 音を付けるのか

    • ブロックの色をどうするのか

    有名なものは短い説明でも伝わりやすい。

    自分だけのルールは、具体的に伝える。

    この区別が必要です。


    実在しない名前を出した場合

    次のような、Codexが内容を判断できない名前を与えたとします。

    「サンマパニック」というゲームを作ってください。
    

    この名前だけでは、ゲームの内容が分かりません。

    その場合、Codexは質問を返すか、名前から内容を推測して作り始める可能性があります。

    推測で進めてほしくない場合は、最初に次の指示を入れます。

    内容を判断できない場合は、推測で実装せず、作業を始める前に質問してください。
    

    分からないことを質問する仕組みは、以前より強くなっています。

    ただし、Codexが必ず質問してくれるとは限りません。

    推測してほしくない作業では、質問するように明示する方が安全です。


    4.Codexの「推論」は、作業の難しさで変える

    Codexでは、モデルがどの程度深く考えるかを選択できます。

    画面や使用するモデルによって表示は異なりますが、次のような段階があります。

    • 低い

    • 中

    • 高い

    • 非常に高い

    推論を高くすると、複雑な作業を丁寧に考えやすくなります。

    その代わり、回答までの時間や使用量も増えます。

    そのため、常に「非常に高い」を選べばよいわけではありません。


    最初の壁打ちは「非常に高い」

    新しいアプリを作り始めるときは、Codexにこちらの考えを理解してもらう必要があります。

    たとえば、次のような場合です。

    • 何を作るか、まだ整理できていない

    • 実装方法を比較したい

    • 必要な機能を整理したい

    • 複数のサービスを連携したい

    • 調査しながら設計したい

    • 長期間使う仕組みを作りたい

    • 既存のコード全体を見直したい

    この段階では、推論を**「非常に高い」**にし、まず設計や作業計画を考えてもらう方が進みやすいと感じています。

    たとえば、次のように指示します。

    まず実装せず、目的、必要な機能、リスク、実装方法を整理してください。
    
    不足情報があれば質問してください。
    
    方針に合意したあと、実装へ進んでください。
    

    最初の設計がずれると、後から大きな手戻りが発生します。

    そのため、最初の壁打ちには推論を多く使い、実装方針を固める考え方です。


    小さな修正は「中」でも進められる

    すでに作ったアプリに対して、次のような小さな修正をする場合があります。

    ボタンの色を青から黄色へ変更してください。
    
    見出しの文字を4px大きくしてください。
    
    エラーメッセージの誤字を修正してください。
    

    このような作業なら、推論は「中」でも対応しやすいです。

    目安として、次のように使い分けています。

    誤字や色の変更

    →中

    小規模な機能追加

    →中から高

    原因が分からない不具合の調査

    →高

    新しいアプリの設計

    →高から非常に高い

    複数サービスの連携

    →非常に高い

    研究や難易度の高い構築

    →非常に高い

    レート制限や使用量については、こちらの記事にまとめています。

    ▼Codexのレート制限で止まらないために確認したこと


    5.Skillsは、何度も使う手順をCodexへ渡す仕組み

    毎回、同じ指示を書いている作業はありませんか。

    たとえば、次のようなルールです。

    • 記事を作るときは、最初に読者の悩みを書く

    • 画像を作るときは、ブランドカラーを使用する

    • コードを変更したら、必ずテストを実行する

    • 商品データを処理するときは、指定の列名へそろえる

    • 記事末尾には関連記事へのリンクを置く

    こうした繰り返し使う手順は、Skillとしてまとめられます。

    Skillには、次のような情報を入れられます。

    • 作業手順

    • 守るルール

    • 参照資料

    • テンプレート

    • 必要に応じて実行するスクリプト

    作成したSkillは、Codexが作業内容から自動的に選ぶ場合もあれば、名前を指定して呼び出すこともできます。

    記事作成Skillを使って、このメモからnote記事を作ってください。
    

    Skillを使うと、毎回長い説明を書く必要を減らせます。


    Skillは「完成品」ではなく「作業方法」

    Skill自体が記事やアプリを作るわけではありません。

    Skillは、Codexへ仕事の進め方を教えるものです。

    たとえば、記事作成なら、次の流れをSkillへ入れられます。

    入力された箇条書きを確認する
    ↓
    不足情報を質問する
    ↓
    読者と目的を決める
    ↓
    構成を作る
    ↓
    確認後に本文を書く
    ↓
    関連記事への導線を入れる
    

    この流れをSkillとして保存すれば、別の記事でも再利用できます。

    毎回同じルールを説明しているなら、Skill化できないか考える価値があります。


    6.画像の添付・生成・編集もできる

    Codexには、画像を添付して作業を頼めます。

    たとえば、次のような使い方です。

    この画面の余白が狭いので、見やすく修正してください。
    
    添付画像の配色に合わせて、ウェブサイトを作ってください。
    
    このエラー画面を見て、原因になりそうな箇所を調べてください。
    

    画像を参考に、コードやデザインを変更できます。

    また、画像生成に対応した環境では、Codex内から画像を生成・編集することもできます。

    このウェブサイト用の背景画像を作ってください。
    
    制作意図、配色、構図を説明してから生成してください。
    

    と頼めば、画像を作るだけでなく、なぜそのデザインにしたのかも説明させられます。

    ただし、制作意図の説明が自動で必ず付くわけではありません。

    説明が必要な場合は、プロンプトに含めます。


    7.プラグインやMCPをつなぐと、外部の情報や機能を使える

    Codexだけで作業を完結させる必要はありません。

    プラグインやMCPを接続すると、外部サービスの情報を読み、対応する操作を実行できます。

    たとえば、次のような使い方があります。

    • Slackの会話を整理する

    • Google Driveの資料を読む

    • Gmailのメールを確認する

    • Figmaのデザイン情報を参照する

    • GitHubのIssueやコードを確認する

    • ウェブサイトやアプリを作成する

    • 外部データを取得して資料へまとめる

    接続するサービスや与えた権限によって、利用できる操作は変わります。

    すべての連携で、読み取りや書き込みの両方ができるわけではありません。


    Skill・アプリ連携・MCP・プラグインの違い

    名前が多く、最初はかなり混乱しました。

    初心者向けには、次のように分けると理解しやすいです。

    Skill

    →作業の手順やルールをCodexへ教えるもの

    アプリ連携

    →外部サービスに保存されている情報や機能を使うもの

    MCP

    →Codexと外部ツールを接続するための仕組み

    プラグイン

    →Skill、アプリ連携、MCPなどをまとめて追加する仕組み

    たとえば、「Slackの会議内容をまとめて資料にする」という作業では、次のような組み合わせが考えられます。

    Slackと接続する
    ↓
    会話を取得する
    ↓
    Skillの手順に沿って整理する
    ↓
    ドキュメントを作成する
    

    外部情報を使う仕組みと、作業方法を教える仕組みは別物です。

    ここを分けて考えると、理解しやすくなります。


    8.コンテキストを読ませることは「再学習」ではない

    Codexにプロジェクト内の資料、過去のコード、説明文を読ませると、こちらの考えに合った出力になりやすくなります。

    ただし、これはモデル自体を新しくトレーニングしているわけではありません。

    正確には、

    現在の作業で参照するコンテキストを渡している

    状態です。

    たとえば、プロジェクト内に次の資料があったとします。

    ブランドガイドライン.md
    記事作成ルール.md
    過去記事.md
    商品情報.csv
    

    Codexがこれらを読むことで、次の情報を踏まえて作業できます。

    • 使う色

    • 避ける言葉

    • 記事の構成

    • 商品の最新情報

    • 過去に決めたルール

    資料を読ませることによって、そのプロジェクトに合った回答へ近づきます。

    ただし、別のプロジェクトや新しい環境でも永続的に学習されるわけではありません。


    Codexが何を考えて作ったのか確認する

    作業結果だけでは、なぜその実装になったのか分からないことがあります。

    その場合は、次のように質問します。

    今回の実装方針を決めた理由を説明してください。
    
    どのファイルと情報を参考にしましたか。
    
    ほかに検討した方法と、採用しなかった理由を整理してください。
    
    次に変更すると壊れる可能性がある箇所を教えてください。
    

    Codexの内部思考そのものを読むわけではありません。

    判断理由、参照した情報、変更内容を説明してもらう形です。

    これを繰り返すと、コードが分からなくても、どのような考えで作られているのかを理解しやすくなります。


    9.迷ったときに使うコピペ用テンプレート

    Codexが思ったように動かないときは、追加指示を思いつくまま書く前に、目的と現状を整理します。

    # 目的
    
    最終的に実現したいこと:
    [作りたいもの、解決したい問題]
    
    この機能を使う人:
    [利用者]
    
    完成と判断する状態:
    [動作、画面、出力結果]
    
    # 現在の状態
    
    現在できていること:
    [確認済みの内容]
    
    現在できていないこと:
    [エラー、不具合、不足機能]
    
    問題が発生する手順:
    1. [操作]
    2. [操作]
    3. [問題が起きる場所]
    
    # 作業範囲
    
    変更してよいもの:
    [ファイル、機能、設定]
    
    変更してはいけないもの:
    [既存機能、データ、デザイン]
    
    今回は作らなくてよいもの:
    [後回しにする機能]
    
    # 進め方
    
    まず原因と対応方針を整理してください。
    
    不足情報がある場合は、推測で変更せず、作業前に質問してください。
    
    方針を説明したあと、必要な修正を実行してください。
    
    修正後は、以下を報告してください。
    
    ・変更したファイル
    ・変更内容
    ・確認した動作
    ・残っている問題
    ・次に確認すべきこと
    

    この形で伝えると、Codexが勝手な前提で進むことを減らせます。

    特に重要なのは、次の5つです。

    • 目的

    • 完成条件

    • 現在地

    • 変更してよい範囲

    • 今回はやらないこと


    10.Codexが分からなくなったときの確認方法

    Codexを使っていて迷ったら、症状ごとに確認する場所を変えます。

    何を作ればよいか伝わらない

    →目的、利用者、完成条件を確認する

    変更してほしくないファイルまで修正された

    →変更してよい範囲と、変更禁止範囲を伝える

    機能を作りすぎる

    →今回は作らないことを明記する

    回答や提案が浅い

    →推論を高くする

    小さな修正なのに時間がかかる

    →推論を中へ下げる

    前の情報が混ざっている

    →スレッドやプロジェクトを分ける

    毎回同じ説明をしている

    →Skillへまとめる

    外部の情報を使いたい

    →アプリ連携、プラグイン、MCPを確認する

    画像を参考にしてほしい

    →画像を添付し、どこを見てほしいか指定する

    なぜその実装になったか分からない

    →参照した情報と実装理由を説明させる

    問題が起きたときは、すぐに設定を変えるのではなく、どの種類の問題なのかを切り分けることが大切です。


    11.Codexを常に同じ考えで使うには

    毎回同じ考えを持って行動するために、以下の表は重要なポイントになります。

    画像
    画像

    今回のメモ

    今回の内容をまとめます。

    • Codexは、コードを読み、編集し、実行する作業エージェント

    • プロジェクトは、初心者向けには作業対象のフォルダと考える

    • 同じプロジェクト内で、複数のスレッドを分けられる

    • Codexも目的や完成条件を明確にするほど進みやすい

    • 有名な仕組みは短い説明でも理解しやすい

    • 独自の名称やルールは具体的に説明する

    • 最初の設計や難しい調査では、推論を高くする

    • 小さな修正では、中程度の推論でも進められる

    • Skillsには、繰り返し使う手順やルールを保存できる

    • 画像の添付、生成、編集にも対応できる

    • プラグインやMCPで外部サービスと接続できる

    • コンテキストを読ませることは、モデルの再学習ではない

    • 判断理由や参照した情報は、Codexへ説明させる


    もう1ステップ進みたいなら

    Codexへ何を伝えるべきか迷う場合は、プロンプトを完成形から逆算する考え方が役立ちます。

    2026/6/26 追記
    まだ調べたりないと感じたため、続編となる記事を書きました。
    ここを読んでいただくと、中級へのステップにさらに進めやすくなります。

    続・【中級でつまづいた人のための】Codexで迷ったときに戻る、プロジェクト・推論・Skillsの基本
    https://note.com/egashi_aiwork/n/ndf7311deed98

    ▼ChatGPTの回答がずれる原因は「ゴールの曖昧さ」でした|プロンプトエンジニアリング入門

    Codexの推論を高くしたときに、レート制限や使用量が気になる場合はこちらです。

    ▼Codexのレート制限で止まらないために確認したこと

    Codexの動作自体が重くなった場合は、こちらに対処法をまとめています。

    ▼Codexが重い。10個以上試して最後に効いた、表示キャッシュだけ削除する方法

    Codexを使ったnote投稿の自動化については、こちらです。

    ▼noteの記事自動公開をCodexで試した記録


     
     
    AIの活用事例や最新情報を、実際に使った活用事例、中級者でもつまづきそうになる点などを、日本一わかりやすくを目標に取り組んでいます。 【メインコンテンツ】 大規模言語モデル、ChatGPT、CodeX、画像生成、アプリ制作、デザインなど

    あなたへのおすすめ