告别手填端点与密钥: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
多套 AI 提供商要手填端点、API 密钥、模型名,来回复制粘贴费时还容易出错。CC Switch 深度链接协议ccswitch:// 把这些填表动作压缩成一次点击:拿到分享链接,点开就能一键导入provider、提示词、MCP 配置和技能仓库。
三步完成首次导入
不用看文档也能跑通,最短路径只有三步:
- 拿到一个 ccswitch:// 链接。来源可以是教程、同事分享,或官方在线生成器拼出来的结果。
- 点击链接。系统会提示"是否打开 CC Switch",确认后应用启动。
- 在弹出的确认框里核对配置预览,点导入即可落库。
整个过程不需要你打开任何设置页,配置会自动填进对应表单。
ccswitch:// 一键导入背后的解析流程
一句话定义:ccswitch:// 是 CC Switch 安装时向系统注册的自定义 URL 协议,浏览器把这类链接交给应用处理。
它的工作流程可以拆成四步:
- 点击链接,系统唤起 CC Switch
- 应用解析 URL 中的查询参数
- 参数按类型填充到对应的导入表单
- 你在确认框里点"导入"后,配置才真正写入
解析逻辑集中在后端src-tauri/src/deeplink/目录,按资源类型拆成了 provider、mcp、prompt、skill 几个模块,想抠细节可以直接翻源码。
四类资源导入对照
协议支持四类资源,各有分工:
| 资源类型 | 用途 | 典型参数 | 适用人群 |
|---|---|---|---|
| provider | 新增一个 AI 提供商 | endpoint、apiKey、model | 经常切换多家服务的重度用户 |
| prompt | 导入一条提示词模板 | content、description | 有固定提示词、想多设备复用的人 |
| mcp | 导入 MCP 服务器配置,一次可下发到多个应用 | apps、config | 需要批量 MCP 配置导入的开发者 |
| skill | 挂载 GitHub 技能仓库 | repo、branch、directory | 用技能库扩展工作流的用户 |
常用参数速查表
拼链接或排查链接时,这张表够用:
| 参数 | 取值 / 示例 | 说明 |
|---|---|---|
| resource | provider / prompt / mcp / skill | 资源类型,必填 |
| app | claude / codex / gemini | 目标应用,必填 |
| name | My Provider | 配置名称 |
| homepage | https://example.com | 提供商官网 |
| endpoint | https://api.example.com/v1 | API 端点,支持逗号分隔多个地址 |
| apiKey | sk-xxxx… | API 密钥,确认框中仅显示前 4 位,其余以星号替代 |
| model | claude-sonnet-4 | 默认模型 |
| icon | claude | 提供商图标 |
进阶玩法:内嵌配置、远程引用与用量脚本
- Base64 内嵌配置:链接太短装不下整份配置时,把 JSON 或 TOML 做 Base64 编码放进
config参数,配合configFormat声明格式即可。 - 远程配置引用:用
configUrl存一个地址,导入时 CC Switch 去拉取并解析,链接本身保持简短。 - 用量查询脚本:v3.9 起,provider 可以附带用量查询配置,包括自动查询间隔、专用 API 密钥等,脚本正文会完整展示在导入确认框中,不会悄悄生效。
团队配置同步与分享场景
团队配置同步:管理员拼好一份标准链接发到群里,新成员点开就能得到和大家一致的提供商、密钥与模型组合,省掉逐条口头交代。
社区分享优质配置:调好的 provider 参数、好用的提示词模板、验证过的 MCP 配置,都可以通过配置分享链接直接流转,接收方零门槛落地。
跨设备迁移:同一账号体系下换电脑,把常用链接收藏起来,点击恢复环境比手动备份快得多。
密钥脱敏与安全提醒
⚠️ 确认框对敏感字段做了脱敏:apiKey只显示前 4 个字符,其余用星号替代,避免你在核对配置时把完整密钥暴露给旁人。
两条使用建议:
- 只导入可信来源的链接,导入前认真看一遍配置预览。
- 对外分享前,先把链接里的 apiKey 移除或替换,走安全渠道传输。
CC Switch 深度链接协议把"填八个字段"变成"点一次链接",对配置分享和团队配置同步场景尤其划算。想深入参数细节,可查阅 docs/user-manual/zh/5-faq/5.3-deeplink.md,实现细节见 src-tauri/src/deeplink/ 目录。
【免费下载链接】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),仅供参考