什么是 Auto Claude？

Auto Claude 是一个革命性的自主多代理编码框架，它利用 Claude AI 的强大能力，让开发过程完全自动化。你只需描述你想要构建的功能，Auto Claude 就会接管整个开发流程——从规划、实现到质量验证，全程无需人工干预。

项目采用 Electron 构建跨平台桌面应用，后端基于 Python 实现代理逻辑和 QA 管道，前端使用 React + TypeScript 提供现代化的用户界面。通过 Claude Agent SDK 与 Claude AI 进行交互，实现智能化的代码生成和验证。

  • 描述目标，代理自动处理规划、实现和验证
  • 最多 12 个代理终端同时运行，大幅提升开发效率
  • 使用 Git Worktrees 隔离工作空间，主分支始终安全
  • 内置 QA 质量保证循环，问题在审查前自动捕获
  • 跨会话记忆层（Graphiti），让 AI 代理越用越智能
  • 支持 Windows、macOS 和 Linux 全平台

工作流程总览

从任务描述到代码交付的完整自动化流程

📝 任务描述 📋 Spec 创建 🗺️ Planner 规划 💻 Coder 编码 ✅ QA 验证 修复问题
💡 工作流程说明： 用户只需描述任务，系统自动进行复杂度评估，创建规格说明（Spec），然后由 Planner 代理制定实现计划，Coder 代理执行编码，最后 QA 代理进行质量验证。如果发现问题，自动进入修复循环。

多代理协作系统

四种专业代理各司其职，协同完成复杂开发任务

🧠 记忆层 Graphiti 🗺️ Planner Agent 制定实现计划 💻 Coder Agent 执行代码实现 🔍 QA Reviewer 验证验收标准 🔧 QA Fixer 修复发现的问题 问题修复循环（最多50次迭代）
🗺️
Planner Agent
规划者
分析任务需求，创建详细的子任务实现计划，确定执行顺序和依赖关系
💻
Coder Agent
编码者
按照计划逐个实现子任务，可生成子代理进行并行工作
🔍
QA Reviewer
质量审查
检查所有验收标准，生成问题报告，支持 E2E 测试
🔧
QA Fixer
问题修复
根据 QA 报告修复问题，直到所有测试通过

智能复杂度评估

根据任务特征自动选择最优执行流程

🟢 SIMPLE 1-2 个文件 | 单一服务 1. Discovery 发现 2. Quick Spec 快速规格 3. Validation 验证 3 个阶段 🟡 STANDARD 3-10 个文件 | 1-2 服务 1. Discovery 2. Requirements 3. Context 4. Spec Writing 5. Planning 6. Validation 6 个阶段 🔴 COMPLEX 10+ 文件 | 多服务 | 外部集成 1. Discovery 5. Spec Writing 2. Requirements 6. Self Critique 3. Research 7. Planning 4. Context 8. Validation 包含深度研究和自我批评阶段 8 个阶段
复杂度 文件数量 服务数量 执行阶段 典型场景
SIMPLE 1-2 个 单一服务 3 个阶段 UI 修复、文案更改、样式调整
STANDARD 3-10 个 1-2 个服务 6 个阶段 新功能开发、Bug 修复、代码重构
COMPLEX 10+ 个 多服务 8 个阶段 系统架构调整、外部 API 集成、跨模块功能

扩展思考配置

根据任务需求动态调整 AI 的思考深度

None
-
无扩展思考
快速响应
Low
1K
轻度思考
简单任务
Medium
4K
中度分析
常规开发
High
16K
深度思考
QA 审查
Ultrathink
65K
最大深度
规格创建
🧠 阶段默认配置：
• Spec 创建：Sonnet + Medium（复杂任务使用 Ultrathink）
• Planning 规划：Opus + High（深度分析任务结构）
• Coding 编码：Sonnet + Medium（平衡速度和质量）
• QA 验证：Sonnet + High（仔细检查每个细节）

核心特性

Auto Claude 提供了一套完整的自动化编码工具集

🎯

自主任务执行

只需描述你的目标，AI 代理会自动处理规划、实现和验证的全过程，无需手动干预。

⚡

并行执行

支持最多 12 个代理终端同时运行多个构建任务，极大提升开发效率。

🔒

隔离工作空间

所有更改都在 Git Worktrees 中进行，确保你的主分支始终处于安全状态。

✅

自验证 QA

内置质量保证循环（最多 50 次迭代），在你审查之前自动捕获并修复问题。

🔀

AI 驱动合并

