ethos-router 0.1.0 → 0.1.2

package/README.md

@@ -18,6 +18,7 @@ ethos codex     # Codex 를 에토스 라우터로 실행
 | `ethos login` | 브라우저에서 승인하고 키를 받습니다 |
 | `ethos logout` | 키를 정지하고 설정을 지웁니다 |
 | `ethos whoami` | 어느 워크스페이스로 붙어 있는지 봅니다 |
+| `ethos use [코드]` | 어느 모델로 붙을지 정합니다 |
 | `ethos claude [인자…]` | Claude Code 를 에토스 라우터로 실행합니다 |
 | `ethos codex [인자…]` | Codex 를 에토스 라우터로 실행합니다 |
 | `ethos env` | 다른 도구에 넣을 환경변수를 찍습니다 |
@@ -27,6 +28,20 @@ ethos codex     # Codex 를 에토스 라우터로 실행
 | `ethos usage` | 기간별 사용 내역을 봅니다 |
 | `ethos doctor` | 어디가 막혔는지 점검합니다 |
 
+## 모델
+
+`ethos claude` 는 붙을 모델을 정해서 넘깁니다. **정해 주지 않으면 도구가 제
+기본 이름을 보내는데, 저희 카탈로그 코드에는 공급사 접두사가 붙어 있어서
+그 이름으로는 못 찾습니다.**
+
+```bash
+ethos use                          # 지금 무엇으로 붙는지
+ethos models claude                # 쓸 수 있는 코드
+ethos use anthropic/claude-opus-5  # 바꾸기
+```
+
+고른 값은 설정에 남습니다. `ETHOS_MODEL` 로 한 번만 덮어쓸 수도 있습니다.
+
 ## 키
 
 `ethos login` 은 키를 **두 개** 받아 `~/.ethos/config.json` 에 0600 으로

package/index.js

@@ -16,7 +16,7 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync }
 import { homedir, hostname } from "node:os";
 import { dirname, join } from "node:path";
 
-const VERSION = "0.1.0";
+const VERSION = "0.1.2";
 const DEFAULT_BASE = "https://router.ethos.ai.kr";
 const CONFIG_PATH = join(homedir(), ".ethos", "config.json");
 
