最終更新日: 2026年09月25日
テンプレート説明
Codex CLIは、OpenAI製のAI支援コーディングエージェントです。自然言語でコードの生成、レビュー、デバッグ、説明を行うことで、開発者の生産性を大幅に向上させるツールです。
スタートアップスクリプトのテンプレートを利用してサーバー作成を行う手順はご利用ガイドを参照してください。
加えて、2026年9月25日より、サプライチェーン攻撃対策として同梱ツール「Takumi Guard」の管理スクリプトが同梱されます(デフォルトは無効)。2026年9月24日以前に作成したサーバーには同梱されていません。詳しくは後述の「同梱ツール(Takumi Guard)」をご覧ください。
重要
Codex CLIを使用するには、ChatGPT Plus/Pro/Team/EnterpriseアカウントまたはOpenAI APIキーが必要です。認証なしでは利用できません。
仕様
対応OSイメージ
Ubuntu 24.04 LTS
主要ソフトウェア
| ソフトウェア名 | バージョン | ライセンス | 用途 |
|---|---|---|---|
| Codex CLI | latest | OpenAI利用規約 | AI支援コーディングエージェント |
| Node.js | 22.0+ | MIT License | JavaScript実行環境(CLI用) |
| npm | Latest | Artistic License 2.0 | パッケージマネージャー |
| Git | Latest | GPL v2 | バージョン管理システム |
| UFW | Latest | GPL v3 | ファイアウォール |
スタートアップスクリプト情報
| 項目 | 説明 |
|---|---|
| アプリケーション利用ポート | 22/tcp (SSH管理用のみ) |
| インストールディレクトリ | /root/.codex, /home/codex/.codex |
| 管理スクリプト | /root/codex-cli-manage.sh(/root/takumi-guard.sh) ※2026年9月24日以前に作成したサーバーでは、従来の /root/codex-cli-diagnose.sh・/root/start-codex.sh をご利用ください。 |
| 初期状態 | CLIツールインストール済み(認証待ち) |
| 専用ユーザー | codex (sudo権限付与) |
メモ
管理スクリプトは2026年9月25日に更新されました。2026年9月25日以降に本テンプレートでサーバーを作成した場合は、単一の管理スクリプト(/root/codex-cli-manage.sh、diagnose/startサブコマンド)をご利用ください。2026年9月24日以前に作成したサーバーでは、従来の /root/codex-cli-diagnose.sh・/root/start-codex.sh がそのままご利用いただけます。
その他
最小システム要件
- CPU: 64-bit (x86-64) CPU(10年以内推奨)
- メモリ: 最小4GB、推奨8GB以上
- ディスク容量: 2GB以上の空き容量
- ネットワーク: 安定したインターネット接続必須(API呼び出し用)
認証要件
- ChatGPT Plus/Pro/Team/Enterprise/Eduアカウント(推奨)
- OpenAI APIキー(代替手段、使用量課金)
利用手順
メモ
スタートアップスクリプトにてアプリケーションのインストールが完了するまで数分かかります。
インストール完了後、rootディレクトリに「codex-cli-info.txt」というファイルが作成されますのでご確認ください。
ファイルが存在しない場合、作成されるまでしばらくお待ちください。
スタートアップスクリプトの実行状況は、SSH接続後に以下のコマンドで確認できます。
# tail -f /var/log/codex-cli-install.log
重要
Codex CLIを使用するにはOpenAIアカウントまたはAPIキーによる認証が必要です。以下の手順に従って認証設定を行い、AI支援コーディング機能をご利用ください。
Step 0: セキュリティグループについて
ConoHa VPS(Ver.3.0)ではサーバー毎にIPアドレスまたはポートでトラフィックを制御するセキュリティグループ(仮想ファイアウォール)が設定されます。
本テンプレートをご利用の場合は、予め利用するポートの通信許可設定が必要です。
詳細はセキュリティグループを参照してください。
Step 1: VPSへの接続
作成されたVPSにSSHで接続します。
# SSH接続(ConoHaコントロールパネルから確認したIPアドレスを使用)
ssh root@[VPSのIPアドレス]
Step 2: インストール状況の確認
まず、システム診断スクリプトを実行してインストール状況を確認します。使用するコマンドは、サーバーの作成日によって異なります。
2026年9月25日以降に作成したサーバー:
# /root/codex-cli-manage.sh diagnose
2026年9月24日以前に作成したサーバー:
# /root/codex-cli-diagnose.sh
Step 3: 専用ユーザーへの切り替え
Codex CLIはcodex専用ユーザーに対してのみインストールされます。rootユーザーでは実行できないため、認証設定の前に専用ユーザーへ切り替えてください。
# su - codex
Step 4: 認証設定
Codex CLIを使用するための認証を行います。以下いずれかの方法で認証してください。
方法1: ChatGPTアカウント(推奨・デバイスコード認証)
# codex login --device-auth
ヘッドレスVPS環境のため、ブラウザを起動できないデバイス向けのデバイスコード認証方式を使用します。コマンド実行後に表示されるURLとコードを、お手元の端末のブラウザで開いて認証を完了してください。事前にChatGPTのセキュリティ設定またはワークスペース権限で、デバイスコード認証が許可されている必要があります。ChatGPT Plus、Pro、Team、Enterprise、Eduプランが対象です。
方法2: OpenAI APIキー
# export OPENAI_API_KEY="your-api-key-here"
# printenv OPENAI_API_KEY | codex login --with-api-key
APIキーを利用する場合、ChatGPTのサブスクリプションとは別に、使用量に応じた課金が発生します。
Step 5: 基本的な使用方法
認証完了後、Codex CLIを使用できます。
# 対話モードで開始
# codex
# プロンプト付きで実行
# codex "このコードベースを説明して"
# 非対話モードで実行
# codex exec "エラーを修正して"
# ヘルプ表示
# codex --help
管理スクリプト一覧
メモ
管理スクリプトは2026年9月25日に更新されています。サーバーの作成日に応じて、以下のいずれかをご利用ください。
2026年9月25日以降に作成したサーバー
| スクリプト名 | 機能 | 使用例 |
|---|---|---|
| codex-cli-manage.sh diagnose | システム診断・状況確認 | # /root/codex-cli-manage.sh diagnose |
| codex-cli-manage.sh start | クイックスタートガイド表示 | # /root/codex-cli-manage.sh start |
2026年9月24日以前に作成したサーバー
| スクリプト名 | 機能 | 使用例 |
|---|---|---|
| codex-cli-diagnose.sh | システム診断・状況確認 | # /root/codex-cli-diagnose.sh |
| start-codex.sh | クイックスタートガイド表示 | # /root/start-codex.sh |
セキュリティグループ
以下のポートが使用されます:
| ポート番号 | プロトコル | 用途 | 必須/オプション |
|---|---|---|---|
| 22 | TCP | SSH | 任意 |
メモ
Codex CLIはコマンドラインツールであり、Webインターフェースは提供しません。すべての操作はSSH接続したターミナル上で行います。
アプリケーションの具体的な利用方法につきましては、サービス開発元やサービス提供元の公式サイト、Wikiなどで最新情報をご確認ください。
同梱ツール(Takumi Guard)
本テンプレートには、サプライチェーン攻撃対策としてTakumi Guardの管理スクリプト(/root/takumi-guard.sh)が同梱されています(デフォルトは無効)。Takumi Guardは複数のテンプレートに共通で同梱されるツールのため、詳しい使い方は独立したページにまとめて記載しています。
基本的な有効化・無効化は、root権限で以下のコマンドを実行します。
# /root/takumi-guard.sh status
# /root/takumi-guard.sh enable
# /root/takumi-guard.sh disable
メモ
メール認証モードへの切り替え、レート制限、対象パッケージマネージャーの一覧、組織向けプランなど詳細な使い方は、Takumi Guard(同梱ツール)のページを参照してください。
外部リンク
| サイト名 | URL | 説明 |
|---|---|---|
| Codex CLI公式ドキュメント | https://developers.openai.com/codex/cli/ | 公式ドキュメント・使用方法 |
| Codex CLI GitHubリポジトリ | https://github.com/openai/codex | ソースコード・リリース情報 |
| OpenAI公式サイト | https://openai.com/ | OpenAI製品情報・最新ニュース |
| ChatGPT | https://chat.openai.com/ | 認証用ChatGPTアカウント |
| OpenAI Community Forum | https://community.openai.com/ | コミュニティサポート・議論 |
| Takumi Guard(同梱ツール) | https://doc.conoha.jp/products/vps-v3/startupscripts-v3/takumi-guard/ | Takumi Guardの詳細な使い方(本サイト内ページ) |