bizrouter 0.3.3 → 0.3.4

package/AGENT_MANUAL.md

@@ -186,8 +186,15 @@ server named `bizrouter` inside Claude Code, Codex and OpenCode for that run
 and `bizrouter_search` with the same rules as above — `bizrouter_api` refuses
 mutating calls unless `confirm: true` is passed after the user agreed.
 
-Claude Code can only run Anthropic models (it always sends Anthropic-only
-fields); use Codex/OpenCode/Hermes for GPT or Gemini.
+Claude Code runs any chat model in the catalog. Its `/model` picker lists
+Claude models by their code and every other chat model as
+`claude-code/<code>` (Claude Code only shows ids containing `claude` or
+`anthropic`); `--model <code>` without the prefix works too. 1M-window models
+carry Claude Code's `[1m]` marker so it accounts for the full window. On a
+non-Anthropic model the gateway drops the Anthropic-only hints Claude Code
+always sends (`cache_control`, `thinking`, `context_management`, earlier
+thinking blocks) and reports dropped breakpoints in
+`x-bizrouter-cache-control-dropped`.
 
 ## 7a. BizRouter Search — answers grounded in live data
 

package/README.md

@@ -26,15 +26,18 @@ bizrouter hermes                # Hermes
 
 | 도구 | 실행 시 하는 일 | 설정 파일 변경 |
 | --- | --- | --- |
-| Claude Code | `ANTHROPIC_BASE_URL=https://api.bizrouter.ai/claude`, 토큰, 빈 `ANTHROPIC_API_KEY`, 모델 선택창 자동 채움을 넘기고, 사용자 settings.json의 다른 게이트웨이 설정이 이기지 못하도록 명령행 settings로 고정 | 없음 |
+| Claude Code | `ANTHROPIC_BASE_URL=https://api.bizrouter.ai/claude`, 토큰, 빈 `ANTHROPIC_API_KEY`, 모델 선택창 자동 채움(이 키로 쓸 수 있는 채팅 모델 전체)을 넘기고, 사용자 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`)와 모델을 이번 실행에만 지정 | 없음 |
 
 도구는 평소처럼 실행됩니다. 바뀌는 것은 그 실행에서 모델을 호출하는 주소와 인증뿐이어서, 화면과 사용법은 같고 과금·모델 정책·감사 로그는 BizRouter 콘솔에 남습니다. `bizrouter` 없이 실행하면 평소대로 동작합니다. 우리 옵션 뒤의 인자는 도구에 그대로 전달됩니다.
 
+Claude Code는 컨텍스트 창 크기를 모델 ID의 `[1m]` 마커로만 판단합니다(모델 목록의 `context_length`는 무시). 그래서 `bizrouter claude`는 모델을 지정하지 않으면 이 키가 쓸 수 있는 1M 컨텍스트 Claude 모델(Sonnet 우선)을 `ANTHROPIC_MODEL=<모델>[1m]`으로 넘기고, 직접 지정한 1M 모델에도 마커를 붙입니다. 200k 모델에는 붙이지 않습니다. 1M 입력은 표준 단가로 과금됩니다.
+
 ```bash
 bizrouter claude --model anthropic/claude-opus-5 -p "실패하는 테스트 고쳐줘"
+bizrouter claude --model bizrouter/glm-5.3     # GPT·Gemini·GLM·Kimi 등 이 키가 쓸 수 있는 모든 채팅 모델
 bizrouter codex --model openai/gpt-5.5 --reasoning-effort high exec "README 요약해줘"
 bizrouter opencode --model google/gemini-3.5-pro
 bizrouter claude --dry-run          # 실행 대신 넘겨줄 환경 변수와 명령을 보여줍니다
@@ -93,7 +96,7 @@ bizrouter auth / logout / env / update
 
 ## 알아둘 것
 
