TOMONIAI School
🔎 お試し閲覧(プレビュー)。ログインすると進捗保存・テスト採点・修了証が使えます。

Level 2 OpenAI Codex を使う

OpenAI Codex(CLI)を導入し、承認モードとサンドボックスを理解して小さなタスクを安全に任せられる

  1. レッスン本文
  2. 実務演習
  3. チェックテスト

広げる ― もう一つの相棒で、選択肢を増やす

「道具は一つでなくていい。場面で選べると強い。」

このレベルで身につけること
OpenAI の Codex(ターミナルで動く Codex CLI)を導入し、Claude Code と同じ「頼む→確認→承認」のリズムで使う。特に 承認モードとサンドボックス(AIの作業を安全な範囲に閉じ込める仕組み)を理解し、安全に任せる感覚を身につける。

学習の流れ:① Codexとは → ② 導入する → ③ 承認モードとサンドボックス → ④ AGENTS.md とモデル → ⑤ 小さなタスクを完走する

📌 前回の振り返り(Level 1):Claude Code で「頼む→差分を読む→承認」の基本サイクルを身につけました。Codex も同じリズムです。新しく覚えるのは主に「安全のための設定(承認モードとサンドボックス)」です。

特に変わりやすい部分があります。 モデル名や利用上限は頻繁に変わります。最新は公式ドキュメント developers.openai.com/codex を正としてください。


Section 1 Codex とは

「コードを書くAIエージェント」の総称

ここでいう Codex は、OpenAI のAIコーディングのための道具の総称です(昔あった2021年の古い「Codex」モデルとは別物)。 使う場所によって、いくつかの形があります。

どこで使う
Codex CLIターミナルで動く(オープンソース)。本レベルで使うのはこれ
IDE拡張VS Code などのエディタの中で使う
クラウド版(ChatGPT内)ChatGPTから作業を頼み、クラウドで進めてもらう
codex exec対話せず自動で動かす(自動化・CI向け)

まずは Codex CLI を、ターミナルで動かしてみましょう。Claude Code と役割はよく似ています。

ポイント「Codex」は一つのアプリ名ではなく“家族”の名前。本レベルではターミナル版(Codex CLI)を扱う。

Section 2 導入する

インストールとサインイン

① インストールする(いずれか一つ)

# Node.js(npm)を使う場合 ※パッケージ名の @openai/ に注意
npm install -g @openai/codex
# Homebrew(macOS / Linux)
brew install --cask codex

⚠️ よくある罠:パッケージ名は @openai/codex(先頭に @openai/)です。 @ の付かない codexまったく別の古いパッケージなので入れないこと。Windows は WSL2 での利用が無難です。

② 起動する 作業フォルダに入って codex と打つだけ。

cd my-project
codex

③ サインインする 初回に次のどちらかで認証します。

方法向いている人
ChatGPTアカウントでサインイン(Plus / Pro / Business など)プラン内の枠で使いたい人(おすすめ)
OpenAI APIキー使った分だけ(トークン課金)支払いたい人・自動化用途
ポイント起動の形は Claude Code とそっくり:「フォルダに入って codex」。覚えることは少ない。

Section 3 承認モードとサンドボックス

AIを“安全な砂場”の中で働かせる

Codex の特徴は、サンドボックスという考え方です。 サンドボックス=AIの作業を安全な範囲(砂場)に閉じ込め、許可なく外へ影響を出させない仕組みのこと。 これを 承認モード で切り替えます。3つだけ覚えましょう。

モードできること確認のされ方
Read Only(読み取りのみ)読む・分析する・計画を出す変更や実行の前に必ずたずねる
Auto(自動)★既定作業フォルダの中で読み・編集・実行フォルダのやネット利用の前にたずねる
Full Access(フルアクセス)どこでも読み書き・ネット利用たずねない(危険・上級者向け

既定は Auto。「作業フォルダの中なら自分で進め、外に出るときは人に聞く」という、ちょうどよい安全さです。

図を描画中…
ポイント初心者は Auto のままでOK。Full Access や「承認スキップ」の危険オプションは、信頼できる場面以外で使わない。

Section 4 AGENTS.md とモデル

お約束メモと「頭脳」の選び方

AGENTS.md は、Codex に渡すプロジェクトのお約束メモです。 Claude Code の CLAUDE.md と同じ役割で、流儀・テスト方法・やってほしくないことなどを書いておくと、 Codex が作業の前に読んで従ってくれます。

モデル(AIの頭脳) Codex には既定のモデルが自動で選ばれます。 モデル名はとても頻繁に新しくなるため、教材では特定の名前を覚えません。 切り替えたいときは codex --model 〈名前〉 などで指定でき、今の一覧は公式ドキュメントdevelopers.openai.com/codex/models)で確認します。

