OpenAI Codex CLI 是一个开源的命令行 AI 编程助手，基于 OpenAI 的模型提供代码生成和项目操作能力。本文将介绍它的安装、配置、常见用法，以及使用中需要注意的坑。
什么是 Codex CLI
Codex CLI 是 OpenAI 推出的命令行工具，允许开发者在终端中直接与 AI 交互，完成代码编写、文件操作、调试等任务。它是开源项目，基于 Node.js 构建，支持沙箱模式执行代码。
与 Claude Code 类似，Codex CLI 也采用"代理"模式——AI 可以自主读取文件、执行命令、修改代码，而不只是被动回答问题。
安装
通过 npm 全局安装 Codex CLI：
npm install -g @openai/codex
验证安装：
codex --version
配置
设置 OpenAI API Key：
export OPENAI_API_KEY=sk-xxxxx
你也可以将 Key 写入 .env 文件或 shell 配置文件中，避免每次手动设置。
基本用法
交互模式
直接运行 codex 进入交互模式，在终端中与 AI 对话：
codex
# 进入交互式对话界面
单次执行
使用 -q 参数执行单条指令，适合脚本化场景：
codex -q "在当前项目中添加一个 .gitignore 文件"
指定工作目录
使用 --cd 参数指定工作目录：
codex --cd /path/to/project
常见坑
权限问题
Codex CLI 默认在沙箱模式下运行，某些操作可能被拒绝。如果需要更宽松的权限，可以使用 --full-auto 模式，但请注意安全风险：
codex --full-auto
建议仅在可信环境中使用 --full-auto，并始终用 git 跟踪变更。
上下文丢失
与 Claude Code 类似，Codex CLI 也会在长对话中丢失上下文。建议：
- 将大任务拆分为小步骤
- 使用
CODEX.md文件持久化关键上下文 - 定期开启新对话
输出不稳定
由于 LLM 的非确定性，同样的提示可能产生不同的结果。对于需要精确输出的场景：
- 使用更明确的提示词
- 指定输出格式（如"只输出 JSON"）
- 设置
temperature=0降低随机性
最佳实践
- 始终使用 Git — 在使用 Codex CLI 之前确保项目有 Git 版本控制，方便回滚不需要的变更
- 明确指定范围 — 在提示词中明确告诉 Codex CLI 应该修改哪些文件，避免不必要的变更
- 使用沙箱模式 — 除非必要，不要使用
--full-auto，让 Codex CLI 在受限环境中操作 - 验证输出 — 对生成的代码进行测试和审查，不要盲目信任 AI 输出
← 返回文章列表使用 Wishmere 可以同时管理 Claude Code 和 Codex CLI，根据任务自动选择最合适的工具。