ME

michael-elkabetz/bgagents

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

49 stars 10 forks 质量 59 趋势 13MIT

这是第一个开源项目,将最强大的代码代理,如 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(推荐)
  1. 克隆仓库:

  2. 设置环境变量:

更新docker-compose.yml,添加以下环境变量:

  1. 使用 Docker Compose 部署:

  2. ** 访问服务:**

本页由 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

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

  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
在 GitHub 查看完整 README

安装

docker run -e GITHUB_TOKEN=[ghp_xxx] \
新手?先看 mcpskill.org 教程 →