raysonmeng/agent-bridge

A local bridge for bidirectional collaboration between Claude Code and Codex. 连接 Claude Code 与 Codex 的本地实时协作桥接工具。

AgentBridge – Claude Code와 OpenAI Codex가 실시간으로 대화할 수 있도록 해주는 로컬 브리지

무엇인가요 – AgentBridge는 개발자 측에서 실행되는 유틸리티로, 작은 데몬과 명령줄 래퍼(abg / agentbridge)를 실행합니다. 이 도구는 두 개의 대규모 언어 모델 코딩 어시스턴트 – Claude Code (Anthropic)와 Codex (OpenAI) – 를 연결하여 서로 메시지를 주고받고, 서로의 작업을 검토하며, 작업을 넘겨주는 것을 가능하게 합니다. 사용자는 터미널 간에 텍스트를 복사-붙여넣기 할 필요가 없습니다.

왜 중요한가요 – 일반적으로 두 개의 별도 터미널을 실행하고, 코드를 복사-붙여넣기하며, 한 쪽이 할당량에 도달했을 때 수동으로 전환해야 합니다. AgentBridge는 이 "릴레이" 과정을 자동화합니다:

각 어시스턴트는 지속적인 피어로 살아남습니다,
메시지는 자동으로 전달되며(백업 큐를 갖습니다),
바쁜 경고 기능은 반대 쪽이 활성화된 턴 중일 때 응답을 차단하고,
내장된 워치독은 한 쪽 어시스턴트가 할당량을 초과했을 때 다른 쪽으로 턴을 넘겨 긴 작업이 계속될 수 있도록 합니다.

핵심 기능 (README에 설명된 내용)

기능	얻을 수 있는 것
양방향 Claude ↔ Codex 메시징	Claude는 Codex의 `agentMessage` 페이로드를 채널 알림으로 수신하고, Codex는 `reply` 도구를 통해 Claude의 응답을 수신합니다.
백업 큐를 갖는 푸시 전달	푸시 전달이 실패하면 데몬이 메시지를 메모리에 저장하고 `get_messages`를 통해 재시도합니다.
턴 조율	바쁜 경고 기능은 반대 쪽이 활성화된 턴 중일 때 응답을 차단합니다. 무반응 워치독은 5분간 침묵이 지속되면 턴을 완료하도록 강제합니다.
여러 쌍을 병렬로 실행	동일한 리포지토리에서 여러 개의 Claude+Codex 쌍을 실행할 수 있으며, 각 쌍은 고유한 포트 집합을 갖습니다 (+10씩 증가, 4500부터 시작).
회복력 있는 라이프사이클	Claude 재시작에도 데몬이 살아남으며, 백오프를 사용해 자동 재연결하고, 고립된 프로세스를 정리하며, `abg doctor` 진단 기능을 제공합니다.
스레드 자동 재개	`abg codex`는 마지막 Codex 스레드를 자동으로 다시 열고, `abg resume`은 양쪽 모두를 마지막 세션에 다시 연결하기 위한 명령어를 출력하거나 실행합니다.
예산 조율 및 자동 재개	한 쪽 어시스턴트의 구독 할당량이 만료되면 브리지가 해당 쪽을 일시 정지하고 다른 쪽은 계속 작동시켜 긴 작업을 유지합니다.
컨텍스트를 작게 유지하기 위한 필터링	`agentMessage` 페이로드만 교환되며, 다른 도구 호출의 잡음은 제거됩니다. 세 단계 마커 시스템(`[IMPORTANT]`, `[STATUS]`, `[FYI]`)을 통해 전달, 버퍼링, 무시할 내용을 제어할 수 있습니다.
네트워크 간 협업 (프리뷰)	v3는 브로커 기반의 "룸" 기능을 추가하여, 서로 다른 기계에서 실행되는 쌍도 메시지를 교환할 수 있게 합니다.

빠른 시작 워크플로우 (README에서)

Bun 설치 – 데몬에 필요한 런타임입니다.
CLI 설치 – npm install -g @raysonmeng/agentbridge (설치 후 Claude Code 플러그인 등록됨).
프로젝트 초기화 – abg init은 .agentbridge/config.json을 생성하고 종속성 확인합니다.
Claude 시작 – abg claude는 브리지 채널이 활성화된 상태로 Claude Code를 시작합니다.
Codex 시작 – 다른 터미널에서 abg codex를 실행하여 동일한 브리지에 연결된 Codex TUI를 시작합니다.

