musistudio/claude-code-router · error · Error

No browser app is configured.

Error message

No browser app is configured.

What it means

Error "No browser app is configured." thrown in musistudio/claude-code-router.

Source

Thrown at packages/core/src/web/management-server.ts:377

  openBotGatewayQrWindow: async (request) => {
    const qrRequest = request as BotGatewayQrWindowOpenRequest;
    await openSystemExternal(qrRequest.url);
    return {
      message: "Opened the QR login URL in your default browser.",
      observed: false,
      opened: true
    };
  },
  openBuiltInBrowser: async (url) => {
    const targetUrl = readString(url);
    if (targetUrl) {
      await openSystemExternal(targetUrl);
      return;
    }
    const config = await loadAppConfig();
    const appUrl = firstConfiguredBrowserAppUrl(config) || "about:blank";
    if (appUrl === "about:blank") {
      throw new Error("No browser app is configured.");
    }
    await openSystemExternal(appUrl);
  },
  openProfile: async (request) => {
    const syncedClaudeAppConfig = await syncClaudeAppGatewayConfig(await loadAppConfig());
    const config = syncedClaudeAppConfig.config;
    const status = await gatewayService.ensureStarted(config);
    if (status.state !== "running") {
      throw new Error(status.lastError || "CCR gateway did not start.");
    }
    logProfileApplyResult(await applyProfileConfig(config));
    return openProfileFromCcr(config, request as ProfileOpenRequest);
  },
  probeLocalAgentProvider: (request) => probeLocalAgentProvider(request as LocalAgentProviderProbeRequest),
  probeProvider: (request) => probeGatewayProvider(request as GatewayProviderProbeRequest),
  probeProviderCandidates: (request) => probeGatewayProviderCandidates(request as GatewayProviderProbeCandidatesRequest),
  quitApp: async () => {
    setTimeout(() => process.kill(process.pid, "SIGTERM"), 50).unref();

View on GitHub (pinned to 99f24806c6)

When it happens

Trigger: Thrown at packages/core/src/web/management-server.ts:377 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of musistudio/claude-code-router@99f24806c6 (2026-08-27). Data as JSON: /api/errors/edc2244ad5f8c883. Report an issue: GitHub.