ポイントモデル名は“水もの”。暗記せず「既定で動く・必要なら切替・最新は公式で確認」と覚えるのが正解。

Section 5 小さなタスクを完走する

Auto モードで、安全に1つ作る

小さなフォルダ(例:calc.py が1つあるだけ)で試してみましょう。

  1. フォルダに入って codex を起動。初回は ChatGPTでサインイン
  2. モードが Auto であることを確認。
  3. こう頼む:

    calc.py に、2つの数を足して返す関数 add(a, b) を追加して。あわせて、その動きを確かめる簡単なテストも書いて、テストを実行して。」

  4. Codex が 計画と差分を提示 → あなたが読む。フォルダ内の編集は Auto なら進む。
  5. テスト実行コマンドを承認 → 結果(成功)が表示される。
  6. 続けて改善:

    「文字が渡されたときは、わかりやすいエラーを返すようにして。」

  7. また差分→承認→実行。これで安全に完走です。
ポイント「テストも書いて、実行して」と頼むと、AI自身に動作確認までさせられる。これも事故を減らす良い習慣。

⚠️ よくある失敗

安全のための仕組みを、自分で外してしまう
「いちいち確認されるのが面倒」と感じて、Full Access や「承認をスキップする危険オプション」を最初から使ってしまう——これは事故のもとです。実際、フルアクセスのまま信頼できないプロジェクトでAIを動かし、想定外のコマンドが走ってしまった、という失敗があります。
学び:サンドボックスと承認は“ブレーキ”。既定の Auto を保ち、信頼できる場面以外でブレーキを外さない。心配なら Git で記録し、いつでも戻せるようにしておく。

このレベルのまとめ

  • Codex はOpenAIのAIコーディングの総称で、本レベルではターミナルの Codex CLI を使った
  • 導入は「@openai/codex をインストール → フォルダで codex → ChatGPTかAPIキーでサインイン」
  • 承認モードは3つ(Read Only / Auto〈既定〉/ Full Access)。Auto が安全で便利
  • AGENTS.md でお約束を渡せる。モデル名は変わりやすいので最新は公式で確認
  • 安全装置(サンドボックス・承認)をむやみに外さない——これが安全に任せるコツ

次は 実務演習(exercises.md) で、学んだことを自分の言葉にしてみましょう。

実務演習

Level 2 実務演習

やってみる ― 「安全に任せる」を手で覚える

教材を読んだら、必ず手を動かしてください。


演習 1|Claude Code と Codex の「同じ」と「違い」を言葉にする

以下のシナリオを読んで、空欄を自分の言葉で埋めてください。

シナリオ:Level 1 で Claude Code を覚えた友人に、「Codex って何が同じで、何が新しいの?」と聞かれました。 2〜3文で説明してください。

答えを見る

【参考】こう言えたらOKの例

「基本のリズムは同じで、ターミナルでフォルダに入って起動して、日本語で頼む→差分を確認→承認、の繰り返しだよ。新しく覚えるのは“サンドボックス”っていう安全の仕組みで、AIをどこまで自由に動かすかを Read Only / Auto / Full Access で選べる。ふだんは Auto のままで大丈夫。」

ポイント:「リズムは同じ」「新しいのは承認モード/サンドボックス」「既定はAutoで十分」に触れていればOK。


演習 2|場面に合う承認モードを選ぶ

次の場面で、Read Only/Auto/Full Access のどれが適切か選び、理由を一言添えてください。

場面選ぶモード理由
A自分の小さな練習フォルダで、ファイルを編集させたい
B中身をまだ信用していない、拾ってきたプロジェクトを“調べるだけ”
Cフォルダの外やネットも自由に触らせたい(通常の学習で)
Dテストの実行まで、作業フォルダ内で一通り任せたい
答えを見る

【答え合わせ】

