Codex CLI のインストールと CodeNodex ワンクリック設定

Codex CLI はローカル端末のターミナルで動作するコーディングエージェントです。インストール前に、現在のユーザーが対象ディレクトリに書き込めることを確認し、チーム全体で一元アップグレードできるインストール方法を優先すること。

公式インストールスクリプトは迅速な開始に適し、npm と Homebrew は対応するパッケージマネージャーをすでに利用している環境に適している。複数のインストールを同時に保守してはいけない。そうでないと PATH の古い実行ファイルが先に呼び出される可能性がある。

インストールが完了しても設定が完了したとは限らない。最初にバージョン、ヘルプ、ローカル診断を確認することで、PATH の問題と後続の認証問題を切り分けられる。以下のコマンドは状態の読み取りのみで、プロジェクトのコードは変更しない。

codex コマンドが存在しない場合は、ターミナルを開き直して再度確認してください。それでも失敗する場合は、パッケージマネージャーの bin ディレクトリが PATH に含まれていることを確認し、同名の古いファイルが存在しないか調査してください。

CodeNodex のインストールスクリプトは、現在のシステムとアーキテクチャに一致するリリースパッケージをダウンロードし、SHA256 を検証します。CLI は設定を書き込む前に Key を検証します。ログインパスワードや API Key をプロジェクトのリポジトリに書き込むことはありません。

Unix インストーラーは /usr/local/bin へのインストールを優先します。権限がない場合はユーザーディレクトリにフォールバックします。Windows はデフォルトでローカルのアプリデータディレクトリにインストールされます。

ログインのパスは既に CodeNodex アカウントを持つユーザーに適しています。CLI はアカウント下の Key を一覧表示し、検証後に $CODEX_HOME/config.toml と auth.json を書き込みます。CODEX_HOME が未設定の場合はデフォルトで ~/.codex/ を使用します。

マージでは既存の provider、プロジェクト設定、CLI が管理していないフィールドが保持されます。対象ファイルが解析不能な場合、シンボリックリンクである場合、または書き込み途中で失敗した場合は停止してロールバックします。

自動化環境や人機認証が有効なサイトでは Key を直接提供できます。サイレント入力により鍵が shell の履歴に残るのを回避できますが、現在 --key は値をプロセス引数として渡すため、同一マシン上の高権限プロセスから観察される可能性があります。長期利用ではログインによる Key の選択を優先してください。

platform は Key の実際のプロトコルと一致している必要があります。Codex の CodeNodex 設定は openai を使用します。検証失敗時はファイルに書き込みません。

最後に CLI の診断、ログイン状態、読み取り専用タスクを順に確認します。初回タスクではリポジトリの読み取りと計画の提示のみを行えば、コード変更なしにモデル、provider、作業ディレクトリがすべて有効であることを確認できます。

読み取り専用タスクが正常なら、次にファイル書き込みを伴うワークフローに進みます。こうすることで問題発生時に、接続チェーンか権限ポリシーのどちらが原因かを明確に切り分けられます。