Skip to content
CC Switch WikiUnofficial Community Wiki

Adding a provider fails: crypto.randomUUID is not a function - cc-switch

Quick fix

Upgrade to cc-switch v3.9 or newer, which adds a crypto.randomUUID fallback for older macOS; or upgrade macOS past 12.3 Monterey / 11.6.5 Big Sur.

Symptom

Section titled “Symptom”
Error output
添加供应商失败：crypto.randomUUID is not a function. (In 'crypto.randomUUID()', 'crypto.randomUUID' is undefined)
English translation

Adding a provider failed: crypto.randomUUID is not a function. (In 'crypto.randomUUID()', 'crypto.randomUUID' is undefined)

Cause

Section titled “Cause”

This comes from cc-switch calling the system Web API `crypto.randomUUID()` when adding or updating a provider. Older macOS versions (11.7.10, 12.2.1) do not provide that function, so saving a provider throws `crypto.randomUUID is not a function`. It has nothing to do with your Node version and is not a mistake in the provider config itself.

Maintainers confirmed in the related issues that `crypto.randomUUID` first arrived in macOS 12.3 Monterey and macOS 11.6.5 Big Sur, and that cc-switch 3.8.2 - 3.8.3 calls it directly. The fix was to add a fallback for older systems in v3.9; without upgrading cc-switch, you have to upgrade macOS. Some users also mention the same error when updating a provider.

Fix

Section titled “Fix”

  1. Upgrade cc-switch to v3.9 or newer; maintainers confirmed that version added a `crypto.randomUUID` fallback for older macOS.

  2. If you cannot upgrade cc-switch yet, upgrade macOS to 12.3 Monterey or 11.6.5 Big Sur or newer, so the system provides `crypto.randomUUID()` itself.

  3. Reopen cc-switch, go back into provider management, and add or update a provider to confirm `crypto.randomUUID is not a function` no longer appears.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version3.8.2 - 3.8.3
PlatformsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 4 real issues

FAQ

Section titled “FAQ”
Which macOS version do I need to upgrade past to resolve this?
Maintainers replied that `crypto.randomUUID` first arrived in macOS 12.3 Monterey and macOS 11.6.5 Big Sur; those versions or newer resolve it.
Which version is compatible?
Maintainers confirmed cc-switch v3.9 adds the fallback for older systems. If you are on 3.8.2/3.8.3, upgrade to v3.9 or newer.
Why do I get this error even on Node 18+?
The error comes from the system Web API `crypto.randomUUID()` and has nothing to do with your Node version — it triggers whenever an older macOS lacks that function.
Does updating a provider throw the same error?
Users report the same error occasionally when updating a provider. The root cause is the same — older macOS lacking `crypto.randomUUID()` — so upgrade cc-switch or the system the same way.
Section titled “Related problems”
Add CoderPlan provider preset for Claude CodeFeature request: add a CoderPlan provider preset to cc-switch. A Claude Code preset PR exists, but merge status is unconfirmed.1 issues mergedOn the add provider page, search results cannot be clicked to select - cc-switchUpdate to a version with the UI fix. As a stopgap, Tab to the preset after searching and press Enter to select it.4 issues mergedCC Switch config import / sync not taking effectUpgrade CC Switch to v3.16.1+, and check that WebDAV / cloud sync and the config write path are syncing correctly.23 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.