如何本地安装和使用OpenAI的Codex CLI?

如何本地安装和使用OpenAI的Codex CLI?

OpenAI 最新推理模型的强大功能通过 OpenAI Codex CLI(一款开源命令行工具)直接传输到您的终端。它是一款便携式编程助手,可以在您的计算机上本地读取、编辑和执行代码,从而加快功能开发速度、修复问题并帮助您理解复杂代码。OpenAI 表示,由于 CLI 在本地运行,除非您选择共享,否则您的源代码永远不会离开您的环境。在本文中,我将向您展示如何在本地安装和使用 OpenAI 的 Codex CLI。

为什么选择Codex CLI?

Codex CLI 专为那些熟悉终端操作,并希望实现 ChatGPT 级别的推理能力,同时又能运行代码、管理文件和进行迭代,并保持版本控制的开发者而设计。简而言之,它是一种聊天驱动的开发方式,能够理解并执行您的代码。它的主要功能包括:

  • 零设置:无需配置,只需携带您的 OpenAI API 密钥即可开始使用!
  • 最低要求:您需要 Node.js (v22+) 和 npm (v10+),但总体而言,设置过程快速且轻量。
  • 全自动模式:在禁用网络的目录沙盒中运行,确保您的数据保持私密和安全。
  • 多模式支持:发送屏幕截图或图表,Codex CLI 可以解释并复制您图片中显示的需求。
  • 开源:该工具完全开源,因此您可以探索代码库,甚至为其开发做出贡献。

请注意,Codex CLI 是一个正在进行的实验项目。由于尚不稳定,它可能存在问题、功能缺失或发生颠覆性变化。

推荐阅读:如何访问和使用 OpenAI Codex

审批模式

审批模式控制授予 AI 系统(Codex CLI)的访问权限级别。共有三种审批模式,具体说明如下:

模式 代理可以做什么 何时使用
Suggest(默认) 读取文件。建议编辑和 shell 命令,但在更改或执行命令之前需要您的批准。 安全探索、代码审查、学习代码库。
Auto Edit 自动读取和写入文件。仍会在运行 shell 命令之前询问。 重构或重复编辑时,希望监控副作用的情况。
Full Auto 在沙盒(禁用网络)环境中,自动读取、写入并执行命令,范围限于当前目录。 较长任务,如在您去喝咖啡时修复损坏的构建或进行功能原型开发。

沙盒详情

macOS 12+

Codex CLI 使用 Apple Seatbelt (sandbox-exec) 对命令进行沙盒处理。

  • 大多数文件系统都被置于只读监狱中,只有少数例外,例如 $PWD$TMPDIR~/.codex,这些文件仍然可写。
  • 默认情况下,出站网络访问被完全阻止——即使子进程尝试使用 curl,也会失败。

Linux

沙盒默认未启用。OpenAI 建议使用 Docker 进行沙盒处理。Codex CLI 在一个轻量级容器镜像中运行,您的代码库也挂载在同一位置以实现读写访问。自定义的 iptables/ipset 防火墙脚本会阻止除访问 OpenAI API 之外的所有出口流量。这确保了可重复、可预测的执行,而无需在主机上拥有 root 权限。要启用此功能,请使用 run_in_container.sh 脚本配置沙盒环境。

全新codex-mini-latest

codex-mini-latest 是 o4-mini 的微调版本,专为 Codex CLI 使用。它拥有 20 万个上下文窗口,最多可输出 10 万个 token。codex-mini-latest 的定价介于 GPT-4.1 和 o4-mini 之间,下图显示了每百万 token 的输入、缓存输入和输出价格。

全新codex-mini-latest

Source: OpenAI

如何访问Codex CLI?

请按照以下简单步骤访问 Codex CLI:

1. 转到您正在进行的项目。

如果您想尝试使用虚拟代码库,建议您克隆此代码库,以便我们开始测试 Codex CLI。Github 代码库链接:https://github.com/Badribn0612/warren_buffet_persona

使用命令“git clone https://github.com/Badribn0612/warren_buffet_persona”克隆此代码库。您也可以使用更小的代码库。

2. 转到代码库所在的目录。

使用命令“cd <working directory>”转到该目录。

3. 安装 Codex CLI。

现在我们已准备好开始访问 Codex CLI。让我们安装它。使用以下命令: npm install -g @openai/codex – 此命令将在您的系统中全局安装 Codex CLI。

安装 Codex CLI

4. 获取 API。

OpenAI 为 Plus 用户提供价值 5 美元的 codex-mini-latest API,为 Pro 用户提供价值 50 美元的积分。要兑换,请使用以下命令。

codex — login

这会要求您登录或使用 API 密钥。

codex-mini-latest API

5. 现在,您可以使用 ChatGPT 登录 Codex CLI。

使用 ChatGPT 登录 Codex CLI

6. 兑换成功消息。

成功登录 Codex CLI 后,您应该能够在终端和 OpenAI 仪表板中看到兑换成功的消息。

兑换成功消息

7. 检查您是否可以在终端中访问 Codex CLI。

开始访问 Codex CLI:

在终端中访问 Codex CLI

8. 扫描您的代码库。

经过整整 3 分钟的浏览和扫描,我得到了关于代码库的全面反馈。

扫描您的代码库

9. 在代码库中进行更改。

现在,让我们使用 Codex CLI 进行一些更改。

提示词:Enhance the chainlit application app.py, this has the persona of warren buffet:1. Add search tools2. Improve the code quality, 3. Enhance the chainlit application

在代码库中进行更改

输出:

运行 codex cli 大约 15 分钟后,在经历了代理所做的更改并批准后,执行停止了。

运行 codex cli 大约 15 分钟 运行 codex cli 大约 15 分钟 运行 codex cli 大约 15 分钟

以上是 Codex CLI 代理执行过程中的一些截图。

使用Codex CLI的推论

根据我使用 Codex CLI 代理的经验,我发现它在进行更改时采取了谨慎而深思熟虑的方法。它会验证每个步骤,仅在必要时应用修改,并始终致力于找到最佳解决方案。然而,与使用 CursorWindsurf 等工具手动进行类似更改相比,此过程可能明显较慢。

当然,这只是我的个人经验,您的结果可能会因您所使用的领域或技术栈而异。在本例中,代码库涉及最近更新的库,而 Codex 很难处理这些库。(注意:Codex 的知识截止日期为 2024 年 6 月 1 日)

您也可以考虑尝试使用 Claude Code,看看它如何处理您的用例,并确定哪种工具最适合您的工作流程。

小结

Codex CLI 是一款强大的命令行工具,可将 OpenAI 的高级推理功能直接引入您的本地开发环境。它允许开发者使用自然语言与代码交互,执行调试、重构和功能开发等任务,同时确保敏感数据在本地安全可靠。

Codex CLI 内置沙盒功能、支持多模式运行,并只需极简设置,非常适合喜欢在终端中工作并希望完全掌控代码库的开发者。虽然它仍处于实验阶段,并且在某些情况下可能比其他工具慢,但它对代码更改的谨慎处理以及对隐私的高度重视,使其成为将智能代码辅助集成到工作流程中的有力选择。

评论留言