Codex Env Setup

Codex 環境建置

先判斷作業系統，再確認 Codex Desktop app 是否已安裝、登入。不要一開始就重裝所有工具。

本 Skill 不檢查 GitHub 帳號、不執行 gh auth status，也不安裝 Git 或 GitHub CLI。GitHub 相關設定全部留給 codex-github。

步驟一：檢查

Windows 使用 PowerShell：

node --version
uv --version

只有使用者明確要使用 CLI 時才執行：

codex --version

Node.js 需 18 以上，建議使用目前 LTS。缺少選用的 Codex CLI 不算 Desktop 環境失敗。

步驟二：只補裝缺少項目

Windows

winget install --id OpenJS.NodeJS.LTS --exact --accept-source-agreements --accept-package-agreements
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Codex Desktop app 尚未安裝時，可引導使用者到官方下載頁，或使用：

winget install Codex -s msstore

macOS

brew install node
curl -LsSf https://astral.sh/uv/install.sh | sh

Linux

Linux 沒有 Codex Desktop app，使用 IDE 擴充或 Codex CLI。Node.js 依 NodeSource LTS 官方指示安裝，uv 使用：

curl -LsSf https://astral.sh/uv/install.sh | sh

安裝後若目前程序仍找不到指令，先重開 PowerShell 或 Codex Desktop app，再重新檢查，不要立刻判定安裝失敗。

步驟三：驗收

至少確認：

• Codex Desktop app 能開啟並正常對話，或使用者選用的 IDE／CLI 可運作。
• node --version 為 18 以上。
• uv --version 有正常版本輸出。
• 只有選用 CLI 時，才要求 codex --version 成功。
• 全程沒有要求 GitHub 帳號或 GitHub 登入。

最終回報：已安裝／已補裝清單、版本、Codex 使用介面與登入狀態，以及仍需使用者手動完成的項目。