概述
OpenAI Codex CLI 是一个开源命令行工具,可将我们最新推理模型的强大功能直接引入您的终端。它充当轻量级编码代理,可以在本地计算机上读取、修改和运行代码,以帮助您更快地构建功能、消除错误并理解不熟悉的代码。由于 CLI 在本地运行,因此除非您选择共享源代码,否则您的源代码永远不会离开您的环境。
有关 Codex 的更多详细信息,请直接查看 Github 仓库 - https://github.com/openai/codex。
主要功能
-
零设置安装 – 单个(或)即可开始使用。
npm install -g @openai/codex
codex --upgrade
-
多模式输入 – 传递文本、屏幕截图或图表,并让代理相应地生成或编辑代码。
-
丰富的审批工作流程 – 选择您希望使用三种不同模式的动手实践方式(请参阅审批模式)。
-
完全在您的终端中运行 – 非常适合快速迭代,无需切换上下文。
审批模式
模式 |
代理可以做什么 |
适用情形 |
Suggest (默认) |
读取文件。提议编辑和shell命令,但在进行更改或执行命令之前需要您的批准。 |
安全探索、代码审查、学习代码库。 |
自动编辑 |
自动读取和写入文件。在运行 shell 命令之前仍然询问。 |
重构或重复编辑,以密切关注副作用。 |
全自动 |
在范围限定为当前目录的沙盒、网络禁用环境中自主读取、写入和执行命令。 |
较长的任务,例如在您喝咖啡时修复损坏的构建或原型设计功能。 |
专业提示:如果目录不受版本控制,Codex 会在输入 Auto Edit 或 Full Auto 之前发出警告。
快速开始
-
安装:
npm install -g @openai/codex
-
Authenticate:导出您的 OpenAI API 密钥 ()。
export OPENAI_API_KEY="<OAI_KEY>"
-
在 Suggest 模式下运行:在项目根目录中,键入 codex 并询问例如:“Explain this repo to me”。
-
切换模式:根据需要添加标志:
-
codex --auto-edit
-
codex --full-auto
-
-
查看输出:Codex 以内联方式打印建议的补丁和 shell 命令。根据需要批准、拒绝或调整。
常见问题
Codex 使用哪些模型?
默认情况下,Codex 以 o4-mini 为目标以进行快速推理。您可以指定响应 API 中可用的任何模型,例如 .我们还建议您验证您的开发人员帐户,以便开始在 API 中查看思路摘要。codex -m o3
Codex 会将我的代码上传到 OpenAI 吗?
不。所有文件读取、写入和命令执行都在本地进行。仅将提示、高级上下文和可选的差异摘要发送到模型进行生成。
如何更改审批模式?
使用适当的标志 (、、) 启动 Codex,或使用会话中快捷方式进行切换。--suggest
--auto-edit
--full-auto
/mode
支持哪些平台?
Codex 正式支持 macOS 和 Linux。Windows 支持是实验性的,可能需要 WSL。
代理卡住或超时 - 我该怎么办?
-
确保您有稳定的 Internet 连接以进行 API 调用。
-
尝试取消当前步骤并要求 Codex 继续。
CTRL‑C
-
如果使用 Full Auto 模式,请确认 Sandbox 有权访问所需的目录。
发表评论 取消回复