Codex CLI をローカルで使う手順

更新日：2025/05/04

インストール、初期設定について

前提としてCodex CLI をローカルでインストールする場合、基本的にはプロジェクトごとにインストールすることになるよ！

というのも npm の仕様によるもので…

npm install @openai/codex は そのフォルダ（プロジェクト）専用、

要するに、node_modules/ にライブラリが入って、他のプロジェクトからは見えない、、

  • プロジェクトフォルダ作成
mkdir codex-cli-test
cd codex-cli-test
  • npmでプロジェクト初期化
npm init -y
  • Codex CLI をインストール
npm install @openai/codex
npm install したらどうなる？ 生成されるファイル構造 project/ ├── node_modules/ │ ├── .bin/ │ │ └── [実行ファイル] │ └── [パッケージ名]/ └── package.json # コマンドライン実行用 # パッケージ本体 実行方法 方法1: npx $ npx [コマンド] [引数] node_modules/.bin/内を実行 方法2: npm scripts $ npm run [スクリプト名] package.jsonに定義が必要

これでプロジェクトフォルダ内でcodexをCLIで動かせます、、が先にAPIキーをセットしないとエラーになってしまいます

Codex CLIは、APIキーをどう取得する？

APIキーはPowerShellの設定ファイルに追記することによって、実行時にAPIキーを使用できます

↓$PROFILE は「PowerShell起動時に実行されるスクリプトファイルのパス」

echo $PROFILE
C:\Users\username\OneDrive\ドキュメント\WindowsPowerShell\Microsoft.PowerShell_profile.ps1
  • プロファイルファイルを開く
notepad $PROFILE

↓存在してなけれが、新規作成

メモ帳 × ファイル C:\Users\username\OneDrive\ドキュメント\WindowsPowerShell \Microsoft.PowerShell_profile.ps1 が見つかりません。 新しく作成しますか？ はい いいえ
  • メモ帳でAPIキーについての1行をいれて保存
$env:OPENAI_API_KEY = "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
≡ Microsoft.PowerShell_profile − □ × + ファイル 編集 表示 ∨ ⚙ $env:OPENAI_API_KEY = “sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx” 行 1、列 135 135 文字 100% Windows (CRLF) UTF-8
  • PowerShell を開き直してAPIキーが登録できているか確認
echo $env:OPENAI_API_KEY

※PowerShellの環境変数にだけ保存されていて、プロジェクト内（＝フォルダやコード）には保存されてないから安全（Git管理しても大丈夫！）

  • Codexへの最初のチャット文
npx codex "say hello"
PS C:\user\codex-cli-test> npx codex “say hello” ● OpenAI Codex (research preview) v0.1.xxxxxxxxx localhost session: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx └ workdir: C:\user\codex-cli-test └ model: o4-mini └ provider: openai └ approval: suggest user say hello codex Hello! How can I help you today? | ctrl+c to exit | “/” to see commands | enter to send – 100% context left

基本のコマンド

ローカルにインストールしている場合は（グローバルでない）は上記の導入でnpxを付けて実行

コマンド機能例
codexインタラクティブ起動
codex "説明して"1発コマンド
codex -i image.pngスクショ入力
codex -m o4-miniモデル変更
codex -d ~/myrepo作業ディレクトリ指定
codex --suggest提案型モード
codex --auto-edit自動編集モード
codex --full-auto全自動サンドボックスモード

新規記事

すべてを見る
人気記事ランキング
ピックアップ記事
話題のキーワードから探す