
这是第一个开源项目,将最强大的代码代理,如 ANTHROPIC ClaudeCode 和 OpenAI Codex 转化为后台代理,可通过 REST API、用户界面和 MCP 访问
概览
bgagents 是第一个开源项目,将最强大的代码代理(如 ANTHROPIC ClaudeCode 和 OpenAI Codex)转化为后台代理,可通过 REST API、MCP 和交互式前端访问 最快运行bgagents的方法就是使用我们预构建的Docker镜像: - API_KEY:您的 Anthropic Claude 或 OpenAI API 密钥(自动检测提供者)- GITHUB_TOKEN:GitHub 访问令牌(请求中提供的替代方案) - : Claude-Sonnet-4-20250514(默认),Claude-opus-4-20250514,Claude-3-7-Sonnet-20250219- : Codex-Mini-最新(默认),O4-Mini 更新docker-compose.yml,添加以下环境变量: 4. - : http://localhost(端口80) - : http://localhost:3000 - : http://localhost:6213 用以下环境变量更新主 Docker 文件: - : http://localhost - : http://localhost:3000 - : http://localhost:6213
概述(AI 翻译)
bgagents 是第一个开源项目,将最强大的代码代理(如 ANTHROPIC ClaudeCode 和 OpenAI Codex)转化为后台代理,可通过 REST API、MCP 和交互式前端访问
✨ 特色
开始
快速入门(推荐)
最快运行bgagents的方法就是使用我们预构建的Docker镜像:
GitHub认证(选择一种方法):
选项1:直接令牌
选项2:OAuth 流
可选环境变量:
API_KEY:您的Anthropic Claude或OpenAI API密钥(自动检测提供者)GITHUB_TOKEN:GitHub访问令牌(请求中提供的替代方案)
** 🤖 支持的AI模型:**
- 拟人化:claude-sonnet-4-20250514(默认),claude-opus-4-20250514,claude-3-7-sonnet-20250219
- OpenAI:codex-mini-最新(默认),o4-mini
制作
先决条件
搭配 Docker Compose(推荐)
-
克隆仓库:
-
设置环境变量:
更新docker-compose.yml,添加以下环境变量:
-
使用 Docker Compose 部署:
-
** 访问服务:**
- 前端:http://localhost(端口80)
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
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)
-
Clone the repository:
git clone https://github.com/michael-elkabetz/claudecodex.git cd claudecodex -
Set up environment variables:
Update
docker-compose.ymlwith 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
安装
docker run -e GITHUB_TOKEN=[ghp_xxx] \