垦荒学园
  • 中文

      • Codex 命令行工具（CLI）

      桌面应用之外，Codex CLI 是终端里的开源 Agent（Rust 实现，启动快、资源占用低），尤其适合脚本化、CI、远程/服务器开发。本章是 CLI 的一站式参考，并集中说明 CLI 与桌面应用的差异点：CLI 配置、Skills、沙箱、模型、提示词与实用示例。

      与 App 共享同一套 Agent 与配置模型；通用概念见对应专章，这里聚焦命令行特有的用法。

      启动与基本用法

      cd your-project
codex                          # 启动交互式 TUI
codex "总结 src/auth 的认证流程"  # 带初始提示启动

      交互中可用斜杠命令（/status、/model、/review…）与 $skill、@文件。

      子命令一览

      命令用途
      codex交互式 TUI
      codex exec "..." / codex e非交互单次任务（脚本/CI）
      codex resume [id]继续上次/指定会话
      codex fork把会话分叉成新线程
      codex cloud [list]浏览/执行云端任务
      codex apply / codex a应用云端任务的最新 diff
      codex mcp管理 MCP 服务器（list/add/remove）
      codex plugin安装/列出/移除插件
      codex features列出/启用/禁用功能开关
      codex login / logout认证 / 注销
      codex doctor本地诊断报告
      codex sandbox <os> -- <cmd>在 Codex 沙箱里测试命令
      codex execpolicy check -- <cmd>校验规则命中
      codex app打开桌面应用（macOS/Windows）
      codex update检查并更新 CLI
      codex completion生成 shell 补全
      codex mcp-server把 Codex 自身作为 MCP server（stdio）

      常用标志

      标志说明
      -s, --sandboxread-only / workspace-write / danger-full-access
      -a, --ask-for-approvaluntrusted / on-request / never
      -m, --model指定模型（如 gpt-5.5）
      -C, --cd启动前切换工作目录
      -c key=value临时覆盖配置项
      -i, --image附加图片文件
      -p, --profile叠加某个 Profile
      --search启用 live Web 搜索（默认可为 cached）
      --oss使用本地开源 provider（Ollama）
      --add-dir额外可写目录
      --json / --output-last-message机器可读 / 打印最终摘要
      --dangerously-bypass-approvals-and-sandbox跳过沙箱与审批（危险）

      CLI 配置

      CLI 读取 ~/.codex/config.toml（项目级 .codex/config.toml 需信任），并可用 -c 临时覆盖、--profile 切换组合、CODEX_HOME 整体隔离。

      codex -c model="gpt-5.4" -c model_reasoning_effort="xhigh" "重构这个模块"
codex --profile review "审查未提交改动"
export CODEX_HOME="$HOME/.codex-ci" && codex exec "..."   # 隔离配置

      完整分层与字段见 配置与定制。

      CLI 沙箱与安全

      CLI 把权限拆成沙箱与审批两个标志：

      # 安全本地默认
codex --sandbox workspace-write --ask-for-approval on-request

      测试某命令是否被沙箱拦截：

      codex sandbox macos --log-denials -- echo test   # macOS
codex sandbox linux -- echo test                  # Linux

      CLI Skills

      Skills 在 CLI 与 App 完全通用：

      codex
> /skills            # 查看可用 Skills
> $commit            # 显式调用某个 Skill
> $skill-installer   # 安装 curated skills
codex plugin         # 安装/管理打包插件

      存放位置：~/.agents/skills/<name>/（个人）或 .agents/skills/<name>/（仓库）。编写规范见 Agent Skills。

      CLI 模型选择

      codex -m gpt-5.5 "..."                       # 启动时指定
codex -c model_reasoning_effort=xhigh "..."  # 调推理强度
# 会话内：/model 切换

      选型建议（强模型定方案、快模型批量执行）见 模型选择。--oss 可接本地 Ollama 模型用于离线/隐私场景。

      CLI 提示词技巧

      终端场景的额外技巧：

      • 把常用长指令固化成 Skill，用 $name 一键触发，避免重复粘贴
      • 一次性任务用 codex exec "..."，可与管道/重定向组合
      • 用 -i 附图做 UI 还原；用 @文件 给精确锚点
      • 复杂任务先 --sandbox read-only 让它规划，再切 workspace-write 执行
      • 通用结构（目标/约束/上下文/验证/汇报）见 提示词最佳实践

      CLI 实用示例

      只读规划：

      codex --sandbox read-only "分析 legacy/billing.js 的职责，给拆分方案，不改文件"

      修测试（非交互）：

      codex exec --sandbox workspace-write -a on-request \
  "运行 npm test 并仅修复失败用例，不要改 package.json"

      CI 生成发布说明：

      codex exec --sandbox read-only -a never --output-last-message \
  "根据 git log $(git describe --tags --abbrev=0)..HEAD 生成 Markdown changelog" \
  > RELEASE_NOTES.md

      指定子目录并加载其 AGENTS.md 链：

      codex --cd services/api "列出该服务的公开 API 路由"

      接力云端再拉回：

      codex cloud list          # 看云端任务
codex apply               # 应用云端 diff 到本地

      下一步