Codex CLI:OpenAI推出的本地编码AI智能体
Codex CLI是什么?
Codex CLI 是Openai推出的一个轻量级命令行工具,可以为终端用户提供类似 ChatGPT 的推理能力,并能够实际运行代码、操作文件并进行迭代,所有操作都在版本控制下完成。它支持多模态输入,允许用户通过自然语言指令完成代码生成、编辑和运行等任务。
Codex CLI主要功能
代码生成与编辑:用户可以通过简单的英语指令让 Codex CLI 生成代码,例如“创建一个 Python 脚本,读取 CSV 文件并打印某列的平均值”。
文件管理:支持执行文件操作,如“将所有 .txt 文件移动到名为 notes 的文件夹中”。
调试辅助:用户可以粘贴错误信息,Codex CLI 会提供修复建议。
项目搭建:能够快速生成项目模板,例如“搭建一个基本的 Node.js 服务器”。
多模态支持:支持通过截图或图表输入来实现功能。
本地运行:Codex CLI 在本地运行,所有文件的读取、写入和命令执行均在本地完成,除非用户主动选择分享,否则源代码不会离开本地环境。
Codex CLI特点
开源与免费:Codex CLI 是完全开源的,用户可以自由查看、修改代码,并贡献到其开发中。
本地运行:该工具在本地终端运行,确保代码执行和文件操作在用户系统内完成,保障数据隐私。
模型无关性:默认使用 OpenAI 的 GPT-4-turbo 模型,但用户可以切换到其他兼容的 API 端点,如 o3 和 o4-mini。
灵活配置:通过 .codex YAML 文件进行配置,支持自定义变量和模板。
安全模型与权限
Codex CLI 提供三种审批模式,用户可以通过 --approval-mode 参数选择:
建议模式(默认):可以读取仓库中的任何文件,但需要用户批准所有文件写入和 Shell 命令。
自动编辑模式:可以读取并应用补丁写入文件,但需要用户批准所有 Shell 命令。
全自动模式:可以读写文件并执行 Shell 命令,无需用户批准。
Codex CLI使用场景
Codex CLI 主要面向在终端环境中工作的开发者,帮助他们更高效地完成日常开发任务。它并非完全自动化的编码助手,而是用于支持和加速常规任务。
Codex CLI安装方法
通过 npm 安装(推荐):
npm install -g @openai/codex
从源代码构建:
克隆仓库并进入 CLI 包目录:
git clone https://github.com/openai/codex.git cd codex/codex-cli
安装依赖并构建:
npm install npm run build
运行本地构建的 CLI 或通过 npm link 全局链接。
配置
Codex CLI 会在 ~/.codex/ 目录中查找配置文件:
config.yaml:可以设置默认模型等配置项。
instructions.md:可以定义自定义指令。
使用
交互式运行:
codex
运行特定命令:
codex "explain this codebase to me"
全自动模式:
codex --approval-mode full-auto "create the fanciest todo-list app"
非交互模式 / CI 模式
可以在 CI/CD 流水线中以无头模式运行 Codex CLI。例如:
- name: Update changelog via Codex run: | npm install -g @openai/codex export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}" codex -a auto-edit --quiet "update CHANGELOG for next release"
github地址:https://github.com/openai/codex
详细情况:https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started