モード解説
AAuto作業フォルダ内の編集・実行を任せられ、外に出るときだけ確認。ふだん使いに最適
BRead Only信用できない物は、まず読むだけ。変更や実行はさせない
C(避ける)Full Access は通常の学習では不要。むやみに使わないのが正解
DAuto作業フォルダ内ならテスト実行まで進む。外部に出るときは確認される

ポイント:迷ったら Auto。信用できない物は Read OnlyFull Access は基本使わない


演習 3|Auto モードで小さなタスクを完走する(実践)

実際に Codex CLI を起動して、次のミニタスクを最後までやってみましょう。

お題:小さなフォルダで codex を起動(Autoモード)。 「2つの数のうち大きい方を返す関数を作って、その動きを確かめるテストも書いて、実行して」と頼む。 そのあと「同じ数だったときは『同じ』と返すようにして」と1回だけ改善を頼む。

やってみて気づいたこと(モードの表示・どこで確認を求められたか・テスト結果):
答えを見る

**【参考】**ねらいは“安全に完走する流れ”の体感です。次ができていれば十分です。

  • 起動時に モードが Auto であることを確認できた
  • 依頼 → 計画・差分が提示され、フォルダ内編集が進んだ
  • テスト実行まで行い、結果(成功)を確認できた
  • 追加依頼で小さく直せた

ポイント:「テストも書いて実行して」と頼み、AIに動作確認までさせたかどうか。これが安全に任せるコツ。


演習が終わったら、チェックテスト(test.md) で理解度を確認しましょう。


🤖 AI採点の観点(LMS用)

このセクションは、自作LMSの AI評価エンジンexercise_answers.ai_score 0〜100 / ai_feedback)に接続することを想定しています。

演習採点の観点(合格の鍵・3点)
演習1①基本リズムは Claude Code と同じと述べている/②新しい点が承認モード/サンドボックスだと述べている/③既定の Auto で十分に触れている
演習2①判定が妥当(A:Auto・B:Read Only・C:避ける・D:Auto)/②理由が「信頼できるか・範囲はどこか」に基づく/③Full Access をむやみに選んでいない
演習3①モードが Auto と確認できた/②差分提示とフォルダ内編集を体験/③テスト実行まで完走し小さく直せた

採点プロンプト(テンプレート)

あなたは「AIコーディング入門」の講師です。Level 2(OpenAI Codex を使う)の演習回答を採点してください。

【レベルの狙い】Codex(CLI)を導入し、承認モードとサンドボックスを理解して小タスクを安全に任せられる
【採点する演習】{{演習番号}}
【採点の観点】{{上表の該当する観点(3点)}}
【受講者の回答】{{answer_text}}

次のJSON形式だけで出力してください。励ます語り口で、専門用語は避けてください。
{
  "score": 0〜100の整数,
  "good": "良かった点(1〜2文)",
  "improve": "もっと良くなる点(1〜2文)",
  "one_tip": "次に試すと伸びる具体的な一歩(1文)"
}

チェックテスト(練習・採点あり)

🟢 練習モード:その場で採点します(記録は残りません)。本番採点・進捗・修了証は ログイン後に使えます。

10問・8問以上正解で合格です。すべて選択してから採点してください。

Q1.本コースでいう「Codex」とは何を指しますか?

Q2.本レベルでターミナルから使うのは、Codex のどの形ですか?

Q3.Codex CLI を npm で入れるときの正しいパッケージ名はどれですか?

Q4.Codex CLI のサインイン方法として、教材が案内している組み合わせはどれですか?

Q5.「サンドボックス」の説明として最も適切なものはどれですか?

Q6.Codex CLI の既定(デフォルト)の承認モードはどれですか?

Q7.「Auto モード」のふるまいとして正しいものはどれですか?

Q8.中身をまだ信用していない、拾ってきたプロジェクトを「調べるだけ」にしたいとき、適切なモードはどれですか?

Q9.`AGENTS.md` の役割として最も適切なものはどれですか?

Q10.Codex の「モデル」との付き合い方として最も適切なものはどれですか?

このレベルの気づき

感じたこと・気づいたこと・分からなかった点を一言どうぞ(任意)。送信すると講師に届きます

※ プレビューでは送信できません。

本文を読み終えたら

TOMONI AI School