快速开始

5 分钟内让 Forgexa 跑起来。

前置条件

• Docker & Docker Compose
• Git
• 已安装以下任一 AI Agent CLI：Claude Code、Codex、GitHub Copilot、Gemini CLI、OpenCode、Kimi Code、MiMo Code、Qwen Code、CodeBuddy、Qoder CLI、TraeCode CLI、ZCode 或受门禁保护的 DeepSeek Harness 预览

MiMo Code（mimo，v0.1.14+）、Qwen Code（qwen，v0.24.1+）、CodeBuddy（codebuddy，v2.156.0+）、Qoder CLI（qoder，v1.1.59+）、TraeCode CLI（trae）与 ZCode（zcode）均是显式 Runtime 与 AgentHost 集成。请在实际运行它们的本机 CLI profile 中配置认证、端点和模型；Forgexa 不保存或覆盖这些设置。它们不会被自动路由或默认后备链选择。CodeBuddy 与 Qoder 均已完成本机 AgentHost 首轮/恢复 gate；TraeCode CLI 与 ZCode 在真实 live 验收前保持门禁保护。

DeepSeek Harness（deepseek，精确 0.2.0-rc.2）是第 7 个显式集成，限于 Desktop/个人 Runtime。它使用受管 home 与外部认证只读引用，要求构件/Node/平台验收；不会自动路由，原生 Windows 和共享池保持关闭。选择前参阅 Harness 安装。

1. 克隆并启动

git clone <your-repo-url> forgexa
cd forgexa

# 启动所有服务 (API, Web, PostgreSQL, Redis, MinIO)
docker compose up -d

Web UI 地址：http://localhost:3000，API 地址：http://localhost:8000。

2. 登录

默认管理员账号：

• 邮箱：admin@example.com
• 密码：admin123

# 推荐使用 Forgexa CLI 登录
forgexa login --server http://localhost:8000 --email admin@example.com --password admin123

3. 创建组织

登录后，创建一个组织来管理团队：

1. 点击左上角组织选择器
2. 点击 创建组织
3. 输入组织名称（如 "我的团队"）
4. 创建完成后你自动成为组织 Owner

TIP

组织是最顶层容器。在组织内创建工作空间来组织项目。

4. 启动守护进程

守护进程运行在宿主机上，执行 AI Agent 任务：

# 设置环境变量
export DAEMON_SERVER_URL=http://localhost:8000
export DAEMON_API_TOKEN=<your-token>

# 启动守护进程
forgexa daemon start

守护进程会：

1. 发现已安装的 Agent CLI（claude、codex、copilot、gemini、opencode、kimi、mimo、qwen、codebuddy、qoder、trae、zcode 和 deepseek）
2. 注册到 API 服务器
3. 开始轮询任务

MiMo Code（mimo，v0.1.14+）、Qwen Code（qwen，v0.24.1+）、CodeBuddy（codebuddy，v2.156.0+）、Qoder CLI（qoder，v1.1.59+）、TraeCode CLI（trae）与 ZCode（zcode）需要时请显式选择；自动路由和默认后备链仍使用另外 6 个标准候选。

将任一显式本机 CLI 分配给节点、执行或工作流策略之前，先在实际运行任务的本机 Runtime 或 AgentHost 上完成其认证、端点和模型配置。Forgexa 不会把这些设置经由平台传递；CodeBuddy 与 Qoder 会以空 settings source、严格 MCP 和固定工具策略启动。通用 LLM Integration 则独立用于需求预处理、知识问答等平台功能。

5. 创建项目

1. 打开 Web UI → 选择工作空间 → 项目 → 新建项目
2. 填写项目信息：
   • 名称、项目缩写
   • 技术栈（如 ["python", "fastapi"]）
   • Git 仓库 URL（可选）
3. 保存

6. 提交需求

1. 进入项目 → 需求 → 新建需求
2. 输入自然语言需求：

   "创建一个用户注册的 REST API 端点，包含邮箱验证和密码哈希"

3. 点击 分析 — AI 将生成结构化规格说明
4. 审核并 批准 需求

7. 生成并执行计划

1. 需求审批后，点击 生成计划
2. 审核生成的计划（工作项、执行节点）
3. 点击 批准计划 — 确认执行计划
4. 如果有在线守护进程，执行将自动开始

8. 监控执行

• 执行 页面 — 观察流水线进度（设计 → 编码 → 测试 → 评审）
• 看板 页面 — 在看板列中跟踪工作项
• 门禁 页面 — 在提示时审核和批准质量门禁

下一步

• 组织管理 — 管理团队、邀请、预算
• 安装部署 — 详细的部署选项
• 基本工作流 — 深入了解开发生命周期
• WORKFLOW.md 配置 — 自定义 Agent 行为