Tip · 最後核對
CLI 安裝與驗證資料最後核對日期為 2026-10-12。請參考 Codex CLI 文件、驗證文件 與 Windows WSL 指南。
安裝 Codex CLI
安裝前檢查
Codex CLI 支援 macOS、Linux 和 Windows。Windows 可原生執行;若專案與工具鏈已在 Linux 環境,仍可使用 WSL2。
| 檢查項目 | 建議 |
|---|---|
| Git | 建議安裝,用於儲存庫上下文、diff 與回滾點 |
| Node.js 與 npm | 只有使用 npm 安裝方式時才需要 |
| 工作區 | 選擇可以回復小型測試變更的資料夾 |
git --version
node -v
npm -v
安裝與更新
macOS 或 Linux 可使用官方安裝腳本:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
已有 Node.js 時可從 npm 安裝:
npm install -g @openai/codex
npm install -g @openai/codex@latest
macOS 也可使用 Homebrew:
brew install --cask codex
檢查版本:
codex --version
驗證方式
可以用 ChatGPT 帳號登入,也可以提供 OpenAI API Key;兩者是不同的帳號與計費路徑,實際能力仍取決於工作區和方案。
codex login
API Key 工作階段請依目前 CLI 驗證文件操作,不要把 Key 寫入 shell 歷史或儲存庫。
第一次唯讀任務
進入專案資料夾,要求 Codex 只讀檢查儲存庫。確認輸出、權限和測試命令後,再允許寫入。
排查安裝問題
分開判斷網路、套件、登入與權限錯誤。改用其他安裝方式前,先檢查官方文件與目前版本。
下一步
接著閱讀 第一次執行 Codex CLI。
程式碼範例
npm install -g @openai/codex
npm install -g @openai/codex@latest
printenv OPENAI_API_KEY | codex login --with-api-key
cd path/to/your/project
codex
请先阅读这个仓库的目录结构、README、包管理器配置和测试配置。不要修改文件。请总结:
1. 项目用途
2. 主要技术栈
3. 如何安装依赖和运行测试
4. 你建议我下一步交给你的 3 个低风险任务
參考截圖




來源與站內連結
- /start/01-what-is-codex.md
參考表格
| 項目 | 说明 |
|---|---|
| 操作系统 | 支持 macOS、Linux 和 Windows;Windows 可以原生运行,也可以按需使用 WSL2 |
| Git | 推荐安装,方便 Codex 读取仓库、检查差异和创建回退点 |
| Node.js 与 npm | 只有选择 npm 安装方式时才需要 |
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
codex 命令找不到 | 安装目录未进入 PATH,或安装尚未完成 | 先确认使用的是独立脚本、npm 还是 Homebrew,再检查对应安装目录和 shell PATH |
| 登录后仍提示无权限 | 登录方式、账号计划、工作区策略或会话状态问题 | 运行 codex login 重新登录,并确认使用的是 ChatGPT 账号还是 API Key |
| Windows 原生运行异常 | Windows sandbox、终端或本地工具链不满足项目需要 | 先检查原生环境;需要 Linux 工具链时再改用 WSL2,并把仓库放在 Linux 主目录下 |
| 仓库命令跑不起来 | 项目依赖未安装或本地环境缺失 | 先安装项目依赖,再让 Codex 读取测试配置 |
