2025/09/18
【勉強会】 Codex CLI 勉強会を開催しました
はじめに
今回の社内勉強会では、OpenAI が公開しているコーディング AI エージェント Codex CLI の紹介とセットアップ方法を共有しました。
今年の初め頃から、Cursor などの IDE 型 AI を活用した開発スタイルが注目されてきました。一方で最近は、CLI 型 AI を用いたより構造的な AI 駆動開発にも関心が集まっています。
勉強会では「GUI ツールがあるのに、なぜ CLI を使うのか？」という疑問にも触れながら、CLI 型の特徴や活用シーンを整理しました。
ChatGPT 有料プラン加入者であれば追加料金なしで利用できる点も、試しやすさという意味でメリットの一つです。
コーディング AI エージェントとは
コーディング AI エージェントとは、開発作業に特化した AI ツールを指します。
単なるコード補完にとどまらず、次のような作業まで支援します。
- コード生成
- ファイル操作
- コマンド実行
- 設計支援
- コードレビュー
現在は大きく 3 つのタイプに分類されます。
| 種類 | 特徴 |
|
CLI 型 |
複雑なタスクが得意・自動化と相性が良い |
|
IDE 型 |
補完やインライン修正が得意 |
|
クラウド型 |
完全自律・長時間作業が可能 |
現場では、CLI 型と IDE 型を用途に応じて併用するケースも増えています。
CLI 型が注目される理由
CLI 型が広く知られるようになったきっかけの一つが Claude Code です。
Anthropic は、CLI 型は汎用性が高く、モデル進化の恩恵を受けやすい設計であると説明しています。
また実務面では、
- CI/CD に組み込みやすい
- スクリプトとの相性が良い
- 高性能 LLM を一定コストで利用できる
といった点が評価されています。
ベンチマーク（SWE-bench）でも高いスコアを記録しており、実用的な選択肢の一つと言えます。
Codex CLI とは
Codex CLI は、OpenAI が開発した CLI 型のコーディング AI エージェントです。
2025年4月に公開されました。
当初は、利用にあたり LLM を個別に用意する必要があったことや、CLI という形式に馴染みがないこともあり、大きな広がりには至りませんでした。
その後、ChatGPT 有料プランに Codex が組み込まれたことで、より手軽に高性能モデルを利用できるようになりました。
これをきっかけに、再び注目を集めています。
SWE-bench では 74.9％ というスコアを記録しており、一定の性能を示しています。
Codex CLI 導入ハンズオン（Windows）
今回は Azure OpenAI Service 経由でのセキュア利用 を前提に解説しました。
Node.js インストール
npm を使うため必須です。
Codex CLI インストール
npm install -g @openai/codex
Azure OpenAI Service 設定
config.toml を作成し、モデルを指定します。
今回は codex-mini を利用しました。
API キーを環境変数に設定
setx AZURE_OPENAI_API_KEY"******"
共通プロンプト設定（日本語化）
AGENTS.md に以下を記載します。
日本語で回答すること
デフォルトでは英語で応答される場合があるため、この設定を行いました。
基本操作
起動
codexモード切替（/approvals）
-
- Read Only（推奨）
- Auto
- Full Access（注意が必要）
まずは Read Only で挙動を確認する方法を紹介しました。
改行
Ctrl + Enter
ファイル指定
@ で指定可能
Claude Code と Codex CLI の使い分け
最近は、Claude Code と Codex CLI を用途別に使い分けるケースも見られます。
重要なのはツールの優劣ではなく、
- どのタスクにどのツールが向いているか
- チームとしてどう活用するか
という設計の視点です。
AI 駆動開発では、ツールそのものよりも運用設計が成果を左右します。
まとめ
IDE 補完中心の開発スタイルに加え、CLI エージェントを活用した自動化前提の開発も選択肢として広がっています。
Codex CLI は追加コストなしで試せる点や、高性能モデルを利用できる点から、検証する価値のあるツールの一つです。
当社では今後も Claude Code・Codex CLI などの CLI 型 AI を比較・検証しながら、自社にとって最適な活用方法を模索していきます。
