SuperAPI AI 工具集

codex-cli

编程与开发

查看项目

更新于 10-15 20:29

技能介绍

用途:在 Claude Code 会话中调用本地 codex CLI(要求 codex --version ≥ 0.128.0),把代码审查、代码实现或图像生成交给 Codex 作为第二意见,无需离开当前对话。使用前每会话验证一次:运行 codex --version 与 codex login status,后者须显示 Logged in;若未登录,应提示用户自行在提示符执行 ! codex login,不要代为登录。

模式选择:解析 $ARGUMENTS,首个 token 决定模式(review | impl | image),其后为提示词或参数。若未给出子命令则推断:提及 review、diff、PR、second opinion 归为 review;提及 image、picture、render、draw 归为 image;其余归为 impl。回复中需说明所选模式。

review 模式:可用 codex review --uncommitted(含 staged、unstaged、untracked)、codex review --base main(相对基分支的 PR 式审查)、codex review --commit sha(单个提交),也可通过管道传入关注点,如 "Focus on concurrency. Skip nits." | codex review --uncommitted -。返回后应转述并按 CRITICAL/HIGH/MEDIUM/LOW 分组,标注 file:line,不要直接倾倒原始输出;Codex 结论仅为第二意见,若与会话中已验证内容冲突需向用户指出。

impl 模式:优先一次性非交互执行,如 codex exec "<prompt>" -s workspace-write -C "<绝对路径>" --output-last-message codex-out.txt;只读研究或规划用 -s read-only;长提示词可通过 stdin 传入;继续最近会话用 codex exec resume --last "<follow-up>"。默认沙箱为 workspace-write(允许网络,仅在 -C 指定目录内写入),-C 必须传绝对路径。未经用户逐次批准,不要使用 -s danger-full-access 或 --dangerously-bypass-approvals-and-sandbox。完成后读取 codex-out.txt 或 diff 并总结改动,未经询问不要重跑 codex apply。

image 模式:Codex 内置 image_gen.imagegen 工具,在 codex features list 显示 image_generation = stable, true 时自动启用,认证使用 codex 登录,ChatGPT 登录即可,无需 OPENAI_API_KEY。调用示例:codex exec --skip-git-repo-check -s workspace-write -C "<输出目录绝对路径>" "Generate an image of <prompt>, 1024x1024. Save the result as <name>.png in the current working directory."。提示词中不要要求使用 OpenAI API、curl、python 或 openai CLI,否则会走需要 API key 的外部路径。文件先写入 ~/.codex/generated_images/<session_id>/ig_<hash>.png,再尝试复制到工作区;Windows 上 codex-cli 0.128.0 的复制步骤常失败,此时应自行复制文件而非升级沙箱。支持尺寸为 1024x1024、1536x1024、1024x1536,不支持时列出有效选项。需向用户显示绝对路径,不要在对话中嵌入 PNG 字节。

安全与输出:未确认不得把用户标记为机密的代码或提示词发送给 Codex;不得生成未经同意描绘真实可识别人物的图像或违反 OpenAI 使用政策的内容;边界提示词应先询问用户。除用户要求外不要流式输出 Codex 的 stdout,应做总结;长会话保存到 codex-out.txt 并仅引用相关部分;始终说明所运行的模式与确切命令,便于用户复现。此资料未提供收费、价格或具体平台支持范围等信息。