# Codex 命令大全

> Codex CLI 全部命令速查 —— 启动与子命令、会话内斜杠命令、会话恢复、审批与沙箱开关、命令行覆盖。

URL: https://docs.passion8.cc/docs/codex/commands
Language: zh-CN
Publisher: Passion8

这页是 Codex CLI 的命令速查 —— 启动方式、子命令、交互式 TUI 里的斜杠命令,以及命令行临时覆盖配置的开关。不确定当前版本有什么,看 TUI 里 `/` 弹出的菜单为准。




Codex 的 `base_url` 是 `https://passion8.cc/v1`,**带** `/v1`。配置方式见 [CLI 配置](https://docs.passion8.cc/docs/codex/config)。




## 启动与子命令

| 命令 | 说明 |
| --- | --- |
| `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 <策略>` | 覆盖审批策略(`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` | 已弃用兼容参数;新配置使用 `--sandbox workspace-write --ask-for-approval on-request` |
| `--dangerously-bypass-approvals-and-sandbox` | 完全放开,仅限可信 + 有 git 兜底的目录 |




全自动 / 完全放开的开关不要在陌生仓库、生产目录或含密钥的目录里用。详见 [安全说明](https://docs.passion8.cc/docs/security)。




## 会话内斜杠命令

在交互式 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 维护者发送反馈和日志 |




命令集随版本变化,以菜单实际列出的为准。输入框里直接打 `@` 也能模糊查找并引用文件。




## 恢复历史会话

接着上次干,不必从头交代背景:

```bash
codex resume          # 从历史会话里选一个
codex resume --last   # 直接接最近一次
```

## 接着看



- [高阶玩法](https://docs.passion8.cc/docs/codex/tips): AGENTS.md、Profile、MCP、exec 与审批沙箱。
- [常见问题](https://docs.passion8.cc/docs/codex/troubleshooting): 认证、/v1、Responses 接口排查。



## 官方参考

- [Codex manual: CLI command reference](https://developers.openai.com/codex/codex-manual.md)
- [Codex manual: Slash commands in Codex CLI](https://developers.openai.com/codex/codex-manual.md)