bizrouter 0.1.0

package/README.md

@@ -0,0 +1,50 @@
+# bizrouter CLI
+
+쓰던 코딩 에이전트를 그대로 두고, 명령 앞에 `bizrouter` 만 붙이면 BizRouter 로 연결됩니다.
+
+```bash
+npm install -g bizrouter        # 또는: curl -fsSL https://bizrouter.ai/install.sh | bash
+bizrouter login                 # 브라우저에서 API 키를 발급받아 붙여 넣습니다 (한 번만)
+bizrouter claude                # Claude Code
+bizrouter codex                 # Codex CLI
+bizrouter opencode              # OpenCode
+bizrouter hermes                # Hermes
+```
+
+설치 없이 바로 써 볼 수도 있습니다: `npx bizrouter claude`
+
+## 무엇을 해 주나
+
+| 도구 | 실행 시 하는 일 | 설정 파일 변경 |
+| --- | --- | --- |
+| Claude Code | `ANTHROPIC_BASE_URL=https://api.bizrouter.ai/claude`, 토큰, 빈 `ANTHROPIC_API_KEY`, 모델 선택창 자동 채움(`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`)을 넘기고, 사용자 settings.json 의 다른 게이트웨이 설정이 이기지 못하도록 명령행 settings 로 고정 | 없음 |
+| Codex CLI | `-c` 오버라이드로 BizRouter provider(Responses API)와 모델·추론 강도 지정 | 없음 |
+| OpenCode | `OPENCODE_CONFIG_CONTENT` 로 이 키가 쓸 수 있는 모델 전체가 담긴 `bizrouter` provider 를 주입 | 없음 |
+| Hermes | `custom` provider(`CUSTOM_BASE_URL`/`CUSTOM_API_KEY`)와 모델을 이번 실행에만 지정 | 없음 |
+
+우리 옵션 뒤의 인자는 도구에 그대로 전달됩니다.
+
+```bash
+bizrouter claude --model anthropic/claude-opus-5 -p "실패하는 테스트 고쳐줘"
+bizrouter codex --model openai/gpt-5.5 --reasoning-effort high exec "README 요약해줘"
+bizrouter opencode --model google/gemini-3.5-pro
+bizrouter claude --dry-run          # 실행 대신 넘겨줄 환경 변수와 명령을 보여줍니다
+```
+
+## 관리 명령
+
+```bash
+bizrouter models [검색어]        # 이 키로 쓸 수 있는 모델·컨텍스트·원화 단가
+bizrouter doctor                 # 키·연결·설치·충돌 점검
+bizrouter setup claude|codex|opencode   # 도구 설정 파일에 BizRouter 를 영구 등록 (백업 생성)
+bizrouter auth / logout / env / update
+```
+
+`BIZROUTER_API_KEY` 환경 변수가 있으면 저장된 키보다 우선합니다(CI·컨테이너). 설정은 `~/.bizrouter/`(`BIZROUTER_CONFIG_DIR` 로 변경) 에 권한 600 으로 저장됩니다.
+
+## 알아둘 것
+
+- Claude Code 는 Anthropic 전용 필드(`thinking`, `cache_control`)를 항상 보내므로 Claude 모델만 실행할 수 있습니다. GPT·Gemini 는 Codex·OpenCode·Hermes 로 실행하세요.
+- 요구 사항: Node.js 18 이상. 각 코딩 에이전트는 따로 설치돼 있어야 합니다.
+
+문서: https://bizrouter.ai/docs/cli

package/dist/api.js

