5分で読める · AIシステムアーキテクトが執筆
注力分野: Codex入門 · AIコーディングツール
CodexはChatGPTではありません
ChatGPTはチャットで質問に答えるだけ。でもCodexはあなたのプロジェクトの中で実際に作業します。ファイルを読み、コードを修正し、コマンドを実行し、何を変更したかをdiffで表示します。
初心者が最もやりがちなミス：「プロジェクト全体をリファクタリングして」と一度に大きなタスクを頼むことです。
正しい順番：
プロジェクトを読む → 計画を出す → 小さな変更 → diffを確認 → テスト → 繰り返す
エントリーポイントを選ぶ
| 入口 | おすすめ |
|---|---|
| Codex App ⭐ | 初心者向け |
| IDE拡張 | VS Code / Cursorユーザー |
| CLI | ターミナル操作に慣れた人 |
| Web / Cloud | GitHub自動化 |
Codex Appをダウンロードし、ChatGPTアカウントでログイン。小さなプロジェクトを選んで練習しましょう。
タスク1：まずは読むだけ
以下をコピペ：
まだファイルを変更しないでください。このプロジェクトを説明してください：
1. このプロジェクトは何をするものですか？
2. メインディレクトリの役割は？
3. エントリーポイントはどこ？
4. 実行方法は？
5. 不明な点は「不明」と答えてください。
タスク2：プロンプトを構造化する
4つの要素でプロンプトを組み立てます：
| 要素 | 内容 |
|---|---|
| Goal（目標） | 何を達成したいか |
| Context（文脈） | 関連ファイル、エラー情報 |
| Constraints（制約） | 禁止事項（新規依存追加禁止など） |
| Done when（完了条件） | 成功の確認方法 |
悪い例： 「チェックアウト処理を最適化して」
良い例：
Goal:
src/checkout/の重複バリデーションを削減
Context:src/checkout/とsrc/orders/validation.ts
Constraints: 公開APIの変更禁止、新規依存追加禁止
Done when:pnpm test --filter checkoutが全てパス、diffはsrc/checkout/のみ
タスク3：初めての変更——READMEだけ編集
README.mdだけを変更してください。「はじめに」セクションを追加して。
他のファイルは触らないで。新しい依存関係も追加しないで。
変更後、何を変えたか教えてください。
変更後：
git status # 変更ファイルを確認
git diff # 変更内容を確認
diffでチェックすべきポイント：
- ✅ 許可していないファイルを変更していないか？
- ✅ 知らない依存関係が追加されていないか？
- ✅ 重要な設定が削除されていないか？
- ✅ 内容が要件を満たしているか？
安全に使うために
| モード | 初心者のルール |
|---|---|
| Chat / 読み取り専用 | ✅ まずはここから |
| Agent / 自動 | ✅ diffを確認してから |
| 完全アクセス | ❌ 最初から使わない |
プロンプトに絶対に入れないもの：
❌ APIキー、データベースパスワード、本番トークン
❌ 顧客データ、個人情報
❌ 本番DB接続文字列
Gitチェックポイント：
git add .
git commit -m "checkpoint before codex"
7日間練習計画
| 日 | タスク | 目標 |
|---|---|---|
| 1 | プロジェクトを読んで説明 | 何をするのか理解 |
| 2 | 概要ドキュメント作成 | ドキュメント生成に慣れる |
| 3 | READMEのみ編集 | diffレビューに慣れる |
| 4 | 小さなバグ修正 | 現象の説明方法を学ぶ |
| 5 | 修正にテスト追加 | Codexに検証させる |
| 6 | 変更をレビュー | セカンドペアの目 |
| 7 | Worktreeで機能実装 | 隔離環境で作業 |
正しい始め方：
読む → 計画 → 小さな変更 → diff確認 → テスト → 繰り返す
タスクは小さく、権限は絞り、確認を徹底すれば、初日から安全に使えます。