Headless CLI 技能

无交互批量调用 AI CLI 工具，支持 stdin/stdout 管道，实现自动化工作流。

When to Use This Skill

触发条件：

• 需要批量处理文件（翻译、审查、格式化）

• 需要在脚本中调用 AI 模型

• 需要多模型串联/并联处理

• 需要无人值守的 AI 任务执行

Not For / Boundaries

不适用于：

• 需要交互式对话的场景

• 需要实时反馈的任务

• 敏感操作（YOLO 模式需谨慎）

必需输入：

• 已安装对应 CLI 工具

• 已完成身份认证

• 网络代理配置（如需）

Quick Reference

🔴 YOLO 模式（全权限，跳过确认）

Codex CLI

--yolo 是 --dangerously-bypass-approvals-and-sandbox 的别名

alias c='codex --enable web_search_request -m gpt-5.3-codex-max -c model_reasoning_effort="high" --yolo'

Claude Code

alias cc='claude --dangerously-skip-permissions'

Gemini CLI

--yolo 或 --approval-mode yolo

alias g='gemini --yolo'

🟡 Full-Auto 模式（推荐的自动化方式）

Codex CLI

workspace-write 沙箱 + 失败时才审批

codex --full-auto "Your prompt"

Gemini CLI

自动批准编辑工具

gemini --approval-mode auto_edit "Your prompt"

🟢 安全模式（无头但有限制）

Gemini CLI（禁用工具调用）

cat input.md | gemini -p "prompt" --output-format text --allowed-tools '' > output.md

Claude Code（Print 模式）

cat input.md | claude -p "prompt" --output-format text > output.md

Codex CLI（非交互执行）

codex exec "prompt" --json -o result.txt

📋 常用命令模板

批量翻译

设置代理（如需）

export http_proxy=http://127.0.0.1:9910 export https_proxy=http://127.0.0.1:9910

Gemini 翻译

cat zh.md | gemini -p "Translate to English. Keep code/links unchanged."
--output-format text --allowed-tools '' > en.md

代码审查

cat code.py | claude --dangerously-skip-permissions -p
"Review this code for bugs and security issues. Output markdown." > review.md

多模型编排

模型 A 生成 → 模型 B 审查

cat spec.md | gemini -p "Generate code" --output-format text |
claude -p "Review and improve this code" --output-format text > result.md

⚙️ 关键参数对照表

功能 Gemini CLI Claude Code Codex CLI

YOLO 模式 --yolo

--dangerously-skip-permissions

--yolo

指定模型 -m <model>

--model <model>

-m <model>

非交互 -p "prompt"

-p "prompt"

exec "prompt"

输出格式 --output-format text

--output-format text

--json

禁用工具 --allowed-tools ''

--disallowedTools

N/A

继续对话 N/A -c / --continue

resume --last

Examples

Example 1: 批量翻译文档

输入: 中文 Markdown 文件 步骤:

export http_proxy=http://127.0.0.1:9910 export https_proxy=http://127.0.0.1:9910

for f in docs/*.md; do cat "$f" | timeout 120 gemini -p
"Translate to English. Keep code fences unchanged."
--output-format text --allowed-tools '' 2>/dev/null > "en_$(basename $f)" done

预期输出: 翻译后的英文文件

Example 2: 代码审查流水线

输入: Python 代码文件 步骤:

cat src/*.py | claude --dangerously-skip-permissions -p
"Review for: 1) Bugs 2) Security 3) Performance. Output markdown table." > review.md

预期输出: Markdown 格式的审查报告

Example 3: 多模型对比验证

输入: 技术问题 步骤:

question="How to implement rate limiting in Python?"

echo "$question" | gemini -p "$question" --output-format text > gemini_answer.md echo "$question" | claude -p "$question" --output-format text > claude_answer.md

对比两个答案

diff gemini_answer.md claude_answer.md

预期输出: 两个模型答案的对比

References

• references/gemini-cli.md

• Gemini CLI 完整参数

• references/claude-cli.md

• Claude Code CLI 参数

• references/codex-cli.md

• Codex CLI 参数

• Gemini CLI 官方文档

• Claude Code 官方文档

• Codex CLI 官方文档

Maintenance

• 来源: 各 CLI 官方文档

• 更新: 2025-12-19

• 限制: 需要网络连接和有效认证；YOLO 模式有安全风险