터미널 CLI (pleum)
Claude Code, Aider, Codex 등 기존 코딩 에이전트를 PleumRouter에 한 줄로 연결합니다.
설치#
Node 18+ 환경에서 npx pleumrouter로 바로 실행할 수 있습니다. 전역 설치는 npm install -g pleumrouter.
# curl 원라이너 (npm 전역 설치를 감쌈)
curl -fsSL https://router.pleum.ai/install | sh
# 또는 패키지 매니저로
npm install -g pleumrouter
bun install -g pleumrouter
# 설치 없이 바로 실행
npx pleumrouter --help로그인#
브라우저가 자동으로 열리고, 로그인 후 "승인하고 연결"을 누르면 OAuth 세션 토큰이 ~/.pleum/config.json에 저장됩니다. API 키는 발급되지 않습니다.
# 브라우저 로그인 (기본)
npx pleumrouter login
# 브라우저 없는 환경 (SSH · CI)
npx pleumrouter login --device--device를 사용하세요. 8자리 코드가 표시되면 다른 기기 브라우저에서 router.pleum.ai/device에 접속해 입력합니다.에이전트 실행#
에이전트별 env 변수·config 파일을 CLI가 자동으로 설정합니다. Codex는 격리된 ~/.pleum/codex-home, Pi는 ~/.pleum/pi-home, Crush는 ~/.pleum/crush-home만 쓰며 사용자 홈 설정은 건드리지 않습니다.
# 인자 없이 실행 = 런처 메뉴 (↑↓·휠 이동, enter·클릭 실행, →·우클릭 모델 설정)
pleum
# Claude Code
pleum launch claude --model claude-sonnet-5
# Aider
pleum launch aider --model gpt-4.1
# Codex (Responses API 자동 설정, 격리 CODEX_HOME)
pleum launch codex --model gpt-4.1
# Gemini CLI (native generateContent, GOOGLE_GEMINI_BASE_URL 루트)
pleum launch gemini --model gemini-2.5-flash
# Antigravity CLI (agy). alias: antigravity
pleum launch agy --model gemini-2.5-flash
# Pi (picode is a Pi package). alias: picode
pleum launch pi --model gpt-5.4-mini
# omp (Oh My Pi). alias: ohmypi
pleum launch omp --model claude-sonnet-5
# Crush (격리 CRUSH_GLOBAL_CONFIG)
pleum launch crush
# Goose
pleum launch goose
# OpenHands
pleum launch openhands
# Codex (passthrough)
pleum launch codex --model gpt-4.1 -- --full-auto~/.gemini/antigravity-cli/settings.json에 modelProvider=gemini를 병합합니다. 별칭: antigravity→agy, picode→pi, ohmypi→omp. Kiro는 공식 BYOK가 없어 지원하지 않습니다.Desktop 배선#
Dock에서 며칠씩 켜 두는 앱은 로그인 JWT가 아니라 전용 plm_ 키가 필요합니다. pleum wire가 그 키를 발급해 사용자 ~/.claude/settings.json·~/.codex/config.toml에 병합합니다. launch는 세션용, wire는 Desktop용입니다. pleum logout은 이 키를 지우지 않습니다.
# Desktop / Dock — 사용자 ~/.claude · ~/.codex 에 전용 plm_ 키를 병합
pleum wire
pleum wire claude
pleum wire codex
# 설정만 되돌림 (키는 ~/.pleum/wire.json 에 남음)
pleum unwire
pleum unwire --revoke-key채팅 (REPL · 1회 실행 · 파이프)#
멀티턴 대화형 REPL은 물론, 프롬프트를 인자로 주거나 stdin으로 파이프하면 1회 실행되어 스크립트에 바로 쓸 수 있습니다. 모델을 생략하면 인터랙티브 선택 화면이 뜹니다. 응답 후 비용이 크레딧으로 표시됩니다.
# 대화형 REPL — 응답은 마크다운 스트리밍 렌더(굵게·코드블록·리스트)
pleum run gpt-4.1
pleum run # 모델 미지정 → 화살표(↑↓)로 선택
# 1회 실행 (스크립트 · 파이프 — 파이프면 자동으로 원문 그대로)
pleum run gpt-4.1 "한 줄로 요약: 트랜스포머란?"
cat error.log | pleum run gpt-4.1 "원인이 뭐야?"
# REPL 안에서: /help /model(화살표 선택) /system /clear /save /load /exit
# 생성 중 Ctrl+C = 중단(대화 유지) · 멀티라인은 """ · 이미지는 --attach 또는 @경로로 명시 첨부/help로 명령을 봅니다. /model <id>는 대화를 유지한 채 모델을 전환하고(여러 모델 비교), /system·/clear·/save·/load도 지원합니다. 여러 줄은 """로 감쌉니다. 이미지는 메시지에 경로를 쓰는 대신 --attach(또는 @경로)로 명시 첨부해야 업로드됩니다.모델 목록#
인증 없이 공개 모델 목록을 조회합니다. provider·컨텍스트 길이·1M 토큰당 가격(크레딧)을 함께 표시하며, --json으로 스크립트용 출력을 얻습니다. --info는 provider별 지연·처리량·업타임까지 담은 상세 뷰, pleum top은 라우터 전체 사용량 리더보드입니다.
pleum models # 전체 목록 (provider · 컨텍스트 · 가격 크레딧/1M)
pleum models claude # "claude" 포함된 모델만
pleum models gpt --json # JSON 출력 (스크립트 · jq 용)
pleum models <id> --info # 모델 상세 — provider별 지연·처리량·업타임, 주간 사용량
pleum top # 라우터 전체 리더보드 + 제공자 점유율 (--period daily|monthly)잔액 확인#
로그인 후 잔액·지출을 터미널에서 바로 봅니다. usage는 모델/일별 지출을 막대 차트로 보여줍니다 — 세션이 만료되면 pleum login을 다시 실행하세요.
pleum balance # 잔액: 12,500 크레딧 / $9.4231
pleum usage --by model --days 7 # 내 지출 리포트(막대 차트) — model|provider|api_key|day
pleum health # 공개 게이트웨이 상태·로그인 상태 점검유틸리티#
completion은 셸 자동완성 스크립트를 출력합니다(명령·모델명 탭 완성). upgrade는 npm으로 최신 버전을 재설치합니다.
pleum version # 버전 출력
pleum completion zsh # 셸 자동완성 스크립트 (>> ~/.zshrc)
pleum upgrade # 최신 버전으로 재설치셀프호스트 / 스테이징#
PLEUM_BASE_URL 환경변수로 게이트웨이 주소를 바꿀 수 있습니다.
PLEUM_BASE_URL=https://my-instance.example.com pleum launch claude