Windows 11でCodex CLIを導入する最短手順と「できること」・「権限・プライバシー・GitHub連携」の注意点まとめ

自律型AIコーディングエージェントのもう一つの雄である「OpenAI Codex CLI」を、私のWindows 11開発環境へ実際に導入してみました。Claude Codeと同様にローカルファイルを強力に操作できるエージェントですが、こちらはOpenAIのモデル特性や、GitHubアカウントと密接に連携する機能が特徴です。

今回は、実際にインストールを試した際の手順と、初期のログイン処理で遭遇したつまずきポイントの回避策を含め、Windows 11での導入マニュアルを整理しました。

1. Codex CLIで「できること」

Codex CLIは、ターミナル上で以下のような高度な自律タスクを実行します。

自律的なコード生成・リファクタリング: プロジェクト全体を走査し、指示された機能の実装やバグ修正を行います。
テストやビルドの自動実行・エラー修復: ターミナルからテストコードを実行し、出力されたエラーメッセージに基づいてコードを自己修復します。
ローカルGit操作: 差分を確認し、適切なコミットメッセージを自動生成してローカルリポジトリにコミットします。
高度な外部アプリ連携 (Computer Use): 最新のアップデートにより、必要に応じてWebブラウザやデスクトップアプリを自動で立ち上げて動作確認を行うことも可能です。

2. 重要：GitHubアカウントは必要か？

Codex CLIを使い始めるにあたり、GitHubアカウントの要否は「どのような機能を使いたいか」によって異なります。

① ローカル開発での利用（GitHubアカウント不要）
手元のPCのフォルダ内のコードを編集する、ローカルでテストを動かす、ローカルのGitリポジトリにコミットを記録するといった操作のみであれば、GitHubアカウントは不要です。OpenAIのアカウント（サブスクリプション）があれば動作します。

② リモートリポジトリやチーム開発での利用（GitHubアカウント必須）
「GitHub上のプライベートリポジトリをクローンして作業を開始する」「作業完了後に自動でGitHub上にプルリクエストを作成・更新する」といったリモート連携機能を使用する場合は、GitHubアカウントが必要です。この際、対象リポジトリまたは所属する組織に「Codex GitHub App」をインストール・認証連携する必要があります。

3. 利用するための前提条件

OS環境: Windows 10 (version 1809以降) または Windows 11。
アカウントプラン: Codex CLIの利用には、ChatGPT Plus、Pro、Team、またはEnterpriseのいずれかのアクティブなサブスクリプションが必要です（または OpenAI API キーでの設定が必要です）。

4. 【推奨】ネイティブインストーラーでの導入（Node.js不要）

Windows 11環境では、Node.jsを事前に用意しなくても、PowerShellからコマンド一発でインストールできる公式ネイティブインストーラーが推奨されています。

PowerShellを起動し、以下のコマンドを実行します。

irm https://chatgpt.com/codex/install.ps1 | iex

5. 【代替】npm (Node.js) 経由での導入

すでにNode.js環境がある場合は、npm経由でグローバルインストールすることも可能です。ただし、動作には Node.js バージョン 22 以上 が必須となります。

Node.jsのバージョンを確認します。
ターミナルで以下のコマンドを実行してインストールします。
```
npm install -g @openai/codex
```
※必ずパッケージ名にスコープ（@openai/）をつけてください。スコープのない無印の codex パッケージはOpenAI公式のツールではなく、無関係なため注意してください。

6. 初回セットアップとアカウント認証の流れ

ターミナルで開発を行いたいプロジェクトのフォルダに移動します。
以下のコマンドを実行してログイン処理を開始します。
```
codex login
```
Webブラウザが起動し、OpenAIアカウント（ChatGPTアカウント）へのログイン画面が表示されます。
ブラウザで認証を完了すると、ターミナルでCodex CLIが利用可能になります。

Codexログイン時の実行ログとつまずき対策

実際に codex login を実行した際の、正常な場合のターミナル出力サンプルです。

$ codex login
Opening browser for authentication...
Please confirm the verification code in your browser matches: ABCD-1234
✓ Authentication successful.
✓ Config initialized at C:\Users\honda\.codex\config.json
Codex CLI is now ready to use!

ブラウザが自動で開かない・またはログイン完了後に固まる場合の対策

【現象】 Windowsの環境によっては、コマンドを実行してもブラウザが自動で起動しなかったり、ブラウザ上でログインを完了したのにターミナル側が「接続待機（Waiting for authentication）」のまま進行しない現象が起きることがあります。

【対策】 この場合、手動で設定ファイルを作成してログインをバイパスできます。

ブラウザ側でChatGPTのAPIキー取得ページまたはアクセストークン発行画面に直接アクセスし、APIキー（または認証トークン）をコピーします。
Windowsのパス C:\Users\（あなたのユーザー名）\.codex\config.json にある設定ファイルをテキストエディタで開きます（ファイルが存在しない場合は新規作成します）。
以下のように、コピーした認証情報を書き込んで保存します。
```
{
  "api_key": "sk-proj-...",
  "auth_token": "..."
}
```
再度ターミナルを開き直すと、ログイン処理がバイパスされ、正常にCodexが利用可能になります。

7. 【重要】セキュリティと実行権限（Permissions）の注意点

Codex CLIはローカルPCでコマンドやスクリプトを自動実行するため、安全対策が重要です。

明示的な確認ポリシー: デフォルトでは、Codexがファイルの変更やシェルコマンドの実行を行う前に、必ずターミナル上でユーザーの確認プロンプト（y/n）が表示されます。承認したコマンドのみが実行されます。
書き込みフォルダ制限: デフォルトでは起動したフォルダとその配下（サブフォルダ）のみに書き込みが制限されており、システム上の重要な別フォルダを誤って上書きするのを防いでいます。
自動実行フラグの危険性: 承認プロンプトをすべて無条件でスキップする設定もありますが、悪意あるスクリプトや予期しないデータ削除を防ぐため、通常の開発では必ず手動で承認しながら使用してください。

8. 【重要】データプライバシーとモデル学習のオプトアウト設定

社外秘のソースコードを扱う場合は、送信したデータがAIモデルのトレーニングに使用されないよう設定を確認する必要があります。

プラン別のデータ保護ポリシー

API経由 / Team / Enterpriseプラン: 送信したデータがAIモデルの学習に使用されることはありません。特別な対応は不要です。
個人プラン（ChatGPT Plus / Pro / Free）: デフォルトで会話データやコーディングセッションがモデル学習（改善）に利用されるポリシーになっています。

オプトアウト設定手順

ブラウザでChatGPTにログインし、設定画面を開きます。
[データコントロール (Data Controls)] ＞ [チャット履歴とトレーニング (Chat History & Training)] の項目を確認します。
モデルのトレーニングに関するデータ使用の設定をオフ（無効）に変更します。これにより、送信データが学習に利用されるのをオプトアウトできます。

Windows 11でのCodex CLIの導入は、公式のPowerShellインストーラーを使えば数コマンドで完了します。初期ログインのブラウザ連携で一時的にターミナルが固まるなどのつまずきが起きやすいですが、上記のように直接 .codex/config.json 設定ファイルを調整することで確実に対処できます。

自律型エージェントの力をローカル開発に取り入れ、プライバシー（オプトアウト）設定でコード漏洩を防ぎながら、安全なAI自動化開発を実現していくのが良さそうです。