Claude Code Agent

🤖 Claude Code 的远程指挥官

通过 MCP 协议远程操控 Claude Code,支持持久化会话、多 Agent 协作与精细化工具控制,实现复杂开发任务的自动化编排。

收藏
11.8k
安装
3.7k
版本
0.3.0
CLS 安全性认证2026-05-10
点击查看完整报告 >

使用说明

核心用法

Claude Code Skill 是一个基于 MCP(Model Context Protocol)协议的命令行工具,允许外部 Agent 以编程方式控制 Claude Code 的全部能力。它提供两种主要使用模式:

1. 直接 MCP 工具调用 —— 适用于单次操作,如执行 Bash 命令、读写文件、代码搜索等,无需维护会话状态。

2. 持久化会话(Agent Loop) —— 适用于多步骤任务,通过 session-start 创建长期运行的 Claude 实例,Agent 可通过 session-send 发送复杂指令,Claude 自主决策并调用工具链完成迭代开发。支持实时流式输出(--stream)、会话分叉(session-fork)、历史回溯与恢复。

3. 多 Agent 团队协作 —— 可在单一会话中定义多个角色(如架构师、开发者、审查员),通过 @agent 指令动态切换身份,实现流水线式协作。

显著优点

  • 完整工具链访问:覆盖 Claude Code 全部 15+ 工具,包括 Bash、Read/Write/Edit、Glob/Grep、Git、WebSearch、Task 子代理等
  • 企业级管控:支持工具白名单/黑名单(如限制 Bash(rm:*,sudo:*))、权限模式分级(plan/acceptEdits/bypassPermissions)、预算硬上限(--max-budget
  • 模型中立性:通过 --base-url 支持代理至 Gemini、GPT 等其他模型,解除供应商锁定
  • 会话可观测:完整的历史记录、状态查询、搜索与恢复机制,便于审计与故障排查
  • OpenClaw 原生集成:专为多 Agent 框架设计,支持从 openclaw 内部直接调用

潜在局限

  • 基础设施依赖:需预装 Node.js,且依赖 sasha-doctor 后端服务(默认端口 18795)及 Claude Code 本地实例,部署链路较长
  • 网络与成本风险:持久会话可能产生持续 API 调用费用,流式输出在弱网环境下稳定性待验证
  • 权限边界复杂bypassPermissions 等危险模式缺乏强制二次确认,误配置可能导致数据丢失
  • 生态封闭性:当前主要面向 OpenClaw 生态,与其他 Agent 框架(如 AutoGPT、CrewAI)的互操作性未明确

适合人群

  • 构建自动化 DevOps 流水线的平台工程师
  • 需要多 Agent 协作处理大型代码库的软件架构团队
  • 追求 Claude Code 编程化控制的高级用户与 AI Agent 开发者

常规风险

| 风险类别 | 说明 |
|---------|------|
| 执行安全 | Bash 工具可执行任意命令,需严格配置 `--disallowed-tools` 或 `--allowed-tools` 模式 |
| 财务风险 | 未设预算上限的持久会话可能因无限循环或复杂任务产生高额 API 费用 |
| 数据隐私 | 代码与文件内容通过本地 MCP 传输,但若使用 `--base-url` 代理至第三方服务需评估数据合规性 |
| 会话状态丢失 | sasha-doctor 服务崩溃或网络中断可能导致进行中的会话异常终止 |
| 权限提升 | `sudo` 或文件系统根目录写入若未显式禁止,可能被恶意提示词利用 |

安全解读

核心用法

Claude Code Skill 是一个基于 MCP(Model Context Protocol)协议的命令行工具,允许用户以编程方式控制 Claude Code。它提供两种主要工作模式:

1. 直接MCP工具调用:适合单次操作,如执行命令、读写文件、搜索代码等,无需保持会话状态。

2. 持久化会话(Agent Loop):适合多步骤复杂任务,会话保持上下文连续性,支持流式输出实时监控。会话支持权限模式配置(plan/acceptEdits/bypassPermissions等)、工具白名单/黑名单、预算限制等安全控制。

核心命令包括 session-start 创建会话、session-send 发送任务、session-status 查看状态,以及多Agent团队管理功能。

显著优点

  • 灵活的权限控制:支持从完全手动确认到自动接受编辑的多种权限模式,可精确控制允许使用的工具集
  • Agent团队协作:可定义多个专业角色(如架构师、开发者、审查者)并在对话中动态切换,实现复杂任务的协作处理
  • 预算与安全限制:内置 --max-budget 成本控制和工具白名单机制,防止意外高额消费或危险操作
  • 会话管理完善:支持会话暂停/恢复、Fork分支实验、历史搜索与恢复,便于长周期项目管理
  • 多模型兼容:通过 --base-url 代理支持Gemini、GPT等其他模型接入Claude Code工具生态

潜在缺点与局限性

  • 依赖本地后端服务:需要运行 sasha-doctor 服务(默认端口18795),部署复杂度高于纯本地工具
  • 网络通信无强制加密:默认使用HTTP而非HTTPS,自定义端点时需用户自行确保通信安全
  • 个人维护项目:来源为GitHub个人开发者(enderfga),长期维护稳定性相比企业/基金会项目存在不确定性
  • 学习曲线较陡:MCP协议、权限模式、Agent配置等概念需要一定学习时间,文档虽有示例但缺乏详细概念解释

适合人群

  • OpenClaw Agent开发者:需要在Agent工作流中集成Claude Code能力的开发者
  • 自动化CI/CD工程师:需要将Claude Code能力集成到自动化流程中的团队
  • 多Agent系统研究者:探索LLM Agent协作与角色分工的研究者和实践者
  • 高级Claude用户:对Claude Code有深度使用需求,需要程序化控制与批量操作能力的用户

常规风险

  • 服务端信任风险--base-url 允许指向任意端点,若连接不可信服务可能导致指令或数据泄露
  • 权限配置风险bypassPermissions 模式或过度宽松的工具白名单可能导致意外文件修改或命令执行
  • 成本失控风险:未设置预算限制时,复杂Agent任务的API调用可能产生意外费用
  • 会话状态依赖:持久化会话的故障可能导致工作中断,虽支持恢复但存在状态丢失风险

Claude Code Agent 内容

examples文件夹
src文件夹
mcp文件夹
store文件夹
手动下载zip · 24.2 kB
basic-mcp.tstext/plain
请选择文件