Knowledge Notebook
一覧に戻る

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

OpenAIが提供する「Codex」は、ターミナル(CLI)上で動作する自律型のAIソフトウェアエンジニアリングエージェントです。Claude Codeなどと同様に、開発プロジェクトのディレクトリ内で起動して指示を出すだけで、ファイルの検索、読み書き、ビルド、テスト実行、さらにはGitコミットまでローカルで自動実行してくれます。

本記事では、Windows 11環境でCodex CLIを導入する最新の手順と、できること、およびセキュリティ・プライバシー(権限・モデル学習)に加えて「GitHubアカウントは必要か?」という疑問について詳しく解説します。

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 以上 が必須となります。

  1. Node.jsのバージョンを確認します。
  2. ターミナルで以下のコマンドを実行してインストールします。
    npm install -g @openai/codex

    ※必ずパッケージ名にスコープ(@openai/)をつけてください。スコープのない無印の codex パッケージはOpenAI公式のツールではなく、無関係なため注意してください。

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

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

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

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

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

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

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

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

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

オプトアウト設定手順

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

9. まとめ

Windows 11でのCodex CLIのセットアップは、公式のPowerShellインストーラーを使用すれば数分で完了します。ローカルでの自律コーディングだけであればGitHubアカウントは不要なので、まずは手軽にローカル環境で使い始めてみるのがおすすめです。

開発の自律化は大きなメリットですが、実行時の権限チェックとモデル学習対策(オプトアウト)の設定を適切に行い、安全でプライベートな開発環境を構築しましょう。


参考URL