SuperAPI AI 工具集

codex

编程与开发

查看项目

更新于 10-15 22:39

技能介绍

用途:通过自然语言提示调用 OpenAI Codex CLI,完成代码审查、分析、重构与自动化编辑等任务,适用于本地开发与 HPC 集群场景。

主要能力:支持通过 codex exec 执行单次任务;可用 -m 指定模型(如 gpt-5、gpt-5-codex),用 -c model_reasoning_effort 设置推理强度(minimal/low/medium/high);用 -s 选择沙箱模式(read-only 用于审查与分析,workspace-write 用于修改文件,danger-full-access 用于系统或网络操作);支持 --full-auto 非交互执行、-C 切换工作目录、--skip-git-repo-check 在非 Git 仓库运行、--json 输出事件、-o 写入最终消息、-i 附加图片、--oss 使用本地开源模型(需 Ollama)。支持 codex resume --last 或指定会话 ID 恢复。

必要用法:先确认 codex --version;运行时按要求拼接参数,例如 codex exec -m gpt-5 -c model_reasoning_effort="medium" -s read-only --skip-git-repo-check --full-auto "review @file.py" 2>/dev/null。配置文件位于 ~/.codex/config.toml,可定义 profile(如 research、development)并通过 --profile 调用。

HPC/Slurm 限制:在 HPC 集群(如 /home/woody/、/home/hpc/ 或存在 Slurm 环境变量)上,需始终添加 --yolo(即 --dangerously-bypass-approvals-and-sandbox)以绕过 Landlock 沙箱错误;--yolo 与 --full-auto 不兼容,不能同时使用。--yolo 在受限的 HPC 登录节点上使用,个人机器或具备 sudo 权限的系统应谨慎并先请求用户批准。若 --yolo 不可用,可回退用 $(cat file.py) 直接注入代码或 heredoc。

其它限制:配置、模型可用性、认证及费用信息暂未提供;部分版本可能不支持 stdin 的 - 参数。出现沙箱或权限错误时,可改用 stdin 管道、调整沙箱权限或升级沙箱模式,并移除 2>/dev/null 查看完整错误。