easyrouter-config 1.0.1

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 QuantumNous
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This software is a thin wrapper around zcf (https://github.com/UfoMiao/zcf),
+which is licensed under the MIT License. zcf is invoked as a separate process
+via npx; no code from zcf is bundled or modified within this package.

package/README.md

@@ -0,0 +1,108 @@
+# easyrouter-config
+
+> 🚀 一键把 [EasyRouter](https://easyrouter.io) 接入 Claude Code & Codex —— 粘贴 Key 即用
+
+## 特性
+
+- ✅ 一条命令同时配置 Claude Code 和 Codex
+- ✅ 交互式 / 非交互式两种模式
+- ✅ 内置 EasyRouter 按量付费 BaseURL，无需手动输入
+- ✅ 配置完成后自动验证链路连通性
+- ✅ 极薄封装，复用业界成熟的 [zcf](https://github.com/UfoMiao/zcf) 写入逻辑
+
+## 快速开始
+
+### 交互式（推荐新手）
+
+```bash
+npx -y easyrouter-config
+```
+
+按提示粘贴 API Key、回车即可。
+
+### 一行命令（按量付费）
+
+```bash
+npx -y easyrouter-config -k sk-你的token
+```
+
+仅此一种部署模式 —— 内置 `https://easyrouter.io`，按 token 实际用量计费。
+
+#### 只配 Claude Code 或只配 Codex
+
+```bash
+# 只配 Claude Code
+npx -y easyrouter-config -k sk-你的token --only claude
+
+# 只配 Codex
+npx -y easyrouter-config -k sk-你的token --only codex
+```
+
+完成后直接运行：
+
+```bash
+claude     # 启动 Claude Code
+codex      # 启动 Codex
+```
+
+## 命令行参数
+
+| 参数 | 简写 | 说明 |
+|---|---|---|
+| `--api-key <key>` | `-k` | EasyRouter API Key（可省略 `sk-` 前缀） |
+| `--only <tool>` |  | `claude` \| `codex` —— 只配置其一 |
+| `--skip-verify` |  | 跳过连通性验证 |
+| `--verbose` | `-v` | 显示底层 zcf 子进程的详细输出 |
+| `--help` | `-h` | 显示帮助 |
+| `--version` | `-V` | 显示版本 |
+
+## 工作原理
+
+`easyrouter-config` 是 [zcf](https://github.com/UfoMiao/zcf) 的薄封装：
+
+1. 通过交互或参数收集 API Key
+2. 内置 EasyRouter 按量付费 BaseURL（`https://easyrouter.io`）
+3. 调用 `npx zcf init` 两次（一次配 `cc`，一次配 `cx`）
+4. zcf 实际写入：
+   - Claude Code → `~/.claude/settings.json`（注入 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY` 到 `env`）
+   - Codex → `~/.codex/config.toml` + `~/.codex/auth.json`
+5. 通过 `GET {BASE_URL}/v1/models` 探测连通性
+
+完全等价于手动执行：
+
+```bash
+npx -y zcf init -s --code-type cc -p custom --api-type auth_token \
+  -u https://easyrouter.io -k sk-xxx
+npx -y zcf init -s --code-type cx -p custom --api-type auth_token \
+  -u https://easyrouter.io/v1 -k sk-xxx
+```
+
+但你只需要记住一行：`npx -y easyrouter-config`。
+
+## EasyRouter 是什么
+
+[EasyRouter](https://easyrouter.io) 是下一代 LLM 网关与 AI 资产管理平台：
+
+- 统一接口聚合 40+ 上游模型供应商（OpenAI / Claude / Gemini / Azure / Bedrock …）
+- 完整的用户、配额、计费、限流体系
+- 支持按量付费
+
+## 致谢
+
+本工具的核心配置写入逻辑由 **[zcf](https://github.com/UfoMiao/zcf)** 提供。
+我们仅在其上做了 EasyRouter 专属的预设封装与交互简化。
+
+特别感谢 [@UfoMiao](https://github.com/UfoMiao) 与 zcf 团队的开源贡献。
+推荐对工作流定制有更多需求的用户直接使用 zcf 原生命令。
+
+## 开发
+
+```bash
+npm install
+npm run build
+node ./dist/index.js --help
+```
+
+## License
+
+MIT © QuantumNous

package/dist/index.js

@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import {
+  intro,
+  outro,
+  text,
+  confirm,
+  spinner,
+  isCancel,
+  cancel,
+  log,
+  note
+} from "@clack/prompts";
+import { execa } from "execa";
+import pc from "picocolors";
+import { parseArgs } from "util";
+var VERSION = "0.1.0";
+var CLAUDE_BASE_URL = "https://easyrouter.io";
+var CODEX_BASE_URL = "https://easyrouter.io/v1";
+function parseCliArgs() {
+  try {
+    const { values } = parseArgs({
+      args: process.argv.slice(2),
+      options: {
+        "api-key": { type: "string", short: "k" },
+        only: { type: "string" },
+        "skip-verify": { type: "boolean" },
+        verbose: { type: "boolean", short: "v" },
+        help: { type: "boolean", short: "h" },
+        version: { type: "boolean", short: "V" }
+      },
+      allowPositionals: false,
+      strict: false
+    });
+    return {
+      apiKey: values["api-key"],
+      only: values.only,
+      skipVerify: values["skip-verify"],
+      verbose: values.verbose,
+      help: values.help,
+      version: values.version
+    };
+  } catch {
+    return {};
+  }
+}
+function printHelp() {
+  console.log(`
+${pc.bold(pc.cyan("easyrouter-config"))} ${pc.dim("v" + VERSION)}
+\u4E00\u952E\u628A EasyRouter \u63A5\u5165 Claude Code & Codex\uFF08\u6309\u91CF\u4ED8\u8D39\uFF09
+
+${pc.bold("\u7528\u6CD5:")}
+  ${pc.green("npx -y easyrouter-config")}                       \u4EA4\u4E92\u5F0F\uFF08\u63A8\u8350\uFF09
+  ${pc.green("npx -y easyrouter-config -k sk-xxx")}             \u4E00\u884C\u547D\u4EE4\u914D\u7F6E
+  ${pc.green("npx -y easyrouter-config -k sk-xxx --only claude")}  \u53EA\u914D Claude Code
+
+${pc.bold("\u53C2\u6570:")}
+  -k, --api-key <key>     EasyRouter API Key\uFF08\u53EF\u7701\u7565 sk- \u524D\u7F00\uFF09
+      --only <tool>       claude | codex \uFF08\u53EA\u914D\u5176\u4E00\uFF09
+      --skip-verify       \u8DF3\u8FC7\u8FDE\u901A\u6027\u9A8C\u8BC1
+  -v, --verbose           \u663E\u793A zcf \u5B50\u8FDB\u7A0B\u8BE6\u7EC6\u8F93\u51FA
+  -h, --help              \u663E\u793A\u5E2E\u52A9
+  -V, --version           \u663E\u793A\u7248\u672C
+
+${pc.bold("\u5185\u7F6E BaseURL:")}
+  Claude Code \u2192 ${CLAUDE_BASE_URL}
+  Codex       \u2192 ${CODEX_BASE_URL}
+
+${pc.bold("\u539F\u7406:")}
+  \u672C\u5DE5\u5177\u662F ${pc.underline("zcf")} (https://github.com/UfoMiao/zcf) \u7684\u8584\u5C01\u88C5\u3002
+  \u5B9E\u9645\u5199\u5165\u7684\u914D\u7F6E\u5B8C\u5168\u7531 zcf \u5B8C\u6210\uFF1A
+    \u2022 Claude Code \u2192 ~/.claude/settings.json
+    \u2022 Codex       \u2192 ~/.codex/config.toml + ~/.codex/auth.json
+`);
+}
+async function runZcf(opts) {
+  const args = [
+    "-y",
+    "zcf",
+    "init",
+    "-s",
+    // --skip-prompt
+    "--code-type",
+    opts.codeType,
+    "-p",
+    "custom",
+    "--api-type",
+    "auth_token",
+    // EasyRouter 走 Bearer
+    "-u",
+    opts.baseUrl,
+    "-k",
+    opts.apiKey,
+    "-r",
+    "backup",
+    // 已有配置自动备份
+    "--mcp-services",
+    "skip",
+    // 不装额外 MCP，加速
+    "--workflows",
+    "skip",
+    // 不装工作流模板
+    "--output-styles",
+    "skip",
+    // 不装输出样式
+    "--install-cometix-line",
+    "false"
+    // 不装状态栏
+  ];
+  let capturedOut = "";
+  let capturedErr = "";
+  try {
+    const child = execa("npx", args, {
+      stdio: opts.verbose ? "inherit" : "pipe",
+      env: { ...process.env, FORCE_COLOR: opts.verbose ? "1" : "0" },
+      reject: true
+    });
+    if (!opts.verbose) {
+      child.stdout?.on("data", (chunk) => {
+        capturedOut += chunk.toString();
+      });
+      child.stderr?.on("data", (chunk) => {
+        capturedErr += chunk.toString();
+      });
+    }
+    await child;
+  } catch (err) {
+    const detail = err?.stderr || err?.stdout || err?.message || String(err);
+    throw new Error(
+      `zcf \u6267\u884C\u5931\u8D25 (code-type=${opts.codeType}):
+${detail}
+
+\u{1F4A1} \u7528 ${pc.green("--verbose")} \u91CD\u65B0\u8FD0\u884C\u53EF\u770B\u5230\u5B8C\u6574\u65E5\u5FD7`
+    );
+  }
+  const combined = capturedOut + "\n" + capturedErr;
+  if (/CACError|Unknown option/i.test(combined)) {
+    const match = combined.match(/(CACError:.*?)(?:\n|$)/);
+    throw new Error(
+      `zcf \u62D2\u7EDD\u4E86\u6211\u4EEC\u4F20\u7684\u53C2\u6570\uFF08code-type=${opts.codeType}\uFF09\uFF1A
+  ${match?.[1] || "Unknown option"}
+
+\u8FD9\u901A\u5E38\u610F\u5473\u7740 zcf \u5347\u7EA7\u540E flag \u547D\u540D\u53D8\u4E86\u3002\u8BF7\u8054\u7CFB service@easyrouter.io\u3002`
+    );
+  }
+}
+async function verifyConnection(baseUrl, apiKey) {
+  const probeUrl = baseUrl.replace(/\/+$/, "") + "/v1/models";
+  try {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 1e4);
+    const res = await fetch(probeUrl, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "anthropic-version": "2023-06-01"
+      },
+      signal: ctrl.signal
+    });
+    clearTimeout(timer);
+    return { ok: res.ok, status: res.status };
+  } catch (err) {
+    return { ok: false, error: err?.message || String(err) };
+  }
+}
+function normalizeApiKey(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) return trimmed;
+  if (trimmed.startsWith("sk-")) return trimmed;
+  return "sk-" + trimmed;
+}
+function maskKey(key) {
+  if (key.length <= 8) return "*".repeat(key.length);
+  return key.slice(0, 6) + "*".repeat(Math.max(4, key.length - 10)) + key.slice(-4);
+}
+async function main() {
+  const args = parseCliArgs();
+  if (args.help) {
+    printHelp();
+    return;
+  }
+  if (args.version) {
+    console.log(VERSION);
+    return;
+  }
+  console.log();
+  intro(pc.bgCyan(pc.black(" EasyRouter Config ")) + pc.dim(" v" + VERSION));
+  let apiKey;
+  if (args.apiKey) {
+    apiKey = normalizeApiKey(args.apiKey);
+    log.info(`API Key: ${pc.dim(maskKey(apiKey))}\uFF08\u6765\u81EA\u547D\u4EE4\u884C\u53C2\u6570\uFF09`);
+  } else {
+    const input = await text({
+      message: "\u8BF7\u8F93\u5165\u4F60\u7684 EasyRouter API Key",
+      placeholder: "sk-xxxxxxxxxxxxxxxx",
+      validate(value) {
+        if (!value) return "\u4E0D\u80FD\u4E3A\u7A7A";
+        if (value.trim().length < 8) return "Key \u957F\u5EA6\u770B\u8D77\u6765\u4E0D\u5BF9";
+        return void 0;
+      }
+    });
+    if (isCancel(input)) {
+      cancel("\u5DF2\u53D6\u6D88");
+      process.exit(0);
+    }
+    apiKey = normalizeApiKey(input);
+  }
+  let configClaude = true;
+  let configCodex = true;
+  if (args.only === "claude") {
+    configCodex = false;
+  } else if (args.only === "codex") {
+    configClaude = false;
+  }
+  note(
+    [
+      `${pc.bold("\u8BA1\u8D39\u6A21\u5F0F")}    \u6309\u91CF\u4ED8\u8D39`,
+      configClaude ? `${pc.bold("Claude URL")}  ${CLAUDE_BASE_URL}` : null,
+      configCodex ? `${pc.bold("Codex URL")}   ${CODEX_BASE_URL}` : null,
+      `${pc.bold("API Key")}     ${maskKey(apiKey)}`,
+      `${pc.bold("\u5C06\u914D\u7F6E")}      ${[
+        configClaude && "Claude Code",
+        configCodex && "Codex"
+      ].filter(Boolean).join(" + ")}`
+    ].filter(Boolean).join("\n"),
+    "\u914D\u7F6E\u9884\u89C8"
+  );
+  if (!args.apiKey) {
+    const ok = await confirm({ message: "\u7EE7\u7EED\uFF1F", initialValue: true });
+    if (isCancel(ok) || !ok) {
+      cancel("\u5DF2\u53D6\u6D88");
+      process.exit(0);
+    }
+  }
+  const verbose = !!args.verbose;
+  if (configClaude) {
+    if (verbose) {
+      log.step("\u914D\u7F6E Claude Code\uFF08\u8BE6\u7EC6\u65E5\u5FD7\uFF09");
+    }
+    const s = verbose || !process.stdout.isTTY ? null : spinner();
+    s?.start("\u914D\u7F6E Claude Code");
+    if (!s && !verbose) log.info("\u6B63\u5728\u914D\u7F6E Claude Code\uFF08\u9996\u6B21\u8FD0\u884C\u9700\u4E0B\u8F7D zcf\uFF0C\u7EA6 30~60 \u79D2\uFF09...");
+    try {
+      await runZcf({
+        codeType: "cc",
+        baseUrl: CLAUDE_BASE_URL,
+        apiKey,
+        verbose
+      });
+      s?.stop(pc.green("\u2713 Claude Code \u914D\u7F6E\u5B8C\u6210 ") + pc.dim("\u2192 ~/.claude/settings.json"));
+      if (!s) log.success(pc.green("\u2713 Claude Code \u914D\u7F6E\u5B8C\u6210 \u2192 ~/.claude/settings.json"));
+    } catch (err) {
+      s?.stop(pc.red("\u2717 Claude Code \u914D\u7F6E\u5931\u8D25"));
+      console.error(err.message);
+      process.exit(1);
+    }
+  }
+  if (configCodex) {
+    if (verbose) {
+      log.step("\u914D\u7F6E Codex\uFF08\u8BE6\u7EC6\u65E5\u5FD7\uFF09");
+    }
+    const s = verbose || !process.stdout.isTTY ? null : spinner();
+    s?.start("\u914D\u7F6E Codex");
+    if (!s && !verbose) log.info("\u6B63\u5728\u914D\u7F6E Codex...");
+    try {
+      await runZcf({
+        codeType: "cx",
+        baseUrl: CODEX_BASE_URL,
+        apiKey,
+        verbose
+      });
+      s?.stop(pc.green("\u2713 Codex \u914D\u7F6E\u5B8C\u6210 ") + pc.dim("\u2192 ~/.codex/config.toml"));
+      if (!s) log.success(pc.green("\u2713 Codex \u914D\u7F6E\u5B8C\u6210 \u2192 ~/.codex/config.toml"));
+    } catch (err) {
+      s?.stop(pc.red("\u2717 Codex \u914D\u7F6E\u5931\u8D25"));
+      console.error(err.message);
+      process.exit(1);
+    }
+  }
+  if (!args.skipVerify) {
+    const s = process.stdout.isTTY ? spinner() : null;
+    s?.start("\u9A8C\u8BC1\u8FDE\u901A\u6027");
+    if (!s) log.info("\u6B63\u5728\u9A8C\u8BC1\u8FDE\u901A\u6027...");
+    const result = await verifyConnection(CLAUDE_BASE_URL, apiKey);
+    if (result.ok) {
+      const msg = pc.green("\u2713 \u94FE\u8DEF\u9A8C\u8BC1\u901A\u8FC7");
+      s?.stop(msg) ?? log.success(msg);
+    } else {
+      const msg = pc.yellow(
+        `\u26A0 \u9A8C\u8BC1\u672A\u901A\u8FC7${result.status ? ` (HTTP ${result.status})` : ""}` + (result.error ? `: ${result.error}` : "") + ` \u2014\u2014 \u914D\u7F6E\u5DF2\u5199\u5165\uFF0C\u53EF\u624B\u52A8\u6D4B\u8BD5`
+      );
+      s?.stop(msg) ?? log.warn(msg);
+    }
+  }
+  const tips = [];
+  if (configClaude) tips.push(pc.cyan("claude") + pc.dim("  # \u542F\u52A8 Claude Code"));
+  if (configCodex) tips.push(pc.cyan("codex") + pc.dim("   # \u542F\u52A8 Codex"));
+  note(tips.join("\n"), "\u{1F389} \u5168\u90E8\u5B8C\u6210\uFF01\u73B0\u5728\u53EF\u4EE5\u8FD0\u884C\uFF1A");
+  outro(
+    pc.dim("\u611F\u8C22\u4F7F\u7528 EasyRouter ") + pc.underline(pc.cyan("https://easyrouter.io")) + pc.dim(" \xB7 powered by ") + pc.underline("zcf")
+  );
+}
+main().catch((err) => {
+  console.error();
+  console.error(pc.red("\u2717 \u81F4\u547D\u9519\u8BEF\uFF1A"), err?.message || err);
+  if (err?.stack && process.env.DEBUG) {
+    console.error(pc.dim(err.stack));
+  }
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "easyrouter-config",
+  "version": "1.0.1",
+  "description": "🚀 一键把 EasyRouter 接入 Claude Code & Codex —— 粘贴 Key 即用",
+  "type": "module",
+  "bin": {
+    "easyrouter-config": "./dist/index.js",
+    "erc": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node ./dist/index.js",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "easyrouter",
+    "claude-code",
+    "codex",
+    "cli",
+    "ai-gateway",
+    "zcf"
+  ],
+  "author": "QuantumNous <service@easyrouter.io>",
+  "license": "MIT",
+  "homepage": "https://easyrouter.io",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.liebaopay.com/easyrouter/easyrouter-cli-config.git"
+  },
+  "bugs": {
+    "url": "https://gitlab.liebaopay.com/easyrouter/easyrouter-cli-config/-/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "execa": "^9.5.2",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  }
+}