connectbase-client 6.0.1 → 6.3.0

package/dist/cli.js

@@ -41,7 +41,8 @@ __export(cli_exports, {
   normalizeRelativePath: () => normalizeRelativePath,
   parseArgs: () => parseArgs,
   registerEndpointBinding: () => registerEndpointBinding,
-  sha256Hex: () => sha256Hex
+  sha256Hex: () => sha256Hex,
+  storageAdminHeaders: () => storageAdminHeaders
 });
 module.exports = __toCommonJS(cli_exports);
 var crypto = __toESM(require("crypto"));
@@ -146,18 +147,7 @@ function handleTunnelError(msg, appId, localPort) {
 }
 
 // src/cli.ts
-function getPackageVersion() {
-  try {
-    const pkgPath = path2.join(__dirname, "..", "package.json");
-    if (fs2.existsSync(pkgPath)) {
-      const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
-      return pkg.version || "0.0.0";
-    }
-  } catch {
-  }
-  return "3.25.1";
-}
-var VERSION = getPackageVersion();
+var VERSION = "6.3.0" ? "6.3.0" : getPackageVersion();
 var DEFAULT_BASE_URL = "https://api.connectbase.world";
 var colors = {
   reset: "\x1B[0m",
@@ -295,6 +285,41 @@ function normalizeRelativePath(relativePath) {
   if (!p.startsWith("/")) p = `/${p}`;
   return p;
 }
+function storageAdminHeaders(config) {
+  const headers = {
+    "X-Public-Key": config.publicKey
+  };
+  if (config.secretKey) {
+    headers["X-User-Secret-Key"] = config.secretKey;
+    headers.Authorization = `Bearer ${config.secretKey}`;
+    return headers;
+  }
+  warn("Secret Key(cb_sk_)\uAC00 \uC124\uC815\uB3FC \uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+  log(
+    "  Public Key \uB294 \uBE0C\uB77C\uC6B0\uC800 \uBC88\uB4E4\uC5D0 \uACF5\uAC1C\uB418\uB294 \uAC12\uC774\uB77C \uBC30\uD3EC/\uC2B9\uACA9\uC758 \uC790\uACA9\uC99D\uBA85\uC774 \uB420 \uC218 \uC5C6\uC5B4,"
+  );
+  log("  \uACE7 \uC11C\uBC84\uAC00 Secret Key \uB97C \uC694\uAD6C\uD569\uB2C8\uB2E4. \uC9C0\uAE08 \uC124\uC815\uD574 \uB450\uC138\uC694.");
+  log(
+    `  ${colors.cyan}npx connectbase-client init${colors.reset} \uC774 \uBC1C\uAE09\uD574 .connectbaserc \uC5D0 \uC800\uC7A5\uD569\uB2C8\uB2E4.`
+  );
+  log(
+    `  \uC774\uBBF8 \uD0A4\uAC00 \uC788\uB2E4\uBA74 ${colors.cyan}CONNECTBASE_SECRET_KEY${colors.reset} \uD658\uACBD\uBCC0\uC218\uB85C \uC9C0\uC815\uD558\uC138\uC694.`
+  );
+  log("  CI \uC5D0\uC11C\uB294 \uC800\uC7A5\uC18C \uC2DC\uD06C\uB9BF\uC5D0 \uB123\uC73C\uC138\uC694 \u2014 \uC800\uC7A5\uC18C\uC5D0 \uCEE4\uBC0B\uD558\uBA74 \uC548 \uB429\uB2C8\uB2E4.");
+  return headers;
+}
+function reportDeployAuthError(status, data) {
+  if (status !== 401) return false;
+  const detail = data?.error;
+  if (detail?.code !== "SECRET_KEY_REQUIRED") return false;
+  error(detail.message || "\uC774 \uC694\uCCAD\uC5D0\uB294 Secret Key \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.");
+  if (detail.suggestion) {
+    log("");
+    log(`  ${detail.suggestion}`);
+  }
+  log("");
+  return true;
+}
 function loadConfig() {
   const config = {
     publicKey: process.env.CONNECTBASE_PUBLIC_KEY,
@@ -631,10 +656,10 @@ async function deploy(directory, config, isDev = false, deployOpts = {}) {
       const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
       if (pkg.scripts?.build) {
         warn(
-          `\uBC30\uD3EC \uC804 \uBE4C\uB4DC\uB97C \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694: ${colors.cyan}npm run build && npx connectbase deploy${colors.reset}`
+          `\uBC30\uD3EC \uC804 \uBE4C\uB4DC\uB97C \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694: ${colors.cyan}npm run build && npx connectbase-client deploy${colors.reset}`
         );
         warn(
-          `\uB610\uB294 package.json\uC5D0 deploy \uC2A4\uD06C\uB9BD\uD2B8\uB97C \uB4F1\uB85D\uD558\uC138\uC694: ${colors.cyan}npx connectbase init${colors.reset}`
+          `\uB610\uB294 package.json\uC5D0 deploy \uC2A4\uD06C\uB9BD\uD2B8\uB97C \uB4F1\uB85D\uD558\uC138\uC694: ${colors.cyan}npx connectbase-client init${colors.reset}`
         );
       }
     } catch {
@@ -666,11 +691,11 @@ async function deploy(directory, config, isDev = false, deployOpts = {}) {
   const envLabel = isDev ? "QA" : "Prod";
   if (isDev) {
     warn(
-      `${colors.yellow}--dev \uB294 deprecated${colors.reset} \uC785\uB2C8\uB2E4 \u2014 QA \uCC44\uB110\uB85C \uBC30\uD3EC\uD569\uB2C8\uB2E4(production \uBBF8\uBC18\uC601). \uC774\uD6C4 ${colors.cyan}npx connectbase promote${colors.reset} \uB85C production \uC5D0 \uBC18\uC601\uD558\uC138\uC694. promote_mode=manual \uC774\uBA74 \uC77C\uBC18 ${colors.cyan}deploy${colors.reset} \uB3C4 \uB3D9\uC77C\uD558\uAC8C QA \uB85C \uBC30\uD3EC\uB429\uB2C8\uB2E4.`
+      `${colors.yellow}--dev \uB294 deprecated${colors.reset} \uC785\uB2C8\uB2E4 \u2014 QA \uCC44\uB110\uB85C \uBC30\uD3EC\uD569\uB2C8\uB2E4(production \uBBF8\uBC18\uC601). \uC774\uD6C4 ${colors.cyan}npx connectbase-client promote${colors.reset} \uB85C production \uC5D0 \uBC18\uC601\uD558\uC138\uC694. promote_mode=manual \uC774\uBA74 \uC77C\uBC18 ${colors.cyan}deploy${colors.reset} \uB3C4 \uB3D9\uC77C\uD558\uAC8C QA \uB85C \uBC30\uD3EC\uB429\uB2C8\uB2E4.`
     );
   }
   const baseStorageUrl = `${config.baseUrl}/v1/public/storages/webs/${config.storageId}`;
-  const headers = { "X-Public-Key": config.publicKey };
+  const headers = storageAdminHeaders(config);
   const timeoutMs = computeDeployTimeout(totalSize, deployOpts.timeoutMs);
   log(
     `${colors.dim}\uD0C0\uC784\uC544\uC6C3: ${Math.round(timeoutMs / 1e3)}\uCD08${colors.reset}`
@@ -882,7 +907,7 @@ ${colors.cyan}Production: ${dep.production_url}${colors.reset}`
           log(`
 ${colors.yellow}QA URL:  ${dep.qa_url}${colors.reset}`);
         log(
-          `${colors.dim}\uAC80\uC99D \uD6C4 \uBC18\uC601: ${colors.cyan}npx connectbase promote${colors.reset}
+          `${colors.dim}\uAC80\uC99D \uD6C4 \uBC18\uC601: ${colors.cyan}npx connectbase-client promote${colors.reset}
 `
         );
       }
@@ -897,13 +922,15 @@ ${colors.cyan}URL: ${data.url}${colors.reset}
   } else {
     const data = response.data;
     const errorMsg = typeof data === "object" && data !== null ? data.message || data.error || JSON.stringify(data) : typeof data === "string" ? data : `HTTP ${response.status}`;
-    error(`\uBC30\uD3EC \uC2E4\uD328: ${errorMsg}`);
+    if (!reportDeployAuthError(response.status, response.data)) {
+      error(`\uBC30\uD3EC \uC2E4\uD328: ${errorMsg}`);
+    }
     process.exit(1);
   }
 }
 async function promote(config, deploymentId) {
   const baseStorageUrl = `${config.baseUrl}/v1/public/storages/webs/${config.storageId}`;
-  const headers = { "X-Public-Key": config.publicKey };
+  const headers = storageAdminHeaders(config);
   info(
     deploymentId ? `release ${deploymentId} \uB97C production \uC73C\uB85C \uC2B9\uACA9\uD569\uB2C8\uB2E4...` : "\uCD5C\uC2E0 \uBC30\uD3EC\uB97C production \uC73C\uB85C \uC2B9\uACA9\uD569\uB2C8\uB2E4..."
   );
@@ -925,7 +952,9 @@ async function promote(config, deploymentId) {
   if (res.status < 200 || res.status >= 300) {
     const data2 = res.data;
     const msg = typeof data2 === "object" && data2 !== null ? data2.error || data2.message || JSON.stringify(data2) : `HTTP ${res.status}`;
-    error(`promote \uC2E4\uD328: ${msg}`);
+    if (!reportDeployAuthError(res.status, res.data)) {
+      error(`promote \uC2E4\uD328: ${msg}`);
+    }
     process.exit(1);
   }
   const data = res.data;
@@ -938,7 +967,7 @@ ${colors.cyan}Production: ${data.production_url}${colors.reset}
 }
 async function listReleases(config) {
   const baseStorageUrl = `${config.baseUrl}/v1/public/storages/webs/${config.storageId}`;
-  const headers = { "X-Public-Key": config.publicKey };
+  const headers = storageAdminHeaders(config);
   const res = await makeRequest(
     `${baseStorageUrl}/deployments`,
     "GET",
@@ -947,7 +976,9 @@ async function listReleases(config) {
   if (res.status < 200 || res.status >= 300) {
     const data2 = res.data;
     const msg = typeof data2 === "object" && data2 !== null ? data2.error || data2.message || JSON.stringify(data2) : `HTTP ${res.status}`;
-    error(`\uBC30\uD3EC \uC774\uB825 \uC870\uD68C \uC2E4\uD328: ${msg}`);
+    if (!reportDeployAuthError(res.status, res.data)) {
+      error(`\uBC30\uD3EC \uC774\uB825 \uC870\uD68C \uC2E4\uD328: ${msg}`);
+    }
     process.exit(1);
   }
   const data = res.data;
@@ -977,7 +1008,7 @@ ${colors.cyan}\uBC30\uD3EC \uC774\uB825${colors.reset} (promote_mode: ${data.pro
   if (data.qa_url)
     log(`${colors.yellow}QA:         ${data.qa_url}${colors.reset}`);
   log(
-    `${colors.dim}\uB864\uBC31: npx connectbase promote <deployment_id>${colors.reset}
+    `${colors.dim}\uB864\uBC31: npx connectbase-client promote <deployment_id>${colors.reset}
 `
   );
 }
@@ -1044,7 +1075,9 @@ function getProjectRoot() {
   const gitRoot = getGitRoot();
   return gitRoot || process.cwd();
 }
-var CONSOLE_URL = DEFAULT_BASE_URL.replace("api.", "");
+function consoleUrlFor(baseUrl) {
+  return baseUrl.replace("api.", "");
+}
 function openBrowser(url) {
   const { exec } = require("child_process");
   const platform2 = process.platform;
@@ -1059,10 +1092,10 @@ function openBrowser(url) {
   exec(command, () => {
   });
 }
-async function browserAuthFlow() {
+async function browserAuthFlow(baseUrl = DEFAULT_BASE_URL) {
   info("\uBE0C\uB77C\uC6B0\uC800 \uC778\uC99D \uC138\uC158\uC744 \uC2DC\uC791\uD569\uB2C8\uB2E4...");
   const startRes = await makeRequest(
-    `${DEFAULT_BASE_URL}/v1/public/cli-auth/start`,
+    `${baseUrl}/v1/public/cli-auth/start`,
     "POST",
     {}
   );
@@ -1073,7 +1106,7 @@ async function browserAuthFlow() {
     process.exit(1);
   }
   const { session_id } = startRes.data;
-  const authUrl = `${CONSOLE_URL}/auth/cli-auth?session=${session_id}`;
+  const authUrl = `${consoleUrlFor(baseUrl)}/auth/cli-auth?session=${session_id}`;
   log(`
 ${colors.cyan}\uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uB85C\uADF8\uC778\uD558\uC138\uC694:${colors.reset}`);
   log(`${colors.dim}${authUrl}${colors.reset}
@@ -1093,7 +1126,7 @@ ${colors.cyan}\uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uB85C\uADF8\uC778\uD558\uC13
     await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
     try {
       const pollRes = await makeRequest(
-        `${DEFAULT_BASE_URL}/v1/public/cli-auth/poll/${session_id}`,
+        `${baseUrl}/v1/public/cli-auth/poll/${session_id}`,
         "GET",
         {}
       );
@@ -1140,10 +1173,73 @@ ${colors.cyan}\uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uB85C\uADF8\uC778\uD558\uC13
   error("\uC778\uC99D \uC2DC\uAC04\uC774 \uCD08\uACFC\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC2DC\uB3C4\uD574\uC8FC\uC138\uC694.");
   process.exit(1);
 }
+async function promptForSecretKey(baseUrl = DEFAULT_BASE_URL) {
+  log(`
+${colors.dim}\uC778\uC99D \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:${colors.reset}`);
+  log(`  ${colors.cyan}1${colors.reset}) Secret Key \uC9C1\uC811 \uC785\uB825 (cb_sk_...)`);
+  log(`  ${colors.cyan}2${colors.reset}) \uBE0C\uB77C\uC6B0\uC800 \uB85C\uADF8\uC778\uC73C\uB85C \uC790\uB3D9 \uBC1C\uAE09
+`);
+  const authChoice = await prompt(
+    `${colors.blue}?${colors.reset} \uC120\uD0DD (1/2): `
+  );
+  if (authChoice === "2") {
+    try {
+      return await browserAuthFlow(baseUrl);
+    } catch (err) {
+      error(`\uB124\uD2B8\uC6CC\uD06C \uC624\uB958: ${err instanceof Error ? err.message : err}`);
+      info(
+        "\uC778\uD130\uB137 \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uAC70\uB098, Secret Key \uC9C1\uC811 \uC785\uB825(\uC635\uC158 1)\uC744 \uC2DC\uB3C4\uD558\uC138\uC694"
+      );
+      process.exit(1);
+    }
+  }
+  log(
+    `${colors.dim}Secret Key (cb_sk_): \uCF58\uC194 > \uD504\uB85C\uD544 > \uC2DC\uD06C\uB9BF \uD0A4 \uD0ED\uC5D0\uC11C \uBC1C\uAE09${colors.reset}
+`
+  );
+  const entered = await promptSecret(
+    `${colors.blue}?${colors.reset} Secret Key: `
+  );
+  if (!entered) {
+    error("Secret Key\uB294 \uD544\uC218\uC785\uB2C8\uB2E4");
+    process.exit(1);
+  }
+  if (entered.startsWith("cb_pk_")) {
+    error("Public Key\uAC00 \uC544\uB2CC Secret Key(cb_sk_)\uB97C \uC785\uB825\uD558\uC138\uC694");
+    info("Secret Key\uB294 \uCF58\uC194 > \uD504\uB85C\uD544 > \uC2DC\uD06C\uB9BF \uD0A4 \uD0ED\uC5D0\uC11C \uC0DD\uC131\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4");
+    process.exit(1);
+  }
+  if (!entered.startsWith("cb_sk_")) {
+    error(
+      "\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uD0A4 \uD615\uC2DD\uC785\uB2C8\uB2E4. cb_sk_\uB85C \uC2DC\uC791\uD558\uB294 Secret Key\uB97C \uC785\uB825\uD558\uC138\uC694"
+    );
+    process.exit(1);
+  }
+  return entered;
+}
+function saveSecretKeyToRc(secretKey, dir = process.cwd()) {
+  const rcPath = path2.join(dir, ".connectbaserc");
+  let rcData = {};
+  if (fs2.existsSync(rcPath)) {
+    try {
+      rcData = JSON.parse(fs2.readFileSync(rcPath, "utf-8"));
+    } catch {
+    }
+  }
+  rcData.secretKey = secretKey;
+  fs2.writeFileSync(rcPath, `${JSON.stringify(rcData, null, 2)}
+`);
+}
+async function fetchAppsWithSecretKey(baseUrl, secretKey) {
+  return makeRequest(`${baseUrl}/v1/public/cli/apps`, "GET", {
+    "X-Public-Key": secretKey
+  });
+}
 async function init(config = {}, opts = {}) {
   log(`
 ${colors.cyan}Connect Base \uD504\uB85C\uC81D\uD2B8 \uCD08\uAE30\uD654${colors.reset}
 `);
+  const baseUrl = config.baseUrl || DEFAULT_BASE_URL;
   const cwd = process.cwd();
   const projectRoot = getProjectRoot();
   if (cwd !== projectRoot) {
@@ -1157,7 +1253,7 @@ ${colors.cyan}Connect Base \uD504\uB85C\uC81D\uD2B8 \uCD08\uAE30\uD654${colors.r
   if (!process.stdin.isTTY && !nonInteractive) {
     error("\uBE44\uB300\uD654\uD615 \uD658\uACBD\uC785\uB2C8\uB2E4. --yes \uD50C\uB798\uADF8\uC640 \uD568\uAED8 \uD544\uC694\uD55C \uAC12\uC744 \uC9C0\uC815\uD558\uC138\uC694");
     log(
-      `${colors.dim}\uC608: npx connectbase init --yes --secret-key cb_sk_... [--app <\uC571ID>] [--storage <\uC2A4\uD1A0\uB9AC\uC9C0ID>] [--deploy-dir ./dist]${colors.reset}`
+      `${colors.dim}\uC608: npx connectbase-client init --yes --secret-key cb_sk_... [--app <\uC571ID>] [--storage <\uC2A4\uD1A0\uB9AC\uC9C0ID>] [--deploy-dir ./dist]${colors.reset}`
     );
     log(
       `${colors.dim}Secret Key\uB294 CONNECTBASE_SECRET_KEY \uD658\uACBD\uBCC0\uC218\uB85C\uB3C4 \uC804\uB2EC\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4${colors.reset}`
@@ -1179,10 +1275,14 @@ ${colors.cyan}Connect Base \uD504\uB85C\uC81D\uD2B8 \uCD08\uAE30\uD654${colors.r
         process.exit(1);
       }
     } else {
+      info(
+        ".connectbaserc\uAC00 \uC774\uBBF8 \uC788\uC2B5\uB2C8\uB2E4 \u2014 \uAE30\uC874 \uC571/\uD0A4 \uC124\uC815\uC744 \uC7AC\uC0AC\uC6A9\uD574 \uB2E4\uC2DC \uAD6C\uC131\uD569\uB2C8\uB2E4"
+      );
       const overwrite = await prompt(
-        `${colors.yellow}\u26A0${colors.reset} .connectbaserc\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4. \uB36E\uC5B4\uC4F0\uC2DC\uACA0\uC2B5\uB2C8\uAE4C? (y/N): `
+        `${colors.blue}?${colors.reset} \uACC4\uC18D\uD560\uAE4C\uC694? (Y/n): `
       );
-      if (overwrite.toLowerCase() !== "y") {
+      const answer = overwrite.toLowerCase();
+      if (answer === "n" || answer === "no") {
         info("\uCD08\uAE30\uD654\uAC00 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4");
         return;
       }
@@ -1196,57 +1296,14 @@ ${colors.cyan}Connect Base \uD504\uB85C\uC81D\uD2B8 \uCD08\uAE30\uD654${colors.r
       );
       process.exit(1);
     }
-    info("Secret Key \uD655\uC778\uB428 (\uD50C\uB798\uADF8/\uD658\uACBD\uBCC0\uC218/.connectbaserc)");
+    info("\uC800\uC7A5\uB41C Secret Key \uC0AC\uC6A9 (\uD50C\uB798\uADF8/\uD658\uACBD\uBCC0\uC218/.connectbaserc)");
   } else if (nonInteractive) {
     error(
       "Secret Key\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4: --secret-key cb_sk_... \uB610\uB294 CONNECTBASE_SECRET_KEY \uD658\uACBD\uBCC0\uC218"
     );
     process.exit(1);
   } else {
-    log(`
-${colors.dim}\uC778\uC99D \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:${colors.reset}`);
-    log(`  ${colors.cyan}1${colors.reset}) Secret Key \uC9C1\uC811 \uC785\uB825 (cb_sk_...)`);
-    log(`  ${colors.cyan}2${colors.reset}) \uBE0C\uB77C\uC6B0\uC800 \uB85C\uADF8\uC778\uC73C\uB85C \uC790\uB3D9 \uBC1C\uAE09
-`);
-    const authChoice = await prompt(
-      `${colors.blue}?${colors.reset} \uC120\uD0DD (1/2): `
-    );
-    if (authChoice === "2") {
-      try {
-        secretKey = await browserAuthFlow();
-      } catch (err) {
-        error(`\uB124\uD2B8\uC6CC\uD06C \uC624\uB958: ${err instanceof Error ? err.message : err}`);
-        info(
-          "\uC778\uD130\uB137 \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uAC70\uB098, Secret Key \uC9C1\uC811 \uC785\uB825(\uC635\uC158 1)\uC744 \uC2DC\uB3C4\uD558\uC138\uC694"
-        );
-        process.exit(1);
-      }
-    } else {
-      log(
-        `${colors.dim}Secret Key (cb_sk_): \uCF58\uC194 > \uD504\uB85C\uD544 > \uC2DC\uD06C\uB9BF \uD0A4 \uD0ED\uC5D0\uC11C \uBC1C\uAE09${colors.reset}
-`
-      );
-      secretKey = await promptSecret(
-        `${colors.blue}?${colors.reset} Secret Key: `
-      );
-      if (!secretKey) {
-        error("Secret Key\uB294 \uD544\uC218\uC785\uB2C8\uB2E4");
-        process.exit(1);
-      }
-      if (secretKey.startsWith("cb_pk_")) {
-        error("Public Key\uAC00 \uC544\uB2CC Secret Key(cb_sk_)\uB97C \uC785\uB825\uD558\uC138\uC694");
-        info(
-          "Secret Key\uB294 \uCF58\uC194 > \uD504\uB85C\uD544 > \uC2DC\uD06C\uB9BF \uD0A4 \uD0ED\uC5D0\uC11C \uC0DD\uC131\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4"
-        );
-        process.exit(1);
-      }
-      if (!secretKey.startsWith("cb_sk_")) {
-        error(
-          "\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uD0A4 \uD615\uC2DD\uC785\uB2C8\uB2E4. cb_sk_\uB85C \uC2DC\uC791\uD558\uB294 Secret Key\uB97C \uC785\uB825\uD558\uC138\uC694"
-        );
-        process.exit(1);
-      }
-    }
+    secretKey = await promptForSecretKey(baseUrl);
   }
   let appId = "";
   let publicKey = "";
@@ -1262,7 +1319,7 @@ ${colors.dim}\uC778\uC99D \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:${co
   const issuePublicKey = async (targetAppId) => {
     info("Public Key \uC0DD\uC131 \uC911...");
     const newKeyRes = await makeRequest(
-      `${DEFAULT_BASE_URL}/v1/public/cli/apps/${targetAppId}/public-keys`,
+      `${baseUrl}/v1/public/cli/apps/${targetAppId}/public-keys`,
       "POST",
       { "X-Public-Key": secretKey },
       JSON.stringify({})
@@ -1277,14 +1334,26 @@ ${colors.dim}\uC778\uC99D \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:${co
   };
   try {
     info("\uC571 \uBAA9\uB85D \uC870\uD68C \uC911...");
-    const appsRes = await makeRequest(
-      `${DEFAULT_BASE_URL}/v1/public/cli/apps`,
-      "GET",
-      { "X-Public-Key": secretKey }
-    );
+    let appsRes = await fetchAppsWithSecretKey(baseUrl, secretKey);
     if (appsRes.status === 401) {
-      error("Secret Key\uAC00 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uCF58\uC194\uC5D0\uC11C \uD0A4\uB97C \uD655\uC778\uD558\uC138\uC694");
-      process.exit(1);
+      warn("\uC800\uC7A5\uB41C Secret Key\uAC00 \uB354 \uC774\uC0C1 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 (\uB9CC\uB8CC \uB610\uB294 \uCDE8\uC18C)");
+      if (nonInteractive) {
+        error(
+          "\uC0C8 Secret Key\uB97C --secret-key cb_sk_... \uB610\uB294 CONNECTBASE_SECRET_KEY \uB85C \uC804\uB2EC\uD558\uC138\uC694"
+        );
+        process.exit(1);
+      }
+      info("\uC0C8 Secret Key\uB85C \uB2E4\uC2DC \uC778\uC99D\uD569\uB2C8\uB2E4");
+      secretKey = await promptForSecretKey(baseUrl);
+      appsRes = await fetchAppsWithSecretKey(baseUrl, secretKey);
+      if (appsRes.status === 401) {
+        error(
+          "\uC0C8\uB85C \uBC1B\uC740 Secret Key\uB3C4 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uCF58\uC194 > \uD504\uB85C\uD544 > \uC2DC\uD06C\uB9BF \uD0A4 \uD0ED\uC5D0\uC11C \uD0A4 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uC138\uC694"
+        );
+        process.exit(1);
+      }
+      saveSecretKeyToRc(secretKey, cwd);
+      success("\uC0C8 Secret Key\uB97C .connectbaserc\uC5D0 \uC800\uC7A5\uD588\uC2B5\uB2C8\uB2E4");
     }
     if (appsRes.status !== 200) {
       throw new Error(`HTTP ${appsRes.status}`);
@@ -1334,7 +1403,7 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `
       ) || projectName;
       info("\uC571 \uC0DD\uC131 \uC911...");
       const createRes = await makeRequest(
-        `${DEFAULT_BASE_URL}/v1/public/cli/apps`,
+        `${baseUrl}/v1/public/cli/apps`,
         "POST",
         { "X-Public-Key": secretKey },
         JSON.stringify({ name: appName })
@@ -1389,9 +1458,13 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `
     try {
       info("\uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0 \uC870\uD68C \uC911...");
       const listRes = await makeRequest(
-        `${DEFAULT_BASE_URL}/v1/public/storages/webs`,
+        `${baseUrl}/v1/public/storages/webs`,
         "GET",
-        { "X-Public-Key": publicKeyForSdk }
+        {
+          "X-Public-Key": publicKeyForSdk,
+          "X-User-Secret-Key": secretKey,
+          Authorization: `Bearer ${secretKey}`
+        }
       );
       if (listRes.status === 200) {
         const listData = listRes.data;
@@ -1427,9 +1500,13 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `
           ) || projectName;
           info("\uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0 \uC0DD\uC131 \uC911...");
           const createRes = await makeRequest(
-            `${DEFAULT_BASE_URL}/v1/public/storages/webs`,
+            `${baseUrl}/v1/public/storages/webs`,
             "POST",
-            { "X-Public-Key": publicKeyForSdk },
+            {
+              "X-Public-Key": publicKeyForSdk,
+              "X-User-Secret-Key": secretKey,
+              Authorization: `Bearer ${secretKey}`
+            },
             JSON.stringify({ name })
           );
           if (createRes.status !== 200) {
@@ -1479,12 +1556,17 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `
 `);
   success(".connectbaserc \uC0DD\uC131 \uC644\uB8CC");
   addToGitignore(".connectbaserc");
-  addDeployScript(deployDir);
-  await setupClaudeCode(secretKey, projectRoot);
+  const { needsInstall } = addDeployScript(deployDir);
+  await setupClaudeCode(secretKey, projectRoot, baseUrl);
   log(`
 ${colors.green}\uCD08\uAE30\uD654 \uC644\uB8CC!${colors.reset}
 `);
   log(`${colors.dim}\uBC30\uD3EC\uD558\uB824\uBA74:${colors.reset}`);
+  if (needsInstall) {
+    log(
+      `  ${colors.cyan}npm install${colors.reset}   ${colors.dim}# connectbase-client (CLI \uD3EC\uD568) \uC124\uCE58${colors.reset}`
+    );
+  }
   log(`  ${colors.cyan}npm run deploy${colors.reset}`);
   log(`
 ${colors.dim}Claude Code\uC5D0\uC11C MCP\uAC00 \uC790\uB3D9 \uC5F0\uACB0\uB429\uB2C8\uB2E4${colors.reset}
@@ -1539,31 +1621,46 @@ function addDeployScript(deployDir) {
   const pkgPath = path2.join(process.cwd(), "package.json");
   if (!fs2.existsSync(pkgPath)) {
     warn("package.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC5B4 deploy \uC2A4\uD06C\uB9BD\uD2B8\uB97C \uCD94\uAC00\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4");
-    return;
+    return { needsInstall: false };
   }
   try {
     const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
     if (!pkg.scripts) pkg.scripts = {};
+    const declared = (name) => Boolean(pkg.dependencies?.[name] || pkg.devDependencies?.[name]);
+    let needsInstall = false;
+    if (!declared("connectbase-client")) {
+      if (!pkg.devDependencies) pkg.devDependencies = {};
+      pkg.devDependencies["connectbase-client"] = VERSION === "0.0.0" ? "latest" : `^${VERSION}`;
+      needsInstall = true;
+    }
     if (pkg.scripts.deploy) {
       info(
         `package.json\uC5D0 \uC774\uBBF8 deploy \uC2A4\uD06C\uB9BD\uD2B8\uAC00 \uC788\uC2B5\uB2C8\uB2E4: "${pkg.scripts.deploy}"`
       );
-      return;
+    } else {
+      const deployCmd = `connectbase deploy ${deployDir}`;
+      pkg.scripts.deploy = pkg.scripts.build ? `npm run build && ${deployCmd}` : deployCmd;
+      success("package.json\uC5D0 deploy \uC2A4\uD06C\uB9BD\uD2B8 \uCD94\uAC00 \uC644\uB8CC");
     }
-    const deployCmd = `connectbase deploy ${deployDir}`;
-    pkg.scripts.deploy = pkg.scripts.build ? `${pkg.scripts.build} && ${deployCmd}` : deployCmd;
     fs2.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `);
-    success(`package.json\uC5D0 deploy \uC2A4\uD06C\uB9BD\uD2B8 \uCD94\uAC00 \uC644\uB8CC`);
+    if (needsInstall) {
+      success(
+        `package.json devDependencies\uC5D0 connectbase-client@${pkg.devDependencies["connectbase-client"]} \uCD94\uAC00 \uC644\uB8CC`
+      );
+    }
+    return { needsInstall };
   } catch {
     warn("package.json \uC218\uC815\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4");
+    return { needsInstall: false };
   }
 }
 function getGitRoot() {
   try {
     const { execSync } = require("child_process");
     return execSync("git rev-parse --show-toplevel", {
-      encoding: "utf-8"
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
     }).trim();
   } catch {
     return null;
@@ -1665,6 +1762,7 @@ var LEGACY_DOC_FILES = [
 ];
 async function downloadDocs(baseDir, opts = {}) {
   const quiet = opts.quiet === true;
+  const baseUrl = opts.baseUrl || DEFAULT_BASE_URL;
   if (!baseDir) {
     baseDir = getProjectRoot();
   }
@@ -1686,7 +1784,7 @@ async function downloadDocs(baseDir, opts = {}) {
   if (!quiet) info("SDK \uAC1C\uBC1C \uAC00\uC774\uB4DC \uB2E4\uC6B4\uB85C\uB4DC \uC911...");
   try {
     const res = await makeRequest(
-      `${DEFAULT_BASE_URL}/v1/storages/webs/claude-md?template=rules&format=sections`,
+      `${baseUrl}/v1/storages/webs/claude-md?template=rules&format=sections`,
       "GET",
       {}
     );
@@ -1719,7 +1817,7 @@ async function downloadDocs(baseDir, opts = {}) {
       }
       return "unchanged";
     }
-    const stamp = `<!-- generated by connectbase-cli v${VERSION} (${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}) \u2014 \uC790\uB3D9 \uC0DD\uC131 \uD30C\uC77C\uC785\uB2C8\uB2E4. \uC9C1\uC811 \uC218\uC815\uD558\uC9C0 \uB9D0\uACE0 'npx connectbase update'\uB85C \uAC31\uC2E0\uD558\uC138\uC694 -->
+    const stamp = `<!-- generated by connectbase-cli v${VERSION} (${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}) \u2014 \uC790\uB3D9 \uC0DD\uC131 \uD30C\uC77C\uC785\uB2C8\uB2E4. \uC9C1\uC811 \uC218\uC815\uD558\uC9C0 \uB9D0\uACE0 'npx connectbase-client update'\uB85C \uAC31\uC2E0\uD558\uC138\uC694 -->
 
 `;
     for (const section of sections) {
@@ -1799,7 +1897,7 @@ function updateRootClaudeMd(claudeMdPath, quiet = false) {
 
 1. \uC704\uC5D0 import\uB41C project-rules.md\uC758 \uAE30\uB2A5 \uB9E4\uD551\uD45C\xB7\uBCF4\uC548 \uADDC\uCE59\uC744 \uB530\uB974\uC138\uC694
 2. \uCF54\uB4DC\uB97C \uC791\uC131\uD558\uAE30 \uC804 \`search_sdk_docs("\uD0A4\uC6CC\uB4DC")\`\uB85C SDK \uAD6C\uD604 \uBC29\uBC95\uC744 \uAC80\uC0C9\uD558\uACE0, \uAC80\uC0C9 \uACB0\uACFC\uC758 \uCF54\uB4DC \uD328\uD134\uC744 \uADF8\uB300\uB85C \uB530\uB974\uC138\uC694
-3. \`search_sdk_docs\` \uB3C4\uAD6C\uAC00 \uBCF4\uC774\uC9C0 \uC54A\uC73C\uBA74 MCP\uAC00 \uC5F0\uACB0\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC785\uB2C8\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \`npx connectbase mcp\` \uC2E4\uD589\uC744 \uC548\uB0B4\uD558\uC138\uC694 (Secret Key \uD544\uC694)
+3. \`search_sdk_docs\` \uB3C4\uAD6C\uAC00 \uBCF4\uC774\uC9C0 \uC54A\uC73C\uBA74 MCP\uAC00 \uC5F0\uACB0\uB418\uC9C0 \uC54A\uC740 \uC0C1\uD0DC\uC785\uB2C8\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \`npx connectbase-client mcp\` \uC2E4\uD589\uC744 \uC548\uB0B4\uD558\uC138\uC694 (Secret Key \uD544\uC694)
 ${endMarker}`;
   if (fs2.existsSync(claudeMdPath)) {
     let content = fs2.readFileSync(claudeMdPath, "utf-8");
@@ -1835,7 +1933,7 @@ function createSubPackageClaudeMd(subClaudeMdPath, gitRoot, quiet = false) {
 
 1. \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8\uC758 \`${relPath}/.claude/docs/project-rules.md\`\uC758 \uAE30\uB2A5 \uB9E4\uD551\uD45C\xB7\uBCF4\uC548 \uADDC\uCE59\uC744 \uB530\uB974\uC138\uC694
 2. \uCF54\uB4DC\uB97C \uC791\uC131\uD558\uAE30 \uC804 \`search_sdk_docs("\uD0A4\uC6CC\uB4DC")\`\uB85C SDK \uAD6C\uD604 \uBC29\uBC95\uC744 \uAC80\uC0C9\uD558\uC138\uC694
-3. \`search_sdk_docs\` \uB3C4\uAD6C\uAC00 \uBCF4\uC774\uC9C0 \uC54A\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \`npx connectbase mcp\` \uC2E4\uD589\uC744 \uC548\uB0B4\uD558\uC138\uC694
+3. \`search_sdk_docs\` \uB3C4\uAD6C\uAC00 \uBCF4\uC774\uC9C0 \uC54A\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \`npx connectbase-client mcp\` \uC2E4\uD589\uC744 \uC548\uB0B4\uD558\uC138\uC694
 ${endMarker}`;
   if (fs2.existsSync(subClaudeMdPath)) {
     let content = fs2.readFileSync(subClaudeMdPath, "utf-8");
@@ -1863,7 +1961,7 @@ ${subBlock}
   }
   if (!quiet) success(`\uC11C\uBE0C \uD328\uD0A4\uC9C0 CLAUDE.md \uC0DD\uC131 \uC644\uB8CC: ${subClaudeMdPath}`);
 }
-async function setupMcp(secretKey) {
+async function setupMcp(secretKey, baseUrl = DEFAULT_BASE_URL) {
   const gitRoot = getGitRoot();
   const root = gitRoot || process.cwd();
   const monorepo = detectMonorepo(root);
@@ -1874,51 +1972,31 @@ async function setupMcp(secretKey) {
     }
   }
   const mcpConfigPath = path2.join(root, ".mcp.json");
+  if (secretKey) {
+    const check = await fetchAppsWithSecretKey(baseUrl, secretKey).catch(
+      () => null
+    );
+    if (check?.status === 401) {
+      warn("\uC800\uC7A5\uB41C Secret Key\uAC00 \uB354 \uC774\uC0C1 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 (\uB9CC\uB8CC \uB610\uB294 \uCDE8\uC18C)");
+      secretKey = "";
+    }
+  }
   if (!secretKey) {
     if (!process.stdin.isTTY) {
-      error("Secret Key\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4 (\uBE44\uB300\uD654\uD615 \uD658\uACBD)");
+      error("\uC720\uD6A8\uD55C Secret Key\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4 (\uBE44\uB300\uD654\uD615 \uD658\uACBD)");
       log(`${colors.dim}\uB2E4\uC74C \uC911 \uD558\uB098\uB85C \uD0A4\uB97C \uC804\uB2EC\uD558\uC138\uC694:${colors.reset}`);
       log(
-        `  ${colors.cyan}npx connectbase mcp --secret-key cb_sk_...${colors.reset}`
+        `  ${colors.cyan}npx connectbase-client mcp --secret-key cb_sk_...${colors.reset}`
       );
       log(
-        `  ${colors.cyan}CONNECTBASE_SECRET_KEY=cb_sk_... npx connectbase mcp${colors.reset}`
+        `  ${colors.cyan}CONNECTBASE_SECRET_KEY=cb_sk_... npx connectbase-client mcp${colors.reset}`
       );
       process.exit(1);
     }
-    log(`
-${colors.dim}\uC778\uC99D \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:${colors.reset}`);
-    log(`  ${colors.cyan}1${colors.reset}) Secret Key \uC9C1\uC811 \uC785\uB825 (cb_sk_...)`);
-    log(`  ${colors.cyan}2${colors.reset}) \uBE0C\uB77C\uC6B0\uC800 \uB85C\uADF8\uC778\uC73C\uB85C \uC790\uB3D9 \uBC1C\uAE09
-`);
-    const authChoice = await prompt(
-      `${colors.blue}?${colors.reset} \uC120\uD0DD (1/2): `
-    );
-    if (authChoice === "2") {
-      try {
-        secretKey = await browserAuthFlow();
-        const skRcPath = path2.join(process.cwd(), ".connectbaserc");
-        let rcData = {};
-        if (fs2.existsSync(skRcPath)) {
-          try {
-            rcData = JSON.parse(fs2.readFileSync(skRcPath, "utf-8"));
-          } catch {
-          }
-        }
-        rcData.secretKey = secretKey;
-        fs2.writeFileSync(skRcPath, `${JSON.stringify(rcData, null, 2)}
-`);
-        addToGitignore(".connectbaserc", root);
-        success("Secret Key \uBC1C\uAE09 \uBC0F \uC800\uC7A5 \uC644\uB8CC");
-      } catch (err) {
-        error(`\uC778\uC99D \uC2E4\uD328: ${err instanceof Error ? err.message : err}`);
-        process.exit(1);
-      }
-    } else {
-      secretKey = await promptSecret(
-        `${colors.blue}?${colors.reset} Secret Key: `
-      );
-    }
+    secretKey = await promptForSecretKey(baseUrl);
+    saveSecretKeyToRc(secretKey);
+    addToGitignore(".connectbaserc", root);
+    success("Secret Key\uB97C .connectbaserc\uC5D0 \uC800\uC7A5\uD588\uC2B5\uB2C8\uB2E4");
   }
   const mcpEntry = {
     type: "http",
@@ -1957,10 +2035,10 @@ ${colors.dim}\uC778\uC99D \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:${co
 ${colors.dim}Claude Code\uC5D0\uC11C ConnectBase MCP \uB3C4\uAD6C\uB97C \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.${colors.reset}`
   );
 }
-async function setupClaudeCode(secretKey, projectRoot) {
+async function setupClaudeCode(secretKey, projectRoot, baseUrl = DEFAULT_BASE_URL) {
   const root = projectRoot || getProjectRoot();
-  await downloadDocs(root);
-  await setupMcp(secretKey);
+  await downloadDocs(root, { baseUrl });
+  await setupMcp(secretKey, baseUrl);
 }
 async function fetchLatestVersion(packageName) {
   try {
@@ -2068,7 +2146,7 @@ ${colors.cyan}ConnectBase Update${colors.reset}
   if (!opts.skipDocs) {
     log("");
     info("SDK \uBB38\uC11C \uC5C5\uB370\uC774\uD2B8 \uC911...");
-    await downloadDocs(projectRoot);
+    await downloadDocs(projectRoot, { baseUrl: config.baseUrl });
   }
   if (!opts.skipMcp) {
     log("");
@@ -2153,15 +2231,15 @@ function setupMonorepoRoot(projectRoot, monorepo) {
     if (!pkg.scripts) pkg.scripts = {};
     let changed = false;
     if (!pkg.scripts["cb:update"]) {
-      pkg.scripts["cb:update"] = "npx connectbase update";
+      pkg.scripts["cb:update"] = "npx connectbase-client update";
       changed = true;
     }
     if (!pkg.scripts["cb:docs"]) {
-      pkg.scripts["cb:docs"] = "npx connectbase docs";
+      pkg.scripts["cb:docs"] = "npx connectbase-client docs";
       changed = true;
     }
     if (!pkg.scripts["cb:mcp"]) {
-      pkg.scripts["cb:mcp"] = "npx connectbase mcp";
+      pkg.scripts["cb:mcp"] = "npx connectbase-client mcp";
       changed = true;
     }
     if (changed) {
@@ -3353,7 +3431,7 @@ function showHelp() {
 ${colors.cyan}connectbase${colors.reset} - Connect Base SDK & CLI
 
 ${colors.yellow}\uC0AC\uC6A9\uBC95:${colors.reset}
-  npx connectbase <command> [options]
+  npx connectbase-client <command> [options]
 
 ${colors.yellow}\uBA85\uB839\uC5B4:${colors.reset}
   init                  \uD504\uB85C\uC81D\uD2B8 \uCD08\uAE30\uD654 (\uC571 \uC0DD\uC131, MCP \uC124\uC815, SDK \uBB38\uC11C \uB2E4\uC6B4\uB85C\uB4DC)
@@ -3401,40 +3479,40 @@ ${colors.yellow}\uC635\uC158:${colors.reset}
 
 ${colors.yellow}\uBE60\uB978 \uC2DC\uC791:${colors.reset}
   ${colors.dim}# 1. \uCD08\uAE30\uD654 (\uCD5C\uCD08 1\uD68C)${colors.reset}
-  npx connectbase init
+  npx connectbase-client init
 
   ${colors.dim}# 1-1. \uBE44\uB300\uD654\uD615 \uCD08\uAE30\uD654 (CI/AI \uC5D0\uC774\uC804\uD2B8)${colors.reset}
-  npx connectbase init --yes --secret-key cb_sk_...
+  npx connectbase-client init --yes --secret-key cb_sk_...
 
   ${colors.dim}# 2. SDK \uC804\uCCB4 \uC5C5\uB370\uC774\uD2B8 (\uBC84\uC804 \uCCB4\uD06C + \uBB38\uC11C + MCP)${colors.reset}
-  npx connectbase update
+  npx connectbase-client update
 
   ${colors.dim}# 2-1. \uBAA8\uB178\uB808\uD3EC \uB8E8\uD2B8\uC5D0 \uD3B8\uC758 \uC2A4\uD06C\uB9BD\uD2B8 \uC124\uCE58${colors.reset}
-  npx connectbase update --setup-root
+  npx connectbase-client update --setup-root
 
   ${colors.dim}# 3. SDK \uBB38\uC11C\uB9CC \uC5C5\uB370\uC774\uD2B8${colors.reset}
-  npx connectbase docs
+  npx connectbase-client docs
 
   ${colors.dim}# 4. MCP \uC11C\uBC84 \uC124\uC815${colors.reset}
-  npx connectbase mcp
+  npx connectbase-client mcp
 
   ${colors.dim}# 4. Prod \uBC30\uD3EC${colors.reset}
   npm run deploy
 
   ${colors.dim}# 4-1. QA \uC6CC\uD06C\uD50C\uB85C\uC6B0 (\uC2E0\uADDC \uC2A4\uD1A0\uB9AC\uC9C0 \uAE30\uBCF8 promote_mode=manual)${colors.reset}
-  npx connectbase deploy ./dist   ${colors.dim}# QA \uD658\uACBD\uC5D0\uB9CC \uBC30\uD3EC${colors.reset}
-  npx connectbase releases        ${colors.dim}# \uBC30\uD3EC \uC774\uB825 \uD655\uC778${colors.reset}
-  npx connectbase promote         ${colors.dim}# QA \uAC80\uC99D \uD6C4 production \uBC18\uC601${colors.reset}
+  npx connectbase-client deploy ./dist   ${colors.dim}# QA \uD658\uACBD\uC5D0\uB9CC \uBC30\uD3EC${colors.reset}
+  npx connectbase-client releases        ${colors.dim}# \uBC30\uD3EC \uC774\uB825 \uD655\uC778${colors.reset}
+  npx connectbase-client promote         ${colors.dim}# QA \uAC80\uC99D \uD6C4 production \uBC18\uC601${colors.reset}
 
   ${colors.dim}# 5. \uD130\uB110 (\uAE30\uBCF8)${colors.reset}
-  npx connectbase tunnel 3000
+  npx connectbase-client tunnel 3000
 
   ${colors.dim}# 6. \uD130\uB110 (GPU \uC11C\uBC84 \uB4F1 \uAE34 \uC751\uB2F5 \uC2DC)${colors.reset}
-  npx connectbase tunnel 7860 --timeout 300 --max-body 50
+  npx connectbase-client tunnel 7860 --timeout 300 --max-body 50
 
 ${colors.yellow}\uD658\uACBD\uBCC0\uC218:${colors.reset}
   CONNECTBASE_PUBLIC_KEY    Public Key (cb_pk_*)
-  CONNECTBASE_SECRET_KEY    Secret Key (cb_sk_*, \uD130\uB110\uC6A9)
+  CONNECTBASE_SECRET_KEY    Secret Key (cb_sk_*) \u2014 \uBC30\uD3EC/\uC2B9\uACA9/\uD130\uB110\uC5D0 \uD544\uC218
   CONNECTBASE_PUBLIC_KEY       (deprecated) \uB808\uAC70\uC2DC \u2014 publicKey \uB610\uB294 secretKey \uB85C \uC0AC\uC6A9
   CONNECTBASE_STORAGE_ID    \uC2A4\uD1A0\uB9AC\uC9C0 ID
   CONNECTBASE_BASE_URL      \uC11C\uBC84 URL
@@ -3544,20 +3622,20 @@ async function main() {
       setupRoot: parsed.options.setupRoot === "true"
     });
   } else if (parsed.command === "docs") {
-    await downloadDocs();
+    await downloadDocs(void 0, { baseUrl: config.baseUrl });
   } else if (parsed.command === "mcp") {
-    await setupMcp(config.secretKey);
+    await setupMcp(config.secretKey, config.baseUrl);
   } else if (parsed.command === "deploy") {
     const directory = parsed.args[0] || fileConfig.deployDir || ".";
     if (!config.publicKey) {
       error(
-        'Public Key\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. "npx connectbase init"\uC73C\uB85C \uC124\uC815\uD558\uAC70\uB098 -k \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uC138\uC694'
+        'Public Key\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. "npx connectbase-client init"\uC73C\uB85C \uC124\uC815\uD558\uAC70\uB098 -k \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uC138\uC694'
       );
       process.exit(1);
     }
     if (!config.storageId) {
       error(
-        '\uC2A4\uD1A0\uB9AC\uC9C0 ID\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. "npx connectbase init"\uC73C\uB85C \uC124\uC815\uD558\uAC70\uB098 -s \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uC138\uC694'
+        '\uC2A4\uD1A0\uB9AC\uC9C0 ID\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. "npx connectbase-client init"\uC73C\uB85C \uC124\uC815\uD558\uAC70\uB098 -s \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uC138\uC694'
       );
       process.exit(1);
     }
@@ -3578,7 +3656,10 @@ async function main() {
         if (fs2.existsSync(
           path2.join(docsRoot, ".claude", "docs", DOCS_MANIFEST_FILE)
         )) {
-          const refreshed = await downloadDocs(docsRoot, { quiet: true });
+          const refreshed = await downloadDocs(docsRoot, {
+            quiet: true,
+            baseUrl: config.baseUrl
+          });
           if (refreshed === "updated") {
             info("SDK \uBB38\uC11C\uAC00 \uC0C8 \uBC84\uC804\uC73C\uB85C \uAC31\uC2E0\uB418\uC5C8\uC2B5\uB2C8\uB2E4 (.claude/docs/)");
           }
@@ -3589,13 +3670,13 @@ async function main() {
   } else if (parsed.command === "promote" || parsed.command === "releases") {
     if (!config.publicKey) {
       error(
-        'Public Key\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. "npx connectbase init"\uC73C\uB85C \uC124\uC815\uD558\uAC70\uB098 -k \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uC138\uC694'
+        'Public Key\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. "npx connectbase-client init"\uC73C\uB85C \uC124\uC815\uD558\uAC70\uB098 -k \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uC138\uC694'
       );
       process.exit(1);
     }
     if (!config.storageId) {
       error(
-        '\uC2A4\uD1A0\uB9AC\uC9C0 ID\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. "npx connectbase init"\uC73C\uB85C \uC124\uC815\uD558\uAC70\uB098 -s \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uC138\uC694'
+        '\uC2A4\uD1A0\uB9AC\uC9C0 ID\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. "npx connectbase-client init"\uC73C\uB85C \uC124\uC815\uD558\uAC70\uB098 -s \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uC138\uC694'
       );
       process.exit(1);
     }
@@ -3607,7 +3688,7 @@ async function main() {
   } else if (parsed.command === "tunnel") {
     const portStr = parsed.args[0];
     if (!portStr) {
-      error("\uD3EC\uD2B8 \uBC88\uD638\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. \uC608: npx connectbase tunnel 8084");
+      error("\uD3EC\uD2B8 \uBC88\uD638\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. \uC608: npx connectbase-client tunnel 8084");
       process.exit(1);
     }
     const port = parseInt(portStr, 10);
@@ -3672,5 +3753,6 @@ main().catch((err) => {
   normalizeRelativePath,
   parseArgs,
   registerEndpointBinding,
-  sha256Hex
+  sha256Hex,
+  storageAdminHeaders
 });