OpenAI Codexのインストールと使用方法

CodexはOpenAIが開発した「AIベースのソフトウェアエンジニアリングエージェント」である。
Tags:

開発者の視点で重要なのは、Codexは「インストール型プログラム」というより、複数の方式で接続して使うツールだという点である。

つまり、ローカルに必ずインストールしなければならない構造ではなく、ChatGPT、CLI、IDE、Webなど多様な方式で使用できる。

Codexのインストール

ChatGPTで使用（最も簡単な方法）

実際、多くの場合は別途インストールせずに開始する。

方法

  1. ChatGPTにログイン
  2. Codex機能を有効化（プランが必要）
  3. すぐに使用

CodexはChatGPTプランに含まれて提供される。

特徴

  • インストール不要
  • すぐに使用可能
  • 最も簡単な方式

Mac環境でCLIをインストール（開発者向け）

Mac環境のターミナルベースでCodexを使いたいなら、これが核心である。

事前準備

まず基本環境から確認する必要がある。

以下は必須である。

  • macOS（Ventura以降推奨）
  • Node.js（18以上）
  • npmまたはpnpm
Nodeのインストール（未インストールの場合）
brew install node

インストール確認:

node -v
npm -v

Codex CLIのインストール

公式に提供されているCLIインストール方式である。

npm install -g @openai/codex

インストール確認:

codex --version

ログイン（最重要）

codex

初回実行時、次のようなコンソール画面が表示される。

  Welcome to Codex, OpenAI's command-line coding agent

  Sign in with ChatGPT to use Codex as part of your paid plan
  or connect an API key for usage-based billing

> 1. Sign in with ChatGPT
     Usage included with Plus, Pro, Business, and Enterprise plans

  2. Sign in with Device Code
     Sign in from another device with a one-time code

  3. Provide your own API key
     Pay for what you use

  Press Enter to continue

ここで1番のChatGPTアカウントでログインを選択すると、ブラウザーが開く。 alt text

ログインするとCLIとアカウントが接続される。

その後、コンソールに表示される内容を確認し、ボタンを何度か押すと使用準備が完了する。

╭───────────────────────────────────────────────╮
│ >_ OpenAI Codex (v0.125.0)                    │
│                                               │
│ model:     gpt-5.5   /model to change         │
│ directory: ~/develop/devkuma/devkuma-hugo-www │
╰───────────────────────────────────────────────╯

  Tip: GPT-5.5 is now available in Codex. It's our strongest agentic coding model yet, built to reason through large codebases, check
  assumptions with tools, and keep going until the work is done.

  Learn more: https://openai.com/index/introducing-gpt-5-5/


› Use /skills to list available skills

使用フロー

改めて整理すると、使用フローは次のとおりである。

  • CLIでcodexを実行
  • ログインを進める（ChatGPTアカウント）
  • プロジェクトフォルダーで実行
  • 自然言語で作業を指示

この過程が終わると、CLIとアカウントが接続される。

例:

"このプロジェクトにRedisキャッシュを追加して"

IDE拡張（VS Codeなど）

使用方法

  1. VS Codeを開く
  2. Codex拡張をインストール
  3. ログイン

利点

  • コードを見ながらすぐ修正
  • 自動リファクタリング
  • コードレビュー支援

Web/アプリベースの使用

Codexは次の方式もサポートする。

  • Codex Web
  • Codex専用アプリ
  • GitHub連携

特にWebではGitHub接続が必要である。

Codexの使用

API/SDK方式（上級）

バックエンドで直接使いたい場合:

  • OpenAI APIキーを使用
  • Codexモデルを呼び出し
  • 自動化システムを構築

開発者基準の推奨インストール/使用

現実的には次のように分かれる。

  • 入門
    • ChatGPT -> すぐ使用
  • 実務
    • CLI + IDEを一緒に使用
  • 上級
    • API + 自動化（CI/CD連携）

まとめ

重要ポイント（よく混乱する）

「Codexインストール = プログラムのダウンロード」ではない。 正確には「Codexを使用できるインターフェースをインストールすること」である。

開発者向けTips

次のように使うと効率がよい。

  • CLI: 大きな作業（リファクタリング、機能追加）
  • ChatGPT: アイデア/設計
  • IDE: 細かな修正

組み合わせて使うことが核心である。

一行要約

Codexはインストールするツールではなく、接続して使うAI開発エージェントである