Skip to content
PleumRouter
始める

ターミナル CLI（pleum）

Claude Code、Aider、Codex などのコーディングエージェントを1コマンドで PleumRouter に接続します。

インストール

npx pleumrouter（Node 18+）でそのまま実行、またはグローバルインストール: 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 変数・設定ファイルを CLI が自動でセットします。ANTHROPIC_BASE_URL や TOML を手動で変更する必要はありません。

bash
# 인자 없이 실행 = 런처 메뉴 (↑↓·휠 이동, enter·클릭 실행, →·우클릭 모델 설정)
pleum

# 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 · 単発 · パイプ）

マルチターンの対話型 REPL に加え、プロンプトを引数で渡すか stdin でパイプすると 1 回だけ実行され、スクリプトにそのまま使えます。モデルを省略するとインタラクティブな選択画面が表示されます。応答後にクレジットでコストが表示されます。

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(화살표 선택)  /system  /clear  /save  /load  /exit
# 생성 중 Ctrl+C = 중단(대화 유지) · 멀티라인은 """ · 이미지 경로 넣으면 멀티모달
REPL 内では /help でコマンド一覧を表示します。/model <id> は 会話を保ったままモデルを切り替え（複数モデルの比較）でき、/system・/clear・/save・/load にも対応します。複数行は """ で囲み、メッセージに画像パスを含めるとマルチモーダルで送信されます。

モデル一覧

認証なしで公開モデルカタログを参照できます。プロバイダー・コンテキスト長・100 万トークンあたりの価格を表示し、--json でスクリプト向けの出力が得られます。--info はプロバイダー別のレイテンシ・スループット・稼働率まで含む詳細ビュー、pleum top はルーター全体の利用ランキングです。

bash
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 はモデル別/日別支出を棒グラフで表示し、新しいログインキー（usage:read 付き）が必要です — 403 が出たら pleum login を再実行してください。

bash
pleum balance                    # 잔액: 12,500 크레딧 / $9.4231
pleum usage --by model --days 7  # 내 지출 리포트(막대 차트) — model|provider|api_key|day
pleum health                     # 게이트웨이 연결·DB·환율·로그인 상태 점검

ユーティリティ

completion はシェル補完スクリプトを出力します（コマンドとモデル名を補完）。upgrade は npm で最新版を再インストールします。

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

セルフホスト / ステージング

PLEUM_BASE_URL 環境変数でゲートウェイ URL を上書きできます。

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