2 Codex 安装、登录与环境诊断：先让本地跑起来

Codex 安装登录手绘图

学 Codex 的第一步不是写 prompt，而是把环境跑稳。很多“AI 不会改代码”的问题，最后发现是工作目录不对、Git 没装好、终端权限不对、Node 或 Python 不在 PATH 里。

这一篇只做三件事：安装入口、登录方式、诊断环境。

Windows 用户怎么开始

如果你用 Windows，官方 Windows 文档推荐从 Microsoft Store 下载 Codex App。命令行安装也可以用：

winget install Codex -s msstore

Codex App 在 Windows 上可以用 PowerShell 原生运行，也可以配置为在 WSL2 里运行。我的建议是：

Windows 下还要确认 Git、Node、Python、GitHub CLI 这些基础工具是否可用。官方 Windows 文档也给了 winget install --id Git.Git、OpenJS.NodeJS.LTS、GitHub.cli 等基础安装建议。

装好以后，在项目根目录运行：

codex

这会启动交互式终端 UI。你也可以直接带一句任务：

codex "先不要修改代码，解释这个项目的目录结构"

如果你装了 Codex App，可以用：

codex app

在 macOS 上它可以直接打开指定 workspace；在 Windows 上，官方 CLI reference 说明它会打开或引导安装桌面 App，并打印要打开的路径。

Codex 支持用 ChatGPT 账号，也支持用 OpenAI API key。官方 pricing/manual 里也提醒：用 API key 时，某些 cloud-based 功能可能不可用。个人用户通常优先用 ChatGPT 账号登录；CI、自动化、共享环境再考虑 API key。

常用命令：

codex login
codex logout

不要把 API key 写进仓库，也不要贴进文章、日志或公开 issue。CI 里要放到 GitHub secrets 这类密钥管理位置。

遇到问题前，先记住这个命令：

codex doctor

官方 CLI reference 里说明，codex doctor 会检查安装、配置、认证、运行时、Git、终端、app-server 和 thread inventory。它很适合用来排查“为什么 Codex 读不到项目”“为什么权限不对”“为什么登录状态异常”。

如果你以后向别人求助，先贴 codex doctor --summary 的摘要，比只说“不能用”有效得多。当然，涉及路径、账号、token 的敏感内容要先处理。

第一次开始前，至少检查：

git --version
node --version
python --version
codex doctor --summary

如果项目是前端，再跑项目自己的安装和构建命令；如果是后端，先确认虚拟环境和测试命令。

下一篇开始进入真实仓库：让 Codex 先读代码，再做第一次低风险改动。

参考资料：