OpenAI Codex CLI - ターミナルで動作する軽量コーディングエージェント

 (github.com/openai)
17 ポイント 投稿者 GN⁺ 2025-04-17 | 1件のコメント | WhatsAppで共有
  • OpenAI Codexはターミナルで動作する軽量コーディングエージェントで、開発者がターミナル環境でChatGPTレベルの推論、コード実行、ファイル操作、バージョン管理機能を活用できるようにする
  • Codexは設定不要で、ネットワーク無効化とディレクトリサンドボックスによって安全に実行される
  • マルチモーダル機能をサポートし、スクリーンショットやダイアグラムを通じて機能を実装できる
  • Codexは完全なオープンソースであり、開発者が直接貢献し発展させられる利点がある
  • さまざまなOSで実行可能で、macOS、Linux、Windows WSL2をサポートする

OpenAI Codexの紹介

  • OpenAI Codexはターミナルで動作する軽量コーディングエージェント
  • 開発者はターミナル環境でChatGPTレベルの推論、コード実行、ファイル操作、バージョン管理機能を活用できる
  • 設定不要で、ネットワーク無効化とディレクトリサンドボックスによって安全に実行される
  • マルチモーダル機能をサポートし、スクリーンショットやダイアグラムを通じて機能を実装できる
  • 完全なオープンソースで、開発者が直接貢献し発展させることができる

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

  • Codexはエージェントの自律性を決定できる--approval-modeフラグを提供する
  • Suggestモードではファイル読み取りのみ可能で、すべてのファイル書き込み/パッチおよびシェルコマンドには承認が必要
  • Auto Editモードではファイルの読み取りとパッチ書き込みが可能で、シェルコマンドには承認が必要
  • Full Autoモードではファイルの読み取り/書き込みおよびシェルコマンドの実行が可能で、ネットワークは無効化され、現在の作業ディレクトリに制限される

プラットフォームサンドボックスの詳細

  • macOS 12+ではApple Seatbeltを使ってコマンドをラップする
  • LinuxではDockerを使用し、最小コンテナイメージ内でCodexを実行する
  • どちらのアプローチも日常的な利用では透過的に動作する

システム要件

  • OS: macOS 12+, Ubuntu 20.04+/Debian 10+, Windows 11 (WSL2)
  • Node.js: 22以上（LTS推奨）
  • Git: 2.23+（PRヘルパー機能のため推奨）
  • RAM: 最低4GB（推奨8GB）

CLIリファレンス

  • codex: 対話型REPLを起動
  • codex "…": 対話型REPLの初期プロンプト
  • codex -q "…": 非対話型の"静音モード"
  • 主なフラグ: --model/-m, --approval-mode/-a, --quiet/-q

メモリとプロジェクト文書

  • CodexはMarkdownの指示を次の順序でマージする: ~/.codex/instructions.md, codex.md（リポジトリルート）, codex.md（現在の作業ディレクトリ）
  • --no-project-docまたはCODEX_DISABLE_PROJECT_DOC=1で無効化できる

非対話型 / CIモード

  • Codexをパイプラインでヘッドレス実行できる
  • CODEX_QUIET_MODE=1で対話型UIのノイズを除去できる

レシピ

  • codex "Refactor the Dashboard component to React Hooks": クラスコンポーネントをリファクタリングし、テストを実行
  • codex "Generate SQL migrations for adding a users table": ORMを推論し、マイグレーションファイルを生成して実行
  • codex "Write unit tests for utils/date.ts": テストを生成して実行
  • codex "Bulk‑rename *.jpeg → *.jpg with git mv": ファイル名を安全に変更し、使用箇所を更新
  • codex "Explain what this regex does: ^(?=.*[A-Z]).{8,}$": 正規表現を説明
  • codex "Carefully review this repo, and propose 3 high impact well-scoped PRs": 影響の大きいPRを提案
  • codex "Look for vulnerabilities and create a security review report": セキュリティ上の脆弱性を見つけて説明

インストール

  • npm経由でインストール（推奨）: npm install -g @openai/codex
  • ソースからビルド: リポジトリをクローンした後、CLIパッケージに移動して依存関係をインストールし、ビルド

設定

  • Codexは~/.codex/で設定ファイルを探す
  • カスタム指示を定義可能: ~/.codex/instructions.md

FAQ

  • OpenAIは2021年にCodexというモデルをリリースしており、これは自然言語プロンプトからコードを生成するAIシステム
  • Codexは常にサンドボックス内で実行され、疑わしいコマンドやファイル変更が提案された場合はnを入力することで作業ツリーに影響を与えない
  • Windowsでは直接実行されず、Windows Subsystem for Linux (WSL2)が必要
  • サポートされるモデル: Responses APIを通じて利用可能なすべてのモデル

貢献

  • このプロジェクトは活発に開発中であり、コードが大きく変更される可能性がある
  • 貢献を歓迎しており、信頼性と長期的な保守性を重視する
  • 開発ワークフロー、高品質なコード変更の作成、PRの作成、レビューのプロセス、コミュニティの価値観、支援の受け方などのガイドラインを提供

ライセンス

  • このリポジトリはApache-2.0ライセンス

関連記事

1件のコメント

 
GN⁺ 2025-04-17
Hacker Newsの意見

  • Codex o4-miniとClaude Codeを比較して、中規模コードベースのドキュメント化を試みた

    • Claude Codeは素晴らしいドキュメントを書いた
    • Codexはコードにない内容を想像し、誤ったアーキテクチャを説明した
    • Codexの問題は、正しいコンテキストを読み込み、注意を払うことに苦労しているように見えること
    • o3とo4-miniモデルへの期待は高く、別のテストではより良い結果が出ることを望む

  • geminiにリポジトリ全体または一部を貼り付け、作成したスクリプトを使ってコードに変更を適用した

    • aider、copilot、continueなども試したが、それぞれ欠点があった

  • Claude Codeは非常に優れており、他のコーディングエージェントに失望した経験がある

    • Claude Codeを使って前向きな結果を得られ、15ドルのコストは正当化されるかもしれない
    • 競争が良い結果をもたらすことを願う

  • 関連するデモと紹介動画があり、Claude Codeへの直接的な回答になっている

    • オープンソースではなく、DMCAに関する言及がある
    • Claude Codeのインタビューがまもなく公開予定で、コードエージェントCLIの重要性を扱う
    • Claude CodeおよびOAI Codexのパワーユーザー事例を募集中

  • 現時点ではClaude Codeより性能が劣るが、オープンソースなので迅速に改善されることを望む

  • CodexはWindowsで直接は動作せず、WSL2が必要

    • Windowsでのネイティブ開発の範囲が縮小する傾向にある

  • Codexの初期使用体験は良くなかった

    • デフォルトモデルが動作せず、モデルを変更する必要がある
    • NodeJSエラーで最初にクラッシュした
    • 初期問題を解決した後、Claude Codeと比較中

  • OpenAI APIキーを環境変数として設定する方法がある

    • 他の3rd partyユーティリティがAPIキーにアクセスできる可能性への懸念がある

  • Amazon Q Developer CLIで良い結果を得ており、claude-3.7-sonnetを使っていると考えている