CC Switch 深度链接：一键导入 AI 配置
【免费下载链接】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 的ccswitch://深度链接协议，把提供商、MCP 服务器、提示词和 Skill 四类配置打包进一条 URL。你点一下链接，就能在另一台设备上装好同样的环境，省掉填端点、贴密钥、选模型的手动步骤。整条流程大约 10 秒。
导入提供商配置
你从同事那里拿到一条分享链接，设备已装好 CC Switch，协议在安装时自动注册。
- 在浏览器里点击链接。首次点击会询问是否打开外部应用，选“允许”。
- CC Switch 弹出确认窗口，列出链接里的名称、端点和模型。
- 点击导入，新提供商出现在列表，需要时再点启用。
确认窗口里apiKey只显示前 4 位，其余打码。
分发完整配置到团队
你想把整套提供商设置分发给团队，不只是端点和密钥。
- 把完整配置导出为 JSON，Codex 用 TOML。
- Base64 编码后放进
config参数，或用configUrl指向远程配置地址。 - 把不含密钥的链接发出，每位同事自己补上
apiKey。
大家的端点和模型保持一致，只有密钥不同。URL 参数与配置内容冲突时，以 URL 参数为准。
导入 MCP 服务器
团队有一份统一的 MCP 服务器清单，想一次装进多个工具。
- 链接里设
resource=mcp。 apps参数用逗号列出目标应用，config参数放服务器 JSON 配置。- 在确认窗口里导入。
服务器同时进入所选应用的 MCP 面板；已存在时只更新启用状态，不改原配置。
核对 provider 链接参数
下表覆盖最常用的 provider 深度链接，其余资源类型（prompt / mcp / skill）的参数差异见官方文档。
| 字段 | 说明 | 必填 | 示例 |
|---|---|---|---|
resource | 资源类型：provider / prompt / mcp / skill | 是 | provider |
app | 目标应用 | 是 | claude |
name | 提供商名称 | 是 | 测试提供商 |
endpoint | API 端点，多个用逗号分隔 | 否 | https://api.example.com/v1 |
apiKey | API 密钥 | 否 | sk-xxxx |
model | 默认模型 | 否 | claude-sonnet-4 |
homepage | 提供商官网 | 否 | https://example.com |
icon | 内置图标名 | 否 | claude |
enabled | 导入后是否立即启用 | 否 | true |
表外补充：Claude 可用haikuModel、sonnetModel、opusModel分别指定三档模型；v3.9 起可携带usageScript与usageAutoInterval，新设备自带用量自动查询。
核对深度链接的边界
- 兼容性：协议只认
v1主机名与/import路径，写错直接被拒。发出链接前先用生成器校验格式。 - 数据可见性：密钥打码只在显示层，链接本身是明文。公开分享时去掉
apiKey，让对方自己填。 - 数据可见性：
config的 Base64 不是加密，懂的人一条命令就能解开。对外分享前想清楚里面有什么。 - 解析规则：
resource=skill只支持 Claude，且repo必须是owner/name格式。 - 解析规则：MCP 的
config固定按 JSON 解析；重复导入已存在的服务器时，只更新启用状态。
跑通第一条分享链接
先跑通一条 provider 深度链接，再试一条 mcp 链接，两个都成功后把不含密钥的版本发给同事复验。延伸入口：
- 带 Base64 编解码器的链接生成器：deplink.html
- 协议解析源码：src-tauri/src/deeplink/parser.rs
- 官方协议文档：docs/user-manual/zh/5-faq/5.3-deeplink.md
链接一贴，配置就位。
【免费下载链接】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），仅供参考