이제 Claude에게 "Codex와 작업을 분할해 보고서를 제안해 주세요..." 라고 요청하면, 두 어시스턴트가 수동 복사-붙여넣기 없이 협상하고 구현하며 코드를 검토하는 모습을 관찰할 수 있습니다.

내부 동작 방식

bridge.ts – Claude가 플러그인으로 로드하는 짧은 수명의 프론트엔드 클라이언트입니다. Claude의 reply 호출을 데몬으로 전달하고, Codex 메시지를 수신하여 Claude로 다시 전달합니다.
daemon.ts – 지속적인 백그라운드 프로세스로, Codex 앱 서버(WebSocket 또는 유닉스 소켓을 통해)와 통신하며 쌍의 권위 있는 상태를 유지합니다.
통신 흐름:
- Codex → daemon → bridge → Claude (채널 알림)
- Claude → bridge → daemon → Codex (삽입된 turn/start)
각 메시지는 source 필드를 포함하여 브리지가 메시지를 원본으로 되돌려 보내는 것을 방지하고, 루프를 막습니다.

설치 및 사전 요구 사항 (목록에 나와 있음)

종속성	추천 버전	설치 명령어
Bun	v1.3.11+	`curl -fsSL https://bun.sh/install
Claude Code	2.1.269	`npm install -g @anthropic-ai/claude-code@2.1.269`
Codex CLI	0.154.0	`npm install -g @openai/codex@0.154.0`

참고: CLI는 기본적으로 Claude를 --dangerously-skip-permissions로, Codex를 --yolo로 실행합니다 (즉, 명령어 실행 및 파일 편집을 프롬프트 없이 수행할 수 있음). 정상적인 권한 프롬프트가 필요하면 --safe 또는 AGENTBRIDGE_SAFE=1을 설정하세요.

일반적인 명령어

명령어	기능
`abg init`	종속성 확인, Claude 플러그인 등록, `.agentbridge/config.json` 작성
`abg claude [args]`	브리지 채널이 활성화된 상태로 Claude Code 시작 (필수 플래그 삽입)
`abg codex [args]`	브리지에 연결된 Codex TUI 시작; `abg codex --new`는 새 스레드 생성
`abg resume`	마지막 세션에 다시 연결하기 위해 필요한 명령어를 출력하거나 실행
`abg pairs`	여러 개의 Claude+Codex 쌍 목록 보기, 제거, 정리
`abg doctor`	읽기 전용 진단 (환경, 데몬 상태, 로그)
`abg budget`	각 어시스턴트의 구독 할당량 상태 표시
`abg kill`	데몬과 관리하는 모든 Codex TUI를 안전하게 종료
`abg dev`	개발자용 – 로컬 마켓플레이스 등록 및 플러그인 동기화 강제

누가 사용할 수 있을까

이미 Claude Code와 Codex에 접근 권한이 있는 단독 개발자로, 두 어시스턴트가 자동으로 협업하기를 원하는 사람.
다양한 LLM 제공업체 간의 다중 에이전트 코딩 워크플로우, 작업 분할, 또는 교차 검토를 탐구하는 연구자.
한 제공업체의 할당량이 만료되었을 때도 작업을 유지할 수 있는 방법이 필요한 팀으로, 장시간 코드 생성 작업을 수행하는 경우.

제한 사항 (명시적으로 언급됨)

로컬 전용 – 호스팅되거나 다중 테넌트 서비스가 아님.
두 개의 특정 에이전트(Claude Code와 Codex)만 지원함. 일반적인 오케스트레이션 프레임워크는 아님.
보안 경계가 최소화됨 – 브리지는 두 에이전트와 작업 공간을 신뢰한다고 가정함.

더 알아보기

웹사이트 및 데모: https://raysonmeng.github.io/agent-bridge/ (실제 세션의 애니메이션 재생)
문서: 리포지토리의 docs/ 폴더 – 매뉴얼, 문제 해결 가이드, 네트워크 간 "룸" 기능에 대한 세부 정보 포함.
커뮤니티 토론: LINUX DO 개발자 포럼 (README에 링크 있음).

TL;DR

AgentBridge는 가벼운 Bun 기반 데몬과 CLI로, Claude Code와 OpenAI Codex가 단일 개발 세션 내에서 대화하고, 작업을 분할하며, 서로의 출력을 검토할 수 있도록 해줍니다. 턴 조율, 할당량 이관, 메시지 필터링을 자동으로 처리합니다. 수동 복사-붙여넣기 없이 두 LLM 코딩 어시스턴트가 협업하고 싶은 개발자를 위한 도구입니다.