BytePioneer-AI/codex-host

Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。

CodexHost – Codex Desktop 내에서 여러 AI 에이전트 하니스 실행

개요

공식 Codex Desktop IDE 내에서 여러 AI 코딩 어시스턴트(Pi, Claude Code, Grok 등)를 실행할 수 있는 데스크톱 확장 프로그램입니다.
각 어시스턴트는 하니스라고 하며 별도 세션으로 표시되지만 프로젝트 사이드바, diff 보기, 채팅 UI는 공유합니다.

주요 기능

기능	설명
에이전트 간 협업	채팅에서 `#`를 입력하여 작업을 다른 하니스(예: `#pi` 또는 `#claude-code`)에 위임할 수 있습니다. 대상은 자체 네이티브 세션에서 실행되는 동안 동일한 작업 공간에 머무릅니다.
통합 diff 및 포크 UI	모든 응답에서 코드 변경 diff를 표시할 수 있으며, 어떤 메시지에서든 브랜치나 새 워크트리를 포크할 수 있습니다.
도구 호출 표시	편집이나 명령을 확장하여 기본 도구 호출, 추론 단계, 토큰 사용량을 확인할 수 있습니다.
원격 하니스	SSH(또는 실험적 Windows 원격 제어)를 통해 원격 VPS에서 하니스를 실행하고 UI는 로컬 머신에 유지합니다.
실시간 사용 통계	토큰 수, 캐시 적중률, 비용 추정치가 앱 내에 표시됩니다.
원클릭 계정 가져오기	로컬에 로그인된 Codex/Grok 자격 증명을 Pi와 같은 다른 하니스로 가져와 할당량 정보를 동기화합니다.
Mermaid 다이어그램 렌더링	일부 에이전트의 일반 텍스트 TUI와 달리 다이어그램이 데스크톱 UI에 직접 렌더링됩니다.

시작 방법

npm으로 설치(npm install -g @codexhost/cli)하거나 Releases 페이지에서 플랫폼별 설치 프로그램을 다운로드합니다.
codexhost를 실행합니다(최신 상태 유지는 codexhost update). CLI는 호스트 레이어가 연결된 Codex Desktop을 시작합니다.
IDE 내에서 오른쪽 하단의 에이전트 선택기를 열고 지원되는 하니스를 선택합니다. #를 사용하여 전환하거나 작업을 위임합니다.

지원 하니스(README 기준)

Pi(및 Oh My Pi 플러그인)
Claude Code
OpenCode
Grok
DeepSeek 하니스
Antigravity CLI
CodeBuddy, WorkBuddy, Cursor, Hermes, Qoder, Kimi Code 등. 모두 스트리밍 응답, 도구 상태, 편집 diff, 슬래시 명령, 에이전트 간 작업 핸드오프와 같은 핵심 기능을 제공합니다.

기술 개요

호스트는 Codex Desktop의 네이티브 서버와 하니스 플러그인 사이에 CLI 셰임을 주입합니다.
각 하니스는 작은 어댑터로 래핑됩니다(Pi는 RPC, Claude Code는 Agent SDK, 기타는 일반 ACP 프로토콜 사용).
UI는 다시 빌드되지 않습니다. CodexHost는 CDP/Electron Inspector를 통해 기존 Electron 기반 데스크톱을 확장하므로 공식적인 모양과 느낌을 유지합니다.
원격 실행은 원격 머신에 동일한 codexhost 바이너리를 설치하고 '원격' 서비스를 시작한 후 SSH로 연결하여 작동합니다.

대상 사용자

커뮤니티 및 기여

도움말과 토론을 위해 WeChat 그룹이 제공됩니다.
기여를 환영합니다. 저장소에는 새 하니스 어댑터 추가 가이드와 플러그인 스캐폴딩에 도움이 되는 스킬(codexhost-add-harness)이 포함되어 있습니다.

결론 CodexHost는 Codex Desktop 환경 내에서 많은 AI 코딩 에이전트를 통합하는 진정하고 기능이 풍부한 통합 레이어로, LLM 기반 코드 어시스턴트를 사용하는 개발자에게 매끄럽고 협업적인 워크플로를 제공합니다.