razzant/claudexor

Multi-harness control plane for Claude Code, Codex, Cursor, and OpenCode: quota-aware rotation across multiple Claude/Codex subscriptions, shared thread context, and cross-model review.

Claudexor – AI 기반 코딩 에이전트를 위한 로컬 우선 제어 플레인

무엇인가요 – Claudexor는 귀하의 머신에 설치되는 오픈소스 Node.js 애플리케이션으로, 이미 지불한 다양한 AI 코드 생성 도구(GitHub Codex, Anthropic Claude Code, Cursor CLI, OpenCode, Antigravity/Gemini 등)를 통합적으로 조율합니다. 각 공급업체의 네이티브 CLI 또는 API를 일관된 "채팅 턴" 모델로 변환하는 단일 타입 지정 API를 제공합니다.

읽기 전용 턴: 질문을 던지고 공급업체의 네이티브 응답을 받습니다.
쓰기 턴: 검토, 감사, 적용 가능한 검사 가능한 패치를 생성합니다.
Best-of-N 레이스: 여러 해서스가 경쟁적인 솔루션을 생성하고, 이를 교차 검토 및 중재합니다.
타입 지정된 사실(비용, 할당량, 인증, 웹 증거)은 모든 작업에 대해 기록되어 결정론적 감사 추적을 제공합니다.

이 모든 작업은 로컬에서 실행되며, 상태는 일반 파일에 저장되며 테레메트리가 전혀 전송되지 않습니다.

핵심 기능

기능	기능 설명
통합 인터페이스	하나의 `claudexor` CLI(또는 macOS 데스크톱 앱)로 지원되는 모든 공급업체와 상호작용 가능. 각 공급업체의 특수성에 대해 배울 필요 없음.
자격 증명 프로필	이름이 지정된 프로필로 여러 구독을 병렬로 유지 가능하며, 각각 고유의 할당량 추적과 격리된 상태를 가짐.
예산 및 할당량 회계	모든 요청은 정확한 비용과 남은 할당량을 로그에 기록. 알 수 없는 비용은 결코 `$0`으로 보고되지 않음.
Best-of-N 레이스 및 중재	동일한 작업을 여러 모델에서 실행하고 패치를 수집한 후, 구성 가능한 리뷰 패널이 최상의 결과를 선택.
결정론적 게이트 및 보호된 경로	`*/.env`, `migrations/**`와 같은 글로브를 정의하여 패치 적용 전 수동 승인이 필요하게 함.
원격 SSH 실행	macOS UI는 기존 `~/.ssh/config`로 접근 가능한 임의의 호스트에서 스레드를 시작할 수 있음. UI는 로컬에 유지되며, 무거운 작업은 원격에서 실행됨.
데몬 및 제어 API	백그라운드 데몬(`claudexord`)이 장시간 실행 작업, 이벤트 스트리밍, JSON-Over-HTTP 제어 표면을 처리하여 임베딩 호출자에 적합.
Ouroboros와의 통합	Claudexor는 Ouroboros 자기 개발 에이전트 내부의 실행 계층으로 사용 가능하며, 코드 변경의 지속적 증거를 제공.
숨겨진 테레메트리 없음	모든 데이터는 `~/.claudexor`(또는 프로젝트 워크스페이스)에 있으며, 상류로 전송되지 않음.

일반적인 워크플로우 (CLI 예제)

# CLI를 전역으로 설치
npm install -g claudexor
claudexor doctor   # 환경의 건전성 확인

# 간단한 읽기 전용 쿼리
claudexor ask "이 함수는 무엇을 반환합니까?"

# 특정 해서스(예: Codex)로 코딩 작업 실행
claudexor agent "실패하는 인증 리프레시 테스트 수정" --harness codex

# 두 모델로 레이스를 실행하고 가장 작은 패치 유지
claudexor best-of "add() 최적화" --harness codex,claude --n 2

# 생성된 실행 검사
claudexor inspect <run_id>

# 패치 적용 (먼저 드라이런)
claudexor apply <run_id> --dry-run

동일한 명령어는 그래픽적 macOS 앱에서도 사용 가능하며, 실시간 할당량 바, 스레드 목록, 인라인 아티팩트 미리보기도 제공됩니다.

설치 옵션

방법	세부 사항
npm (CLI + 데몬)	`npm install -g claudexor`로 `claudexor` 및 `claudexord` 바이너리 제공. macOS 및 Linux에서 작동.
macOS 앱	GitHub 릴리스 페이지에서 서명된 DMG를 다운로드하여 Applications 폴더로 드래그 앤 드롭. 앱은 자체 Node 런타임과 데몬을 번들로 제공하므로, 별도의 Node 설치는 번들 버전만 필요.
소스에서	리포지토리 복제 후 `pnpm install --frozen-lockfile && pnpm build` 실행. 빌드된 `packages/cli/dist/cli.js`를 진입점으로 사용.
원격 SSH	앱은 기존 `~/.ssh/config`로 접근 가능한 임의의 호스트에서 스레드를 시작할 수 있음. 자격 증명은 원격 호스트에 유지되며, UI 트래픽만 로컬로 터널링됨.

누구에게 적합한가요?

여러 AI 코딩 서비스에 구독하고 단일, 감사 가능한 워크플로우를 원하는 개인 개발자.
결정론적 비용 추적, 할당량 강제, 코드 머지 전 리뷰 게이트가 필요한 팀.
고수준 자율 시스템(예: Ouroboros 자기 개발 에이전트)을 구축하는 연구자/에이전트. 신뢰할 수 있는 로컬 호스팅 실행 계층이 필요.
모든 테레메트리를 거부하고 모든 상태를 디스크에 저장하고자 하는 보안 중심 사용자.

성숙도 및 안정성

현재 릴리스: v3.10.2.
프로젝트는 "2.0에서의 안정성" 계약을 정의: 핵심 동사와 모드 ID는 안정. experimental으로 표시된 것은 변경 가능.
서명된 런타임 매니페스트로 공급망 공격 방지. 서명되지 않거나 변조된 업데이트는 거부.
원격 호스트 부트스트랩은 v3.7까지 지원. v3.8~v3.9.7은 서명 문서 누락으로 인해 새 DMG가 필요.
Windows는 공식적으로 지원되지 않음(로컬 해서스 설치 프로그램은 Windows에서 타입 지원되지 않음).

프라이버시 및 데이터 주권

모든 파일(실행 로그, 패치, 할당량 기록, 시크릿)은 ~/.claudexor 또는 프로젝트 워크스페이스 내에 저장.
백그라운드 테레메트리 없음. 네트워크 트래픽은 명시적으로 구성한 공급업체 API로만.
시크릿(API 키, OAuth 토큰)은 플랫폼의 네이티브 시크릿 저장 규칙에 따라 저장되며, 로그에 평문으로 기록되지 않음.

빠른 링크

웹사이트: https://claudexor.ai/
문서: docs/ARCHITECTURE.md, docs/AGENT_ONBOARDING.md, docs/FEATURES.md
GitHub: https://github.com/razzant/claudexor
npm 패키지: https://www.npmjs.com/package/claudexor

요약

Claudexor는 여러 상용 AI 코딩 서비스를 하나의 감사 가능하고 로컬 호스팅된 플랫폼으로 다룰 수 있는 진정한 프로덕션 대응 도구입니다. 공급업체의 CLI 위에 예산 관리, 다중 모델 레이스, 리뷰 중재, 엄격한 파일 기반 상태 관리를 추가하여 AI 지원 개발을 더 예측 가능하고 안전하게 만듭니다.