vibe-coding-cn/i18n/zh/skills/01-AI工具/headless-cli/references/codex-cli.md

Codex CLI 参数参考

来源: 官方文档

安装

npm install -g @openai/codex

认证

# 方式 1: 浏览器 OAuth (ChatGPT 账号)
codex login

# 方式 2: API Key
printenv OPENAI_API_KEY | codex login --with-api-key

# 检查登录状态
codex login status

核心命令

命令	说明	示例
codex	启动交互式 TUI	codex
codex "prompt"	带提示词启动	codex "explain this"
codex exec / codex e	非交互模式	codex exec "fix bugs"
codex resume	恢复会话	codex resume --last
codex apply / codex a	应用 Cloud 任务的 diff	codex apply TASK_ID
codex mcp	管理 MCP 服务器	codex mcp add server
codex completion	生成 shell 补全	codex completion zsh

全局参数

参数	说明	示例
--model, -m	指定模型	-m gpt-5-codex
--sandbox, -s	沙箱策略: read-only/workspace-write/danger-full-access	-s workspace-write
--ask-for-approval, -a	审批模式: untrusted/on-failure/on-request/never	-a on-failure
--full-auto	自动化预设 (workspace-write + on-failure)	--full-auto
--dangerously-bypass-approvals-and-sandbox / --yolo	跳过所有审批和沙箱	--yolo
--search	启用网页搜索	--search
--add-dir	添加额外写入目录	--add-dir ./other
--enable	启用功能标志	--enable web_search_request
--disable	禁用功能标志	--disable feature_name
--config, -c	配置覆盖	-c model_reasoning_effort="high"
--image, -i	附加图片	-i image.png
--cd, -C	设置工作目录	-C /path/to/project
--profile, -p	配置文件 profile	-p my-profile
--oss	使用本地开源模型 (Ollama)	--oss

codex exec 专用参数

参数	说明	示例
--json	输出 JSONL 格式	--json
--output-last-message, -o	保存最终消息到文件	-o result.txt
--output-schema	JSON Schema 验证输出	--output-schema schema.json
--color	颜色输出: always/never/auto	--color never
--skip-git-repo-check	允许在非 Git 目录运行	--skip-git-repo-check

可用模型

• gpt-5-codex - 标准模型
• gpt-5.1-codex - 增强版
• gpt-5.1-codex-max - 最强模型

推理强度配置

-c model_reasoning_effort="low"    # 快速
-c model_reasoning_effort="medium" # 平衡
-c model_reasoning_effort="high"   # 深度

无头模式用法

# 非交互执行
codex exec "fix all linting errors"

# 管道输入
echo "explain this error" | codex exec -

# YOLO 模式（跳过所有确认和沙箱）
codex --yolo "Your prompt"

# 或完整写法
codex --dangerously-bypass-approvals-and-sandbox "Your prompt"

# full-auto 模式（推荐的自动化方式）
codex --full-auto "Your prompt"

# 完整 YOLO 配置别名
alias c='codex --enable web_search_request -m gpt-5.1-codex-max -c model_reasoning_effort="high" --yolo'

# 恢复最近会话
codex resume --last
codex exec resume --last "continue"

配置文件

配置存储在 ~/.codex/config.toml：

model = "gpt-5-codex"
sandbox = "workspace-write"
ask_for_approval = "on-failure"

[features]
web_search_request = true

常见问题

1. 审批弹窗: 使用 --yolo 或 --full-auto
2. 需要联网: 使用 --search 或 --enable web_search_request
3. 推理不够深: 使用 -c model_reasoning_effort="high"
4. 非 Git 目录: 使用 --skip-git-repo-check