最終更新日: 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の詳細な使い方(本サイト内ページ)