About codex-env-setup
A setup skill for people preparing a Codex environment through the desktop app, an IDE extension, or the CLI. It checks the operating system and required tools first, installs only missing items, then verifies the chosen interface and its status.
Key features
- 01Check setup by operating system
- 02Verify Node.js and uv
- 03Install only missing tools
- 04Validate Codex interface and status
- 05Troubleshoot commands not found
Use cases
- 01Set up Codex in a new environment
- 02Address missing Node.js or uv
- 03Confirm the desktop app or CLI works
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ mathruffian-dot/ codex-lazy-packs --skill codex-env-setupAfter installing, type/codex-env-setupin Claude Code to confirm it loaded.
Details
From the project READMECodex 環境建置
先判斷作業系統,再確認 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 使用介面與登入狀態,以及仍需使用者手動完成的項目。