@@ -211,15 +211,29 @@ const TOOLS = {
     bin: "claude",
     install: "npm i -g @anthropic-ai/claude-code",
     // 앤트로픽 형식 창구. 도구가 뒤에 /v1/messages 를 붙인다.
-    env: (key, base) => ({
+    //
+    // **ANTHROPIC_API_KEY 는 넣지 않는다.** 둘 다 있으면 API_KEY 가 이기는데,
+    // 그 값이 있으면 Claude Code 가 "이 키를 쓸까요" 승인 절차를 따로 탄다.
+    // 게이트웨이 연결의 조합은 BASE_URL + AUTH_TOKEN 둘뿐이다.
+    env: (key, base, model) => ({
       ANTHROPIC_BASE_URL: `${base}/claude`,
       ANTHROPIC_AUTH_TOKEN: key,
-      ANTHROPIC_API_KEY: key,
+      // **모델을 정해 주지 않으면 도구가 제 기본 이름을 보낸다.** 우리 카탈로그
+      // 코드에는 공급사 접두사가 붙어 있어서 그 이름으로는 못 찾고, 도구는
+      // 전체화면 화면이라 오류가 화면과 함께 지워진다 — "아무 일도 안 일어남" 이
+      // 된다. 실제로 그랬다(2026-09-09).
+      ANTHROPIC_MODEL: model.main,
+      // 요약·제목 같은 잔일에 쓰는 작은 모델. 이걸 안 정해 주면 주 모델은
+      // 붙는데 잔일에서만 조용히 실패한다 — 원인을 찾기 훨씬 어렵다.
+      ANTHROPIC_SMALL_FAST_MODEL: model.small,
     }),
   },
   codex: {
     bin: "codex",
     install: "npm i -g @openai/codex",
+    // 모델은 정해 주지 않는다. 이 도구가 어떤 변수로 모델을 읽는지 확인한 적이
+    // 없고, 확인 안 한 값을 넣으면 붙는 것처럼 보이다가 호출에서만 틀린다.
+    // 모델은 도구의 제 방식(--model 등)으로 고르고, 코드는 ethos models 로 본다.
     env: (key, base) => ({
       OPENAI_BASE_URL: `${base}/v1`,
       OPENAI_API_KEY: key,
@@ -227,16 +241,41 @@ const TOOLS = {
   },
 };
 
-function toolEnv(name, key, base) {
-  return TOOLS[name].env(key, base);
+/**
+ * 어느 모델로 붙일지.
+ *
+ * 고른 값은 설정에 남는다 — 매번 정하게 하면 대부분 기본값으로 돌고, 기본값이
+ * 무엇인지 모른 채 쓴다. `ethos use <코드>` 로 바꾸고 `ethos whoami` 에서 확인한다.
+ * 코드는 `ethos models` 가 보여주는 그대로다(공급사 접두사 포함).
+ */
+const DEFAULT_MODEL = { main: "anthropic/claude-sonnet-5", small: "anthropic/claude-haiku-4.5" };
+
+function modelFor(cfg) {
+  return {
+    main: process.env.ETHOS_MODEL || cfg.model || DEFAULT_MODEL.main,
+    small: process.env.ETHOS_SMALL_MODEL || cfg.smallModel || DEFAULT_MODEL.small,
+  };
+}
+
+function toolEnv(name, key, base, model) {
+  return TOOLS[name].env(key, base, model);
 }
 
 async function cmdRunTool(name, rest) {
   const cfg = loadConfig();
   const key = needKey(cfg);
   const t = TOOLS[name];
-  const env = { ...process.env, ...toolEnv(name, key, baseUrl(cfg)) };
+  const base = baseUrl(cfg);
+  const model = modelFor(cfg);
+  const env = { ...process.env, ...toolEnv(name, key, base, model) };
+
+  // 무엇을 어디로 띄우는지 한 줄 남긴다. 이 도구들은 전체화면 화면을 쓰기
+  // 때문에, 뜨자마자 죽으면 **화면이 복원되면서 오류 메시지까지 같이
+  // 사라진다.** 그러면 사용자에게는 아무 일도 안 일어난 것처럼 보인다.
+  // 이 줄이 있으면 적어도 "우리는 띄웠고 저쪽이 죽었다"는 것은 남는다.
+  err(dim(`  ${t.bin} · ${base} · ${model.main}`));
 
+  const started = Date.now();
   const child = spawn(t.bin, rest, { stdio: "inherit", env });
   child.on("error", (e) => {
     if (e.code === "ENOENT") {
@@ -245,6 +284,15 @@ async function cmdRunTool(name, rest) {
     die(e.message);
   });
   child.on("exit", (code, signal) => {
+    // 곧바로 죽었으면 오류를 봤을 리가 없다 — 보는 방법을 알려준다.
+    // 인자를 준 실행(--version 등)은 빨리 끝나는 게 정상이므로 빼고,
+    // 대화형으로 띄웠는데 곧바로 끝났거나 실패로 끝난 경우만 말한다.
+    const tooFast = Date.now() - started < 3000;
+    if (!signal && tooFast && (rest.length === 0 || code !== 0)) {
+      err(dim(`  ${t.bin} 이 바로 종료됐습니다(코드 ${code ?? 0}).`));
+      err(dim(`  화면이 지워져 메시지가 안 보일 수 있습니다. 아래로 직접 확인하세요:`));
+      err(dim(`    eval "$(ethos env)" && ${t.bin}`));
+    }
     // 신호로 죽은 것을 0 으로 보고하면 스크립트가 성공으로 읽는다
     process.exit(signal ? 1 : (code ?? 0));
   });
@@ -258,7 +306,8 @@ function cmdEnv(args) {
   const cfg = loadConfig();
   const key = needKey(cfg);
   const base = baseUrl(cfg);
-  const vars = { ...toolEnv("claude", key, base), ...toolEnv("codex", key, base) };
+  const model = modelFor(cfg);
+  const vars = { ...toolEnv("claude", key, base, model), ...toolEnv("codex", key, base, model) };
   const shell = args.shell || (process.env.SHELL?.includes("fish") ? "fish" : "posix");
   for (const [k, v] of Object.entries(vars)) {
     out(shell === "fish" ? `set -gx ${k} ${v}`
@@ -431,6 +480,42 @@ function which(bin) {
   });
 }
 
+// ── use ──────────────────────────────────────────────────
+//
+// 어느 모델로 붙을지 정한다. 코드가 카탈로그에 있는지 **정하는 자리에서**
+// 확인한다 — 안 하면 오타가 설정에 그대로 저장되고, 그 다음 실행에서
+// 도구가 뜨자마자 죽는다(화면이 걷히면서 오류까지 사라진다).
+async function cmdUse(args) {
+  const cfg = loadConfig();
+  const code = args._[0];
+  if (!code) {
+    const m = modelFor(cfg);
+    out("");
+    out(`  지금 모델   ${bold(m.main)}`);
+    out(`  잔일 모델   ${m.small}`);
+    out("");
+    out(dim('  바꾸려면  ethos use <코드>      (코드는 ethos models 로 봅니다)'));
+    out(dim('  잔일까지  ethos use <코드> --small <코드>'));
+    out("");
+    return;
+  }
+
+  const { json: d } = await call("/v1/prices");
+  const ids = new Set(d.models.map((m) => m.id));
+  for (const c of [code, args.small].filter(Boolean)) {
+    if (!ids.has(c)) {
+      // 비슷한 것을 같이 보여준다. "없습니다" 만 남기면 다음 행동이 없다.
+      const near = [...ids].filter((x) => x.includes(c.split("/").pop().slice(0, 6))).slice(0, 5);
+      die(`카탈로그에 없는 모델입니다: ${c}`,
+        near.length ? `비슷한 코드: ${near.join(", ")}` : "ethos models 로 코드를 확인하세요.");
+    }
+  }
+  cfg.model = code;
+  if (args.small) cfg.smallModel = args.small;
+  saveConfig(cfg);
+  out(green("✓ ") + `${code} 로 붙습니다.` + (args.small ? ` (잔일 ${args.small})` : ""));
+}
+
 // ── whoami ────────────────────────────────────────────────
 function cmdWhoami() {
   const cfg = loadConfig();
@@ -438,6 +523,7 @@ function cmdWhoami() {
   out("");
   out(`  워크스페이스  ${bold(cfg.workspace?.name ?? dim("알 수 없음"))}`);
   out(`  창구 주소     ${baseUrl(cfg)}`);
+  out(`  모델          ${modelFor(cfg).main}`);
   // 키 전체를 찍지 않는다. 스크린샷과 화면 공유로 새어 나가는 자리다.
   out(`  키            ${apiKey(cfg).slice(0, 12)}…`);
   out("");
@@ -451,6 +537,7 @@ function help() {
   ${bold("ethos login")}                브라우저에서 승인하고 키를 받습니다
   ${bold("ethos logout")}               키를 정지하고 설정을 지웁니다
   ${bold("ethos whoami")}               어느 워크스페이스로 붙어 있는지 봅니다
+  ${bold("ethos use")} ${dim("[코드]")}            어느 모델로 붙을지 정합니다 ${dim("(빈 값이면 지금 값)")}
 
   ${bold("ethos claude")} ${dim("[인자…]")}      Claude Code 를 에토스 라우터로 실행합니다
   ${bold("ethos codex")} ${dim("[인자…]")}       Codex 를 에토스 라우터로 실행합니다
@@ -501,6 +588,7 @@ async function main() {
     case "login": return await cmdLogin(args);
     case "logout": return await cmdLogout();
     case "whoami": return cmdWhoami();
+    case "use": return await cmdUse(args);
     case "env": return cmdEnv(args);
     case "models": return await cmdModels(args);
     case "chat": return await cmdChat(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ethos-router",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "에토스 라우터 명령줄 도구. 한 번 로그인하면 코딩 도구가 에토스 라우터를 보게 됩니다.",
   "type": "module",
   "bin": {