AI IDE List
AI IDE List
OpenAI Codex最後核對：2026 年 6 月 18 日

Codex CLI 速查表

面向 Codex CLI 的精簡繁體中文參考，涵蓋官方已文件化指令、常用參數、非互動執行、MCP、外掛管理和內建 slash commands。

快速開始Slash 指令
codex

本機 repo 互動式開發

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

閱讀說明

本頁是繁體中文速查表，不是官方文件的完整複刻；指令名、參數名和列舉值保留英文原文。