-- Claude Code는 Anthropic 전용 필드(`thinking`, `cache_control`)를 항상 보내므로 Claude 모델만 실행할 수 있습니다. GPT·Gemini는 Codex·OpenCode·Hermes로 실행하십시오.
+- Claude Code에서도 이 키가 쓸 수 있는 채팅 모델 전체를 씁니다. `/model` 선택창에는 Claude 모델은 그대로, 나머지는 `claude-code/` 접두를 붙여(예: `claude-code/bizrouter/glm-5.3[1m]`) 나타나고, `--model`이나 `/model`에는 접두 없는 카탈로그 ID를 그대로 써도 됩니다. Claude 외 모델로 갈 때 게이트웨이가 Claude Code가 항상 보내는 Anthropic 전용 힌트(`cache_control`, `thinking`, `context_management`, 이전 턴 thinking 블록)를 떼어 내며, 뗀 `cache_control` 개수는 응답 헤더 `x-bizrouter-cache-control-dropped`로 알립니다. 1M 컨텍스트 모델에는 `[1m]`을 붙여 Claude Code가 200k로 잘못 계산하지 않게 합니다.
 - 콘솔 세션은 로그인한 사용자의 권한(owner/member)을 그대로 따릅니다. 구성원(member)은 자기 API 키와 사용량만 다룰 수 있습니다.
 - API 키(`sk-br-v1-…`)의 권한은 예전과 같습니다. 모델 호출만 되고, 콘솔 관리는 브라우저에서 승인한 사람의 콘솔 세션으로만 됩니다. 범위는 그 사람이 웹 콘솔에서 할 수 있는 일과 같습니다.
 - 콘솔의 「사용량 조회 API」 키는 별개의 읽기 전용 키입니다. CLI는 쓰지도 바꾸지도 않습니다.

package/dist/commands/console.js

@@ -382,10 +382,25 @@ export async function orgCommand(argv) {
     }
 }
 const AUDIT_USAGE = [
-    'bizrouter audit list [--status success|error|blocked] [--model ID] [--key 이름] [--app 이름] [--user 이메일|이름] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--search 텍스트] [--limit N] [--cursor C] [--json]',
+    'bizrouter audit list [--status success|failure] [--response-type normal|sensitive|blocked] [--model ID] [--key 이름] [--app 이름] [--user 이메일|이름] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--search 텍스트] [--limit N] [--cursor C] [--json]',
     'bizrouter audit show <log_id> [--json]',
     'bizrouter audit stats [--json]',
 ].join('\n');
