关于 ask-codex
Ask LLM 将编码助手和 MCP 客户端连接到 OpenAI Codex CLI,为代码和计划提供第二意见。它面向希望在现有助手会话中让另一模型审查更改或评议计划的开发者。
主要功能
- 01审查代码和暂存更改
- 02质疑计划与假设
- 03使用已认证的服务订阅
- 04可选的逐次编辑配对审查
- 05审查时使用只读控制
适用场景
- 01检查暂存更改中的错误
- 02请 Codex 进行安全审查
- 03实现前比较方案
MCP 相关
向 MCP 客户端提供代码审查和计划评议工具,并连接 Codex CLI 及其他受支持的提供方。设置流程可配置客户端注册和工作流。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @ask-llm/codex-mcpGMCPT_TIMEOUT_MSTimeout for Codex CLI execution in milliseconds (default: 300000 = 5 minutes)GMCPT_LOG_LEVELLog verbosity: debug, info, warn, error (default: warn)本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
4收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 否 | 请勿设置此参数。此工具会自动使用 gpt-6-astra,并在配额错误时回退到 gpt-5.6-terra。仅当用户明确要求特定模型时才设置此参数。 |
| prompt | string | 是 | 要发送给 Codex CLI 的问题、代码审查请求或分析任务 |
| sandbox | enum | 否 | 此调用的 Codex 沙箱模式。默认值为 'read-only',用于强制执行核心审查约定(Codex 读取并提出建议,MCP 客户端进行编辑)。仅当工作流需要 Codex 自行写入文件(例如,生成图像)时,才将其设为 'workspace-write' 作为明确的退出选项。审查、第二意见和分析工作流绝不能设置此项。read-only | workspace-write |
| preferred | boolean | 否 | 当 ASK_CODEX_PREFERRED_MODEL 配置为不同于 gpt-6-astra 默认值时,选择启用该配置。内置首选值同样是 gpt-6-astra,因此普通调用和审查技能应保持未设置。 |
| sessionId | string | 否 | 临时单次调用时省略。首次调用时传入空字符串 (""),以创建可持久化并可恢复的会话线程;随后在后续调用中传入返回的 [Thread ID: ...] 值,以在完整保留先前上下文的情况下继续。 |
| includeDirs | array | 否 | 在全新调用中,Codex 除工作目录外还可访问的其他目录(映射到 codex `--add-dir`,可重复指定)。与恢复的 sessionId 一起使用时会被拒绝,因为 `codex exec resume` 不支持 --add-dir;目录绝不会被静默丢弃。必须是相对路径(例如,'packages/api')。适用于相关上下文分布在同级软件包中的 monorepo。 |
| reasoningEffort | enum | 否 | 此调用的 Codex 推理强度。默认值为 medium;/codex-review 和 /brainstorm 为优先质量的工作流使用 high。low | medium | high | xhigh | max | ultra |
详细介绍
Ask LLM
为编码 Agent 提供第二意见。
在编码助手中,利用你现有的模型订阅,为代码或计划征求第二意见。
适用于已经在使用编码助手并订阅了其他模型的个人开发者和小型团队:无需 API 密钥、复制粘贴或离开当前会话,即可请另一家供应商的模型审查你的更改或质疑你的计划。
You: ask codex to review src/auth.ts for security issues
Codex: ⚠ verifyToken() compares tokens with === — not timing-safe (line 42)
⚠ the session cookie is missing a SameSite attribute
Claude: Good catches — applying both fixes to src/auth.ts.
安装
你需要在 Linux 或 macOS 上安装 Node.js 24+。首次审查前,必须已安装并登录你的编码助手(例如 Claude Code)和你要咨询的供应商(例如 Codex)。Ask LLM 负责配置连接,不会安装供应商或帮你登录。如果你从未在这台机器上登录过 Codex 等供应商 CLI,请先登录,然后重新运行设置。
npm i -g @ask-llm/mcp && ask-llm setup
设置过程会要求你确认检测到的每个主机和工作流。检查预览,确认助手的注册信息和工作流,拒绝其他项,然后按照显示的任何手动步骤操作。重启助手,或在项目中启动新会话。
首次审查
在安装并登录 Claude Code 和 Codex 后,在项目中打开 Claude Code 并提问:
Ask Codex to review my staged changes for bugs and missing error handling. Check each finding against the source before proposing fixes.
如果你在 Codex 中工作并订阅了 Claude?请改为咨询 Claude。选择与你当前助手来自不同供应商的提供方。成功的审查会注明审查者和模型,引用相关代码,并报告发现的问题或说明未发现问题。由你决定接受哪些更改,再由助手应用。如果请求失败,请运行 ask-llm doctor,并按照故障排除指南针对你选择的助手和审查者进行排查。对于你不使用的提供方,其相关警告不代表你需要安装它们或添加 API 密钥。
审查计划时,可以试试:“请让 Claude 质疑这个计划:哪些假设可能不成立?在我们的约束条件下,有没有更简单的方法?”
完成按需审查后,配对审查可以提供持续反馈。配对功能需要明确选择加入;设置时默认关闭。
支持的主机
主机是你使用的助手;提供方是你咨询的模型。
| 主机 | 使用体验 |
|---|---|
| Claude Code | 审查、计划评议、比较;隔离的审查者,以及选择加入的逐次编辑配对审查 |
| Codex、Cursor、Grok Build、Gemini CLI | 工具和可移植工作流;按需配对 |
| Antigravity | 工具;设置过程会显示工作流的手动步骤 |
| Pi 0.83.0+ | 原生工具和可移植工作流;可选择加入逐次编辑配对审查 |
| Claude Desktop | 仅工具 |
| OpenCode | 工具和可移植工作流;设置仅通过测试夹具进行验证 |
完整兼容性矩阵和手动设置限制(包括现有 Codex 注册信息),请参阅主机兼容性。
支持的提供方
| 提供方 | 访问方式 |
|---|---|
| Codex | 你已通过身份验证的 Codex CLI/账户 |
| Claude | 你已通过身份验证的 Claude Code 账户;需从 Claude Code 以外的主机进行咨询 |
| Grok | 已通过身份验证的 Grok Build、确切的 Cursor 模型,或明确选择的按量计费 xAI API 选项 |
| Antigravity | 你已通过身份验证的 agy 订阅;默认关闭执行,选择加入也不保证只读 |
| Ollama | 你机器上的本地模型 |
| Gemini | 符合条件的 Gemini Code Assist Standard/Enterprise 席位 |
Cursor Agent 也可以咨询 Cursor 目录中的确切模型。这是一种连接方式,使用情况由你的 Cursor 方案决定。
信任与成本
审查运行使用只读的提供方控制;你使用的助手仍是编辑器。Antigravity 在明确启用前会拒绝执行,且启用后无法保证只读访问。请仅审查你获准与所选提供方共享的内容。
调用会消耗你现有提供方套餐的配额,或按该账户的计费方式收费。Grok 的 xAI API 是单独计量收费的选项,需要 API 密钥;Ask LLM 不会替你启用计费或超额使用。Ollama 支持本地推理。Ask LLM 不发送遥测数据;提供方和主机的数据政策仍然适用。
多个模型意见一致并不能证明结果正确。请结合代码、测试和你的需求验证发现。请参阅数据流和成本与回退方案。
从 @ask-llm/* 迁移
在弃用之前的注册项之前,请先遵循迁移指南。
贡献:CONTRIBUTING.md。采用 MIT 许可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。