智能冲突解决机制，将完成的功能无缝集成回主分支。

🧠

Graphiti 记忆层

基于知识图谱的跨会话记忆系统，让代理能够记住项目的模式和经验。

🔌

MCP 工具集成

支持 Context7、Linear、Puppeteer、Electron 等多种 MCP 服务器扩展。

🔄

自动更新

应用会在发布新版本时自动更新，始终保持最新功能。

四层安全防御

多重安全机制确保代码和系统安全

1️⃣ OS Sandbox 操作系统沙箱 2️⃣ Filesystem Permissions 文件系统权限 3️⃣ Security Hooks 命令白名单验证 4️⃣ Tool Filtering 代理工具过滤
1

操作系统沙箱

所有 Bash 命令在隔离的沙箱环境中运行，防止意外或恶意操作影响系统

2

文件系统权限

所有文件操作严格限制在项目目录内，无法访问或修改系统其他文件

3

动态命令白名单

根据检测到的项目技术栈动态生成命令白名单，只允许执行批准的命令

4

代理工具过滤

每种代理类型只能访问其所需的工具集，防止工具滥用

🔐 安全保证：所有发布版本在发布前都经过 VirusTotal 扫描，并包含 SHA256 校验和供验证。macOS 版本已进行代码签名。安全配置文件缓存在 .auto-claude-security.json。

安装指南

选择适合你的安装方式开始使用

Bash 
# 克隆仓库
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude

# 安装所有依赖
npm run install:all

# 开发模式运行（包含E2E测试支持）
npm run dev

# 或构建并运行生产版本
npm start

构建系统要求：

  • Node.js 24+
  • Python 3.12+
  • npm 10+

适用于无头操作、CI/CD 集成或纯终端工作流：

Bash 
cd apps/backend

# 设置 Python 环境（使用 uv 推荐）
uv venv && uv pip install -r requirements.txt

# 配置 OAuth Token
claude setup-token
# 将 token 添加到 apps/backend/.env

# 交互式创建规格
python spec_runner.py --interactive

# 使用任务描述创建规格
python spec_runner.py --task "Add user authentication"

# 强制指定复杂度
python spec_runner.py --task "Fix button" --complexity simple

# 运行自主构建
python run.py --spec 001

# 列出所有规格
python run.py --list

# 审查更改
python run.py --spec 001 --review

# 合并到主分支
python run.py --spec 001 --merge

# 丢弃构建
python run.py --spec 001 --discard

项目架构

模块化设计，清晰的代码组织

目录结构 
Auto-Claude/
├── apps/
│   ├── backend/           # Python 后端 - 所有代理逻辑
│   │   ├── agents/        # 代理实现 (Planner, Coder, QA)
│   │   ├── core/          # 客户端、认证、安全
│   │   ├── spec/          # Spec 创建和验证
│   │   ├── qa/            # QA 验证循环
│   │   ├── security/      # 安全验证器
│   │   ├── memory/        # 记忆管理
│   │   ├── prompts/       # 代理系统提示词
│   │   └── integrations/  # Graphiti, Linear, GitHub
│   └── frontend/          # Electron 桌面应用
│       └── src/           # React + TypeScript UI
├── guides/                # 使用文档
├── tests/                 # 测试套件
└── scripts/               # 构建工具

配置选项

通过环境变量自定义 Auto Claude 行为

.env 
# 从 .env.example 创建配置文件
cp apps/backend/.env.example apps/backend/.env

# ===== 必需配置 =====
CLAUDE_CODE_OAUTH_TOKEN=your-token  # 通过 claude setup-token 获取

# ===== 可选配置 =====
# 记忆层
GRAPHITI_ENABLED=true               # 启用 Graphiti 跨会话记忆
GRAPHITI_MCP_URL=http://localhost:8000/mcp/  # Graphiti MCP 服务器

# 模型配置
AUTO_BUILD_MODEL=                   # 覆盖默认 Claude 模型

# Linear 集成
LINEAR_API_KEY=                     # Linear API 密钥（项目管理）

# E2E 测试（Electron）
ELECTRON_MCP_ENABLED=true           # 启用 Electron MCP 服务器
ELECTRON_DEBUG_PORT=9222            # 远程调试端口

# CLAUDE.md 支持
USE_CLAUDE_MD=true                  # 读取项目 CLAUDE.md 作为上下文

加入社区

与其他开发者一起探索 AI 编码的未来

💬 Discord 社区 🐛 报告问题 💡 讨论区 ⭐ GitHub 仓库