codex CLIの再起動コマンド
'''
npx codex
codex
'''
OpenAI Codex CLIの設定
基本的なインタラクションを超えて、Codex CLIはその動作を調整し、より複雑なワークフローに統合する方法を提供します。
CLIリファレンス:
codex: 対話モード。
codex "...": 初期プロンプトを持つ対話モード。
codex -q "..."またはcodex --quiet "...": スクリプトに適した対話的でない「静かなモード」。-jsonフラグが追加されている場合はJSONを出力します。
主要フラグ:
-model / m: 使用するOpenAIモデルを指定します(例:gpt-4、o4-mini)。
-approval-mode / a: 自動化レベルを設定します(suggest、auto-edit、full-auto)。
-quiet / q: 対話的でないモードを有効にします。
メモリとプロジェクトのコンテキスト:
Codex CLIは、Markdownファイルからプロジェクト固有の指示とコンテキストを組み込むことができ、特定の優先順位でレイヤリングします:
~/.codex/instructions.md: すべてのプロジェクトに適用される個人的で全体的なガイダンス。
codex.md(リポジトリのルートに): プロジェクトの共有ノート、規則、または全体のリポジトリに対する高水準のコンテキスト。
codex.md(現在の作業ディレクトリに): サブパッケージまたはディレクトリに対する特定の指示。
これにより、チームはプロジェクトの標準を埋め込んだり、Codexが使用するためにコードベース内にヒントを直接提供したりできます。この機能は、--no-project-docフラグを使用するか、環境変数CODEX_DISABLE_PROJECT_DOC=1を設定することで無効にできます。
非対話的 / CIモード:
自動化のために設計されたCodex CLIは、継続的インテグレーション(CI)パイプラインでヘッドレスで実行できます。--quiet(または-q)フラグを使用するか、CODEX_QUIET_MODE=1の環境変数を設定することで、対話的UI要素が抑制されます。
例としてのGitHub Actionステップ:
- name: Codexを使用した変更ログの更新
run: |
npm install -g @openai/codex
export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}"
codex -a auto-edit --quiet "最近のコミットに基づいて次のリリースのためにCHANGELOGを更新する"
設定ファイル:
Codexは~/.codex/ディレクトリ内で設定を探します:
~/.codex/config.yaml: デフォルト(好ましいモデルやフルオートモードでのエラー時の動作など)を定義します。
model: o4-mini # 呼び出し時のデフォルトモデル
fullAutoErrorMode: ask-user # エラー時の動作:ask-userまたはignore-and-continue
~/.codex/instructions.md: 前述のように、グローバルなカスタム指示のために(例: "常に絵文字で返答してください", "明示的に指示しない限りgitコマンドを使用しないでください")。
実用的なアプリケーション:成功のためのレシピ
READMEには、Codex CLIが適しているタスクの種類を示すいくつかの具体的な例(「レシピ」)が提供されています:
コードのリファクタリング: codex "ダッシュボードコンポーネントをReact Hooksにリファクタリングする" - Codexはクラスコンポーネントを分析し、書き換えを試み、テスト(npm test)を実行し、承認のための差分を示します。
マイグレーションの生成: codex "ユーザーテーブルを追加するためのSQLマイグレーションを生成する" - 使用しているORM(例:Prisma、Sequelize)を推測し、必要なマイグレーションファイルを作成し、それらをサンドボックス化されたデータベース環境で実行します。
ユニットテストの作成: codex "utils/date.tsのユニットテストを書く" - Codexはテストケースを生成し、それらを実行し(おそらくnpm testまたはjestなどのシェルコマンドを通じて)、通過するまでコードまたはテストを修正します。
一括ファイル操作: codex "一括リネーム *.jpeg → *.jpg with git mv" - 必要なgit mvコマンドを作成して実行し、コード内の参照/インポートも更新します。
コード/正規表現の説明: codex "この正規表現が何をするのか説明してください: ^(?=.*[A-Z]).{8,}$" - LLMの説明力を活用して、人間が読める形式で的確な説明を提供します。
高レベルなリポジトリ分析: codex "このリポジトリを慎重にレビューし、影響の大きいスコープの狭いPRを3つ提案してください" - 戦略的なコードレビューおよび提案生成の可能性を示しています。
セキュリティ監査: codex "脆弱性を探し、セキュリティレビュー報告書を作成してください" - AIの知識ベースを使用して潜在的なセキュリティ上の欠陥を特定し、それらを説明します。
結論
オープンソースでCLIを重視した開発者のために構築されているCodex CLIは、信頼できるコーディングエージェントとして不可欠な存在を目指しています。生産性を向上させ、開発者がコマンドラインから複雑な課題に集中できるようになっています。アクティブな開発が続く中で、開発者が日常のワークフローでAIとどのように相互作用するかを大きく変える可能性を秘めています。