初心者から始めるCodex入門:AIと進める開発の基本要理

ブログ

Codexは単に質問に答えるだけのAIではなく、プロジェクトの内容を読み、コードを修正し、コマンドを実行して結果を確認する「作業するAI」です。専門用語が多く難しく感じるかもしれませんが、その本質は「先生がこれから学ぶ人に教える授業」のような形式で理解できます。

1. 基本は「お願い・確認・修正」の3ステップ

初心者が最初に覚えるべき操作は非常にシンプルで、AIに「全体を読んで提案してもらい、人間がOKした範囲だけを直させ、最後に確認する」という流れです。まずは「このプロジェクトが何をしているものか、初心者にも分かるように説明してください」と頼むところから始めるのが安全です。

2. ルールを共有する「AGENTS.md」

毎回同じ注意をするのを避けるため、プロジェクトのルールを記した「申し送りノート」がAGENTS.mdです。初心者に説明するなら、これは「AIの頭を急に良くする魔法ではなく、毎回忘れてほしくないルールを置いておくノート」と言い換えられます。

3. 必殺技を共通化する「Skills」と見回りの「hooks」
  • Skills(必殺技カード): 何度も繰り返す決まった手順を再利用できる形にしたものです。
  • hooks(見回り係): 作業の前後にルール違反がないかチェックする仕組みです。初心者は、最初から設定を書く必要はなく、まずは「危ない作業を止め、テストを確認する役割」であることを理解すれば十分です。
4. 外部とつながる「MCP」と自動化の「SDK/exec」
  • MCP(校外学習バス): GitHubやSlackなどの外部サービスから情報を取ってくる仕組みです。これから学ぶ人は、まずは読み取り専用の設定から始めるのが安全です。
  • SDKとexec(部品化): プログラムからCodexを呼び出す方法ですが、これはこれから学ぶ人が最初からやるべきことではありません。まずは手動で班長(Codex)にお願いするのが基本であり、放送室から自動で依頼を流すような自動化は、慣れてから検討する段階のものです。
結論:仕事を渡せる人になる

Codexを初心者に教える際の一ばん大事な結論は、「AIを使える人は、AIに詳しい人ではなく、仕事を分けて、ルールを渡して、確認できる人である」ということです。

このように、まずは小さなファイルから直し、その理由を説明させるというステップから始めることで、これから学ぶ人もCodexの本質を掴むことができます。

岡山のホームページ作成