AI IDE List
AI IDE List
OpenAI Codex最后核对：2026 年 6 月 18 日

Codex CLI 速查表

面向 Codex CLI 的紧凑中文参考，覆盖官方已文档化命令、常用参数、非交互运行、MCP、插件管理和内置 slash commands。

快速开始Slash 命令
codex

本地仓库交互式开发

codex exec

脚本与一次性任务

codex cloud

Cloud 任务工作流

/permissions

实时会话权限控制

快速开始

最常用的 Codex 命令

覆盖本地交互、一次性自动化、Cloud 任务和交互式会话控制等高频场景。

交互式工作
codex

在当前工作区打开终端 UI。

一次性自动化
codex exec "fix the failing test"

以非交互模式运行 Codex 并流式输出结果。

继续工作
codex resume --last

返回最近的交互式会话。

应用 Cloud 输出
codex apply TASK_ID

应用 Codex Cloud 任务生成的最新 diff。

会话权限
/permissions

调整 Codex 无需询问即可执行的操作。

模型控制
/model

选择当前模型和 reasoning effort。

全局参数

codex [OPTIONS] [PROMPT]

这些参数主要用于基础 codex 命令，很多也可被子命令接受。

--add-dir

类型 / 取值

path

用途

在主工作区之外额外添加一个可写目录。

--ask-for-approval, -a

类型 / 取值

untrusted | on-request | never

用途

设置 Codex 运行命令前何时需要询问。

--cd, -C

类型 / 取值

path

用途

在 agent 启动前设置工作目录。

--config, -c

类型 / 取值

key=value

用途

在命令行中覆盖配置值。

--dangerously-bypass-approvals-and-sandbox

类型 / 取值

boolean

用途

在已有外部隔离的环境中禁用审批和沙箱。

--yolo

类型 / 取值

boolean

用途

危险绕过模式的别名。

--dangerously-bypass-hook-trust

类型 / 取值

boolean

用途

本次运行启用 hooks 时跳过持久信任检查。

--disable

类型 / 取值

feature

用途

强制关闭某个功能开关。

--enable

类型 / 取值

feature

用途

强制开启某个功能开关。

--image, -i

类型 / 取值

path[,path...]

用途

给初始提示附加图片。

--model, -m

类型 / 取值

string

用途

覆盖已配置的模型。

--no-alt-screen

类型 / 取值

boolean

用途

禁用终端 UI 的 alternate-screen 模式。

--oss

类型 / 取值

boolean

用途

使用本地开源模型提供方，通常配合 Ollama。

--profile, -p

类型 / 取值

string

用途

加载指定的 Codex 配置 profile。

--remote

类型 / 取值

ws://host:port | wss://host:port | unix:// | unix://PATH

用途

将 TUI 连接到远程 app-server。

--remote-auth-token-env

类型 / 取值

ENV_VAR

用途

从环境变量读取远程 bearer token。

--sandbox, -s

类型 / 取值

read-only | workspace-write | danger-full-access

用途

选择 shell 命令的沙箱策略。

--search

类型 / 取值

boolean

用途

启用实时网页搜索。

--strict-config

类型 / 取值

boolean

用途

配置中存在未知字段时报错。

PROMPT

类型 / 取值

string

用途

可选的启动提示。

只有在外部环境已经提供强隔离时，才应使用 --dangerously-bypass-approvals-and-sandbox 或 --yolo。

命令总览

官方已文档化的顶层命令

Stable 适合日常使用；Experimental 可能随 Codex 演进而变化。

codex稳定

启动交互式终端 UI。

codex app稳定

打开 Codex 桌面应用。

codex app-server实验性

启动本地 app-server，用于开发或调试。

codex apply稳定

在本地应用 Codex Cloud 任务 diff。

codex a稳定

codex apply 的别名。

codex archive稳定

归档已保存的交互式会话。

codex cloud实验性

从终端浏览或运行 Codex Cloud 任务。

codex cloud-tasks实验性

codex cloud 的别名。

codex completion稳定

生成 shell 自动补全脚本。

codex debug app-server send-message-v2实验性

向 app-server 发送 V2 测试消息。

codex debug models实验性

打印 Codex 可见的模型目录。

codex doctor稳定

创建本地诊断报告。

codex exec稳定

以非交互模式运行 Codex。

codex e稳定

codex exec 的别名。

codex execpolicy实验性

评估命令执行策略规则。

codex features稳定

列出或持久化功能开关覆盖。

codex fork稳定

从旧会话分叉出新线程。

codex login稳定

认证 / 登录 Codex。

codex logout稳定

移除已保存的凭据。

codex mcp实验性

管理 MCP server 定义和认证。

codex mcp-server实验性

将 Codex 本身作为 MCP server 运行。

codex plugin实验性

安装、列出和移除 Codex 插件。

codex plugin marketplace实验性

管理插件市场来源。