@@ -0,0 +1,81 @@
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { apiBase, ensureCacheDir, readJsonFile, writePrivateJson } from './config.js';
+import { CliError } from './ui.js';
+const CACHE_TTL_MS = 10 * 60 * 1000;
+const REQUEST_TIMEOUT_MS = 8000;
+function keyHash(apiKey) {
+    return createHash('sha256').update(apiKey).digest('hex').slice(0, 16);
+}
+function cachePath(apiKey) {
+    return join(ensureCacheDir(), `models-${keyHash(apiKey)}.json`);
+}
+export class ApiError extends CliError {
+    status;
+    constructor(status, message, hint) {
+        super(message, { hint });
+        this.status = status;
+    }
+}
+async function requestJson(path, apiKey) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    let response;
+    try {
+        response = await fetch(`${apiBase()}${path}`, {
+            headers: { Authorization: `Bearer ${apiKey}`, 'User-Agent': 'bizrouter-cli' },
+            redirect: 'manual',
+            signal: controller.signal,
+        });
+    }
+    catch (error) {
+        const reason = error instanceof Error && error.name === 'AbortError' ? '응답이 8초 안에 오지 않았습니다' : String(error);
+        throw new CliError(`BizRouter API(${apiBase()})에 연결할 수 없습니다: ${reason}`, {
+            hint: '네트워크나 프록시 설정을 확인하세요. 사내망이면 api.bizrouter.ai 로 나가는 HTTPS 가 열려 있어야 합니다.',
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (response.status === 401 || response.status === 403) {
+        throw new ApiError(response.status, 'API 키가 유효하지 않습니다.', '`bizrouter login` 으로 키를 다시 저장하세요.');
+    }
+    if (!response.ok) {
+        throw new ApiError(response.status, `BizRouter API 가 ${response.status} 를 돌려주었습니다.`);
+    }
+    return response.json();
+}
+/**
+ * Load the model catalog the API key may use. Results are cached for ten
+ * minutes per key so that launching a harness does not wait on the network
+ * every time; `force` bypasses the cache.
+ */
+export async function fetchCatalog(apiKey, options = {}) {
+    const path = cachePath(apiKey);
+    const cached = readJsonFile(path);
+    const fresh = cached && Date.now() - Date.parse(cached.fetched_at) < CACHE_TTL_MS;
+    if (cached && fresh && !options.force) {
+        return { models: cached.models, exchange_rate: cached.exchange_rate, fetched_at: cached.fetched_at, from_cache: true };
+    }
+    try {
+        const body = (await requestJson('/v1/models', apiKey));
+        const models = Array.isArray(body.models) ? body.models : [];
+        const exchange_rate = Number(body.exchange_rate ?? 0);
+        const fetched_at = new Date().toISOString();
+        writePrivateJson(path, { key_hash: keyHash(apiKey), fetched_at, models, exchange_rate });
+        return { models, exchange_rate, fetched_at, from_cache: false };
+    }
+    catch (error) {
+        if (cached && options.allowStale && !(error instanceof ApiError && (error.status === 401 || error.status === 403))) {
+            return { models: cached.models, exchange_rate: cached.exchange_rate, fetched_at: cached.fetched_at, from_cache: true };
+        }
+        throw error;
+    }
+}
+/** Chat-capable, text-producing models: what a coding agent can actually drive. */
+export function chatModels(models) {
+    return models.filter((m) => (m.api_type === 'chat_completions' || m.api_type === 'responses') && m.output_modalities.includes('text'));
+}
+export function findModel(models, id) {
+    return models.find((m) => m.id === id);
+}

package/dist/args.js

@@ -0,0 +1,64 @@
+export const REASONING_EFFORTS = ['max', 'xhigh', 'high', 'medium', 'low', 'minimal', 'none'];
+export class ArgError extends Error {
+}
+/**
+ * Parse launcher flags. Like Ori, our own flags come first; the first token we
+ * do not recognise (or `--`) ends our parsing and everything after it goes to
+ * the harness untouched, so `bizrouter claude -p "hi"` still works.
+ */
+export function parseLaunchArgs(argv) {
+    const out = { closedNetwork: false, dryRun: false, help: false, passthrough: [] };
+    let i = 0;
+    const takeValue = (flag) => {
+        const value = argv[i + 1];
+        if (value === undefined || value.startsWith('-'))
+            throw new ArgError(`${flag} 뒤에 값이 필요합니다.`);
+        i += 2;
+        return value;
+    };
+    while (i < argv.length) {
+        const token = argv[i];
+        if (token === '--') {
+            out.passthrough.push(...argv.slice(i + 1));
+            return out;
+        }
+        const eq = token.indexOf('=');
+        const name = token.startsWith('--') && eq > 0 ? token.slice(0, eq) : token;
+        const inline = token.startsWith('--') && eq > 0 ? token.slice(eq + 1) : undefined;
+        const value = (flag) => (inline !== undefined ? ((i += 1), inline) : takeValue(flag));
+        switch (name) {
+            case '--model':
+            case '-m':
+                out.model = value(name);
+                continue;
+            case '--reasoning-effort': {
+                const v = value(name);
+                if (!REASONING_EFFORTS.includes(v)) {
+                    throw new ArgError(`--reasoning-effort 값은 ${REASONING_EFFORTS.join(', ')} 중 하나여야 합니다.`);
+                }
+                out.reasoningEffort = v;
+                continue;
+            }
+            case '--closed-network':
+                out.closedNetwork = true;
+                i += 1;
+                continue;
+            case '--dry-run':
+                out.dryRun = true;
+                i += 1;
+                continue;
+            case '--help':
+            case '-h':
+                out.help = true;
+                i += 1;
+                continue;
+            default:
+                out.passthrough.push(...argv.slice(i));
+                return out;
+        }
+    }
+    return out;
+}
+export function hasFlag(args, ...flags) {
+    return args.some((a) => flags.some((f) => a === f || a.startsWith(`${f}=`)));
+}

package/dist/browser.js

@@ -0,0 +1,18 @@
+import { spawn } from 'node:child_process';
+/** Best-effort browser open; returns false when nothing could be started. */
+export function openInBrowser(url) {
+    const [cmd, args] = process.platform === 'darwin'
+        ? ['open', [url]]
+        : process.platform === 'win32'
+            ? ['cmd', ['/c', 'start', '', url]]
+            : ['xdg-open', [url]];
+    try {
+        const child = spawn(cmd, args, { stdio: 'ignore', detached: true });
+        child.on('error', () => undefined);
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/catalog.js

@@ -0,0 +1,44 @@
+import { chatModels } from './api.js';
+/** Used when the catalog cannot be reached and the user pinned nothing. */
+export const FALLBACK_DEFAULT = {
+    codex: 'openai/gpt-5.5',
+    opencode: 'anthropic/claude-sonnet-5',
+    hermes: 'anthropic/claude-sonnet-5',
+};
+export function isAnthropicModelId(id) {
+    return /claude|anthropic/i.test(id);
+}
+/**
+ * Pick a sensible default model per harness from the models this key may use.
+ * Claude Code keeps its own alias defaults (sonnet/opus), so it returns
+ * undefined and lets the family mapping on the gateway decide.
+ */
+export function pickDefaultModel(harness, models) {
+    if (harness === 'claude')
+        return undefined;
+    const chat = chatModels(models);
+    const ids = chat.map((m) => m.id);
+    const first = (pred) => ids.find(pred);
+    if (harness === 'codex') {
+        return (first((id) => id.startsWith('openai/') && /codex/i.test(id)) ??
+            first((id) => id.startsWith('openai/gpt-')) ??
+            first(isAnthropicModelId) ??
+            ids[0]);
+    }
+    return (first((id) => id === 'anthropic/claude-sonnet-5') ??
+        first((id) => id.startsWith('anthropic/claude-sonnet')) ??
+        first(isAnthropicModelId) ??
+        first((id) => id.startsWith('openai/gpt-')) ??
+        ids[0]);
+}
+/** Return the closest catalog ids for an unknown id, for error hints. */
+export function suggestModels(models, wanted, limit = 5) {
+    const needle = wanted.toLowerCase().split('/').pop() ?? wanted.toLowerCase();
+    const tokens = needle.split(/[-_.\s]+/).filter(Boolean);
+    return chatModels(models)
+        .map((m) => ({ id: m.id, score: tokens.filter((t) => m.id.toLowerCase().includes(t)).length }))
+        .filter((x) => x.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit)
+        .map((x) => x.id);
+}

package/dist/commands/doctor.js

@@ -0,0 +1,117 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { fetchCatalog, chatModels } from '../api.js';
+import { apiBase, ENV_KEY_NAME, HARNESSES, resolveCredential } from '../config.js';
+import { binaryVersion } from '../spawn.js';
+import { c, maskKey, print } from '../ui.js';
+import { claudeSettingsPath, codexConfigPath, opencodeConfigPath } from './setup.js';
+const ICON = { ok: c.green('✔'), warn: c.yellow('⚠'), fail: c.red('✖') };
+async function probe(url, apiKey) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 6000);
+    try {
+        const started = Date.now();
+        const res = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` }, redirect: 'manual', signal: controller.signal });
+        return `${res.status} (${Date.now() - started}ms)`;
+    }
+    catch (error) {
+        return `연결 실패: ${error instanceof Error ? (error.name === 'AbortError' ? '6초 초과' : error.message) : String(error)}`;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Environment and config that would override what the launchers set. */
+export function conflictFindings(env, files) {
+    const findings = [];
+    const base = apiBase();
+    if (env.ANTHROPIC_API_KEY) {
+        findings.push({
+            level: 'warn',
+            text: `ANTHROPIC_API_KEY 가 셸에 설정돼 있습니다 (${maskKey(env.ANTHROPIC_API_KEY)}).`,
+            hint: '`bizrouter claude` 는 실행 시 빈 값으로 덮어쓰므로 동작에는 문제가 없지만, `claude` 를 직접 실행하면 Anthropic 으로 바로 갑니다.',
+        });
+    }
+    if (env.ANTHROPIC_BASE_URL && !env.ANTHROPIC_BASE_URL.startsWith(base)) {
+        findings.push({ level: 'warn', text: `ANTHROPIC_BASE_URL 이 다른 주소를 가리킵니다: ${env.ANTHROPIC_BASE_URL}`, hint: '`bizrouter claude` 는 이 값을 덮어씁니다.' });
+    }
+    if (env.OPENAI_BASE_URL) {
+        findings.push({ level: 'warn', text: `OPENAI_BASE_URL 이 설정돼 있습니다: ${env.OPENAI_BASE_URL}`, hint: 'Codex 는 provider 설정이 우선이라 영향이 없지만, 다른 도구가 이 값을 읽을 수 있습니다.' });
+    }
+    if (files.claudeSettings) {
+        try {
+            const parsed = JSON.parse(files.claudeSettings);
+            const keys = Object.keys(parsed.env ?? {}).filter((k) => k.startsWith('ANTHROPIC_') || k.startsWith('CLAUDE_CODE_'));
+            const foreignBase = parsed.env?.ANTHROPIC_BASE_URL && !parsed.env.ANTHROPIC_BASE_URL.startsWith(base);
+            if (foreignBase) {
+                findings.push({
+                    level: 'warn',
+                    text: `Claude Code settings.json 의 env 가 다른 게이트웨이를 가리킵니다: ${parsed.env?.ANTHROPIC_BASE_URL}`,
+                    hint: '`bizrouter claude` 는 명령행 settings 로 덮어쓰지만, `claude` 단독 실행은 그 주소로 갑니다. `bizrouter setup claude` 로 갈아탈 수 있습니다.',
+                });
+            }
+            else if (keys.length) {
+                findings.push({ level: 'ok', text: `Claude Code settings.json 에 env ${keys.length}개가 있고 BizRouter 와 충돌하지 않습니다.` });
+            }
+        }
+        catch {
+            findings.push({ level: 'warn', text: 'Claude Code settings.json 을 JSON 으로 읽을 수 없습니다.', hint: 'Claude Code 자체도 이 파일을 못 읽습니다. 문법을 확인하세요.' });
+        }
+    }
+    if (files.codexConfig) {
+        const provider = /^\s*model_provider\s*=\s*"([^"]+)"/m.exec(files.codexConfig)?.[1];
+        if (provider && provider !== 'bizrouter') {
+            findings.push({ level: 'ok', text: `Codex config.toml 의 기본 provider 는 "${provider}" 입니다.`, hint: '`bizrouter codex` 는 -c 로 덮어쓰므로 그대로 두어도 됩니다. `codex` 단독으로도 BizRouter 를 쓰려면 `bizrouter setup codex`.' });
+        }
+    }
+    return findings;
+}
+export async function doctorCommand() {
+    const findings = [];
+    const nodeMajor = Number(process.versions.node.split('.')[0]);
+    findings.push(nodeMajor >= 18
+        ? { level: 'ok', text: `Node.js ${process.versions.node}` }
+        : { level: 'fail', text: `Node.js ${process.versions.node} — 18 이상이 필요합니다.` });
+    const cred = resolveCredential();
+    if (cred.source === 'none') {
+        findings.push({ level: 'fail', text: '인증 정보가 없습니다.', hint: `\`bizrouter login\` 또는 ${ENV_KEY_NAME} 환경 변수.` });
+    }
+    else {
+        const where = cred.source === 'env' ? `환경 변수 ${ENV_KEY_NAME}` : `저장 파일 ${cred.path}`;
+        findings.push({ level: 'ok', text: `인증 출처: ${where} · ${maskKey(cred.apiKey ?? '')}` });
+        try {
+            const catalog = await fetchCatalog(cred.apiKey ?? '', { force: true });
+            findings.push({ level: 'ok', text: `키 유효 · 사용 가능한 채팅 모델 ${chatModels(catalog.models).length}개 (전체 ${catalog.models.length}개)` });
+        }
+        catch (error) {
+            findings.push({ level: 'fail', text: error instanceof Error ? error.message : String(error) });
+        }
+        const base = apiBase();
+        findings.push({ level: 'ok', text: `GET ${base}/v1/models → ${await probe(`${base}/v1/models?limit=1`, cred.apiKey ?? '')}` });
+        const claudeModels = await probe(`${base}/claude/v1/models?limit=1`, cred.apiKey ?? '');
+        findings.push(claudeModels.startsWith('200')
+            ? { level: 'ok', text: `GET ${base}/claude/v1/models → ${claudeModels} (Claude Code /model 선택창 자동 채움)` }
+            : { level: 'warn', text: `GET ${base}/claude/v1/models → ${claudeModels}`, hint: 'Claude Code 의 /model 선택창이 내장 목록으로만 채워집니다.' });
+    }
+    for (const h of HARNESSES) {
+        const version = binaryVersion(h);
+        findings.push(version ? { level: 'ok', text: `${label(h)}: ${version}` } : { level: 'warn', text: `${label(h)}: 설치되어 있지 않습니다.` });
+    }
+    const claudeSettings = existsSync(claudeSettingsPath()) ? readFileSync(claudeSettingsPath(), 'utf8') : undefined;
+    const codexConfig = existsSync(codexConfigPath()) ? readFileSync(codexConfigPath(), 'utf8') : undefined;
+    findings.push(...conflictFindings(process.env, { claudeSettings, codexConfig }));
+    if (existsSync(opencodeConfigPath())) {
+        findings.push({ level: 'ok', text: `OpenCode 설정 파일: ${opencodeConfigPath()}` });
+    }
+    for (const f of findings) {
+        print(`${ICON[f.level]} ${f.text}`);
+        if (f.hint)
+            print(`   ${c.dim(f.hint)}`);
+    }
+    const failed = findings.some((f) => f.level === 'fail');
+    print();
+    print(failed ? c.red('해결해야 할 항목이 있습니다.') : c.green('BizRouter 연결 준비가 끝났습니다.'));
+    return failed ? 1 : 0;
+}
+function label(h) {
+    return { claude: 'Claude Code (claude)', codex: 'Codex CLI (codex)', opencode: 'OpenCode (opencode)', hermes: 'Hermes (hermes)' }[h];
+}

