run-codex

• ✅ MCP 服务架构：从 Bash 脚本迁移到 MCP 服务，提供类型安全的 JSON-RPC 接口
• ✅ Slash Commands：新增 /claude、/gemini、/codex 命令
• ✅ 完美的参数传递：支持任意长度、多段、包含特殊字符的文本，无需担心 shell 转义
• ✅ 简化的调用链路：直接调用 MCP 工具，减少中间层
• ✅ 向后兼容：保留原有脚本作为参考

---

• 独立进程运行：在子进程中运行 AI CLI 工具，完全隔离环境
• MCP 服务：通过 Model Context Protocol 提供稳定可靠的工具接口
• Slash Commands：快捷的命令行界面，简单易用
• 环境变量管理：自动传递和管理 API Key、代理等环境变量
• 并行执行：支持同时运行多个独立任务
• 结果捕获：自动捕获和解析执行结果（JSON 格式）
• 灵活配置：支持自定义工作目录、权限模式、工具限制等
• 工具调用监控：通过 PreToolUse 和 PostToolUse hooks 实时监控工具调用
• 任务完成提醒：支持配置任务完成后的系统通知（延迟时间可自定义）
• Context7 集成：自动获取最新的第三方库文档
• Unix Socket 通信：与 CCCore 的通信采用高效的 Unix Socket 方式
• 中文标点规范：内置中文标点符号使用规范 Skill，确保中文输出的专业性

---

| 工具 | MCP 服务 | Slash Command | Skill | 特性 |

|------|---------|--------------|-------|------|

| Claude Code | claude | /claude | run-claude | 所有无头模式功能、会话恢复 |

| Gemini CLI | gemini | /gemini | run-gemini | 扩展系统、多目录支持 |

| Codex CLI | codex | /codex | run-codex | 沙箱模式、结构化输出、o3 模型 |

| iFlow | iflow | /iflow | run-iflow | 中华文化理解、中文古文理解、测试用例生成 |

| 类型 | 名称 | 说明 | 特性 |

|------|------|------|------|

| Slash Command | /commit [目标目录] | 生成符合约定式提交规范的提交信息 | 自动分析所有文件改动，以功能为单位生成提交信息 |

| Slash Command | /search <搜索目的> | 网络搜索 | 调用 search-specialist Agent |

| Slash Command | /translate <翻译内容> | 翻译文本/文件/网页 | 调用 translator Agent，支持任意语言互译 |

| Skill | commit | 生成提交信息 | 约定式提交规范、功能维度分析 |

| Skill | chinese-output | 中文标点规范 | 全角标点使用、中英文混排规则 |

| Agent | 说明 | 特性 |

|-------|------|------|

| prompt-engineer | 提示词工程专家 | 高级提示词编写技巧、思维链、宪法式 AI |

| search-specialist | 网络研究专员 | 高级搜索技术、结果筛选、多源验证 |

| translator | 专业翻译官 | 优雅流畅的翻译、支持任意语言互译 |

---

方式 1：通过 Marketplace

```bash

# 添加 marketplace

/plugin marketplace add /path/to/SkillMarketplace

# 安装插件

/plugin install headless-knight@local-marketplace

```

方式 2：手动安装

```bash

# 克隆到插件目录

cd ~/.claude/plugins

git clone https://github.com/lostabaddon/HeadlessKnight.git headless-knight

# 重启 Claude Code

```

---

方式 1：使用 Slash Commands（最简单）

```

/claude 分析 src/auth.js 的安全问题

/gemini 为 src/utils.js 生成单元测试

/codex 使用 o3 模型重构代码

/iflow 为这个项目生成详细的测试用例

/commit 生成提交信息

/search Claude Code 最新文档

/translate README.md 翻译成英文

```

方式 2：通过 Skill

```

用 Claude Code 分析这个文件的安全性，重点关注：

1. SQL 注入风险
2. XSS 攻击防护
3. 权限验证漏洞

```

插件会自动：

1. 调用对应的 MCP 工具
2. 在独立进程中运行 AI CLI
3. 返回结构化结果

方式 3：直接调用 MCP 工具

```javascript

// 使用 MCP 工具

mcp__plugin_headless-knight_cli-runner__claude

// 参数（JSON 格式，完美支持长文本）

{

"prompt": "这是一个很长很长的任务描述\n\n可以分多段\n\n包含特殊字符 \"引号\" $变量 命令\n\n完全不用担心转义问题",

"workDir": ".",

"model": "sonnet"

}

```

---

环境变量

| 变量名 | 说明 | 是否必需 |

|--------|------|---------|

| ANTHROPIC_API_KEY | Claude API 密钥 | ✅ （使用 Claude Code） |

| GEMINI_API_KEY | Gemini API 密钥 | ✅ （使用 Gemini CLI） |

| OPENAI_API_KEY | OpenAI API 密钥 | ✅ （使用 Codex CLI） |

| CLAUDE_CODE_COMMAND | Claude Code 启动命令 | ❌ （默认 claude） |

| GEMINI_CLI_COMMAND | Gemini CLI 启动命令 | ❌ （默认 gemini） |

| OPENAI_CODEX_COMMAND | Codex CLI 启动命令 | ❌ （默认 codex） |

| IFLOW_COMMAND | iFlow 启动命令 | ❌ （默认 iflow） |

| HTTP_PROXY | HTTP 代理 | ❌ |

| HTTPS_PROXY | HTTPS 代理 | ❌ |

| ALL_PROXY | HTTPS 代理 | ❌ |

| CCCORE_HOST | CCCore 服务主机 | ❌ (默认 localhost) |

| CCCORE_HTTP_PORT | CCCore HTTP 端口 | ❌ (默认 3579) |

| CCCORE_SOCKET_PATH | CCCore Unix Socket 路径 | ❌ （默认 /tmp/cccore.sock） |

---

claude

工具：mcp__plugin_headless-knight_cli-runner__claude

参数：

• prompt （必需）：任务描述
• systemPrompt：系统提示
• workDir：工作目录
• model：模型名称（sonnet / haiku / opus）
• env：自定义环境变量（键值对对象）

gemini

工具：mcp__plugin_headless-knight_cli-runner__gemini

参数：

• prompt （必需）：任务描述
• systemPrompt：系统提示
• workDir：工作目录
• model：模型名