14-命令行Flags详解
14 命令行Flags详解
概述
Codex 提供了 30 多个命令行 Flags（标志参数），用于精细控制其行为。掌握这些 Flags 能让你在不同场景下灵活调用 Codex，充分发挥其能力。本文将这些 Flags 分为常用、调试、高级和配置覆盖四大类，逐一详解并给出使用示例。
常用 Flags
–model：指定 AI 模型
用于指定当前会话使用的模型：
# 使用 GPT-5.4-Codex 模型codex--modelgpt-5.4-codex# 使用轻量级 Mini 模型（适合快速查询）codex-q--modelgpt-5.3-codex-mini"解释这段代码"# 使用最强模型处理复杂任务codexexec--modelgpt-5.5"设计系统架构图"–sandbox：安全沙箱控制
控制是否在沙箱环境中执行命令（沙箱限制文件系统和网络访问）：
# 开启沙箱（默认开启）codex--sandboxtrue# 关闭沙箱（需要完全的文件访问权限时）codex--sandboxfalse# 在非交互模式下关闭沙箱codexexec--sandboxfalse--full-auto"安装系统包"–ask-for-approval / --full-auto：执行确认控制
这两个 Flag 控制 Codex 在执行操作前是否需要用户确认：
# 需要确认（默认行为）—— 适合有风险的操作codex --ask-for-approval# 完全自动执行 —— 适合信任的脚本化场景codex --full-auto"删除日志目录中7天前的文件"# 在 exec 子命令中组合使用codexexec--full-auto"运行数据库迁移脚本"安全建议：
- 生产环境操作始终使用
--ask-for-approval - 本地开发中已知安全的操作可以使用
--full-auto - CI/CD 环境中使用
--full-auto，但任务定义要尽可能精确
–cd：设置工作目录
指定 Codex 的工作目录，所有文件操作基于此路径：
# 设置工作目录codex--cd/var/www/myapp# 在非交互模式中使用codexexec--cd~/projects/backend"创建 RESTful API 路由"# 结合相对路径codex--cd../other-project"比较两个项目的 package.json"–add-dir：添加上下文目录
将多个目录添加到 Codex 的上下文中（而不仅仅限于工作目录）：
# 添加共享库目录作为上下文codex--cd/myapp --add-dir /shared/lib --add-dir /shared/components# 在代码重构时添加多个依赖目录codexexec--add-dir ./utils --add-dir ./models"重构 controllers 中的代码"–mcp：MCP 服务器配置
配置 MCP（Model Context Protocol）服务器来扩展 Codex 的能力：
# 启用 MCP 服务器codex--mcp--mcp-server"https://my-mcp-server.example.com"# 配置多个 MCP 服务器codex--mcp--mcp-server"server1"--mcp-server"server2"# MCP 使用本地