bgagents는 ANTHROPIC ClaudeCode 및 OpenAI Codex와 같은 가장 강력한 코드 에이전트를 전환하는 최초의 오픈 소스 프로젝트이며 REST API, MCP 및 대화 형 frontend를 통해 액세스 할 수 있습니다.

✨ 특징

시작하기

빠른 시작 (추천)

bgagents 실행을 얻는 가장 빠른 방법은 우리의 pre-built Docker 이미지로 입니다:

GitHub 인증 (하나의 방법 선택):

** 옵션 1: 직접 토큰**

** 옵션 2 : OAuth 흐름 **

** 옵션 환경 변수 : **

• 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와 비교: **

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