docs: update headless-cli references with official documentation

- gemini-cli.md: added --approval-mode, settings.json config
- claude-cli.md: added slash commands, CLAUDE.md, permissions config
- codex-cli.md: added exec command, config.toml, full-auto mode
- SKILL.md: added full-auto mode, parameter comparison table

Sources:
- https://geminicli.com/docs/get-started/configuration/
- https://docs.anthropic.com/en/docs/claude-code/
- https://developers.openai.com/codex/cli/reference
This commit is contained in:
tukuaiai
2025-12-19 16:10:37 +08:00
parent 3fa7b6bfed
commit 8595bdc12f
4 changed files with 243 additions and 81 deletions
@@ -1,30 +1,72 @@
# Codex CLI 参数参考
> 来源: [官方文档](https://developers.openai.com/codex/cli/reference)
## 安装
```bash
npm install -g @openai/codex-cli
npm install -g @openai/codex
```
## 认证
需要 OpenAI API Key 或 ChatGPT Plus 订阅。
```bash
# 方式 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` |
## 全局参数
| 参数 | 说明 | 示例 |
|:---|:---|:---|
| `-m, --model` | 指定模型 | `-m gpt-5.1-codex-max` |
| `--enable` | 启用功能 | `--enable web_search_request` |
| `-c` | 配置选项 | `-c model_reasoning_effort="high"` |
| `--dangerously-bypass-approvals-and-sandbox` | 跳过审批和沙箱 | 见下方 |
| `--yolo` | YOLO 模式 | `--yolo` |
| `--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.1-codex` - 标准模型
- `gpt-5-codex` - 标准模型
- `gpt-5.1-codex` - 增强版
- `gpt-5.1-codex-max` - 最强模型
- `gpt-5.1-codex-xhigh` - 超高性能
## 推理强度配置
@@ -37,25 +79,45 @@ npm install -g @openai/codex-cli
## 无头模式用法
```bash
# 基础调用
codex -m gpt-5.1-codex "Your prompt"
# 非交互执行
codex exec "fix all linting errors"
# YOLO 模式(跳过所有确认)
# 管道输入
echo "explain this error" | codex exec -
# YOLO 模式(跳过所有确认和沙箱)
codex --yolo "Your prompt"
# 完整 YOLO 配置
codex --enable web_search_request \
-m gpt-5.1-codex-max \
-c model_reasoning_effort="high" \
--dangerously-bypass-approvals-and-sandbox \
"Your prompt"
# 完整写法
codex --dangerously-bypass-approvals-and-sandbox "Your prompt"
# 别名设置
alias c='codex --enable web_search_request -m gpt-5.1-codex-max -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox'
# 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`
```toml
model = "gpt-5-codex"
sandbox = "workspace-write"
ask_for_approval = "on-failure"
[features]
web_search_request = true
```
## 常见问题
1. **审批弹窗**: 使用 `--dangerously-bypass-approvals-and-sandbox`
2. **需要联网**: 使用 `--enable web_search_request`
1. **审批弹窗**: 使用 `--yolo``--full-auto`
2. **需要联网**: 使用 `--search``--enable web_search_request`
3. **推理不够深**: 使用 `-c model_reasoning_effort="high"`
4. **非 Git 目录**: 使用 `--skip-git-repo-check`