본문으로 건너뛰기
dopejs
전체 프로젝트

GoZen

출시됨

API 프록시 자동 페일오버를 갖춘 멀티 CLI 환경 전환기.

Claude Code, Codex, OpenCode의 환경을 한곳에서 전환하고, 상위 프로바이더가 불안정해져도 작업을 계속합니다 — GoZen이 API 트래픽을 프록시하고 자동으로 페일오버합니다.

개요

모든 API 설정은 `~/.zen/zen.json`에 모이고, 단일 `zend` 데몬이 프록시 서버와 비밀번호로 보호되는 웹 UI를 함께 호스팅합니다. 디렉터리를 특정 프로파일과 CLI에 바인딩할 수 있어, 프로젝트 폴더에서 `zen`만 입력하면 알맞은 클라이언트가 알맞은 프로바이더로 연결됩니다.

도입할 이유는 프록시에 있습니다. 요청은 thinking, image, long-context 같은 특성에 따라 라우팅되고, 주 프로바이더를 쓸 수 없으면 백업으로 넘어갑니다. 3버전에서는 프로바이더·모델·프로젝트별 토큰/비용 추적, 경고·다운그레이드·차단 동작이 있는 예산 한도, 프로바이더 헬스 체크, 여러 부하 분산 전략, 웹훅 알림이 추가되었습니다.

설정은 WebDAV, S3, GitHub Gist 또는 GitHub 저장소를 통해 기기 간 동기화할 수 있으며 AES-256-GCM으로 암호화됩니다. 웹 UI 토큰은 세션 인증 하에 RSA로 암호화되어 전송됩니다.

무엇을 하나

  • Claude Code, Codex, OpenCode를 하나의 전환기로 관리하며 디렉터리 바인딩으로 프로젝트별 설정 가능.
  • 백업 프로바이더로 자동 페일오버하는 내장 HTTP 프록시와 시나리오 라우팅(thinking, image, 긴 컨텍스트).
  • 프로바이더·모델·프로젝트별 사용량 및 비용 추적, 일/주/월 예산 한도.
  • 지연 시간과 오류율을 추적하는 프로바이더 헬스 모니터링. 페일오버, 라운드로빈, 최소 지연, 최소 비용 분산.
  • WebDAV, S3, GitHub Gist, GitHub 저장소를 통한 암호화 설정 동기화(AES-256-GCM).
  • Telegram, Discord, Slack, Lark, Messenger에서 Claude Code 세션을 모니터링하고 제어하는 봇 게이트웨이.
  • `zen upgrade`로 자체 업데이트하며 zsh / bash / fish 자동완성 제공.

시작하기

설치

curl -fsSL https://raw.githubusercontent.com/dopejs/gozen/main/install.sh | sh

첫 실행

zen config add provider && zen