protocol handler not registered - cc-switch

Quick fix

在 Linux 的 CC Switch.desktop 文件中将 Exec 修改为 cc-switch %U，解决 Chromium 浏览器无法识别导入协议的问题；WSL 同步需检查管理员权限。

Symptom

报错原文复制

CC-Switch not installed or protocol handler not registered.

Cause

导入与同步功能在不同环境下会因不同机制失败。在 Linux 系统中，Chromium 内核浏览器（如 Edge、Chrome）要求桌面快捷方式的 Exec 行必须包含 %U 或 %u 参数才能将其视为有效的 URL 协议处理器。cc-switch 的 .deb 安装包默认缺失此参数，导致网页调用导入链接时被浏览器拦截。

此外，在 Windows 与 WSL 混合环境中，跨系统同步（如 skill 软链接）会因权限或文件系统差异导致创建符号链接失败，且 WSL 目录下的配置和 MCP 读取也存在路径映射问题。

Fix

1. 1

   在 Linux 系统中，手动修改 cc-switch 的桌面快捷方式文件，为 Exec 添加 %U 参数。

   /usr/share/applications/CC Switch.desktop

   Exec=cc-switch
   Exec=cc-switch %U

2. 2

   或者在 Linux 终端中运行以下命令一键修复（注意：软件更新后可能会被覆盖，需重新执行）：sudo sed -i 's/^Exec=cc-switch$/Exec=cc-switch %U/' "/usr/share/applications/CC Switch.desktop"

3. 3

   若在 Windows 下向 WSL 同步 skill 时遇到创建符号链接失败，请确保已开启 Windows 开发人员模式，并以管理员身份运行 cc-switch。

Affected Versions

Toolcc-switch

Version3.16.1 - 3.16.4

PlatformsLinuxWindows

Source Issues

本页汇总自 3 个真实 issue

• #1626当配置在WSL中的一些问题
• #3625skill同步出错
• #4821Linux: Protocol handler (ccswitch://) not recognized by Chromium browsers due to missing %U in Exec line

FAQ

为什么 xdg-open 可以打开，但 Chrome/Edge 浏览器不行？

Chromium 浏览器有额外的验证机制，必须检查 desktop 文件的 Exec 行是否包含 %U 或 %u，而 xdg-open 没有此限制。

Windows 下同步 skill 到 WSL 报错“创建符号链接失败”怎么办？

请确认已开启 Windows 开发人员模式，并以管理员权限运行 cc-switch。如果仍然失败，可能是跨文件系统软链接限制，目前版本对此支持有限。

相关问题

每次点击都会先弹出系统文件夹选择器 cc-switch修改 src/App.tsx 移除 handleOpenTerminal 中的 pickDirectory() 调用，即可解决点击打开终端时强制弹出文件夹选择器的问题。3 issues merged原子替换失败 os error 50将 Claude Code 配置目录从 WSL 路径改回 Windows 本地路径，或回退至 v3.19.0。1 issues merged重启电脑后禁用的 MCP 重新生效 - Codex官方尚未修复此配置覆盖问题，需手动清理配置文件中的冲突 MCP 节点，并谨慎使用 deeplink 导入以防自定义设置丢失。3 issues merged