Omnara：解锁Claude Code的环境限制

⚠️ 重要通知 ⚠️

此版本的 Omnara 已停止维护。由此带来的不便，我们深表歉意。这个版本是围绕 Claude Code CLI 构建的封装层，但由于 Claude Code 持续更新，继续维护这种方案已经不可行。

我们已迁移至全新的语音优先 coding agent 平台 https://omnara.com。新平台使用 Claude Agent SDK 构建，保留了你喜爱的功能——通过 Web 和移动端访问自己的机器——但不再封装 Claude Code CLI，而是构建了一套自主集成的体验。这使我们能够提供更加可靠、更易维护的服务。

旧版 Web 应用： 这个已弃用版本的旧版 Web 控制台位于 https://claude.omnara.com，并将持续运行至 2025 年年底。如需使用，请将 Python package 升级到 1.7.0 版本：pip install omnara==1.7.0

新平台： omnara.com 上的新版本现已改为 bun 可执行程序。可使用以下命令安装：curl -fsSL https://omnara.com/install/install.sh | bash

当前付费客户： 你可以通过 contact@omnara.com 联系我们申请退款。我们还会为你在 omnara.com 新平台上的账户赠送 2 个月免费额度，并且你当前的付费价格将永久保留。

移动 App 自动更新： 如果你启用了自动更新，移动 App 可能已经升级至 v1.5.0（新平台）。如果你需要访问适用于这个已弃用平台的旧版本（< 1.5.0），请联系 contact@omnara.com，我们可以通过 TestFlight 为你提供访问权限。

从源码构建： Web 和移动 App 现已完全基于 Apache 2.0 协议开源。如果你希望自行托管或运行旧版本，可以从源码构建 Web 控制台（apps/web/）和移动 App（apps/mobile/）。

问题咨询： 如有其他问题，请通过 contact@omnara.com 联系我们。

将你的 AI 工作团队装进口袋。

📱 iOS App • 🤖 Android App • 🌐 Web 控制台 • 📖 文档 • 🎥 演示 • ⭐ GitHub

# Install Omnara (requires python >= 3.10)
pip install omnara

# Start a Claude Code session that's synced between terminal, web, and mobile
omnara

# Start a Codex CLI session that's synced between terminal, web, and mobile
omnara --agent codex

就是这么简单！根据提示创建账户，然后返回终端与你的 coding agent 交互。现在，你可以通过 Web 控制台或移动 App 查看 coding agent session，并与之交互。

Omnara 能够将你的 AI agents（Claude Code、Codex CLI、n8n 等）从沉默的执行者转变为善于沟通的队友。你可以实时了解 agents 正在执行的工作，并通过 Web 和移动端的统一控制台即时回答它们的问题。

使用你偏好的 package manager 安装 Omnara：

# Using pip
pip install omnara

# Using uv
uv tool install omnara

# Using pipx
pipx install omnara

Omnara 根据不同的工作流提供三种运行模式：

omnara

以标准 CLI 界面启动 Claude Code，并在终端、Web 控制台和移动 App 之间完整同步。你仍然像往常一样在终端中与 Claude Code 交互，同时所有内容都会镜像至 Omnara 控制台。

omnara --agent codex

以标准 CLI 界面启动 Codex，并提供与上述模式相同的功能。

omnara headless

在后台运行 Claude Code，不显示终端 UI。当你希望完全通过 Omnara Web 控制台或移动 App 与 Claude Code 交互时，这种模式非常适合。

omnara serve

暴露一个 endpoint，让你能够从 Omnara 控制台远程启动 Claude Code instances。非常适合通过手机或其他设备触发 AI agents。

及时升级 Omnara，以使用最新功能：

# Using pip
pip install omnara --upgrade

# Using uv
uv tool upgrade omnara

# Using pipx
pipx upgrade omnara

Omnara 的 n8n 集成提供了一个专用的「Human in the Loop」节点，可以在 n8n 工作流中实现实时的人机协作。它非常适合审批工作流、Agent 对话和引导式自动化。

