Day 04 / 共 20 天 · 第 1 周 · 会用 + 建立心智
CLI 子命令全家桶
MultitoolCli:exec / login / mcp / resume / review / features … 用法地图。
📍 你在整门课的位置 · 第 1 周 · 会用 + 建立心智
D01 项目全景与目录地图→D02 安装、登录与第一次对话→D03 沙箱与审批→D04 CLI 子命令全家桶→D05 TUI 交互与 Slash 命令
L01
入口:无子命令 = 交互 TUI
codex-rs/cli/src/main.rs:
struct MultitoolCli {
// ... config / features / remote / interactive
subcommand: Option<Subcommand>,
}
// 无 subcommand → 跑 TUI;有则分发
Multitool:一个二进制里塞很多子工具——像
git,而不是每个功能一个 exe。L02
子命令地图(用法向)
| 命令 | 干什么 |
|---|---|
codex / codex "…" | 交互 TUI |
exec (e) | 非交互跑一轮任务 |
review | 非交互 code review |
login / logout | 认证 |
mcp | 管理 MCP servers(list/add/remove/login…) |
plugin | 插件管理 |
mcp-server | 把 Codex 自己当 MCP server(stdio) |
app-server | 给 IDE/桌面的 JSON-RPC 服务 |
app | 拉起桌面端(macOS/Windows) |
resume / fork | 恢复 / 分叉会话 |
archive / unarchive / delete | 会话生命周期 |
apply (a) | git apply 最新 agent diff |
sandbox | 在 Codex 沙箱里跑一条命令 |
doctor / update / completion | 诊断 / 自更新 / 补全脚本 |
features | list/enable/disable 功能开关 |
cloud | 浏览云端任务(实验) |
L03
共享重要 flag
| Flag | 含义 |
|---|---|
-m / --model | 模型 |
-s / --sandbox | 沙箱模式 |
-a(TUI) | 审批策略 |
-C / --cd | 工作目录 |
--add-dir | 额外可写目录 |
-p / --profile | 配置 profile |
-c key=value | 临时覆盖 config |
--oss | 本地 Ollama 等 |
--search | 打开 hosted web_search |
--enable / --disable | feature 开关 |
定义散落在 codex-rs/utils/cli/ 与各子命令 Cli 结构体。
L04
今日小结
codex --help
codex exec --help
codex mcp --help
codex features list
✅ 能从 help 里找到 exec/mcp/resume;知道无子命令进 TUI。