# eth-agents：基于 Claude Code 的以太坊多智能体开发平台

> 本文介绍 eth-agents，一个专为 Claude Code 设计的以太坊开发插件，通过 10 个专业 AI 智能体协同工作，实现智能合约开发、安全审计、测试、Gas 优化和多链部署的全流程自动化，开发者只需用自然语言描述需求即可完成复杂任务。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-02T16:15:08.000Z
- 最近活动: 2026-04-02T16:21:02.412Z
- 热度: 156.9
- 关键词: 以太坊, 智能合约, Claude Code, 多智能体, Solidity, 安全审计, RAG, Foundry, Hardhat, Gas 优化, 多链部署
- 页面链接: https://www.zingnex.cn/forum/thread/eth-agents-claude-code
- Canonical: https://www.zingnex.cn/forum/thread/eth-agents-claude-code
- Markdown 来源: ingested_event

---

# eth-agents：基于 Claude Code 的以太坊多智能体开发平台

在区块链开发领域，以太坊智能合约的编写、测试、审计和部署涉及众多工具和复杂的流程。对于开发者而言，在 Foundry、Hardhat、Slither、Mythril 等工具之间频繁切换，记忆各种命令行参数，往往耗费大量精力。eth-agents 项目创新性地将多智能体系统引入以太坊开发工作流，通过 Claude Code 插件形式，让开发者能够用自然语言描述需求，由 10 个专业 AI 智能体自动协同完成复杂任务。

## 项目背景与设计哲学

eth-agents 的核心设计理念是**零配置、自然语言接口、专业化分工**。传统开发工具链需要开发者手动配置环境变量、安装依赖、编写脚本，而 eth-agents 将这些复杂性全部封装在智能体协作层之下。开发者只需像与团队成员对话一样描述需求，系统会自动调度合适的智能体执行任务。

这种设计特别适合以下场景：

- 快速原型开发，需要快速验证合约逻辑
- 安全审计，需要系统性地检查多种漏洞类型
- 多链部署，需要在不同网络间迁移合约
- 团队协作，需要标准化的开发流程

## 架构概览：10 智能体协同网络

eth-agents 的架构采用分层设计，以 Orchestrator（编排器）为核心，协调 10 个专业智能体的工作：

### 编排层：Orchestrator

作为系统的中央协调器，Orchestrator 是每个技能的入口点和每个流水线的出口点。它负责：

- 决定任务的串行或并行执行策略
- 根据任务类型选择合适的模型（Haiku/Sonnet/Opus）
- 在关键节点调用 HUD 服务器更新状态
- 合成各智能体的输出结果
- 验证任务完成质量

Orchestrator 本身不直接编写代码，而是通过调用其他智能体来完成具体工作。

### 开发层智能体

**Contract Developer（合约开发者）**：负责编写 Solidity 和 Vyper 智能合约。该智能体在 TDD（测试驱动开发）循环中工作，优先使用经过审计的库实现（如 OpenZeppelin、Solmate），而非从零编写。

**Unit Test Engineer（单元测试工程师）**：专门编写 Forge 单元测试，追求高覆盖率。在 TDD 模式下，它会先编写失败的测试用例，然后由合约开发者实现代码使其通过。

**Integration Test Engineer（集成测试工程师）**：编写主网分叉测试，验证合约在真实链上状态中的行为。支持针对 Uniswap、Aave 等协议的集成测试。

### 安全层智能体

**Auditor（审计员）**：执行系统性安全审计，支持多种深度级别：

- **静态分析（--static）**：仅使用 Slither/Mythril 进行模式分析，速度快
- **动态测试（--dynamic）**：增加分叉测试和 Echidna 模糊测试
- **形式化验证（--formal）**：增加 Certora Prover / Halmos 形式化验证
- **完整审计（--full）**：三种方法依次执行，最全面

**Security Specialist（安全专家）**：当审计员发现 Critical 或 High 级别漏洞时激活，负责模拟攻击场景，验证漏洞可利用性，并提供修复建议。

### 运维层智能体

**Gas Optimizer（Gas 优化师）**：识别 Gas 浪费，逐类别应用优化，必须通过 `forge snapshot --diff` 显示正向差异后才算完成。输出详细的 Gas 报告，包含每个函数的优化前后对比。

**Deploy Engineer（部署工程师）**：生成部署脚本，执行 dry-run，向用户展示计划和预估 Gas 成本。主网部署始终需要用户显式确认。支持 Ethereum、Arbitrum、Optimism、Base、Polygon、Avalanche 等多条链的主网和测试网。

**dApp Developer（dApp 开发者）**：部署完成后自动更新前端代码，将新合约地址注入到前端配置中，确保前后端同步。

### 调试层智能体

**Debugger（调试器）**：在集成测试失败或违反不变量时激活，进行根因分析，输出详细的 trace 日志和修复建议。

## 九大技能：覆盖完整开发生命周期

eth-agents 将常见开发任务封装为九大技能（Skills），每个技能对应一个协调好的智能体流水线：

### 1. audit — 安全漏洞分析

这是最常用的技能之一。开发者只需说"审计这个合约"，系统就会自动执行：

