Codex
命令大全
Codex CLI 全部命令速查 —— 启动与子命令、会话内斜杠命令、会话恢复、审批与沙箱开关、命令行覆盖。
这页是 Codex CLI 的命令速查 —— 启动方式、子命令、交互式 TUI 里的斜杠命令,以及命令行临时覆盖配置的开关。不确定当前版本有什么,看 TUI 里 / 弹出的菜单为准。
Codex 的 base_url 是 https://passion8.cc/v1,带 /v1。配置方式见 CLI 配置。
#启动与子命令
| 命令 | 说明 |
|---|---|
codex | 进入交互式 TUI |
codex "解释这个项目" | 带一句初始 prompt 直接进交互 |
codex exec "..." | 非交互执行,跑完退出(适合脚本 / CI) |
codex app [PATH] | 启动桌面 App,macOS 可直接打开工作区 |
codex app-server | 启动本地 app-server,用于 Desktop/远程/协议调试 |
codex apply <TASK_ID> | 把 Codex Cloud 任务产生的 diff 应用到本地 |
codex cloud | 从终端浏览或执行 Codex Cloud 任务 |
codex resume | 从历史会话里选一个恢复 |
codex resume --last | 直接接最近一次会话 |
codex fork | 从已有会话 fork 新线程 |
codex archive / codex unarchive | 归档或恢复历史会话 |
codex delete | 永久删除历史会话 |
codex doctor | 生成安装、配置、认证、Git、终端诊断报告 |
codex features | 查看并持久启用/禁用 feature flags |
codex login / codex logout | 登录或退出 Codex |
codex --profile <名> | 用指定 Profile 启动(切换整套配置) |
codex --model <名> | 指定本次使用的模型 |
codex -C <目录> | 指定工作目录 |
codex mcp | 管理 MCP 服务器 |
codex mcp-server | 把 Codex 自己作为 MCP server 暴露给其他 agent |
codex plugin | 管理插件 |
codex plugin marketplace | 管理插件 marketplace |
codex remote-control | 确保本地 app-server daemon 支持 remote-control |
codex sandbox | 在 Codex 提供的沙箱里运行任意命令 |
codex update | 检查并应用 CLI 自更新 |
codex --version | 查看版本 |
#命令行覆盖与权限开关
不改 config.toml,启动时临时覆盖:
| 开关 | 作用 |
|---|---|
-c key=value | 临时覆盖任意配置项,如 -c model_reasoning_effort=high |
-a / --ask-for-approval <策略> | 覆盖审批策略(untrusted / on-request / never) |
-s / --sandbox <级别> | 覆盖沙箱级别(read-only / workspace-write / danger-full-access) |
--add-dir <path> | 额外授予一个目录读写权限,可重复 |
--image <path[,path...]> | 给初始 prompt 附加图片 |
--oss | 使用本地 open-source provider,通常要求 Ollama 正在运行 |
--remote <url> | 连接远程 app-server,支持 WebSocket 或 Unix socket |
--remote-auth-token-env <ENV> | 从环境变量读取 remote bearer token |
--search | 启用 live web search,否则默认 cached search |
--strict-config | config.toml 含未知字段时报错 |
--full-auto | 工作区内自动读写,出界才问 |
--dangerously-bypass-approvals-and-sandbox | 完全放开,仅限可信 + 有 git 兜底的目录 |
全自动 / 完全放开的开关不要在陌生仓库、生产目录或含密钥的目录里用。详见 安全说明。
#会话内斜杠命令
在交互式 TUI 里输入 / 会弹出命令菜单,常用的几个:
| 命令 | 作用 |
|---|---|
/model | 切换模型与推理强度 |
/fast | 切换当前模型的 Fast service tier,前提是模型 catalog 暴露该能力 |
/personality | 切换交流风格,如 friendly、pragmatic、none |
/permissions | 切换审批/权限模式 |
/approve | 对最近被 auto review 拒绝的动作批准一次重试 |
/plan | 进入计划模式,可带 inline prompt |
/goal | 设置、查看、暂停、恢复或清除当前任务 goal |
/init | 扫描项目并生成 AGENTS.md |
/diff | 查看当前改动的 git diff |
/review | 对当前工作树做 review |
/mention | 用 @ 引用某个文件给模型 |
/compact | 压缩上下文,长会话省 token |
/clear | 清屏并开始新 conversation |
/new | 在同一个 CLI session 中开始新 conversation |
/status | 查看当前会话状态与配置 |
/usage | 查看账号 token 使用或 rate-limit reset |
/mcp | 查看已接入的 MCP 服务器与工具 |
/ide | 把 IDE 当前打开文件、选择区等上下文带入下一轮 |
/agent | 切换 active agent thread,查看或继续 spawned subagent |
/ps | 查看实验性后台 terminal 和最近输出 |
/stop | 停止当前 session 的后台 terminal |
/fork | 从当前 conversation fork 新线程 |
/side / /btw | 开一个不干扰主 transcript 的旁路对话 |
/raw | 切换 raw scrollback,方便复制长输出 |
/resume | 从 session 列表恢复历史 |
/archive | 归档当前 session 并退出 |
/delete | 永久删除当前 session 并退出 |
/apps | 浏览 connector/app,插入 $app-slug |
/plugins | 浏览、安装、管理插件 |
/hooks | 查看和管理 lifecycle hooks |
/skills | 浏览并使用 skills |
/memories | 配置 memory 使用和生成 |
/import | 导入 Claude Code 配置、项目文件或最近 chats |
/debug-config | 打印配置层级和 requirements 诊断 |
/statusline | 配置 TUI footer 字段 |
/title | 配置终端窗口/标签标题字段 |
/theme | 选择语法高亮主题 |
/keymap | 查看并持久化快捷键映射 |
/vim | 切换 composer Vim 模式 |
/logout | 清理本机凭证 |
/feedback | 向 Codex 维护者发送反馈和日志 |
命令集随版本变化,以菜单实际列出的为准。输入框里直接打 @ 也能模糊查找并引用文件。
#恢复历史会话
接着上次干,不必从头交代背景:
codex resume # 从历史会话里选一个
codex resume --last # 直接接最近一次#接着看
#官方参考
Support / 支持
Need help? / 需要帮助？
接入、计费与模型异常可邮件联系；服务可用性以状态页为准。
For setup, billing, or model issues, email us. Check the status page for uptime.
也可使用右下角微信 / QQ 客服 · WeChat / QQ support is available at the bottom right
