Auto-Company 详细部署教程

1. 项目简介

Auto-Company 是一个全自主 AI 公司系统，能够 24/7 不停歇运行。它包含 14 个 AI Agent，每个都是该领域世界顶级专家的思维分身，能够自主构思产品、做决策、写代码、部署上线、搞营销——全程没有人类参与。

核心特性：

  • 14 个专家 AI Agent：CEO 是贝索斯（Jeff Bezos）、CTO 是 Werner Vogels、逆向思考是查理·芒格（Charlie Munger）、全栈开发是 DHH、营销是 Seth Godin 等
  • 30+ 技能库：深度调研、网页抓取、财务建模、SEO、安全审计、UX 审计等，任何 Agent 按需取用
  • 强制收敛流程：禁止纯讨论不落地，每轮必须产出代码或决策
  • 轻量级状态管理：整个跨周期记忆就是一个 Markdown 文件（memories/consensus.md）
  • 双引擎支持：底层使用 Claude Code 或 Codex CLI 作为执行引擎
  • 故障自恢复：内置熔断保护、限额等待、consensus 回滚机制

系统架构（五层）：

层级 说明
L1 执行引擎 Claude Code / Codex CLI，继承文件读写、Bash、Git 能力
L2 编排层 auto-loop.sh 永续循环，组 prompt、设超时、判定成败
L3 认知层 14 份角色 Markdown + 35 个技能目录
L4 路由层 PROMPT.md 中的收敛流程指示
L5 可观测层 logs/ 完整日志 + Python dashboard 可视化

重要提醒：这是一个实验项目，能跑但不一定稳定。目前主要支持 macOS，Windows 需要通过 WSL2 运行。

2. 部署前准备

2.1 系统要求

根据官方文档，部署需要满足以下条件：

  • 操作系统：macOS 或 Windows + WSL2 (Ubuntu)
  • Node.js：已安装
  • make：macOS/WSL 需要
  • jq：推荐安装（用于解析引擎返回的 JSON 数据，没有它费用信息无法显示）
  • gh 和 wrangler：可选，用于部署能力
  • Claude Code CLI 或 Codex CLI：已安装并登录
  • Claude Max / Pro 订阅或足够的 API 额度

2.2 资源消耗说明

重要：每个周期都会消耗 LLM 模型额度，持续运行会产生成本。根据相关测试，成本约为每小时 10 美元。建议在使用前充分评估预算。

3. 部署步骤

3.1 macOS 部署

步骤 1：安装前置依赖

1
2
3
4
5
# 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 make 和 jq
brew install make jq

步骤 2：安装并登录 Claude Code CLI

1
2
npm install -g @anthropic-ai/claude-code
claude login

步骤 3：克隆项目

1
2
git clone https://github.com/MaxMiksa/Auto-Company.git
cd Auto-Company

步骤 4：启动方式选择

方式一：前台运行（推荐首次使用）

1
make start

这种方式会直接在终端显示输出，按 Ctrl+C 即可停止。

方式二：安装为守护进程（开机自启 + 崩溃自重启）

1
make install

安装后，系统会通过 launchd 管理进程，实现自动启动和崩溃恢复。

3.2 Windows (WSL2) 部署

步骤 1：安装 WSL2

在 PowerShell（管理员模式）中运行：

1
wsl --install -d Ubuntu

步骤 2：进入 WSL 环境并安装依赖

1
2
3
4
5
6
7
# 在 WSL Ubuntu 中
sudo apt update
sudo apt install -y make jq curl

# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

步骤 3：安装并登录 Claude Code CLI

1
2
npm install -g @anthropic-ai/claude-code
claude login

步骤 4：克隆项目并启动

1
2
3
4
5
6
7
8
git clone https://github.com/MaxMiksa/Auto-Company.git
cd Auto-Company

# 方式一：前台运行
make start

# 方式二：安装为守护进程
make install

Windows 特有命令：

1
2
3
# 在 PowerShell 中
.\scripts\windows\start-win.ps1   # 启动
.\scripts\windows\stop-win.ps1    # 停止

4. 常用命令

根据官方文档，常用管理命令如下：

命令 说明
make start 前台启动循环
make install 安装为守护进程（开机自启 + 崩溃自重启）
make pause 暂停运行
make resume 恢复运行

5. 配置与操作

5.1 修改 AI 团队方向（人工干预）

