convez.ai
AgenteAutomaçãoIntermediário
Sweetteabittersugar

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 GitHub
BomPluginScore · de 0 a 100

Plataforma 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/agency

1 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

Estrelas
3
Forks
1
Acompanhando
0
Saúde
100%
Último commit
há 2 meses
Versão
v0.5.0
Issues abertas
2
Contribuidores
1

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 协作 · 实时监控 · 手机远程操控

License: MIT Version Python Agents Skills PRs Welcome

这个仓库是什么

你下载的是 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…

安装

你需要准备

必需版本说明
Python3.10+python.org
Node.js自动安装安装脚本自动处理(winget/brew/apt)
Claude Code CLI自动安装安装脚本自动处理
Git任意版本git-scm.com
推荐用途
Docker沙箱隔离执行(更安全)
Node.js 18+JS 语法检查(开发者)
你需要获取注册地址
API KeyDeepSeek · 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保留
.envAPI 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

Ver o original no GitHub

Bom para

Relacionados