← 返回學習路線
章節 · 已發布

安裝 Codex CLI

安裝 Codex CLI,選擇 ChatGPT 或 API Key 驗證,檢查版本並準備第一次唯讀執行。

來源: start/10-cli-installation.md快速上手 (原文)
本章閱讀進度 0%學習路線進度 0% · 0/46 已完成章節繼續學習路線 →

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 读取测试配置

延伸閱讀

知識AI Agent:從基礎概念到實際應用知識生產級提示工程:從指令到可量測契約
產品中心 Demo · V0.3