CC Switch ccswitch:// 协议：把配置打包成一条链接，同事点一下就导入-港品优选

CC Switch ccswitch:// 协议：把配置打包成一条链接，同事点一下就导入

【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch

CC Switch 是给 Claude Code、Codex、Gemini 等 AI 编码工具做配置管理的桌面应用。它的ccswitch://深度链接协议，能把提供商、MCP、提示词、技能四种配置打包成一条链接，别人点一下就能导入，不用手填端点和密钥。读完这篇，你会点导入、会拼链接，也能知道哪些坑别踩。

点一条 ccswitch:// 链接：3 步走完整导入流程

先看你作为接收方要做的事，一共 3 步，全程不到 10 秒。

确保 CC Switch 已安装（3.20.x 版本），协议会随安装自动注册，不用额外操作。
在浏览器里点分享链接。第一次点时浏览器会问"是否允许打开外部应用"，选允许，应用会被拉起。
应用弹出确认窗口，把链接里的配置摆给你看。核对无误后点导入，提供商就出现在列表里了。

注意确认窗口里的一个细节：API Key 只显示前 4 位，后面全是星号。这是显示层的脱敏，链接本身还是明文——后面"坑"那节会再强调一次。

拼一条提供商分享链接：3 个必填参数，其余都可选

自己生成链接很简单：ccswitch://v1/import?后面挂参数就行。

先记住必填的 3 个，一个都不能少：

参数	作用	示例值
`resource`	资源类型，提供商固定填`provider`	`provider`
`app`	配置给哪个应用用	`claude`、`codex`、`gemini`
`name`	导入后显示的名称	`我的中转`

app的合法取值有 7 个：claude、codex、gemini、grokbuild、opencode、openclaw、hermes。填错会直接报Invalid provider app type。

选填的按需加，常用几个：

参数	说明	示例
`endpoint`	API 端点，多个用英文逗号分隔	`https://api.example.com/v1`
`apiKey`	密钥，建议留空让对方自己填	`sk-xxxx`
`model`	默认模型	`claude-sonnet-4`
`homepage`	提供商官网	`https://example.com`
`icon`	内置图标名	`claude`
`enabled`	导入后是否立即启用	`true`

Claude 用户还能用haikuModel、sonnetModel、opusModel三个参数，分别指定三档模型，一次配齐。

拼出来大概长这样：

ccswitch://v1/import?resource=provider&app=claude&name=我的中转&endpoint=https%3A%2F%2Fapi.example.com%2Fv1&model=claude-sonnet-4

拼链接时不想手动做 URL 编码？仓库根目录的deplink.html自带表单生成器和 Base64 编解码器，浏览器打开填参数就能生成。

一条链接还能导 MCP、提示词和技能

provider 只是 4 种资源之一，resource换个值，参数结构完全不同。

MCP 服务器（resource=mcp）。必填两个：apps和config。和 provider 不同，MCP 用apps且支持逗号分隔多选，一条链接可以同时给 Claude 和 Codex 装上。config是 Base64 后的 JSON，格式固定按mcpServers结构解析。服务器已存在时重复导入只更新启用状态，不会覆盖原有配置。

提示词（resource=prompt）。必填app、name、content三个，content是提示词正文，可加description和enabled。适合把团队统一的系统提示分享给新人。

技能仓库（resource=skill）。必填repo，且必须是owner/name两段的严格格式，多一段少一段都报错。可选branch、directory指定分支和本地目录名。注意技能只支持 Claude，解析器里直接写死了。

四种资源就 4 个必填字段起跳，参数名不重复记，用时查表就行。

进阶分享：Base64 全量配置，URL 参数优先覆盖

参数逐个传只适合简单场景。配置多了，v3.8 起可以整体塞进config参数：把完整配置文件做 Base64 编码后贴上，Claude 和 Gemini 用 JSON，Codex 用 TOML。也可以留configUrl指向远程配置地址，让对方导入时在线拉取。

覆盖规则先说结论：URL 参数优先于config。两边同时存在时以 URL 参数为准。

这个规则有个实用玩法：你在链接里放好端点和模型，故意不带apiKey，团队每人导入后自己补密钥。配置统一、密钥各管各的，一条链接两用。

v3.9 起链接还能带usageScript、usageAutoInterval等用量查询参数，导入后新用户不用二次配置，用量自动查询直接生效。不过默认usageEnabled是false，脚本只导入不启用，需要手动打开。

想核对解析逻辑，可以看后端解析器：src-tauri/src/deeplink/parser.rs，四种资源的必填校验和取值白名单都在里面。

边界与坑：链接是明文，密钥别往公开渠道贴

🔗 这一节集中讲边界，看完再分享不迟。

协议只认v1和/import。host 不是v1、路径不是/import，解析器直接拒绝，没有容错。
脱敏只在确认窗口里。API Key 打码是界面层的事，链接本身明文可读。真实密钥贴进公开文档或群聊，等于裸奔。
Base64 不是加密。config里的内容任何人一条命令就能解出原文，别把它当保险箱用。
skill 的repo格式最严格。必须是owner/name两段，写成全 URL 或单段仓库名都会被判非法。
应用没启动也能导入。v3.13.0 起点链接会按需重建主窗口再弹确认框，首次打开会稍慢，属正常现象，不是卡死。
只导可信来源的配置。导入前确认窗口会展示全部字段，来源不明的链接，先解码看一眼再点。

现在就试一把

最低门槛的起点：打开deplink.html，生成一条不含密钥的提供商链接，在自己电脑上的 CC Switch 里点开，走一遍"确认—导入"。10 秒后你就有了一份能直接发给同事的配置链接，下次换提供商再也不用语音教学了。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析