```
orchestrator → auditor（根据深度标志选择分析级别）
         ↓ 如果是动态或完整审计
     → integration-test-engineer
         ↓ 如果发现 Critical/High 漏洞
     → security-specialist
         ↓
     → audit-report.md
```

输出报告按严重程度排序（Critical → High → Medium → Low → Info），每个发现都包含描述、影响和修复建议。

### 2. tdd — 测试驱动开发

严格执行 TDD 循环：先写失败的测试，再实现代码使其通过。最大迭代 5 轮，输出测试文件、实现合约和覆盖率报告。

### 3. build-contract — 完整合约构建

端到端流水线：需求 → TDD → 静态审计 → Gas 优化。输出生产就绪的合约，包含完整的测试套件和审计摘要。

### 4. deploy — 多链部署

生成部署脚本，执行 dry-run，展示计划和预估成本。主网部署需要用户输入"confirm"确认。自动完成 Etherscan 验证，并更新前端地址。

### 5. gas-optimize — Gas 成本优化

识别 Gas 浪费模式，应用优化，必须通过 snapshot diff 验证改进。输出优化前后的对比报告。

### 6. fork-test — 主网分叉测试

在固定的区块高度对真实链状态执行测试，失败时自动调用 Debugger 进行根因分析。适合测试与现有协议的集成。

### 7. full-protocol — 端到端协议构建

最全面的技能，运行完整的混合流水线：

- **阶段 1（串行）**：合约开发 + TDD 循环
- **阶段 2（并行）**：审计、集成测试、Gas 优化同时进行
- **阶段 3（条件）**：如有需要，激活安全专家和调试器
- **阶段 4（并行）**：部署工程师和 dApp 开发者同时工作
- **阶段 5（串行）**：编排器合成所有输出，生成 protocol-report.md

### 8. learn — 保存可复用模式

从当前会话中提取工作流模式，保存为用户技能，在未来会话中自动激活。实现知识的持续积累。

### 9. help — 显示所有技能

返回格式化的技能指南，不激活任何智能体。

## 安装与使用

安装非常简单，支持两种方式：

**直接从 GitHub 安装**：
```bash
claude plugin install github:cayocan/eth-agents
```

**通过社区仓库安装**（批准后）：
```bash
claude plugin marketplace add anthropics/claude-plugins-community
claude plugin install eth-agents@claude-community
```

无需配置文件，无需环境变量，无需指定工具链。唯一要求是 Claude Code 和 Node.js 18+。

## 自然语言交互示例

eth-agents 的核心优势在于自然语言接口：

```
# 安全审计
"审计这个合约"
"做完整的安全审计，包含形式化验证"
"检查重入和闪电贷漏洞"

# 合约开发
"构建一个 ERC4626 质押合约"
"先为 Vault 合约写测试"
"实现一个带归属期的 ERC20 代币"

# 测试
"对主网运行分叉测试"
"在分叉上测试与 Uniswap V3 的交互"

# 优化
"优化 Vault 合约的 Gas"
"降低部署成本"

# 部署
"部署到 Arbitrum Sepolia"
"将 Token 部署到 Base 主网并更新前端"

# 完整流程
"从头构建完整的 DeFi 协议"
```

## 状态可视化：MCP HUD 服务器

eth-agents 集成了 MCP（Model Context Protocol）HUD 服务器，在开发过程中实时显示：

- 当前激活的技能
- 执行阶段和进度
- Token 使用量
- 智能体状态

这让开发者能够清晰地了解系统正在做什么，以及当前的执行进度。

## 安全设计：主网部署保护

对于涉及资金风险的操作，eth-agents 设计了多层保护：

1. **Dry-run 预览**：所有部署操作先执行模拟运行，展示计划和预估成本
2. **显式确认**：主网部署必须用户输入"confirm"才会继续
3. **审计前置**：build-contract 和 full-protocol 技能会自动执行静态审计
4. **漏洞升级**：Critical/High 级别漏洞会自动触发安全专家进行深度分析

## 技术栈与兼容性

eth-agents 与主流以太坊工具链完全兼容：

- **开发框架**：Foundry、Hardhat
- **合约语言**：Solidity 0.8.x、Vyper
- **审计工具**：Slither、Mythril、Echidna、Certora Prover、Halmos
- **支持网络**：Ethereum、Arbitrum、Optimism、Base、Polygon、Avalanche 及各自的测试网

这种兼容性确保了开发者可以在现有项目基础上无缝集成 eth-agents，无需重构代码。

## 应用场景与价值

eth-agents 特别适合以下场景：

- **快速原型**：用自然语言快速验证想法，自动生成可运行的合约
- **安全优先**：系统性的审计流程，覆盖静态、动态和形式化验证
- **多链策略**：一键部署到多个网络，自动管理地址映射
- **团队标准化**：通过 learn 技能沉淀团队最佳实践，确保一致性
- **学习成长**：新手开发者可以通过观察智能体协作学习专业开发流程

通过将 10 个专业智能体编排成高效的协作网络，eth-agents 将复杂的以太坊开发工作流简化为自然语言对话，显著降低了智能合约开发的门槛，同时保持了专业级的质量和安全性。