개요

CodexHost는 BytePioneer-AI가 만든 LGPL-3.0 오픈소스로, OpenAI Codex Desktop 안에서 다른 에이전트 하네스를 네이티브로 실행하게 한다. “Codex Desktop이 최고의 데스크톱 개발 경험이지만 하네스는 Codex만이 아니다”라는 전제에서 출발한다. README 배지 기준으로 Codex 외에 Pi, Oh My Pi, Claude Code, OpenCode, Grok, DeepSeek Harness, Antigravity CLI, Kiro, CodeBuddy, WorkBuddy, Cursor CLI, Hermes, Qoder, Kimi Code 14개를 지원한다. 2026-10-04 기준 별 2.7k, 최신 릴리스 v0.12.1. npm install -g @codexhost/cli && codexhost로 설치하며 macOS·Windows·Linux(x64/ARM64)를 지원한다.

무엇을 주나

  • 모든 하네스에 Codex Desktop의 Edit Diff, Fork, 메시지 편집, 슬래시 명령을 붙인다. 하네스가 달라도 세션은 한 사이드바에 모인다.
  • #으로 교차 위임: 입력창에서 #claude-code, #pi 등을 골라 독립 작업을 맡긴다. 대상 하네스에 별도 네이티브 세션이 생기고 대화 목록에 나타나며, 호출자는 결과를 기다리거나 백그라운드로 돌린다.
  • 서브에이전트 가시화, 캐시 적중률·비용 추정·컨텍스트 사용량 표시, 로컬 Codex·Grok 자격 증명을 Pi로 가져오기, Mermaid 렌더링.
  • 원격 하네스: SSH 워크스페이스에서 원격 머신에 codexhost remote install/start를 하면 작업은 원격에서, UI는 로컬에서 돈다. Windows용 Remote Control 경로는 실험 단계다.

동작 원리

  • 데스크톱: 공식 Codex Desktop을 CDP/Electron Inspector로 확장한다. 채팅 UI를 새로 만들거나 설치본을 패치하지 않는다.
  • 프로토콜: 공식 app-server 앞에 CLI Shim을 두고 네이티브 Codex 요청은 그대로 통과시킨다. app-server 구조는 2026-05-16-codex-app-server-runtime 참고.
  • 하네스 연결: 네이티브 인터페이스가 있으면 그것을 쓰고(Pi는 RPC, Claude Code는 Agent SDK), 없으면 ACP로 대체한다. 스트리밍·도구 상태·diff·승인·질문이 Codex 네이티브 UI에 그대로 그려진다.
  • 하네스 추가는 플러그인의 Manifest·factory·Adapter·Session 구현이 핵심이고, 저장소의 codexhost-add-harness 스킬을 에이전트에게 주면 된다. Paseo의 멀티 하네스 구조에서 영감을 받았다.

주의

  • 공식 앱을 런타임에 확장하는 방식이라 Codex Desktop 업데이트 때 깨질 수 있다. 문제가 생기면 codexhost console(127.0.0.1:4399)에서 원인을 본다.
  • README 상단에 API 중계 서비스 스폰서 광고가 있다.

codex 중심의 작업 환경에 Pi를 붙이는 맥락은 2026-09-10-pi-agent-workbench와 이어진다.

관련 위키