Skip to content
PleumRouter

터미널 CLI (pleum)

Claude Code, Aider, Codex 등 기존 코딩 에이전트를 PleumRouter에 한 줄로 연결합니다.

설치

Node 18+ 환경에서 npx pleumrouter로 바로 실행할 수 있습니다. 전역 설치는 npm install -g pleumrouter.

bash
# curl 원라이너 (npm 전역 설치를 감쌈)
curl -fsSL https://router.pleum.ai/install | sh

# 또는 패키지 매니저로
npm install -g pleumrouter
bun install -g pleumrouter

# 설치 없이 바로 실행
npx pleumrouter --help

로그인

브라우저가 자동으로 열리고, 로그인 후 "승인하고 연결" 버튼을 누르면 API 키가 ~/.pleum/config.json에 저장됩니다.

bash
# 브라우저 로그인 (기본)
npx pleumrouter login

# 브라우저 없는 환경 (SSH · CI)
npx pleumrouter login --device
SSH 서버·CI 환경처럼 브라우저를 열 수 없을 때 --device를 사용하세요. 8자리 코드가 표시되면 다른 기기 브라우저에서 router.pleum.ai/device에 접속해 입력합니다.

에이전트 실행

에이전트별 env 변수·config 파일을 CLI가 자동으로 설정합니다. 직접 ANTHROPIC_BASE_URL이나 TOML을 수정할 필요 없습니다.

bash
# Claude Code
pleum launch claude --model claude-sonnet-4

# Aider
pleum launch aider --model gpt-4.1

# Codex (Responses API 자동 설정)
pleum launch codex --model gpt-4.1

# Goose
pleum launch goose

# OpenHands
pleum launch openhands

# -- 이후 인자는 도구로 그대로 전달
pleum launch codex --model gpt-4.1 -- --full-auto
opencode·crush는 프로젝트 로컬 파일로 provider를 정의해야 합니다. pleum launch opencode를 실행하면 설정 스니펫을 안내합니다.

채팅 (REPL · 1회 실행 · 파이프)

멀티턴 대화형 REPL은 물론, 프롬프트를 인자로 주거나 stdin으로 파이프하면 1회 실행되어 스크립트에 바로 쓸 수 있습니다. 모델을 생략하면 인터랙티브 선택 화면이 뜹니다. 응답 후 비용이 PLM으로 표시됩니다.

bash
# 대화형 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 <id>  /system  /clear  /save  /load  /exit
# 멀티라인은 """ 로 감싸고, 이미지 경로를 메시지에 넣으면 멀티모달로 전송
REPL 안에서 /help로 명령을 봅니다. /model <id>는 대화를 유지한 채 모델을 전환하고(여러 모델 비교), /system·/clear·/save·/load도 지원합니다. 여러 줄은 """로 감싸고, 메시지에 이미지 경로를 넣으면 멀티모달로 전송됩니다.

모델 목록

인증 없이 공개 모델 목록을 조회합니다. provider·컨텍스트 길이·1M 토큰당 가격(₩)을 함께 표시하며, --json으로 스크립트용 출력을 얻습니다.

bash
pleum models              # 전체 목록 (provider · 컨텍스트 · 가격 ₩/1M)
pleum models claude       # "claude" 포함된 모델만
pleum models gpt --json   # JSON 출력 (스크립트 · jq 용)

잔액 확인

로그인 후 현재 크레딧 잔액을 조회합니다.

bash
pleum balance
# 잔액: 12,500 PLM / $9.4231

유틸리티

completion은 셸 자동완성 스크립트를 출력합니다(명령·모델명 탭 완성). upgrade는 npm으로 최신 버전을 재설치합니다.

bash
pleum version             # 버전 출력
pleum completion zsh      # 셸 자동완성 스크립트 (>> ~/.zshrc)
pleum upgrade             # 최신 버전으로 재설치

셀프호스트 / 스테이징

PLEUM_BASE_URL 환경변수로 게이트웨이 주소를 바꿀 수 있습니다.

bash
PLEUM_BASE_URL=https://my-instance.example.com pleum launch claude