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-switchCC 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资源类型提供商固定填providerproviderapp配置给哪个应用用claude、codex、gemininame导入后显示的名称我的中转app的合法取值有 7 个claude、codex、gemini、grokbuild、opencode、openclaw、hermes。填错会直接报Invalid provider app type。选填的按需加常用几个参数说明示例endpointAPI 端点多个用英文逗号分隔https://api.example.com/v1apiKey密钥建议留空让对方自己填sk-xxxxmodel默认模型claude-sonnet-4homepage提供商官网https://example.comicon内置图标名claudeenabled导入后是否立即启用trueClaude 用户还能用haikuModel、sonnetModel、opusModel三个参数分别指定三档模型一次配齐。拼出来大概长这样ccswitch://v1/import?resourceproviderappclaudename我的中转endpointhttps%3A%2F%2Fapi.example.com%2Fv1modelclaude-sonnet-4拼链接时不想手动做 URL 编码仓库根目录的deplink.html自带表单生成器和 Base64 编解码器浏览器打开填参数就能生成。一条链接还能导 MCP、提示词和技能provider 只是 4 种资源之一resource换个值参数结构完全不同。MCP 服务器resourcemcp。必填两个apps和config。和 provider 不同MCP 用apps且支持逗号分隔多选一条链接可以同时给 Claude 和 Codex 装上。config是 Base64 后的 JSON格式固定按mcpServers结构解析。服务器已存在时重复导入只更新启用状态不会覆盖原有配置。提示词resourceprompt。必填app、name、content三个content是提示词正文可加description和enabled。适合把团队统一的系统提示分享给新人。技能仓库resourceskill。必填repo且必须是owner/name两段的严格格式多一段少一段都报错。可选branch、directory指定分支和本地目录名。注意技能只支持 Claude解析器里直接写死了。四种资源就 4 个必填字段起跳参数名不重复记用时查表就行。进阶分享Base64 全量配置URL 参数优先覆盖参数逐个传只适合简单场景。配置多了v3.8 起可以整体塞进config参数把完整配置文件做 Base64 编码后贴上Claude 和 Gemini 用 JSONCodex 用 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 秒后你就有了一份能直接发给同事的配置链接下次换提供商再也不用语音教学了。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考