这份列表是 OpenAI Codex 内部的功能开关,每个功能都处于特定的开发阶段。下面按稳定程度对这些功能进行了分类说明。
🟢 稳定版 (Stable) - 可以放心使用
这些功能已经过充分测试,适合在日常工作流中启用。
| 功能名称 | 功能说明 |
|---|---|
apps |
支持 AI 直接在你的电脑上跨应用操作,例如"看到"屏幕、自主点击和打字。 |
browser_use |
使 Codex 能直接控制和交互内置的浏览器窗口,用于预览或测试网页应用。 |
browser_use_external |
允许 Codex 使用和交互你系统上已安装的外部浏览器。 |
computer_use |
这是"computer use"功能的核心开关,让 AI 能模拟鼠标和键盘来操控整个电脑的图形界面。 |
enable_request_compression |
启用此功能后,会使用 Zstandard 算法压缩与后端之间的请求,以节省带宽并可能提升速度。 |
fast_mode |
一种高性能模式,生成 token 的速度比常规模式快 1.5 倍,适合对响应速度要求高的交互式任务,但成本更高。 |
guardian_approval |
一个 AI 驱动的自动审批机制,用于评估工具调用的风险,可以在一定程度上实现自动化审批流程。 |
hooks |
允许你在 AI 执行任务的关键节点插入自定义脚本,用于安全检查、日志记录或行为修改。 |
in_app_browser |
在内置的应用内浏览器中打开和预览网页,方便前端开发或网页测试。 |
multi_agent |
启用后,Codex 可以生成多个专门的子代理(Sub-agents)并行处理任务,然后将结果整合,极大地提升了复杂任务的效率。 |
personality |
允许为 AI 设定不同的"人格",从而改变其交互风格。 |
plugins |
支持安装和使用第三方插件来扩展 Codex 的功能,例如集成 JIRA、GitLab 等服务。 |
shell_snapshot |
对 Shell 环境进行快照,避免每次执行命令时都重新加载配置文件,从而加速命令的启动。 |
shell_tool |
核心的 Shell 命令执行工具,允许 AI 在沙盒环境中运行 ls、git 等命令。 |
skill_mcp_dependency_install |
当 skill 依赖某个 MCP Server 时,允许 Codex 自动安装该依赖,简化配置流程。 |
tool_call_mcp_elicitation |
当 MCP 服务器需要用户授权或输入时,通过此功能向用户发起请求。 |
tool_search |
允许 AI 动态搜索并发现可用的工具,而不需要在最开始就加载全部工具定义。 |
tool_suggest |
类似于 tool_search,用于向 AI 智能推荐合适的工具,提升工具的发现效率。 |
unavailable_dummy_tools |
当某项功能因故不可用时,返回一个友好的提示信息,而不是直接报错,以改善用户体验。 |
workspace_dependencies |
管理当前工作区(workspace)的依赖关系,确保 AI 在正确的项目上下文中工作。 |
🟡 开发中 (Under Development) - 可能不稳定
这些功能正在积极开发中,可以尝鲜,但功能可能不完整或存在 bug。
| 功能名称 | 功能说明 |
|---|---|
apply_patch_freeform |
允许 AI 使用更灵活的自由文本格式来生成和应用代码补丁(patch),而非仅限于严格的 JSON 格式。 |
apply_patch_streaming_events |
在应用补丁时,将执行过程以流式事件的形式实时反馈,便于前端或客户端实时获取进度。 |
apps_mcp_path_override |
允许覆盖 MCP(Model Context Protocol)服务器在文件系统中的默认路径,用于高级定制。 |
artifact |
将 AI 生成的复杂内容(如合同草案、架构图)作为独立、可编辑的"工件"(Artifact)在工作区中管理,而不是简单的文本。 |
auth_elicitation |
当 AI 需要用户进行身份验证时,通过此机制向用户发起请求和引导,例如 OAuth 流程。 |
builtin_mcp |
启用内置的 MCP 协议支持。 |
child_agents_md |
可能用于通过 AGENTS.md 文件来配置和生成子代理的行为。 |
chronicle |
允许 AI 通过屏幕捕获和 OCR 技术,自动建立关于你工作内容的长期记忆。 |
code_mode & code_mode_only |
为 AI 提供一种特殊的代码执行环境(例如运行 JavaScript),并支持在多个步骤间保持状态。 |
codex_git_commit |
可能是一个自动生成 Git 提交信息的功能。 |
default_mode_request_user_input |
在默认模式下,遇到需要用户介入的情况时,向用户发起输入请求。 |
enable_fanout |
与并行处理相关,可能用于将单一任务拆分为多个子任务并行执行。 |
enable_mcp_apps |
允许 MCP 服务器调用应用层面的功能。 |
exec_permission_approvals |
在执行某些需要高权限的命令前,请求用户批准,这是细粒度权限控制的一部分。 |
multi_agent_v2 |
多代理系统的第二个版本,可能带来更稳定或更强大的子代理管理能力。 |
plugin_hooks |
允许插件系统使用 Hooks 机制,从而让插件能更深入地与 AI 生命周期集成。 |
realtime_conversation |
支持低延迟、双向的实时对话(包括音频),让交互更自然。 |
remote_compaction_v2 |
用于在远程会话中压缩和总结对话历史,以节省上下文 Token 并提升性能。 |
remote_control |
允许通过手机等设备远程监控、审批和引导电脑上的 Codex 任务。 |
remote_plugin |
支持从远程仓库安装和更新插件。 |
responses_websocket_response_processed |
用于跟踪通过 WebSocket 发送的响应是否已被处理完毕。 |
runtime_metrics |
收集和暴露 AI 运行时的性能指标,用于监控和优化。 |
shell_zsh_fork |
使用一个经过特殊修改(patched)的 Zsh 版本来执行 Shell 命令,以提供更强的安全策略和命令拦截能力。 |
skill_env_var_dependency_prompt |
当 skill 需要某些环境变量但系统中缺失时,自动提醒用户进行配置。 |
workspace_owner_usage_nudge |
在工作空间管理中,提醒所有者的使用情况。 |
🧪 实验性 (Experimental) - 早期验证
高度实验性的功能,可能存在重大变更,仅供早期探索。
| 功能名称 | 功能说明 |
|---|---|
external_migration |
可能与将项目或代码迁移到外部环境或服务有关。 |
goals |
允许你为 AI 设定一个宏观目标,它会自动进行"规划-执行-测试"循环,直到自主判断目标达成。 |
memories |
核心的记忆功能,允许 AI 在不同会话间记住用户偏好、项目信息和历史决策,提供个性化服务。 |
prevent_idle_sleep |
防止操作系统在长时间任务运行时进入休眠状态。 |
terminal_resize_reflow |
当终端窗口大小改变时,自动重新排版和调整已有内容的显示。 |
use_legacy_landlock |
在 Linux 系统上,强制使用旧版的 Landlock 沙箱机制,而非更现代的 Bubblewrap。 |
🔄 已弃用 (Deprecated) - 请勿在新项目中使用
这些功能已被标记为即将移除,或已有更好的替代方案。
| 功能名称 | 替代方案/说明 |
|---|---|
use_legacy_landlock |
推荐使用新的沙箱实现。 |
web_search_cached |
被统一的 web_search 配置项替代,它通过 "cached" 值来启用缓存搜索。 |
web_search_request |
被统一的 web_search 配置项替代。 |
🗑️ 已移除 (Removed) - 已不再可用
这些功能已被完全移除,仅保留配置项以保持兼容性,但已无实际作用。
| 功能名称 | 说明 |
|---|---|
collaboration_modes |
协作模式,已被移除。 |
elevated_windows_sandbox |
曾用于Windows的高权限沙盒,已被移除。 |
experimental_windows_sandbox |
Windows实验性沙盒,已被移除。 |
image_detail_original |
图片处理相关功能,已被移除。 |
js_repl |
JavaScript REPL 环境,已被移除。 |
js_repl_tools_only |
与 js_repl 相关,已被移除。 |
remote_models |
远程模型支持,已被移除。 |
request_rule |
智能权限请求规则,已被移除。 |
responses_websockets |
WebSocket 传输方式的早期版本,已被 v2 版本替代。 |
responses_websockets_v2 |
WebSocket 传输方式的第二个版本。 |
search_tool |
已被 tool_search 替代。 |
sqlite |
内置的 SQLite 功能支持,已被移除。 |
steer |
引导执行的功能,已被移除。 |
tui_app_server |
终端UI的应用服务器,已被移除。 |
undo |
撤销功能,已被移除。 |
unified_exec |
统一命令执行系统,已被移除。 |
use_linux_sandbox_bwrap |
在Linux上使用 Bubblewrap 沙箱的功能,已被移除。 |
如果对某个特定功能感兴趣,可以告诉我,我会为你提供更详细的信息。