package/dist/commands/login.js

@@ -0,0 +1,97 @@
+import { openInBrowser } from '../browser.js';
+import { fetchCatalog, chatModels } from '../api.js';
+import { ENV_KEY_NAME, KEYS_PAGE_PATH, consoleUrl, credentialsPath, looksLikeApiKey, resolveCredential, saveCredential, clearCredential, } from '../config.js';
+import { readSecret } from '../prompt.js';
+import { c, CliError, fail, info, maskKey, ok, print, warn } from '../ui.js';
+export function parseLoginFlags(argv) {
+    const flags = { withKey: false, noBrowser: false };
+    for (const a of argv) {
+        if (a === '--with-key')
+            flags.withKey = true;
+        else if (a === '--no-browser')
+            flags.noBrowser = true;
+        else if (a === '-h' || a === '--help')
+            continue;
+        else
+            throw new CliError(`알 수 없는 옵션입니다: ${a}`, { hint: '사용법: bizrouter login [--with-key] [--no-browser]' });
+    }
+    return flags;
+}
+export async function loginCommand(argv) {
+    const flags = parseLoginFlags(argv);
+    const keysUrl = `${consoleUrl()}${KEYS_PAGE_PATH}`;
+    const current = resolveCredential();
+    if (current.source === 'env') {
+        warn(`${ENV_KEY_NAME} 환경 변수가 설정돼 있어 저장된 키보다 우선합니다 (${maskKey(current.apiKey ?? '')}).`);
+    }
+    if (!flags.withKey) {
+        print(`${c.bold('BizRouter 에 로그인합니다.')}`);
+        print(`1. 브라우저에서 API 키 페이지를 엽니다: ${c.cyan(keysUrl)}`);
+        print('2. 「API 키 만들기」로 키를 발급하거나 기존 키를 복사합니다.');
+        print('3. 아래에 키를 붙여 넣습니다. 입력한 글자는 화면에 보이지 않습니다.');
+        print();
+        if (!flags.noBrowser) {
+            if (!openInBrowser(keysUrl))
+                info('브라우저를 자동으로 열 수 없어 주소만 표시합니다.');
+        }
+    }
+    const entered = await readSecret(`API 키 (${c.dim('sk-br-v1-…')}): `);
+    if (!entered)
+        throw new CliError('키가 입력되지 않았습니다.');
+    if (!looksLikeApiKey(entered)) {
+        throw new CliError('BizRouter API 키 형식이 아닙니다. 키는 sk-br- 로 시작합니다.', {
+            hint: `${keysUrl} 에서 발급한 키를 그대로 붙여 넣으세요.`,
+        });
+    }
+    info('키를 확인하는 중…');
+    try {
+        const catalog = await fetchCatalog(entered, { force: true });
+        const path = saveCredential(entered);
+        ok(`키를 저장했습니다: ${path} (권한 600)`);
+        ok(`이 키로 쓸 수 있는 모델 ${chatModels(catalog.models).length}개를 확인했습니다.`);
+        print();
+        print(`이제 바로 실행할 수 있습니다:`);
+        print(`  ${c.bold('bizrouter claude')}     Claude Code`);
+        print(`  ${c.bold('bizrouter codex')}      Codex CLI`);
+        print(`  ${c.bold('bizrouter opencode')}   OpenCode`);
+        print(`  ${c.bold('bizrouter hermes')}     Hermes`);
+        return 0;
+    }
+    catch (error) {
+        fail(error instanceof Error ? error.message : String(error));
+        if (error instanceof CliError && error.hint)
+            info(error.hint);
+        return 1;
+    }
+}
+export async function authCommand() {
+    const cred = resolveCredential();
+    if (cred.source === 'none') {
+        fail('저장된 BizRouter 인증 정보가 없습니다.');
+        info(`\`bizrouter login\` 을 실행하거나 ${ENV_KEY_NAME} 환경 변수를 설정하세요.`);
+        return 1;
+    }
+    const where = cred.source === 'env' ? `환경 변수 ${ENV_KEY_NAME}` : `저장된 파일 ${cred.path}`;
+    info(`인증 출처: ${where} · 키 ${maskKey(cred.apiKey ?? '')}`);
+    try {
+        const catalog = await fetchCatalog(cred.apiKey ?? '', { force: true });
+        ok(`유효한 키입니다. 사용 가능한 모델 ${chatModels(catalog.models).length}개.`);
+        return 0;
+    }
+    catch (error) {
+        fail(error instanceof Error ? error.message : String(error));
+        if (error instanceof CliError && error.hint)
+            info(error.hint);
+        return 1;
+    }
+}
+export function logoutCommand() {
+    const removed = clearCredential();
+    if (removed)
+        ok(`저장된 키를 지웠습니다: ${credentialsPath()}`);
+    else
+        info('저장된 키가 없습니다.');
+    if (process.env[ENV_KEY_NAME])
+        warn(`${ENV_KEY_NAME} 환경 변수는 그대로 남아 있습니다. 셸에서 unset 하세요.`);
+    return 0;
+}

