5分で読める · はじめてのAIコーディングエージェント
対象: 初心者 · CLI · OpenAI
はじめに
ChatGPTにコードを貼り付けて「バグを見つけて」と聞くと、素晴らしい分析を返してくれます。でも、その修正をエディタに手動でコピーし直して、ウィンドウを切り替えて、テストして…気づけば30分が経っています。
まるで「良いアドバイスをくれるけど、キーボードには絶対に触れない」友人のようです。
Codex CLIは違います。アドバイスするだけでなく、あなたのマシン上で実際に作業します。
Codex CLIとは？
Codex CLIは、OpenAIが開発したオープンソースのターミナルAIエンジニアです。自然言語で指示を出すだけで、コードを読み、ファイルを編集し、コマンドを実行します——すべてローカルマシン上で。
| ツール | イメージ |
|---|---|
| ChatGPT | 電話越しの賢い友人 — アドバイスはくれるが手は出せない |
| GitHub Copilot | 隣でコードを補完してくれる同僚 — 快適だがコードのみ |
| Codex CLI | 向かいの席に座るインターン — タスクを任せれば自分で実行して成果を渡す |
ChatGPTと何が違うのか？
| ChatGPT | Codex CLI | |
|---|---|---|
| コードを読める？ | 貼り付けた分だけ | プロジェクト全体をスキャン |
| ファイルを編集できる？ | 不可 | 可（サンドボックス内） |
| コマンドを実行できる？ | 不可 | 可（npm test, git diff 等） |
| コードレビュー | 貼り付けた分だけ |
/review でPR全体を監査 |
| オープンソース？ | いいえ | Apache 2.0、完全OSS |
| セキュリティ | コンテンツフィルターのみ | OSレベルのサンドボックス + 3段階承認 |
**ChatGPTは「会話ツール」、Codex CLIは「実行ツール」**です。
インストール：3分で最初の会話へ
Step 1: ターミナルを開いてインストール
npm install -g @openai/codex
macOSユーザーはHomebrewでも：
brew install --cask codex
インストール後、OpenAIアカウントでログイン：
codex auth
ChatGPT Plus/Proのアカウントが使えます（利用量はサブスクリプションに計上、追加料金なし）。
Step 2: 起動！
codex
全画面のターミナルインターフェース（TUI）が表示されます。
Step 3: 最初の指示
TUIに直接入力：
Write a Python script that downloads the top 10 posts from Hacker News
and prints their titles with links.
Codexが環境をスキャンし、Pythonの確認、スクリプト作成、実行まで行います。途中で y を一度押すだけです。
これがCodex CLIの基本体験：話す → 実行する → 確認する → 完了。
TUIの基本操作
| ショートカット | 機能 |
|---|---|
| そのまま入力 | Codexに話しかける |
/diff |
Codexが変更した内容を表示 |
/review |
コードレビューを依頼 |
/model gpt-5.5 |
モデルを切り替え |
/plan |
実行前に計画を確認 |
/permissions |
セキュリティモード切替 |
/clear |
新しい会話を開始 |
/fork |
会話を複製して別案を探索 |
Ctrl+R |
入力履歴を検索 |
初心者向けアドバイス：最初の1週間は「入力」+「/diff」だけで十分です。
明日から使える5つのユースケース
1. 未知のコードベースを探索
Explain the architecture of this project. What are the main modules,
how do they connect, and where should I start reading?
半日かかっていたコードリーディングが2分で完了。
2. CIの失敗を自動修正
codex exec "Check which tests are failing, find the root cause, and fix them"
codex exec（略して codex e）は非対話モード。CI/CDパイプラインに最適。
3. ドキュメントの自動生成
codex exec "Find all public functions without docstrings and add them following PEP 257" --sandbox workspace-write
500ファイルのプロジェクトで、従来2日 → 30分に短縮。
4. コードレビュー
TUIで /review と入力するだけ。変更内容を分析し、リスク評価と改善提案を表示。
5. スクリーンショットからコード生成
codex -i mockup.png "Implement this UI using Tailwind CSS"
手作業の70%を削減。
セキュリティ：なぜAIに任せられるのか
第1層：承認モード
| モード | AIの権限 | 用途 |
|---|---|---|
| Read Only | 読み取りのみ | コード探索・レビュー |
| Auto | ファイル編集可、コマンド実行前に確認 | 日常開発（デフォルト） |
| Full Access | 制限なし | CI/CDパイプライン |
/permissions でいつでも切替可能。
第2層：OSレベルサンドボックス
macOSのSeatbelt、Linuxのbubblewrap、Windowsのネイティブサンドボックスを使用。デフォルトではカレントディレクトリ内のみ操作可能。
第3層：ルールエンジン
sudo、bash -c、rm -rf / などは恒久的に禁止。AIがどんなに説得しても実行されません。
よくある初心者のミス
- ChatGPTと同じ使い方：「このコードを説明して」ではなく「このモジュールをasync/awaitにリファクタリングして」
- Full Accessの常用：日常はAutoモードで。全自動はCI/CD専用
-
/diffを忘れる：毎回のセッション後に/diffで変更確認を習慣化
クイックリファレンス
| やりたいこと | コマンド |
|---|---|
| Codex CLI起動 | codex |
| TUIから抜ける |
Ctrl+C → exit
|
| 非対話でタスク実行 | codex e "テスト修正" |
| AIの変更を確認 | /diff |
| コードレビュー | /review |
| 新しい会話 | /clear |
| モデル切替 | /model gpt-5.5 |
| セキュリティモード切替 | /permissions |
| 前回のセッション再開 | codex resume --last |
次のステップ
- インストールして遊ぶ：10分でインストール→ログイン→3つの簡単なコマンド実行
- 実際のタスクで試す：仕事の実務（ドキュメント追加、バグ修正、プロジェクト探索）をCodexに任せる
-
/diffを習慣に：毎回のセッション後に変更内容を確認する習慣をつける
Codex CLIはあなたを置き換えるのではなく、「何を作るか」の判断に集中する時間を作ってくれます。
参考資料
- OpenAI Codex CLI 公式ドキュメント
- Codex CLI GitHubリポジトリ（74.5K+ Stars, Apache 2.0）
- Shareuhack: Codex CLI完全ガイド
- Codex Knowledge Base: Rustアーキテクチャ