musistudio/claude-code-router · error · Error

CCR gateway did not start.

Error message

CCR gateway did not start.

What it means

Error "CCR gateway did not start." thrown in musistudio/claude-code-router.

Source

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

  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();
  },
  restartGateway: async () => {
    const syncedClaudeAppConfig = await syncClaudeAppGatewayConfig(await loadAppConfig());
    const config = syncedClaudeAppConfig.config;
    const status = await gatewayService.restart(config);
    await applyProfileIfServiceRunning(config, status);
    return status;
  },
  restartProxy: async () => {

View on GitHub (pinned to 99f24806c6)

When it happens

Trigger: Thrown at packages/core/src/web/management-server.ts:386 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/1512559e2dabf6ee. Report an issue: GitHub.