+// 서버 감사 로그의 실제 값 (RequestLog.STATUS_CHOICES / RESPONSE_TYPE_CHOICES).
+// 예전 도움말이 `--status error|blocked`를 안내해 0행을 조용히 돌려주는 원인이었다.
+const AUDIT_STATUS_VALUES = ['success', 'failure'];
+const AUDIT_RESPONSE_TYPE_VALUES = ['normal', 'sensitive', 'blocked'];
+export function auditFlagValue(parsed, name, allowed, label) {
+    const value = flagString(parsed, name);
+    if (value === undefined)
+        return undefined;
+    if (!allowed.includes(value)) {
+        throw new CliError(`--${name} 값은 ${allowed.join('|')} 중 하나여야 합니다. (입력: ${value})`, {
+            hint: `${label}에 --response-type을 쓰는 것과 헷갈리지 마십시오. 감사 로그의 status는 요청 성패(success|failure)이고, 차단 여부는 response_type(blocked)입니다.`,
+        });
+    }
+    return value;
+}
 export async function auditCommand(argv) {
     const parsed = parseArgs(argv);
     const [sub, ...rest] = parsed.positional;
@@ -395,7 +410,8 @@ export async function auditCommand(argv) {
             const from = flagString(parsed, 'from');
             const to = flagString(parsed, 'to');
             const data = await get('/audit-logs/', {
-                status: flagString(parsed, 'status'),
+                status: auditFlagValue(parsed, 'status', AUDIT_STATUS_VALUES, '--status'),
+                response_type: auditFlagValue(parsed, 'response-type', AUDIT_RESPONSE_TYPE_VALUES, '--response-type'),
                 model: flagString(parsed, 'model'),
                 api_key: flagString(parsed, 'key'),
                 app_name: flagString(parsed, 'app'),

package/dist/commands/misc.js

@@ -2,7 +2,7 @@ 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.3.3';
+export const VERSION = '0.3.4';
 /** `eval "$(bizrouter env)"` exports the saved key for tools configured by `bizrouter setup`. */
 export function envCommand() {
     const key = requireApiKey();

package/dist/commands/models.js

@@ -52,7 +52,7 @@ export async function modelsCommand(argv) {
     }
     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'));
+    print(c.dim('예: bizrouter codex --model openai/gpt-5.5 · bizrouter claude --model anthropic/claude-opus-5 · bizrouter claude --model bizrouter/glm-5.3'));
     print(c.dim('Search: 어느 채팅 모델이든 뒤에 :search 를 붙이면 실제 데이터를 조회해 답합니다 (예: bizrouter search "질문" --model openai/gpt-5.5)'));
     return 0;
 }

package/dist/commands/setup.js

@@ -4,7 +4,7 @@ import { dirname, join } from 'node:path';
 import { fetchCatalog } from '../api.js';
 import { pickDefaultModel, FALLBACK_DEFAULT } from '../catalog.js';
 import { apiBase, ENV_KEY_NAME } from '../config.js';
-import { claudeEnv } from '../harness/claude.js';
+import { catalogCodeOf, claudeEnv, claudeModelArg, defaultClaudeModel, ONE_MILLION_CONTEXT_MARKER } from '../harness/claude.js';
 import { CODEX_PROVIDER_ID } from '../harness/codex.js';
 import { OPENCODE_PROVIDER_ID, opencodeProvider } from '../harness/opencode.js';
 import { c, CliError, info, ok, print, warn } from '../ui.js';
@@ -119,8 +119,19 @@ export async function setupCommand(argv) {
     const apiKey = requireApiKey();
     const base = apiBase();
     if (target === 'claude') {
+        // ADR-0031: pin a model so plain `claude` runs on the 1M window. The
+        // --model value, else the model already in settings.json, keeps its choice
+        // and gets `[1m]` only when the catalog lists it as a 1M model.
         const path = claudeSettingsPath();
-        const next = mergeClaudeSettings(readJsonObject(path), claudeEnv({ apiKey, apiBase: base, closedNetwork: false }));
+        const existing = readJsonObject(path);
+        const chosen = pinned ?? (typeof existing.model === 'string' ? existing.model : undefined);
+        const catalog = await fetchCatalog(apiKey, { allowStale: true }).catch(() => undefined);
+        const claudeModel = chosen
+            ? claudeModelArg(chosen, catalog?.models.find((m) => m.id === catalogCodeOf(chosen))?.context_length)
+            : defaultClaudeModel(catalog?.models);
+        const next = mergeClaudeSettings(existing, claudeEnv({ apiKey, apiBase: base, closedNetwork: false }));
+        if (claudeModel)
+            next.model = claudeModel;
         const text = `${JSON.stringify(next, null, 2)}\n`;
         if (dryRun) {
             print(text);
@@ -128,7 +139,8 @@ export async function setupCommand(argv) {
         }
         const bak = backup(path);
         writeText(path, text);
-        ok(`${path}의 env 블록에 BizRouter 설정을 넣었습니다.${bak ? ` (백업: ${bak})` : ''}`);
+        const modelNote = claudeModel ? ` 기본 모델은 ${claudeModel}${claudeModel.endsWith(ONE_MILLION_CONTEXT_MARKER) ? '(1M 컨텍스트)' : ''}입니다.` : '';
+        ok(`${path}의 env 블록에 BizRouter 설정을 넣었습니다.${modelNote}${bak ? ` (백업: ${bak})` : ''}`);
         warn('이 파일에는 API 키가 그대로 저장됩니다. 저장소에 커밋되는 프로젝트 .claude/settings.json이 아니라 사용자 설정이라 안전하지만, 기기를 공유한다면 `bizrouter claude` 실행 방식을 권장합니다.');
         info('이제 `claude`만 실행해도 BizRouter로 연결됩니다. 되돌리려면 백업 파일을 복원하세요.');
         return 0;

package/dist/harness/claude.js

@@ -1,10 +1,28 @@
 import { unlinkSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { chatModels } from '../api.js';
 import { hasFlag } from '../args.js';
-import { isAnthropicModelId } from '../catalog.js';
 import { ensureTmpDir } from '../config.js';
-import { CliError } from '../ui.js';
 import { claudeMcpConfig } from './mcp.js';
+/** Claude Code's own marker for a 1M context window; it strips it before sending. */
+export const ONE_MILLION_CONTEXT_MARKER = '[1m]';
+/** Prefix the gateway's Claude Code discovery surface puts on non-Anthropic catalog codes. */
+export const CLAUDE_CODE_MODEL_ALIAS_PREFIX = 'claude-code/';
+const ONE_MILLION_CONTEXT_TOKENS = 1_000_000;
+/**
+ * The catalog code behind a model id as Claude Code's `/model` picker shows it
+ * (`claude-code/<code>[1m]`). Mirrors the gateway's
+ * `normalize_claude_code_surface_model`, so catalog lookups accept whatever the
+ * user copied from the picker.
+ */
+export function catalogCodeOf(model) {
+    let code = model.trim();
+    if (code.endsWith(ONE_MILLION_CONTEXT_MARKER))
+        code = code.slice(0, -ONE_MILLION_CONTEXT_MARKER.length).trimEnd();
+    if (code.startsWith(CLAUDE_CODE_MODEL_ALIAS_PREFIX))
+        code = code.slice(CLAUDE_CODE_MODEL_ALIAS_PREFIX.length);
+    return code;
+}
 /**
  * Environment Claude Code needs to talk to BizRouter. Mirrors what the
  * integration guide documents; `ANTHROPIC_API_KEY` must be present and empty
@@ -21,19 +39,43 @@ export function claudeEnv(options) {
         env.CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = '1';
     return env;
 }
-export function assertClaudeModel(model) {
-    if (!isAnthropicModelId(model)) {
-        throw new CliError(`Claude Code는 Claude 모델만 실행할 수 있습니다: ${model}`, {
-            hint: 'Claude Code는 thinking·cache_control 같은 Anthropic 전용 필드를 항상 보내서 다른 모델은 400으로 거절됩니다. GPT·Gemini는 `bizrouter codex` 또는 `bizrouter opencode`로 실행하세요.',
-        });
-    }
+/**
+ * The `--model` value Claude Code receives. Any BizRouter catalog id works on
+ * the gateway (`/claude/v1/messages` converts non-Anthropic models and drops
+ * the Anthropic-only hints Claude Code always sends); this only appends the
+ * `[1m]` marker for a 1M-window model so Claude Code does not compact five
+ * times too early.
+ */
+export function claudeModelArg(model, contextLength) {
+    if (model.endsWith(ONE_MILLION_CONTEXT_MARKER))
+        return model;
+    if (contextLength !== undefined && contextLength >= ONE_MILLION_CONTEXT_TOKENS)
+        return `${model}${ONE_MILLION_CONTEXT_MARKER}`;
+    return model;
+}
+/**
+ * ADR-0031: the `[1m]`-marked Claude model to default to when the user pinned
+ * nothing, so a bare `bizrouter claude` session is accounted against the 1M
+ * window instead of Claude Code's 200k fallback. Sonnet first (the same
+ * family the other harnesses default to), then any 1M Claude model. Undefined
+ * when the catalog is unavailable or lists no 1M Claude model, leaving Claude
+ * Code's own alias defaults in place.
+ */
+export function defaultClaudeModel(models) {
+    const oneM = chatModels(models ?? []).filter((m) => m.id.startsWith('anthropic/claude-') && m.context_length >= ONE_MILLION_CONTEXT_TOKENS);
+    const found = oneM.find((m) => m.id.startsWith('anthropic/claude-sonnet')) ?? oneM[0];
+    return found ? claudeModelArg(found.id, found.context_length) : undefined;
 }
 export function buildClaudePlan(options) {
-    if (options.model)
-        assertClaudeModel(options.model);
     const env = claudeEnv(options);
     const args = [];
     let cleanup;
+    const model = options.model ? claudeModelArg(options.model, options.modelContextLength) : undefined;
+    // The default goes in the env, not argv: `--model` in passthrough or
+    // `/model` in the session still wins.
+    const injected = model ? undefined : defaultClaudeModel(options.models);
+    if (injected)
+        env.ANTHROPIC_MODEL = injected;
     // A user-level settings.json `env` block outranks shell variables, so a
     // stale ANTHROPIC_BASE_URL there would silently win. The command-line
     // settings level beats every file, so we hand the same env block over as a
@@ -51,14 +93,19 @@ export function buildClaudePlan(options) {
             }
         };
     }
-    if (options.model && !hasFlag(options.passthrough, '--model'))
-        args.push('--model', options.model);
+    if (model && !hasFlag(options.passthrough, '--model'))
+        args.push('--model', model);
     if (options.mcp && !hasFlag(options.passthrough, '--mcp-config'))
         args.push('--mcp-config', claudeMcpConfig(options.mcp));
     args.push(...options.passthrough);
     const notes = [
-        `Claude Code → ${env.ANTHROPIC_BASE_URL}` + (options.model ? ` · 모델 ${options.model}` : ' · 모델은 Claude Code 기본값(sonnet/opus 별칭 자동 매핑)'),
-        '`/model` 선택창에 이 키로 쓸 수 있는 Claude 모델이 자동으로 채워집니다.',
+        `Claude Code → ${env.ANTHROPIC_BASE_URL}` +
+            (model
+                ? ` · 모델 ${model}`
+                : injected
+                    ? ` · 기본 모델 ${injected} (1M 컨텍스트)`
+                    : ' · 모델은 Claude Code 기본값(sonnet/opus 별칭 자동 매핑)'),
+        '`/model` 선택창에 이 키로 쓸 수 있는 채팅 모델 전체가 채워집니다. Claude 외 모델은 `claude-code/` 접두로 표시되고, 1M 컨텍스트 모델에는 `[1m]`이 붙습니다.',
         ...(options.mcp ? ['콘솔 MCP 서버 「bizrouter」 를 이 세션에 연결합니다 (API 키·정책·통계 조작 · 끄기: --no-mcp).'] : []),
     ];
     return { bin: 'claude', args, env, notes, cleanup };

package/dist/index.js

@@ -16,7 +16,7 @@ import { isVirtualModelId, searchModelFor, stripSearchSuffix } from './search.js
 import { setupCommand } from './commands/setup.js';
 import { requireApiKey } from './commands/shared.js';
 import { apiBase, loadUserConfig, resolveSession } from './config.js';
-import { buildClaudePlan } from './harness/claude.js';
+import { buildClaudePlan, catalogCodeOf } from './harness/claude.js';
 import { buildCodexPlan, codexConfigPinsServiceTier } from './harness/codex.js';
 import { codexConfigPath } from './commands/setup.js';
 import { existsSync, readFileSync } from 'node:fs';
@@ -44,8 +44,8 @@ async function resolveModel(harness, args, apiKey) {
     }
     if (pinned) {
         // `bizrouter/route`, `bizrouter/search` and `<id>:search` are policies layered on catalog rows, not rows themselves.
-        const lookup = stripSearchSuffix(pinned);
-        if (models.length && !isVirtualModelId(pinned) && !models.some((m) => m.id === lookup)) {
+        const lookup = catalogCodeOf(stripSearchSuffix(pinned));
+        if (models.length && !isVirtualModelId(lookup) && !models.some((m) => m.id === lookup)) {
             const suggestions = suggestModels(models, lookup);
             warn(`「${pinned}」 는 이 키로 쓸 수 있는 모델 목록에 없습니다.${suggestions.length ? ` 비슷한 모델: ${suggestions.join(', ')}` : ''}`);
             info('그대로 시도합니다. 키의 「API key 사용 범위」나 조직의 모델 정책이 막고 있으면 요청이 거절됩니다.');
@@ -93,7 +93,16 @@ async function launch(harness, argv) {
     let plan;
     switch (harness) {
         case 'claude':
-            plan = buildClaudePlan({ apiKey, apiBase: base, model, closedNetwork: args.closedNetwork, passthrough: args.passthrough, mcp });
+            plan = buildClaudePlan({
+                apiKey,
+                apiBase: base,
+                model,
+                modelContextLength: model ? models.find((m) => m.id === catalogCodeOf(model))?.context_length : undefined,
+                models,
+                closedNetwork: args.closedNetwork,
+                passthrough: args.passthrough,
+                mcp,
+            });
             if (args.reasoningEffort)
                 warn('Claude Code는 추론 강도를 실행 옵션으로 받지 않습니다. 세션 안에서 /effort를 사용하세요.');
             break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bizrouter",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "BizRouter CLI - run Claude Code, Codex, OpenCode, and Hermes through BizRouter, operate the BizRouter console (API keys, usage, policies, audit logs) from the terminal or as an MCP server, and ask BizRouter Search for answers grounded in 50+ live data sources",
   "license": "UNLICENSED",
   "type": "module",