OpenAI Codex CLI 项目教程

1. 项目介绍

OpenAI Codex CLI 是一个轻量级的编码助手，它可以在您的终端中运行。该项目旨在为开发者提供 ChatGPT 级别的推理能力，以及实际运行代码、操作文件和迭代的功能，并且全部在版本控制之下。简而言之，它是一个聊天驱动的开发工具，能够理解和执行您的代码库。

OpenAI Codex CLI 是一个实验性项目，目前正处于积极开发中。它可能包含错误、不完整的功能或进行破坏性更改。该项目开源，鼓励社区参与：提交错误报告、功能请求或拉取请求。

2. 项目快速启动

首先，您需要在您的系统中安装 Node.js 22 或更高版本。然后，您可以通过以下命令全局安装 Codex CLI：

npm install -g @openai/codex

安装完成后，设置您的 OpenAI API 密钥为环境变量：

export OPENAI_API_KEY="your-api-key-here"

请注意，这个命令只为当前终端会话设置密钥。要永久设置，请将 export 行添加到您的壳配置文件中（例如 ~/.zshrc）。

接下来，您可以以交互方式运行 Codex：

codex

或者，您可以提供一个输入提示（并可选择在完全自动模式下运行）：

codex "explain this codebase to me"
codex --approval-mode full-auto "create the fanciest todo-list app"

就是这样 - Codex 会搭建一个文件，在沙箱中运行它，安装缺失的依赖项，并显示实时结果。批准更改后，它们将被提交到您的工作目录。

3. 应用案例和最佳实践

以下是一些使用 Codex CLI 的应用案例：

• 代码重构：使用 Codex 重构代码组件，例如将类组件转换为 React Hooks。
• 数据库迁移：生成 SQL 迁移文件，用于添加用户表等。
• 单元测试：为 utils/date.ts 等文件编写单元测试。
• 文件重命名：批量重命名文件，例如将所有 *.jpeg 重命名为 *.jpg。
• 代码解释：解释正则表达式的作用，例如 ^(?=.*[A-Z]).{8,}$。
• 代码审查：审查代码库并提出三个具有高影响力和良好范围的 PR。

4. 典型生态项目

OpenAI Codex CLI 是 OpenAI 生态中的一个项目，它与其他开源项目和工具协作，例如：

• GitHub Copilot：与 Codex CLI 类似，但它是一个 AI 编码伙伴，可以直接在您的代码编辑器中工作。
• GitHub Actions：使用 Codex CLI 在 CI/CD 管道中进行自动化任务。
• 各种 ORM：Codex CLI 能够推断您的 ORM 并生成相应的数据库迁移。

这些是 OpenAI Codex CLI 的基本介绍和快速启动指南。要深入了解和贡献该项目，请访问其 GitHub 仓库和官方文档。