OpenAI Codex CLI

プロジェクト紹介

Codex CLI is a coding agent from OpenAI that runs locally on your computer.

Codex CLI は、OpenAI が提供するコーディングエージェントであり、お使いのコンピューター上でローカルに実行されます。

公式ホームページ：https://chatgpt.com/codex
プロジェクトホームページ：https://github.com/openai/codex
インストール方法：本ページ下部のチュートリアルを参照

動作デモ

特徴

機能分類	特徴
ターミナルベースのコーディングアシスタント	Codex CLI は、ターミナルベースの対話型コーディングアシスタントであり、コマンドラインでコードの編集、パッチの生成、コマンドの実行に使用されます。
ツール駆動型アーキテクチャ	`apply_patch`、`shell`、`update_plan`、`multi_tool_use` などのツールを提供し、リポジトリファイルと操作を制御された方法で変更するために使用されます。
アトミックなパッチ編集	専用のパッチ形式を使用し、`apply_patch` を介してファイルをアトミックに追加/更新/削除することで、監査とロールバックを容易にします。
サンドボックスと承認	サンドボックスポリシー（例：`workspace-write`、`read-only`）および承認モード（`on-request`、`on-failure`、`never`）をサポートし、書き込みおよびネットワークアクセス権限を制御します。
プラン追跡	`update_plan` はステップをリストアップし、ステータスを追跡するために使用されます。明確な進捗を維持するために、常に `in_progress` ステップが1つだけ存在する必要があります。
対話の規範	重要な操作の前に短い前置きの説明を送信し、友好的で簡潔なトーンを保ち、進捗状況の更新を提供します。
セキュリティ制約	厳格なルール（無関係なファイルを勝手に変更しない、著作権ヘッダーを追加しない、破壊的なコマンドを実行しない）に従い、機密性の高い操作にはユーザーの承認が必要です。
テストとフォーマット	変更後に関連するテストとフォーマットツールを実行することを推奨しますが、現在のタスクに関係のない問題の修正は担当しません。
出力とスタイル	最終出力は CLI のレンダリング規範（例：`**` 見出し、逆引用符によるパス/コマンドの表示）に従い、スキャンしやすい簡潔な構造を保ちます。
並列実行	`multi_tool_use.parallel` を介した複数のツールの並列実行をサポートし、効率を向上させます。

AIモデル設定方法

Windows版図解ガイド

1.ターミナルを開く

windows_open_terminal

2.WSLのインストール

Windowsで最高のパフォーマンスを得るには、Windows Subsystem for Linux (WSL2) をインストールして使用してください。

WSL2をインストールし、Windowsコンピューターを再起動します

wsl --install インストールが完了したら、Windowsコンピューターを再起動してください

!!! caution "Windowsでの注意事項" - CMDではなくPowerShellの使用を推奨します - 権限の問題が発生した場合は、管理者として実行してみてください - 特定のウイルス対策ソフトウェアが誤検知する可能性があるため、ホワイトリストに追加する必要があります

Node Version Manager (NVM) のダウンロード

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

NVMによるNode.js 22のインストール

タブバーで新しいPowerShellウィンドウを開き、WSLを起動します wsl

Node.jsをインストールします

バージョン番号は時期によって変わるため、OpenAIの公式サイトの要件に従って対応するバージョンをインストールしてください：https://developers.openai.com/codex/windows

nvm install 22

3.Codex CLIのインストール

Codex CLIのインストール

npm i -g @openai/codex このコマンドは、npm公式リポジトリから最新バージョンのCodex CLIをダウンロードしてインストールします。

4.設定ファイルの変更

Codex CLI設定ファイルをワンクリックで変更

iex (irm 'https://docs.88api.ai/helper/codex-cli-setup.ps1')

windows-configure

5.Codex CLIの使用開始

これでCodex CLIの使用を開始できます！

Codex CLIの起動

WSL2を起動します wsl 直接Codex CLIを起動: codex 特定のプロジェクトで使用する場合: cd mnt/c/path/to/your/project codex EnterキーでCodex CLIを起動

Codex CLIの権限設定：1. Codexがファイルを直接変更することを許可、2. Codexがファイルを変更する際に手動での承認が必要

モデルの選択

/model

注意：インターフェースアドレスを変更した後、すべてのモデル（公式のプリセットモデルを含む）はカスタムアクセスポイントを呼び出し、公式アカウントのクォータは使用されません。

macOS版図解ガイド

1.Homebrewのインストール (インストール済みの場合はスキップ)

Homebrew は、macOSに不足しているパッケージマネージャーです。