codex remote-control实验性

确保 app-server 已启用 remote-control 支持。

codex resume稳定

恢复之前的交互式会话。

codex sandbox实验性

在 Codex 沙箱中运行命令。

codex unarchive稳定

恢复已归档的会话。

codex update稳定

在支持时检查或应用 CLI 更新。

子命令

按工作流分组的命令矩阵

按场景组织，便于快速扫描，同时保留官方文档化命令面的覆盖。

codex

用途

启动交互式终端 UI。

codex "PROMPT"

用途

带初始指令启动 TUI。

codex --image path

类型 / 取值

path[,path...]

用途

启动时附加一张或多张图片。

codex --remote ENDPOINT

类型 / 取值

ws://, wss://, unix://

用途

将 TUI 连接到远程 app-server。

codex app

用途

打开桌面应用。

codex app PATH

类型 / 取值

path

用途

在 Codex Desktop 中打开指定工作区路径。

codex app --download-url URL

类型 / 取值

url

用途

覆盖桌面安装器下载 URL。

codex app-server

用途

启动本地 app-server。

codex app-server --listen VALUE

类型 / 取值

stdio:// | ws://IP:PORT | unix:// | unix://PATH | off

用途

设置传输监听方式。

codex app-server --stdio

类型 / 取值

boolean

用途

使用 stdio 传输。

codex app-server --analytics-default-enabled

类型 / 取值

boolean

用途

对 app-server 客户端默认启用 analytics。

codex app-server --ws-auth MODE

类型 / 取值

capability-token | signed-bearer-token

用途

选择 WebSocket 认证模式。

codex app-server --ws-audience VALUE

类型 / 取值

string

用途

预期的 JWT audience。

codex app-server --ws-issuer VALUE

类型 / 取值

string

用途

预期的 JWT issuer。

codex app-server --ws-max-clock-skew-seconds N

类型 / 取值

number

用途

允许 token 时间校验存在时钟偏差。

codex app-server --ws-shared-secret-file PATH

类型 / 取值

absolute path

用途

signed bearer token 使用的 HMAC 密钥文件。

codex app-server --ws-token-file PATH

类型 / 取值

absolute path

用途

capability token 文件。

codex app-server --ws-token-sha256 HEX

类型 / 取值

hex SHA-256

用途

预期的 token SHA-256 摘要。

codex remote-control

用途

确保本地 app-server daemon 运行并启用 remote-control。

codex apply TASK_ID

类型 / 取值

string

用途

在本地应用 Codex Cloud 任务 diff。

codex a TASK_ID

类型 / 取值

string

用途

codex apply 的别名。

codex archive SESSION

类型 / 取值

session ID | session name

用途

按 ID 或名称归档已保存会话。

codex unarchive SESSION

类型 / 取值

session ID | session name

用途

按 ID 或名称恢复已归档会话。

codex archive --remote ENDPOINT SESSION

类型 / 取值

endpoint

用途

变更归档状态前先连接远程 app-server。

codex cloud

用途

从终端浏览或运行 Cloud 任务。

codex cloud exec QUERY

类型 / 取值

string

用途

直接提交 Cloud 任务。

codex cloud exec --attempts N

类型 / 取值

1-4

用途

设置 assistant 尝试次数。

codex cloud exec --env ENV_ID

类型 / 取值

ENV_ID

用途

指定 Codex Cloud 环境。

codex cloud list

用途

列出最近的 Cloud 任务。

codex cloud list --cursor VALUE

类型 / 取值

string

用途

使用分页游标。

codex cloud list --env ENV_ID

类型 / 取值

ENV_ID

用途

按环境筛选。

codex cloud list --json

类型 / 取值

boolean

用途

输出 JSON。

codex cloud list --limit N

类型 / 取值

1-20

用途

限制返回的任务数量。

codex cloud-tasks

用途

codex cloud 的别名。

codex resume

用途

恢复交互式会话。

codex resume SESSION_ID

类型 / 取值

uuid

用途

恢复指定交互式会话。

codex resume --all

类型 / 取值

boolean

用途

显示当前目录之外的会话。

codex resume --last

类型 / 取值

boolean

用途

恢复最近的会话。

codex fork

用途

从旧会话分叉出新线程。

codex fork SESSION_ID

类型 / 取值

uuid

用途

分叉指定会话。

codex fork --all

类型 / 取值

boolean

用途

显示当前目录之外的会话。

codex fork --last

类型 / 取值

boolean

用途

分叉最近的会话。

非交互模式

codex exec 参数

当 Codex 以终端、脚本或自动化中的一次性命令运行时使用这些参数。

--cd, -C

类型 / 取值

path

用途

设置工作区根目录。

--color

类型 / 取值

always | never | auto

用途

控制 ANSI 彩色输出。

--dangerously-bypass-approvals-and-sandbox

类型 / 取值

boolean

用途

禁用审批和沙箱。