Auto-Company 的独特设计是：你可以通过编辑 memories/consensus.md 文件来干预 AI 团队的决策方向。

操作方法：

  1. 打开 memories/consensus.md 文件
  2. 找到 ## Next Action 部分
  3. 修改为你希望 AI 团队执行的任务
  4. 下一个周期开始时，AI 团队会读取这个文件并立即转向执行新任务

5.2 查看运行日志

系统会在 logs/ 目录记录每一轮完整输出和思维链。可以通过以下命令查看：

1
2
ls logs/
cat logs/latest.log

5.3 可视化面板

项目提供基于 Python 的本地可视化面板，显示实时周期状态、成本消耗和 Agent 活动。

6. 工作原理

6.1 运行循环

系统通过守护进程（macOS 使用 launchd，WSL 使用 systemd –user）管理一个持续循环：

1
2
3
4
5
6
7
8
9
launchd (崩溃自重启)
  └── auto-loop.sh (永续循环)
        ├── 读 PROMPT.md + consensus.md
        ├── claude -p (驱动一个工作周期)
        │   ├── 读 CLAUDE.md (公司章程 + 安全红线)
        │   ├── 组建 Agent Team (3-5 人)
        │   ├── 执行：调研、写码、部署、营销
        │   └── 更新 memories/consensus.md
        └── 失败处理: 限额等待 / 熔断保护 / consensus 回滚

6.2 强制收敛流程

为防止 AI 陷入无休止讨论，系统在 PROMPT.md 中硬编码了收敛规则：

周期 动作
第 1 轮 头脑风暴，各 Agent 提案，排出 Top 3
第 2 轮 验证 #1：芒格 Pre-mortem + 汤普森市场检验 + 单位经济，逼出 GO/NO-GO
第 3 轮起 GO → 建仓库、写代码、部署；NO-GO → 转向下一个想法

6.3 标准工作流

系统预置了六套标准协作流程：

工作流 协作链
新产品评估 调研 → CEO → 芒格 → 产品 → CTO → CFO
功能开发 交互 → UI → 全栈 → QA → DevOps
产品发布 QA → DevOps → 营销 → 销售 → 运营 → CEO
定价与变现 调研 → CFO → 销售 → 芒格 → CEO
周度回顾 运营 → 销售 → CFO → QA → CEO
机会发现 调研 → CEO → 芒格 → CFO

7. 安全注意事项

重要警告：Auto-Company 需要全权限运行——底层使用 Claude 的 bypassPermissions 或 Codex 的 danger-full-access，所有操作直接发生在你的真实主机上。

安全护栏：系统在 CLAUDE.md 中定义了安全红线（如不删库、不 force push），但这是软约束，不是沙箱隔离。

建议措施：

  • 在隔离环境或专用机器上运行
  • 不要在生产环境或含有敏感数据的机器上部署
  • 定期检查 logs/ 目录，了解 AI 团队的实际操作
  • 根据需要在 CLAUDE.md 中增加更多安全限制

8. 常见问题与解决方案

8.1 费用显示为 N/A

原因：缺少 jq 工具。

解决方案：

1
2
3
4
5
# macOS
brew install jq

# WSL/Ubuntu
sudo apt install jq

8.2 连续失败后停止运行

原因：系统触发了熔断保护。

解决方案：系统内置了连续 5 次失败后进入 5 分钟冷却期的机制，之后会自动恢复并重置计数器。

8.3 运行日志中断或异常

原因：可能是配额耗尽或 API 限流。

解决方案：系统会在检测到 429 或 rate limit 错误时自动等待 1 小时。检查日志确认是否正在等待。

8.4 如何在 Windows 上运行

解决方案：Auto-Company 原生支持 macOS，Windows 用户需要通过 WSL2 运行。按照 3.2 节步骤配置 WSL2 环境即可。

9. 部署架构总结

部署方式 适用场景 启动命令 特点
前台运行 首次体验、调试 make start 实时查看输出，Ctrl+C 停止
守护进程 长期运行 make install 开机自启，崩溃自重启
Windows WSL2 Windows 用户 start-win.ps1 需先配置 WSL2 环境

Auto-Company 的核心设计理念是“用最土的办法解决多 Agent 空转问题”——通过强制收敛流程和轻量级状态管理，让 AI 团队真正产出可落地的成果，而不是无休止地讨论。部署完成后，你可以通过修改 memories/consensus.md 来引导 AI 团队的方向，实现“最小化宏观控制”。