Agency — Painel Web para Claude Code com 32 Agents
Sweetteabittersugar/agency
Web UI para Claude Code com 32 agents, monitoramento de tokens e remoto via celular
Ver no GitHubPlataforma web para orquestração de múltiplos agents Claude com interface gráfica, monitoramento de custos em tempo real e 32 agentes pré-configurados. Substitui a linha de comando por um painel com suporte a injeção sob demanda, arquitetura plugável em camadas e zero necessidade de chaves para experimentação inicial.
Instalação
npx convez-ai Sweetteabittersugar/agency1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Orquestração de múltiplos agents para tarefas complexas
- Monitoramento de uso e custos de API em tempo real
- Execução remota de código Python/Node.js via navegador ou celular
Veredito

Agency é uma solução robusta para quem já trabalha com Claude Code e precisa gerenciar múltiplos agents em produção. A arquitetura plugável e o painel de custos em tempo real agregam valor, mas requer Python 3.10+ e familiaridade com CLI do Claude como pré-requisito.
README
A tradução para o português deste README ainda está na fila.
Agency
Claude Code 的 Web 操作面板 — 多 Agent 协作 · 实时监控 · 手机远程操控
这个仓库是什么
你下载的是 Agency — Claude Code 的 Web 操作面板
Agency 提供:
✅ 浏览器里的聊天界面(替代命令行)
✅ 32 个预配置 AI Agent(开箱即用)
✅ 费用追踪 / 多面板分屏 / 微信 Bot / 权限管理
✅ 一键安装脚本
Agency 不包含:
⚡ Node.js + Claude CLI — 安装脚本全自动装好
❌ API Key — DeepSeek / Anthropic / OpenAI 任选一家注册
❌ Python 3.10+ 运行环境
一句话:Agency 是给 Claude Code 套的 Web 壳。你得先有 Claude Code CLI 和 API Key,Agency 才能干活。
快速开始
# 1. 安装
git clone https://github.com/Sweetteabittersugar/agency.git && cd agency
pip install -e .
# 2. 启动
agency start
# → 浏览器自动打开 http://localhost:8800
# → 无 API Key 也能体验 Demo!
# 3. 配置(可选)
# 点右上角 🔧 → 填入 API Key → 开始干活
Windows 用户? 下载解压 → 双击
install.bat→ 双击start.bat。三步搞定。
功能亮点
| 🧠 | 📊 | 📱 |
|---|---|---|
| 多 Agent 协作 | 实时仪表盘 | 手机远程操控 |
| 32 个专业 Agent 按 12 大类自动匹配任务 | Token · 费用 · 权限全追踪 | 扫码即用,电脑关机也能查 |
| @agent名 显式指定 | 按日期/模型/Agent 三维分析 | 密码保护,Token 持久化 |
| 🔧 | 🎨 | 🔌 |
|---|---|---|
| Skill 工作流 | 多面板分屏 | 11 家模型供应商 |
| 34 个可复用技能模板 | 1/2/4 窗随心切换 | DeepSeek · GPT · Claude · Gemini |
| 一键编辑源码、启用/禁用 | 面板间独立会话互不干扰 | Kimi · 通义 · 智谱 · MiniMax… |
安装
你需要准备
| 必需 | 版本 | 说明 |
|---|---|---|
| Python | 3.10+ | python.org |
| Node.js | 自动安装 | 安装脚本自动处理(winget/brew/apt) |
| Claude Code CLI | 自动安装 | 安装脚本自动处理 |
| Git | 任意版本 | git-scm.com |
| 推荐 | 用途 |
|---|---|
| Docker | 沙箱隔离执行(更安全) |
| Node.js 18+ | JS 语法检查(开发者) |
| 你需要获取 | 注册地址 |
|---|---|
| API Key | DeepSeek · Anthropic · OpenAI |
git clone https://github.com/Sweetteabittersugar/agency.git
cd agency
pip install -e .
agency start
下载解压 → 双击 install.bat → 双击 start.bat
不需要 Web 界面?只把 Agent 定义装进 Claude Code:
cp agents/L1_executor/coder.md ~/.claude/agents/
# Claude Code 里输入 @coder 写个排序函数 就能用
需要 Claude CLI?
npm install -g @anthropic-ai/claude-code。没有 Claude Key?用 DeepSeek 也一样跑。
Docker 沙箱隔离(推荐)
安装 Docker 后,Agent 可在隔离容器中执行,避免影响主机环境:
docker pull claude-code-worker:latest # 可选
Docker 不可用时 Agency 自动以降级模式运行(直接子进程),不影响正常使用。
🔄 更新
pip 安装
pip install --upgrade agency-kit
Git 克隆安装
git pull origin main && pip install -e .
启动时自动检查
Agency 每次启动会自动检查新版本(每 24 小时检查一次,不会频繁骚扰)。
发现新版本时终端会提示升级命令。
如需关闭:设置环境变量 AGENCY_NO_UPDATE_CHECK=1
配置文件(
.env)在升级时不会丢失,放心更新。
更新不会覆盖你的自定义
| 目录 | 用途 | 更新时 |
|---|---|---|
.claude/agents/user/ | 你的自定义 Agent | 保留 |
.claude/skills/user/ | 你的自定义 Skill | 保留 |
.env | API Key 配置 | 保留 |
credentials/ | 登录凭证 | 保留 |
.claude/agents/L*/ | 系统 Agent | 覆盖 |
maestro/ webui/ | 系统代码 | 覆盖 |
修改系统 Agent 前,复制到
user/目录再改。
架构
┌─────────────────────────────────────────────────┐
│ Agency Web UI │
│ 聊天 · 仪表盘 · 设置 · Skill管理 │
└──────────────────────┬──────────────────────────┘
│ REST + SSE
┌──────────────────────▼──────────────────────────┐
│ Maestro 调度引擎 │
│ 路由(关键词+语义) → 分配Agent → 沙箱执行 → 结果 │
└──────────────────────┬──────────────────────────┘
│ claude -p / stdin
┌──────────────────────▼──────────────────────────┐
│ Claude Code + MCP │
│ Agent 定义 · Skill 工作流 · Hook 自动化 │
│ Playwright · Context7 · Brave Search … │
└─────────────────────────────────────────────────┘
项目结构
agency/
├── maestro/ 调度引擎(路由/聊天/编排/成本/安全)
├── webui/ 前端(模块化 JS + CSS 暗色主题 + HTML)
├── agents/ 32 个 Agent 定义(L3/L2/L1/L0 四层)
├── .claude/skills/ 34 个 Skill 工作流
├── rules/ 工程规范
├── hooks/ 生命周期自动化
├── commands/ 快捷命令
├── docs/ 文档
└── tests/ 测试
常见问题
不必须。Agency 支持 11 家模型供应商,推荐 DeepSeek(便宜、中文好、注册即送额度)。无 Key 也能进入 Demo 模式浏览全部功能。
绝对安全。 Key 仅存两份:浏览器 localStorage(你的电脑上)和项目 .env 文件(已 .gitignore)。永不离开你的设备,永不上传任何服务器。
Agency 是 Claude Code 的 Web 操作面板。Claude Code 是命令行 AI 编程工具,Agency 给它加了:Web 界面、多 Agent 智能路由、实时费用追踪、手机远程操控、多面板分屏协作。
Web 界面完全本地运行。但 Agent 执行需要调 AI 模型 API(DeepSeek/OpenAI 等),这部分需要联网。
贡献
欢迎 PR!详见 CONTRIBUTING.md。新功能建议请先开 Issue 讨论。
快速入门:GETTING-STARTED.md | 完整教程:USAGE.md
致谢
- Claude Code — Anthropic 的 AI 编程工具
- ECC — 207K Stars 的 Claude Code 配置增强标杆
License
MIT © 2026 Sweetteabittersugar