OpenAI Codex CLI是一款开源的终端AI编程智能体，采用Apache-2.0协议，它不仅能提供代码补全功能，还可以自主读取项目文件、修改代码、执行命令、运行测试，支持macOS、Linux和Windows（WSL2）系统，是开发者提升编程效率的实用工具。
安装前置要求
安装Codex CLI之前需要确保环境满足以下条件：
- 已安装Node.js 18.0及以上版本，可通过
node -v命令检查版本 - 拥有有效的OpenAI API密钥，可在OpenAI平台创建获取
- Windows用户需要提前配置好WSL2环境，确保能正常运行Linux命令
- 终端工具支持基本命令行操作，如bash、zsh或者PowerShell
不同系统安装步骤
macOS和Linux系统安装
打开终端执行以下命令即可完成全局安装：
# 全局安装Codex CLI npm install -g @openai/codex-cli # 安装完成后检查版本，确认安装成功 codex --version
Windows系统安装（WSL2环境）
先打开WSL2终端，执行和macOS、Linux相同的安装命令即可，安装完成后同样可以通过codex --version命令验证安装结果。如果提示权限不足，可在命令前添加sudo重新执行。
基础配置与使用
首次使用需要先配置API密钥，执行以下命令按照提示输入密钥即可：
# 配置OpenAI API密钥 codex config set api_key 你的API密钥
配置完成后可以尝试基础使用场景，比如让Codex CLI生成简单的代码示例：
// 在终端输入以下命令，让Codex CLI生成一个简单的Node.js HTTP服务代码 codex "生成一个监听3000端口的Node.js HTTP服务，返回Hello World"
Codex CLI会读取当前项目结构，结合需求生成对应代码，还可以执行以下命令让它修改现有代码：
# 让Codex CLI给现有代码添加注释 codex "给当前目录下的index.js文件添加详细的函数注释"
常见问题解决
| 问题现象 | 解决方法 |
|---|---|
| 安装时提示权限不足 | Linux/macOS可在安装命令前加sudo，Windows WSL2环境同样使用sudo提权执行 |
| 执行命令提示API密钥无效 | 重新执行codex config set api_key命令，输入正确的API密钥，确保密钥没有过期 |
| Windows原生环境无法运行 | Codex CLI不支持Windows原生终端，需要切换到WSL2环境执行操作 |
注意事项
使用Codex CLI时要确保项目代码安全，不要将敏感信息暴露在项目中，同时API调用会产生相应费用，建议合理控制使用频率。
日常使用中还可以结合项目需求，让Codex CLI执行测试运行、依赖安装等命令，充分发挥终端AI编程智能体的作用，减少重复编码工作，提升开发效率。