Codex CLI：OpenAIが発表したローカルコーディングAIエージェント 129

小编 · 2025-04-18

Codex CLIは、OpenAIが発表した軽量なコマンドラインツールで、ターミナルユーザーにChatGPTのような推論機能を提供します。ファイルの操作やコードの実実行・反復も可能で、すべての操作はバージョン管理下で行われます。マルチモーダル入力に対応しており、自然言語指示によるコード生成・編集・実行が可能です。

Codex CLI：OpenAIが発表したローカルコーディングAIエージェント

Codex CLIとは？

Codex CLIは、Openaiが発表した軽量なコマンドラインツールで、ターミナルユーザーにChatGPTのような推論能力を提供し、実際にコードを実行したり、ファイルを操作したり、バージョン管理のもとで反復作業を行うことができます。マルチモーダル入力に対応しており、自然言語による指示でコード生成・編集・実行などのタスクを完了できます。

Codex CLI：OpenAI推出的本地编码AI智能体.jpg

Codex CLIの主な機能

コード生成と編集：ユーザーが簡単な英語の指示でCodex CLIにコードを生成させることができます。例えば「CSVファイルを読み取り、特定の列の平均値を表示するPythonスクリプトを作成して」など。
ファイル管理：「すべての.txtファイルをnotesという名前のフォルダに移動する」のようなファイル操作の実行に対応しています。
デバッグ支援：エラーメッセージを貼り付けると、Codex CLIが修正案を提示します。
プロジェクト構築：「基本的なNode.jsサーバーを構築して」のようなプロジェクトテンプレートを迅速に生成できます。
マルチモーダル対応：スクリーンショットや図表を入力して機能を実装することができます。
ローカル実行：Codex CLIはローカルで動作し、ファイルの読み書きやコマンドの実行はすべてローカルで完結します。ユーザーが能動的に共有を選択しない限り、ソースコードがローカル環境を離れることはありません。

Codex CLIの特徴

オープンソース＆フリー：Codex CLIは完全にオープンソースであり、ユーザーは自由にコードを閲覧・変更し、その開発に貢献できます。
ローカル実行：このツールはローカルターミナルで実行され、コード実行とファイル操作がユーザーのシステム内で行われるため、データのプライバシーが保護されます。
モデル非依存：デフォルトではOpenAIのGPT-4-turboモデルを使用しますが、o3やo4-miniなど、他の互換性のあるAPIエンドポイントに切り替えることもできます。
柔軟な設定：.codex YAMLファイルで設定を行い、カスタム変数やテンプレートに対応しています。

セキュリティモデルと権限

Codex CLIは3つの承認モードを提供しており、ユーザーは --approval-mode パラメータで選択できます：

提案モード（デフォルト）：リポジトリ内の任意のファイルを読み取ることができますが、すべてのファイル書き込みとシェルコマンドにはユーザーの承認が必要です。
自動編集モード：ファイルの読み取りとパッチの書き込みを適用できますが、すべてのシェルコマンドにはユーザーの承認が必要です。
完全自動モード：ファイルの読み書きとシェルコマンドの実行を、ユーザーの承認なしに実行できます。

Codex CLIの使用シーン

Codex CLIは主にターミナル環境で作業する開発者を対象としており、日常の開発タスクをより効率的に完了できるようサポートします。完全な自動コーディングアシスタントではなく、通常のタスクをサポート・加速するためのツールです。

Codex CLIのインストール方法

npm経由でインストール（推奨）：

npm install -g @openai/codex

ソースコードからのビルド：

リポジトリをクローンしてCLIパッケージのディレクトリに移動します：

git clone https://github.com/openai/codex.git
cd codex/codex-cli

依存関係をインストールしてビルドします：

npm install
npm run build

ローカルでビルドしたCLIを実行するか、npm linkでグローバルにリンクします。

設定

Codex CLIは ~/.codex/ ディレクトリで設定ファイルを検索します：
config.yaml：デフォルトモデルなどの設定項目を設定できます。
instructions.md：カスタム命令を定義できます。

使用方法

インタラクティブ実行：

codex

特定のコマンドを実行：

codex "explain this codebase to me"

完全自動モード：

codex --approval-mode full-auto "create the fanciest todo-list app"

非インタラクティブモード / CIモード

CI/CDパイプラインでCodex CLIをヘッドレスモードで実行できます。例えば：

- name: Update changelog via Codex
run: |
npm install -g @openai/codex
export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}"
codex -a auto-edit --quiet "update CHANGELOG for next release"

githubアドレス：https://github.com/openai/codex

詳細情報：https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started