--yolo

类型 / 取值

boolean

用途

危险绕过模式的别名。

--dangerously-bypass-hook-trust

类型 / 取值

boolean

用途

运行 hooks 时跳过持久信任。

--ephemeral

类型 / 取值

boolean

用途

不持久化会话 rollout 文件。

--full-auto

类型 / 取值

boolean

用途

已弃用的兼容参数。

--ignore-rules

类型 / 取值

boolean

用途

不加载 execpolicy 规则文件。

--ignore-user-config

类型 / 取值

boolean

用途

不加载用户配置。

--image, -i

类型 / 取值

path[,path...]

用途

给第一条消息附加图片。

--json

类型 / 取值

boolean

用途

输出 NDJSON 事件。

--experimental-json

类型 / 取值

boolean

用途

JSON 事件输出的旧别名。

--model, -m

类型 / 取值

string

用途

覆盖模型。

--oss

类型 / 取值

boolean

用途

使用本地 OSS 模型提供方。

--output-last-message, -o

类型 / 取值

path

用途

将最终 assistant 回复写入文件。

--output-schema

类型 / 取值

path

用途

按 JSON Schema 校验最终输出。

--profile, -p

类型 / 取值

string

用途

加载配置 profile。

--sandbox, -s

类型 / 取值

read-only | workspace-write | danger-full-access

用途

选择沙箱策略。

--skip-git-repo-check

类型 / 取值

boolean

用途

允许在非 Git 仓库中运行。

--config, -c

类型 / 取值

key=value

用途

在命令行中覆盖配置。

PROMPT

类型 / 取值

string | -

用途

初始任务提示；使用 - 从 stdin 读取。

交互式 TUI

内置 slash commands

在 Codex 输入框中输入 / 可打开 slash command 弹窗。

/permissions

设置 Codex 无需询问即可执行的操作。

/ide

包含 IDE 当前打开文件、选区等上下文。

/keymap

重映射 TUI 快捷键。

/vim

切换输入框 Vim 模式。

/sandbox-add-read-dir

在 Windows 上给沙箱添加目录读取权限。

/agent

切换当前 agent 线程。

/apps

浏览 apps / connectors 并插入到提示中。

/plugins

浏览已安装和可发现插件。

/hooks

查看生命周期 hooks。

/clear

清屏并开始新聊天。

/archive

归档当前会话并退出 Codex。

/compact

压缩可见对话以释放上下文 token。

/copy

复制最近完成的 Codex 输出。

/diff

显示 Git diff，包括未跟踪文件。

/exit

退出 CLI。

/experimental

切换实验功能。

/approve

自动审查拒绝后批准一次重试。

/memories

配置 memory 的使用和生成。

/skills

浏览并使用 skills。

/feedback

向 Codex 维护者发送日志。

/init

生成 AGENTS.md 脚手架。

/logout

登出 Codex。

/mcp

列出已配置的 MCP 工具。

/mcp verbose

显示 MCP server 详情。

/mention

将文件或文件夹附加到对话。

/model

Choose model and reasoning effort.

/fast

切换或查看 Fast 服务层。

/plan

切换到计划模式。

/goal

设置、查看、暂停、恢复或清除目标。

/personality

选择沟通风格。

/ps

查看实验性后台终端。

/stop

停止所有后台终端。

/fork

将当前对话分叉到新线程。

/side

开启临时侧聊。

/btw

开启短侧聊。

/raw

切换原始滚动回看模式。

/resume

恢复已保存对话。

/new

在同一 CLI 会话中开始新对话。

/quit

退出 CLI。

/review

让 Codex 审查当前工作区。

/status

显示会话配置和 token 使用量。

/debug-config

打印配置层级诊断信息。

/statusline

配置 TUI 状态栏字段。

/title

配置终端标题字段。

/theme

选择语法高亮主题。

常见写法

/fast on

开启 Fast 服务层。

/fast off

关闭 Fast 服务层。

/fast status

显示 Fast 服务层状态。

/personality friendly

使用 friendly 沟通风格。

/personality pragmatic

使用 pragmatic 沟通风格。

/personality none

关闭 personality 风格。

/goal <objective>

设置任务目标。

/goal pause

暂停当前目标。

/goal resume

恢复当前目标。

/goal clear

清除当前目标。

/prompts:<name>

运行本地自定义 prompt。custom prompts 已弃用，推荐使用 skills。

本机扩展

内置 slash commands 是有限集合，但已安装的 skills、plugins、MCP servers，以及已弃用的 /prompts:* 文件，可能提供本机独有能力。

来源

官方文档

命令名、参数名、成熟度标签和 slash command 覆盖范围基于 OpenAI 官方 Codex CLI 文档。

Codex CLI 参考CLI slash commands自定义 prompts

阅读说明

本页是中文速查表，不是官方文档的完整复刻；命令名、参数名和枚举值保留英文原文。