claude-workflow-studio

中文 · English

一个基于 Web 的可视化平台，用于编排、监控和管理多个 Claude Code Agent 协作完成复杂任务。

⚠️ 开发状态：实验性预览版 — 本项目由知识面较浅薄的大一学生自行开发，功能可能有很多不完善之处，存在未发现的 Bug。未经充分生产环境测试，请不要用于重要文件的修改上。 欢迎 Fork 自行修改。维护时间有限，Issue 和 PR 处理可能不及时。

快速开始

环境要求：Node.js 18+ 和 Claude Code CLI

安装：解压 ZIP → 双击 install.bat → 双击 start.bat → 访问 http://localhost:3000

npm install    # 或双击 install.bat
npm start      # 或双击 start.bat

快速上手

单 Agent 任务：智能体 → 创建智能体 → 任务 → 创建任务 → 选择 Agent → 输入需求 → 执行

多 Agent 流水线：

1. 工作流 → 创建工作流 → 拖入 Agent 节点 → 连线 → 保存
2. 任务 → 创建任务 → 选择关联工作流 → 输入任务描述 → 执行

文件管理：文件 → 浏览/新建/编辑工作区内的文件

核心功能

工作流节点

技术栈

MCP 与 Skills

本平台的子 Agent 直接继承 Claude CLI 的配置，无需额外设置。

• MCP 服务器：在 Claude CLI 中配置后，子 Agent 自动可用
• Skills：在 Claude CLI 中安装后，子 Agent 自动加载

常见问题

Q: Agent 执行失败？ → 检查 CLI 是否安装（claude --version），CLI 不可用时自动回退 SDK 模式

Q: 工作流中断了？ → 重启服务，点击「续传」从断点恢复

Q: 数据会丢吗？ → 每 2 秒自动保存，正常关闭不会丢数据

Q: 能管理多个项目吗？ → 可以，通过「文件」→「切换工作区」创建独立环境

常用命令

npm start              # 启动服务器
npm run dev            # 开发模式（自动重启）
npm test               # 运行测试

批处理脚本（Windows）

深度技术文档（执行引擎、记忆系统、安全机制、API 概览等）请参考 docs/architecture.md。 English version: docs/architecture_EN.md

许可证

MIT License