musistudio/claude-code-router · error · Error

${startedStatus.lastError || `CCR gateway did not start for

Error message

${startedStatus.lastError || `CCR gateway did not start for ${appName}.`}

What it means

Error "${startedStatus.lastError || `CCR gateway did not start for ${appName}.`}" thrown in musistudio/claude-code-router.

Source

Thrown at packages/core/src/profiles/launch-service.ts:436

  if (!startIfMissing) {
    throw new ProfileGatewayUnavailableError(`CCR gateway is not running at ${profileGatewayEndpoint(config)}. Start CCR Desktop or run ccr start before opening ${appName}.`);
  }

  const startedStatus = await gatewayService.start(config);
  if (startedStatus.state === "running") {
    return { config };
  }

  if (options.reuseExisting && isAddressInUseError(startedStatus.lastError)) {
    const existingGateway = await probeExistingProfileGateway(config, profile, candidateConfig);
    if (existingGateway.state === "usable") {
      return { acceptedApiKey: existingGateway.apiKey, config };
    }
    throw new Error(existingGatewayConflictMessage(existingGateway, appName));
  }

  throw new Error(startedStatus.lastError || `CCR gateway did not start for ${appName}.`);
}

type ExistingProfileGatewayProbe =
  | { endpoint: string; reason?: string; state: "unavailable" }
  | { endpoint: string; message: string; state: "incompatible" }
  | { endpoint: string; status?: number; state: "not-ccr" }
  | { endpoint: string; message?: string; status: number; state: "unauthorized" }
  | { endpoint: string; status: number; state: "unusable" }
  | { apiKey?: string; endpoint: string; state: "usable" };

type ExistingGatewayHttpProbe = {
  payload?: unknown;
  reason?: string;
  status?: number;
};

const existingGatewayFetchAttempts = 3;

View on GitHub (pinned to 99f24806c6)

When it happens

Trigger: Thrown at packages/core/src/profiles/launch-service.ts:436 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/85a3b679cbe1a27c. Report an issue: GitHub.