公式サイト：https://brew.sh

Homebrewのインストール

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2.Node.js環境のインストール

Node.js環境のインストール手順

Homebrewを更新 brew update Node.jsをインストール brew install node

!!! caution "macOSでの注意事項" - 権限の問題が発生した場合は、sudoを使用する必要があるかもしれません - 初回実行時には、システム環境設定で許可する必要があるかもしれません - TerminalまたはiTerm2の使用を推奨します

rmation "インストールが成功したかどうかの確認" インストール完了後、ターミナルを開き、以下のコマンドを入力してください： node --version npm --version バージョン番号が表示されれば、インストールは成功です

3.Codex CLIのインストール

Codex CLIのインストール

ターミナルを開き、以下のコマンドを実行してください： # Codex CLIをグローバルにインストール npm install -g @openai/codex 権限の問題が発生した場合は、sudoを使用できます： sudo npm install -g @openai/codex

Codex CLIのインストール確認

インストール完了後、以下のコマンドを入力してインストールが成功したか確認してください： codex --version バージョン番号が表示されれば、おめでとうございます！Codex CLIは正常にインストールされました。

4.設定ファイルの変更

Codex CLI設定ファイルをワンクリックで変更

curl -fsSL https://docs.88api.ai/helper/codex-cli-setup.sh | bash

macos-configure

5.Codex CLIの使用開始

これでCodex CLIの使用を開始できます！

Codex CLIの起動

直接Codex CLIを起動: codex 特定のプロジェクトで使用する場合: cd mnt/c/path/to/your/project codex EnterキーでCodex CLIを起動

Codex CLIの権限設定：1. Codexがファイルを直接変更することを許可、2. Codexがファイルを変更する際に手動での承認が必要

注意：インターフェースアドレスを変更した後、すべてのモデル（公式のプリセットモデルを含む）はカスタムアクセスポイントを呼び出し、公式アカウントのクォータは使用されません。

6.macOSのよくある問題解決

インストール時に権限エラーが表示される

以下の解決策を試してください：

sudoを使用してインストール：sudo npm install -g @openai/codex
または、npmがユーザーディレクトリを使用するように設定：npm config set prefix ~/.npm-global

macOSのセキュリティ設定により実行がブロックされる

システムがCodex CLIの実行をブロックする場合：

「システム環境設定」→「セキュリティとプライバシー」を開きます
「このまま開く」または「許可」をクリックします
または、Terminalで以下を実行します：sudo spctl --master-disable

Linux版図解ガイド

1.Node.js環境のインストール

Codex CLIを実行するにはNode.js環境が必要です。

Node.js環境のインストール手順

NodeSourceリポジトリを追加 sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - Node.jsをインストール sudo apt-get install -y nodejs

!!! caution "Linuxでの注意事項" - 特定のディストリビューションでは、追加の依存関係のインストールが必要な場合があります - 権限の問題が発生した場合は、sudoを使用してください - ユーザーがnpmのグローバルディレクトリへの書き込み権限を持っていることを確認してください

2.Codex CLIのインストール

Codex CLIのインストール

Codex CLIのインストール確認

3.設定ファイルの変更

Codex CLI設定ファイルをワンクリックで変更

curl -fsSL https://docs.88api.ai/helper/codex-cli-setup.sh | bash

macos-configure

4.Codex CLIの使用開始

これでCodex CLIの使用を開始できます！

Codex CLIの起動

直接Codex CLIを起動: # Codex CLIを起動 codex 特定のプロジェクトで使用する場合: # プロジェクトディレクトリに移動 cd /path/to/your/project # Codex CLIを起動 codex EnterキーでCodex CLIを起動

Codex CLIの権限設定：1. Codexがファイルを直接変更することを許可、2. Codexがファイルを変更する際に手動での承認が必要

注意：インターフェースアドレスを変更した後、すべてのモデル（公式のプリセットモデルを含む）はカスタムアクセスポイントを呼び出し、公式アカウントのクォータは使用されません。

5.Linuxのよくある問題解決

インストール時に権限エラーが表示される

以下の解決策を試してください：

sudoを使用してインストール：sudo npm install -g @openai/codex
または、npmがユーザーディレクトリを使用するように設定：npm config set prefix ~/.npm-global
その後、PATHに追加：export PATH=~/.npm-global/bin:$PATH

依存ライブラリの不足

特定のLinuxディストリビューションでは、追加の依存関係のインストールが必要です： # Ubuntu/Debian sudo apt install build-essential # CentOS/RHEL sudo dnf groupinstall "Development Tools"

目次