有关详细的安装和配置说明，请参阅 npm 上的 n8n-nodes-omnara package。

3. GitHub Actions 集成

Omnara 的 GitHub Actions 集成允许你通过 repository dispatch events，在 GitHub Actions 工作流中触发 Claude Code 运行，同时通过 Omnara 控制台监控 Claude Code 并与之交互。

远程启动： 通过手机或 Web 控制台启动 GitHub Actions。

自动创建 PR： Claude 会创建 branches、提交更改并发起 PR。

实时监控： 通过 Omnara 跟踪进度并提供指导。

有关包括 GitHub workflow 配置在内的完整设置说明，请参阅 GitHub Actions 集成指南。

🔧 将你自己的 Agent 集成到 Omnara

方法 1：手动配置 MCP

对于自定义 MCP 设置，你可以手动进行配置：

{
  "mcpServers": {
    "omnara": {
      "command": "pipx",
      "args": ["run", "--no-cache", "omnara", "mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

from omnara import OmnaraClient
import uuid

client = OmnaraClient(api_key="your-api-key")
instance_id = str(uuid.uuid4())

# Log progress and check for user feedback
response = client.send_message(
    agent_type="claude-code",
    content="Analyzing codebase structure",
    agent_instance_id=instance_id,
    requires_user_input=False
)

# Ask for user input when needed
answer = client.send_message(
    content="Should I refactor this legacy module?",
    agent_instance_id=instance_id,
    requires_user_input=True
)

curl -X POST https://agent.omnara.com/api/v1/messages/agent \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Starting deployment process", "agent_type": "claude-code", "requires_user_input": false}'

🏗️ 架构概览

Omnara 提供了一个统一平台，用于监控和控制你的 AI agents：

graph TB
    subgraph "Your AI Agents"
        A[🤖 AI Agents<br/>Claude Code, Cursor, etc.]
    end

    subgraph "Omnara Platform"
        API[🌐 API Server]
        DB[(📊 PostgreSQL)]
        NOTIFY[🔔 Notification Service<br/>Push/Email/SMS]
    end

    subgraph "Your Devices"
        M[📱 Mobile App]
        W[💻 Web Dashboard]
    end

    A -->|Send updates| API
    API -->|Store data| DB
    API -->|Trigger notifications| NOTIFY
    NOTIFY -->|Alert users| M
    DB -->|Real-time sync| M
    DB -->|Real-time sync| W
    M -->|User responses| API
    W -->|User responses| API
    API -->|Deliver feedback| A

    style A fill:#e3f2fd,stroke:#1976d2,stroke-width:3px,color:#000
    style API fill:#c8e6c9,stroke:#388e3c,stroke-width:2px,color:#000
    style DB fill:#ffccbc,stroke:#d84315,stroke-width:2px,color:#000
    style NOTIFY fill:#fff59d,stroke:#f57f17,stroke-width:2px,color:#000
    style M fill:#f8bbd0,stroke:#c2185b,stroke-width:3px,color:#000
    style W fill:#f8bbd0,stroke:#c2185b,stroke-width:3px,color:#000

前置条件：Docker、Python 3.10+、Node.js

git clone https://github.com/omnara-ai/omnara
cd omnara
cp .env.example .env
python infrastructure/scripts/generate_jwt_keys.py
./dev-start.sh  # Starts everything automatically

停止服务：./dev-stop.sh

有关详细的设置说明、手动配置方式和贡献指南，请参阅我们的 Contributing Guide。

我们欢迎各种贡献！请查看 Contributing Guide，了解如何开始参与。

make lint       # Run code quality checks
make format     # Auto-format code
make test       # Run test suite
./dev-start.sh  # Start development servers

💬 GitHub Discussions

Omnara 是一款采用 Apache 2.0 License 的开源软件。

由 Omnara 团队用 ❤️ 打造

网站 • 文档 • Twitter • LinkedIn