using-claude-code-cli-agent-skill

从脚本和编排器中自动化调用 Claude CLI 的工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:using-claude-code-cli-agent-skill。
它的用途是:从脚本和编排器中自动化调用 Claude CLI 的工具
完整的 Skill 内容见:https://321skill.com/skills/using-claude-code-cli-agent-skill/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请使用 using-claude-code-cli 技能,编写一个 Python 脚本,以沙箱模式调用 Claude CLI,并只允许使用 Read 和 Write 工具来处理指定目录下的文件。' 它会生成一个包含 subprocess 调用、正确参数和错误处理的示例脚本,帮助你快速集成自动化能力。

介绍

这个 Skill 解决了开发者需要将 Claude Code CLI 集成到自动化流程、Python 编排器或 Shell 脚本中的问题。它提供了标准化的方法来以编程方式启动、配置和控制 Claude CLI 实例,实现无头(headless)运行和批量处理。

使用方式主要是通过 Python 的 subprocess 模块或 Shell 脚本,结合特定的 CLI 参数(如 —allowedTools, —add-dir, —settings)来调用 Claude 命令。开发者可以配置工具权限、目录访问、沙箱模式以及钩子(hooks),从而实现复杂的自动化任务链。

它非常适合需要批量处理代码任务、构建自动化开发流水线、或者将 AI 能力作为子流程嵌入到现有工具的开发者、DevOps 工程师和自动化脚本编写者。

与同类 CLI 自动化工具相比,它的核心优势在于深度集成了 Claude CLI 特有的配置项(如沙箱模式、工具白名单、钩子系统),并提供了从简单调用到并行代理等不同复杂度的成熟模式参考,而非简单的命令封装。

核心特点

深度聚焦于 Claude CLI 的自动化与编排场景,提供了从权限配置(--allowedTools)、目录访问(--add-dir)到沙箱模式和钩子(hooks)的完整解决方案,而非通用的命令行交互工具。

注意事项

不适合需要复杂交互式对话或图形界面的场景,主要用于后台自动化任务。

常见问题

如何用 Python 脚本调用 Claude CLI?

使用 subprocess 模块,传入 -p 参数和所需的 --allowedTools 等配置。

如何让 Claude CLI 以无头模式运行?

使用 -p 参数提供提示词,并配合 --output-format 等参数实现非交互式运行。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/using-claude-code-cli-agent-skill/raw/index.md 读取 using-claude-code-cli-agent-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。