package/dist/commands/misc.js

@@ -0,0 +1,57 @@
+import { spawn } from 'node:child_process';
+import { ENV_KEY_NAME } from '../config.js';
+import { c, info, print } from '../ui.js';
+import { requireApiKey } from './shared.js';
+export const VERSION = '0.1.0';
+/** `eval "$(bizrouter env)"` exports the saved key for tools configured by `bizrouter setup`. */
+export function envCommand() {
+    const key = requireApiKey();
+    print(`export ${ENV_KEY_NAME}=${shellQuote(key)}`);
+    return 0;
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+export function updateCommand() {
+    const viaBun = /[\\/]\.bun[\\/]/.test(process.argv[1] ?? '');
+    const [cmd, args] = viaBun ? ['bun', ['add', '-g', 'bizrouter@latest']] : ['npm', ['install', '-g', 'bizrouter@latest']];
+    info(`${cmd} ${args.join(' ')}`);
+    return new Promise((resolve) => {
+        const child = spawn(cmd, args, { stdio: 'inherit', shell: process.platform === 'win32' });
+        child.on('error', () => resolve(1));
+        child.on('exit', (code) => resolve(code ?? 1));
+    });
+}
+export function helpText() {
+    return `${c.bold('bizrouter')} — 쓰던 코딩 에이전트를 BizRouter 로 연결합니다. (v${VERSION})
+
+${c.bold('시작하기')}
+  bizrouter login                 브라우저에서 API 키를 발급받아 저장합니다 (한 번만)
+  bizrouter claude                Claude Code 를 BizRouter 로 실행합니다
+  bizrouter codex                 Codex CLI 를 BizRouter 로 실행합니다
+  bizrouter opencode              OpenCode 를 BizRouter 로 실행합니다
+  bizrouter hermes                Hermes 를 BizRouter 로 실행합니다
+
+${c.bold('실행 옵션')} (실행 명령 뒤, 도구 자체 옵션 앞에 씁니다)
+  --model <ID>                    BizRouter 모델 ID (예: anthropic/claude-sonnet-5, openai/gpt-5.5)
+  --reasoning-effort <단계>       minimal · low · medium · high · xhigh (Codex·OpenCode)
+  --closed-network                Claude Code 의 부수 트래픽(버전 확인·텔레메트리)을 끕니다
+  --dry-run                       실행하지 않고 넘겨줄 환경 변수와 명령만 보여줍니다
+  나머지 옵션은 그대로 도구에 전달됩니다. 예: bizrouter claude -p "테스트 고쳐줘"
+
+${c.bold('관리')}
+  bizrouter models [검색어]       이 키로 쓸 수 있는 모델과 원화 단가
+  bizrouter setup <도구>          claude · codex · opencode 설정 파일에 BizRouter 를 영구 등록
+  bizrouter doctor                연결·키·설치·충돌 점검
+  bizrouter auth                  지금 어떤 키가 쓰이는지 확인
+  bizrouter env                   eval "$(bizrouter env)" 로 ${ENV_KEY_NAME} 내보내기
+  bizrouter logout                저장된 키 삭제
+  bizrouter update                CLI 최신 버전으로 업데이트
+
+${c.bold('환경 변수')}
+  ${ENV_KEY_NAME}               저장된 키보다 우선합니다 (CI·컨테이너용)
+  BIZROUTER_CONFIG_DIR            설정 폴더 (기본 ~/.bizrouter)
+
+문서: https://bizrouter.ai/docs/cli
+`;
+}

package/dist/commands/models.js

@@ -0,0 +1,57 @@
+import { chatModels, fetchCatalog } from '../api.js';
+import { CliError, c, formatKrw, padEnd, print } from '../ui.js';
+import { requireApiKey } from './shared.js';
+export function parseModelsFlags(argv) {
+    const flags = { json: false, all: false, refresh: false };
+    for (const a of argv) {
+        if (a === '--json')
+            flags.json = true;
+        else if (a === '--all')
+            flags.all = true;
+        else if (a === '--refresh')
+            flags.refresh = true;
+        else if (a.startsWith('-'))
+            throw new CliError(`알 수 없는 옵션입니다: ${a}`, { hint: '사용법: bizrouter models [검색어] [--all] [--json] [--refresh]' });
+        else
+            flags.query = a;
+    }
+    return flags;
+}
+export function filterModels(models, flags) {
+    const base = flags.all ? models : chatModels(models);
+    if (!flags.query)
+        return base;
+    const q = flags.query.toLowerCase();
+    return base.filter((m) => m.id.toLowerCase().includes(q) || m.name.toLowerCase().includes(q));
+}
+function formatContext(tokens) {
+    if (tokens >= 1_000_000)
+        return `${(tokens / 1_000_000).toFixed(tokens % 1_000_000 === 0 ? 0 : 1)}M`;
+    if (tokens >= 1000)
+        return `${Math.round(tokens / 1000)}K`;
+    return String(tokens);
+}
+export async function modelsCommand(argv) {
+    const flags = parseModelsFlags(argv);
+    const apiKey = requireApiKey();
+    const catalog = await fetchCatalog(apiKey, { force: flags.refresh, allowStale: true });
+    const rows = filterModels(catalog.models, flags);
+    if (flags.json) {
+        print(JSON.stringify(rows, null, 2));
+        return 0;
+    }
+    if (rows.length === 0) {
+        print(flags.query ? `「${flags.query}」에 맞는 모델이 없습니다.` : '이 키로 쓸 수 있는 모델이 없습니다.');
+        return 1;
+    }
+    const idWidth = Math.min(44, Math.max(...rows.map((m) => m.id.length), 8));
+    print(c.dim(`${padEnd('모델 ID', idWidth)}  ${padEnd('컨텍스트', 9)} ${padEnd('입력/1M', 10)} ${padEnd('출력/1M', 10)} 유형`));
+    for (const m of rows) {
+        const type = flags.all ? m.api_type : m.supported_parameters.includes('tools') ? '도구 호출' : '';
+        print(`${padEnd(m.id, idWidth)}  ${padEnd(formatContext(m.context_length), 9)} ${padEnd(formatKrw(m.input_price_per_1m_krw), 10)} ${padEnd(formatKrw(m.output_price_per_1m_krw), 10)} ${c.dim(type)}`);
+    }
+    print();
+    print(c.dim(`${rows.length}개 · 원화 단가는 100만 토큰당 · 환율 ${catalog.exchange_rate}원/달러 · ${catalog.from_cache ? '캐시(최대 10분)' : '지금 조회'}`));
+    print(c.dim('예: bizrouter codex --model openai/gpt-5.5 · bizrouter claude --model anthropic/claude-opus-5'));
+    return 0;
+}