用途
Claude Code Skill 用于通过 MCP(模型上下文协议)控制 Claude Code。它面向 openclaw 智能体,让智能体能够以编程方式调用 Claude Code 的能力,包括持久会话、智能体团队和高级工具控制。
主要能力
基本 MCP 操作
- connect / status / tools:连接、查看状态与工具列表
- bash:执行 shell 命令
- read:读取文件内容
- glob:按模式查找文件
- grep:搜索文件内容
- call:直接调用指定工具(示例中为 Write)
- disconnect:断开连接
持久会话(Agent Loop)
- session-start:启动会话,支持 -d 指定项目目录、--permission-mode、--allowed-tools、--max-budget、--model、--base-url、--append-system-prompt、--add-dir、--agents、--agent、--system-prompt、--tools、--disallowed-tools、--resume、--fork-session、--session-id 等参数
- session-send:发送消息,支持 --stream 实时反馈与 -t 自定义超时
- session-status / session-list / session-history:查看状态、列出会话、查看历史
- session-pause / session-resume-paused:暂停与恢复
- session-fork:分叉会话
- session-stop / session-restart:停止与重启会话
权限模式
包含 acceptEdits(自动接受文件编辑,默认)、plan(应用前预览更改)、default(每次操作询问)、bypassPermissions(跳过所有提示,危险)、delegate(将决策委托给父级)、dontAsk(从不询问,默认拒绝)。
会话历史与搜索
- sessions:浏览 Claude Code 会话
- session-search:按项目、时间(如 2h、日期)或查询词搜索
- resume:恢复历史会话
批量操作
- batch-read:一次读取多个文件
智能体团队
- 可在启动会话时定义多个智能体(如 architect、developer、reviewer),并通过 @agent 名称在对话中切换
- 提供代码审查团队(security、performance、quality)与全栈团队(frontend、backend、database)等模板示例
高级功能
- 工具控制:--allowed-tools、--disallowed-tools、--tools(含模式匹配,如 Bash(git:,npm:)),可禁用全部工具
- 系统提示词:--system-prompt 完全替换、--append-system-prompt 追加
- 会话管理:--resume 配合 --fork-session、--session-id 自定义 UUID、--add-dir 添加工作目录
- 多模型支持(代理):通过 --base-url 将请求路由至代理,使 Gemini、GPT 等模型驱动 Claude Code;需在 8082 端口运行 claude-code-proxy 并配置 API 密钥
可用工具(经 MCP)
Bash、Read、Write、Edit、Glob、Grep、Task、WebFetch、WebSearch、Git*、AskUserQuestion 等(文档称共 10+ 个)。
使用方式
快速开始示例:
- claude-code-skill session-start myproject -d ~/project --permission-mode plan --allowed-tools "Bash,Read,Edit,Write,Glob,Grep" --max-budget 2.00
- claude-code-skill session-send myproject "Find all TODO comments and create GitHub issues" --stream
- claude-code-skill session-status myproject
与 OpenClaw 集成:
- openclaw skills run claude-code-skill -- session-start task -d ~/project
- openclaw skills run claude-code-skill -- session-send task "Implement feature X" --stream
- openclaw skills run claude-code-skill -- session-status task
架构:openclaw agent → claude-code-skill CLI → HTTP(sasha-doctor API :18795)→ MCP(claude mcp serve)→ 文件与工具。
适用场景
建议使用持久会话的情形:需要多次工具调用的多步骤任务、迭代式开发(写代码→测试→修复→重复)、需要完整上下文的长时间对话、智能体需自主工作、需要流式实时反馈。
建议使用直接 MCP 工具的情形:单条命令执行、快速文件读写、一次性搜索、操作之间无需上下文。
文档给出的示例场景包括:代码审查、自动化测试、多智能体调试。
最佳实践与限制
- 对多步骤任务使用持久会话,避免多次断开/重连
- 对长时间任务使用 --stream
- 设置预算上限(如 --max-budget 2.00)
- 对关键更改使用 plan 模式预览
- 实验前先分叉会话
- 错误恢复:session-status、session-history、session-restart,或停止后以 --resume 旧会话 ID 重启
- bypassPermissions 会跳过所有提示,文档标注为危险
- 多模型支持需自行运行 claude-code-proxy 并配置 API 密钥
暂未提供的信息
关于收费、价格与平台支持的官方说明,资料中暂未提供。