bgagentsは、ANTROPIC ClaudeCodeやOpenAI Codexなどの最も強力なコードエージェントをバックグラウンドエージェントに変える最初のオープンソースプロジェクトで、REST API、MCP、インタラクティブなフロントエンドからアクセス可能

✨ 機能

はじめる

##クイックスタート(推奨)

bgagentsの実行の最速の方法は、ビルド済みのDockerイメージです。

GitHub 認証 (一つの方法を選択):

Option 1: 直接トークン

オプション2: OAuth Flow

任意環境変数:

• [API_KEY: Anthropic ClaudeまたはOpenAI APIキー(自動検出プロバイダ)
• [GITHUB_TOKEN:GitHubアクセストークン(リクエストで提供する場合の代替)

** 対応する AI モデル:** -Anthropic: claude-sonnet-4-20250514 (デフォルト)、claude-opus-4-20250514、claude-3-7-sonnet-20250219

• OpenAI: codex-mini-latest (デフォルト), o4-mini

##制作

前提条件

Docker Compose(推奨)

1. リポジトリのクローン:

2.環境変数の設定:

次の環境変数で[docker-compose.ymlを更新します。

3. Docker Compose とのDeploy:

4.サービスへのアクセス:

• フロントエンド: [http://localhost] (ポート80)

bgagents

bgagents is the first open-source project that turns the most powerful code agents, such as ANTHROPIC ClaudeCode and OpenAI Codex into background agents, accessible via REST API, MCP, and an interactive frontend

✨ Features

Getting Started

Quick Start (Recommended)

The fastest way to get bgagents running is with our pre-built Docker image:

GitHub Authentication (Choose one method):

Option 1: Direct Token

docker run -e GITHUB_TOKEN=[ghp_xxx] \
           -e API_KEY=[sk-...-xxx] \ # Optional
           bgagents/bgagents:v1.0.1-alpha

Option 2: OAuth Flow

docker run -e GITHUB_CLIENT_ID=[your_client_id] \
           -e GITHUB_CLIENT_SECRET=[your_client_secret] \
           -e GITHUB_REDIRECT_URI=http://localhost:3000 \
           -e API_KEY=[sk-...-xxx] \ # Optional 
           bgagents/bgagents:v1.0.1-alpha

Optional Environment Variables:

• API_KEY: Your Anthropic Claude or OpenAI API key (auto-detects provider)
• GITHUB_TOKEN: GitHub access token (alternative to providing it in requests)

🤖 Supported AI Models:

• Anthropic: claude-sonnet-4-20250514 (default), claude-opus-4-20250514, claude-3-7-sonnet-20250219
• OpenAI: codex-mini-latest (default), o4-mini

Production

Prerequisites

With Docker Compose (Recommended)

1. Clone the repository:

   git clone https://github.com/michael-elkabetz/claudecodex.git
   cd claudecodex
   

2. Set up environment variables:

   Update docker-compose.yml with the following environment variables:

   VITE_GITHUB_CLIENT_ID=[VITE_GITHUB_CLIENT_ID]
   VITE_GITHUB_REDIRECT_URI=[VITE_GITHUB_REDIRECT_URI]
   GITHUB_CLIENT_SECRET=[GITHUB_CLIENT_SECRET]
   GITHUB_TOKEN=ghp_xxx