理解 OpenAI Codex CLI 命令
作者提供图片
介绍 OpenAI Codex CLI
我们已经看到了像 Windsurf 和 Cursor AI 这样新一代的代理式 IDE。这些代码编辑器不仅能理解你的代码，还能帮助你解决问题、编写代码，甚至从头开始构建整个项目。如果我告诉你，还有一种更好的方法可以使用 AI 代理来改进你的数据科学工作流程呢？
隆重推出 OpenAI Codex CLI，这是一个轻量级的开源命令行工具，可将高级推理模型的力量直接带到你的终端。Codex CLI 允许你分析数据集、编写和测试 Python 代码，甚至构建机器学习项目。
本教程专注于 OpenAI Codex CLI 的功能和命令，帮助你通过单个命令解锁其潜力，以构建、调试和增强任何数据科学项目。如果你有兴趣了解安装和设置，可以访问 官方 GitHub 存储库 以获取详细说明。
Codex CLI 交互模式
成功安装 Codex CLI 后，打开终端，导航到项目目录，然后键入 codex 以启动交互模式。这将使用默认模型和批准设置启动 Codex CLI。
注意：运行 Codex 之前，请确保你的项目目录是 Git 存储库。如果不是，只需键入
git init来初始化它。
交互模式的功能与 ChatGPT 类似。你可以以对话方式与 Codex 互动，让它执行任务并根据需要提供后续指令。
作者提供图片
Codex CLI 多模态
Codex CLI 支持多模态输入，允许你提供图像和文本来生成响应。
在此示例中，我们将使用 Codex CLI 来分析相关性热图可视化并基于此生成分析报告。
注意：我们使用的可视化来自教程：Top 6 Python Libraries for Visualization: Which One to Use?。
作者提供图片
要分析可视化，请使用 --image 参数并指定图像文件的路径。
|
1 |
codex --image "C:\Users\abida\Desktop\output2.webp" |
Codex CLI 将处理图像并根据可视化内容提供初步分析。
作者提供图片
在分析图像后，你可以提供后续指令来生成详细的分析报告。
|
1 |
请 创建一个 分析 报告 并 以 markdown 格式保存。 |
Codex CLI 将创建一个 markdown 文件，其中包含从图像派生的分析见解。该文件将本地保存，供你稍后查看或编辑。
作者提供图片
生成 markdown 文件后，可以在你喜欢的 IDE 或文本编辑器中打开它以查看分析。
作者提供图片
Codex CLI 批准模式
Codex CLI 提供三种不同的批准模式，让用户对决策制定有不同的控制级别。
Suggest Mode (默认)
Suggest Mode 是 Codex CLI 中的默认批准模式。在此模式下，Codex CLI 将在每个步骤请求你的许可，包括创建文件、编辑文件和运行 shell 命令。此模式非常适合希望全程保持完全控制的用户。
|
1 |
codex --approval-mode suggest "请分析 dataset.csv 文件并以 PDF 格式生成分析报告。" |
Codex CLI 将首先分析数据集。
作者提供图片
然后，它会请求你的许可来创建一个执行分析并生成报告的 Python 文件。只需输入“y”即可批准。
作者提供图片
接下来，它会请求许可在终端运行 Python 文件。同样，输入“y”继续。
作者提供图片
最后，Codex CLI 将提供摘要。
作者提供图片
在过程结束时，你将收到 PDF 格式的分析报告，即可使用。
作者提供图片
Auto Edit Mode
在 Auto Edit Mode 中，Codex CLI 会自动创建和编辑文件，而无需征求你的批准。但是，在运行任何 shell 命令之前，它仍会提示你进行许可。此模式对希望简化文件创建和编辑同时保留命令执行控制的用户很有用。
|
1 |
codex --approval-mode auto-edit "请分析 dataset.csv 文件并以 PDF 格式生成分析报告。" |
Codex CLI 将自动创建和编辑必要的 Python 文件，而无需征求你的批准，但它会请求许可在终端运行 Python 文件。
作者提供图片
以最少的交互生成 PDF 格式的分析报告。
作者提供图片
Full Auto Mode
Full Auto Mode 是最自主的选项。在此模式下，Codex CLI 处理一切，从创建和编辑文件到运行 shell 命令，无需任何用户输入。
|
1 |
codex --approval-mode full-auto "请分析 dataset.csv 文件并以 PDF 格式生成分析报告。" |
Codex CLI 将自主创建 Python 文件、执行它并生成 PDF 报告，所有这些都不需要你的批准。
作者提供图片
Codex 模型选择
尽管 Codex CLI 由 OpenAI 维护，但它是一个开源项目，受益于开源社区的定期贡献。这意味着你不仅可以使用 OpenAI 模型，还可以使用第三方专有和开源模型来使用 Codex CLI。
OpenAI 模型
默认情况下，Codex CLI 使用 o4-mini 模型。但是，你可以通过更改 --model 参数来指定不同的 OpenAI 模型。
例如，要使用 gpt-4.1 模型，可以运行以下命令：
|
1 |
codex --model gpt-4.1 --full-auto "创建一个 Python 文件以快速加载和清理 dataset.csv" |
作者提供图片
使用第三方提供商
Codex CLI 还支持第三方提供商，允许你使用其他平台的模型或在本地运行它们。要切换提供商，请使用 --provider 参数。
支持的提供商包括：
- openai (默认)
- openrouter
- gemini
- ollama
- mistral
- deepseek
- xai
- groq
- 任何其他与 OpenAI API 兼容的提供商。
要使用 Groq 作为 LLM（大型语言模型）提供商，你需要将 Groq API 密钥和基础 URL 设置为环境变量。
|
1 2 |
export GROQ_API_KEY="your-api-key-here" export GROQ_BASE_URL="https://your-provider-api-base-url" |
设置环境变量后，你可以将 Groq 指定为提供商并选择模型，例如 deepseek-r1-distill-llama-70b。
|
1 |
codex --provider groq --model deepseek-r1-distill-llama-70b "请创建一个数据分析脚本，该脚本接受清理后的数据并运行统计分析。" |
几秒钟内，Codex CLI 将生成一个统计分析脚本，即可使用。
作者提供图片
Codex Quiet Mode
Codex Quiet mode 是一种非交互式模式，旨在通过以 JSON 格式显示从用户发送到 OpenAI 服务器的请求和服务器的响应来简化工作流程。
|
1 |
codex --quiet "解释 analysis_report.py 文件" |
此模式特别适用于调试、日志记录或将 Codex 集成到需要自动化的更大型项目中。
作者提供图片
Codex CLI 参考
这是本教程中介绍的功能和命令的简要摘要。
| Option | Alias | 描述 | Default Value |
|---|---|---|---|
--model <model> |
-m | 用于补全的模型 | o4-mini |
--provider <provider> |
-p | 用于补全的提供商 | openai |
--image <path> |
-i | 包含在输入中的图像文件路径 | N/A |
--quiet |
-q | 非交互模式，仅打印助手的最终输出 | N/A |
--approval-mode <mode> |
-a | 覆盖批准策略：“suggest”、“auto-edit”或“full-auto” | suggest |
--auto-edit |
N/A | 自动批准文件编辑；仍会提示执行命令 | N/A |
--full-auto |
N/A | 在沙箱中执行时自动批准编辑和命令 | N/A |
总结
OpenAI Codex CLI 目前处于实验阶段，这意味着某些功能和命令可能无法按预期工作，尤其是在 Windows 系统上。但是，随着该工具朝着 Beta 和稳定版本发展，预计将解决许多这些错误，从而提供更顺畅、更可靠的用户体验。
Codex CLI 在市场上脱颖而出的地方在于其效率、速度和准确性。它简化了复杂的编码任务，减少了解决问题所需的步骤，并生成通常可以直接使用的代码。
暂无评论。