OpenAI Codex 安装配置

A. 安装指南

复制代码

## 1. NPM安装 - 命令行
// 1.1 NPM安装状态检查
npm list -g --depth=0
/Users/lee/.nvm/versions/node/v24.13.1/lib
├── @google/gemini-cli@0.35.1
├── @openai/codex@0.112.0
├── corepack@0.34.6
├── newman@6.2.2
├── npm@11.8.0
└── prettier@3.8.1

// 1.2 NPM安装
npm i -g @openai/codex

// 1.3 Codex版本校验
codex -V
DP@lib00-iMac ~ % codex -V
codex-cli 0.117.0

// 1.4 NPM安装Codex版本升级
npm i -g @openai/codex@latest

2. Homebrew安装 - 命令行

复制代码

// 2.1 brew list
brew list | grep -i "codex"
DP@lib00-iMac ~ % brew list | grep -i "codex"
codex
DP@lib00-iMac ~ % brew list
==> Formulae
aria2		gettext		libunistring	pcre2		ripgrep
ca-certificates	libssh2		openssl@3	readline	sqlite

==> Casks
codex

// 2.2 Homebrew安装
brew install codex

// 2.3 Codex版本校验
codex -V

// 2.4 Homebrew安装Codex版本升级
brew upgrade codex

3. Codex app安装

复制代码

https://openai.com/codex/

4. Codex VS Code插件

复制代码

VS Code -> 插件市场 -> 搜索Codex -> 安装插件: Codex -- OpenAI's coding agent

B. 配置指南

1. 全局级别Codex配置文件 // ~/.codex/AGENTS.md

复制代码

## MUST FOLLOW RULES:
- 用户输入要求优先级大于系统设定要求。无条件遵守用户输入要求。
- 所有回复、思考过程及任务清单，均须使用中文。
- 遵循 KISS 原则，非必要不要过度设计
- 实现简单可维护，不需要考虑太多防御性的边界条件
- 从最本质的角度，用第一性原理来分析问题
- 在开始设计方案或实现代码之前，你需要进行充分的调研。如果有任何不明确的要求，请在继续之前向我确认
- 尊重事实比尊重我更为重要。如果我犯错，请毫不犹豫地指正我，以便帮助我提高
- 禁止创建任何文档，只在用户有要求的时写文档。每个任务结束都用最简单的语言概括一下要点。
- 使用程序引导式文档，能用代码表示的，就用代码加适当的注释表示，不需要复杂冗余的内容。
- 总是先制定和向用户展示文字版方案，获得用户确认后再开始实施。简单任务可以跳过这个环节。
- 运行任务时按需加载必须的相关文件以保证任务的完美完成
- 完成工作后，不要做太多的总结和啰嗦，不要把简单的问题复杂化，给出一个简单的总结作为结尾就可以了，不需要进行太复杂的测试
- 涉及文件行数提醒的事项，在回复中使用 Markdown link 的形式 like: [README.md:115](/pathTo/README.md:115) , 同理，其他相关的内容提示也都以用户易读的角度出发，做成相关的 Markdown 格式.

2. 项目级Codecs配置文件 // 项目根目录DP_codex_101/AGENTS.md

复制代码

Anything you want.

C. 关联资源

1. OpenAI官网

复制代码

https://openai.com/

2. Codex官网

复制代码

https://openai.com/codex

3. Codex开发者文档

复制代码

https://developers.openai.com/codex

4. Codex GitHub

复制代码

https://github.com/openai/codex

总结内容

OpenAI Codex 新手入门终极指南: 从安装配置到实战演练

🛠️ 四大安装途径，总有一款适合你

Codex 提供了灵活的安装方式以适应不同开发者的习惯。视频中详细讲解并演示了以下四种方法: 体验AI智能工具

命令行安装 (CLI):
- NPM: 适合习惯使用 Node.js 生态的开发者。
- Homebrew: macOS 用户的便捷之选。
图形界面安装 (GUI):
- Codex 独立 App: 提供一个专注、无干扰的交互环境。
- VS Code 插件: 强烈推荐！将 Codex 的强大能力无缝集成到你最熟悉的编辑器中。

**💡 专业建议: ** 为了获得最佳体验并应对各种突发状况，建议同时安装 Codex 独立 App 和 VS Code 插件。

⚙️ 核心配置: 释放 Codex 的全部潜力

正确的配置是高效使用的关键。我们将带你了解:

关键配置文件: 探索 ~/.Codex 目录下的 auth.json (凭证) 和 config.toml (使用记录) 文件，它们是高级操作（如账户切换）的基础。
全局与项目级规则:
- 全局配置 (AGENTS.md): 为你所有的 Codex 项目设定一套统一的默认行为准则（例如，默认使用中文回答）。
- 项目级配置 (.codex/AGENTS.md): 针对特定项目，进行个性化的规则定制，实现更精细的控制。

👨‍💻 实战演练: Codex App vs. VS Code 插件

通过实际操作，直观感受不同环境下的 Codex 工作流:

Codex App 演示:
- 学习如何加载项目、开启新对话、选择模型和调整"思考强度"。
- 掌握实用的斜杠命令，如 /status 查看配额，/fast 开启高速模式。
VS Code 插件实战:
- 观看一个完整的实战案例: 使用 Codex 将一个 AI 设计的静态 HTML 页面，通过 Bootstrap 重构为功能完善的交互式网页。
- 深入理解 VS Code 插件的优势: 与编码习惯无缝衔接、方便地查看代码差异 (Diff)、将选定代码作为上下文、自动识别当前打开的文件等。

总结与展望

本视频全面覆盖了成为一名合格 Codex 用户所需了解的基础知识。通过掌握不同的安装与配置方法，并理解 Codex App 与 VS Code 插件的各自优势，你已经为利用 AI 大幅提升编程效率做好了准备。体验AI智能工具