HolaOS：All-in-One AI Agent工作空间完整教程

GitHub：holaboss-ai/holaOS | TypeScript | MIT License

项目简介

HolaOS 是一个 All-in-One 的 AI Agent 工作空间，让你在一个界面内同时运行 Claude Code、OpenAI Codex 等多种 AI 编码 Agent。它内置 100+ 工具集成和 MCP（Model Context Protocol）支持，Agent 之间可以共享记忆和上下文。采用 BYOK（Bring Your Own Key）模式，你只需填入自己的 API Key 即可使用，无需额外的订阅费用。HolaOS 的目标是将所有 AI 开发工具统一到一个工作空间中。

安装

# 桌面端安装
# macOS / Windows / Linux
# 从 GitHub Releases 下载安装包
# https://github.com/holaboss-ai/holaOS/releases

# 源码编译
git clone https://github.com/holaboss-ai/holaOS.git
cd holaOS
pnpm install
pnpm build
pnpm electron:dev

# 配置API Key（BYOK）
# 启动后在设置页面填入：
# - Anthropic API Key（Claude Code）
# - OpenAI API Key（Codex）
# - 或本地模型地址（Ollama等）

核心功能

快速使用

// HolaOS 配置文件 (holaos.config.json)
{
  "workspace": "my-project",
  "agents": [
    {
      "name": "claude-code",
      "provider": "anthropic",
      "model": "claude-sonnet-4",
      "apiKey": "${ANTHROPIC_API_KEY}",
      "mcp": true
    },
    {
      "name": "codex",
      "provider": "openai",
      "model": "gpt-4o",
      "apiKey": "${OPENAI_API_KEY}"
    },
    {
      "name": "local-llama",
      "provider": "ollama",
      "endpoint": "http://localhost:11434",
      "model": "llama3.2"
    }
  ],
  "shared_memory": {
    "enabled": true,
    "storage": "./.holaos/memory"
  },
  "integrations": [
    "git", "docker", "postgres", "redis"
  ]
}

// 启动工作空间
// holaos start --config holaos.config.json

// 在工作空间中：
// 1. 用Claude Code重构API模块
// 2. 用Codex生成测试用例
// 3. 两个Agent共享项目记忆
//    - Claude Code重构后，Codex自动感知新结构
//    - 无需手动同步上下文

HolaOS 的多Agent统一管理理念与 OpenFang Agent OS指南 中的Agent操作系统思路类似——都是将多个AI Agent统一到一个平台上管理。HolaOS更偏向开发场景，OpenFang更通用，可根据需求选择。

适用场景