10 秒导入一条 AI 配置：CC Switch ccswitch:// 深度链接三步跑通指南-酒店常州论坛

10 秒导入一条 AI 配置：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

还在对着屏幕抄端点、贴 Key？

给 Claude Code、Codex 或 Gemini 换一批新提供商时，你是不是又开始了"老三样"：复制端点地址、粘贴 API Key、逐个挑模型？想把现成配置发给同事，对方还得从零再填一遍？

CC Switch 的ccswitch://深度链接协议把这件事压成了一个动作：配置打包进一条链接，对方点一下、确认一下，10 秒就能把整套提供商配置搬进自己的应用，全程不用手填。

三步把配置搬进列表

装好 CC Switch（当前 3.20.0）。安装时应用会自动注册ccswitch://协议，不用你做任何配置。
拿到一条分享链接，在浏览器里点它。第一次点会弹出"是否允许打开外部应用"，选"允许"。
应用随即弹出确认窗口，把链接里的端点、模型、密钥（打码）摆给你看；核对无误点"导入"，新提供商立刻出现在提供商列表里——看到名字出现，说明没走错。

拼链接前先看这张参数速查表

最常用的provider类型链接长这样：

ccswitch://v1/import?resource=provider&app=claude&name=测试&endpoint=https://api.example.com/v1&apiKey=sk-xxxx

每个参数对应什么、哪些可以省，查这张表：

字段	含义	是否必填	示例
resource	导入类型，provider 之外还有 prompt / mcp / skill 三种	是	provider
app	配置要放进哪个应用	是	claude、codex、gemini、opencode、openclaw、hermes
name	提供商在列表里的名字	是	测试提供商
endpoint	API 端点，多个地址用英文逗号隔开	否	https://api.example.com/v1
apiKey	接口密钥	否	sk-xxxx
model	默认模型	否	claude-sonnet-4
homepage	提供商官网	否	https://example.com
icon	内置图标名	否	claude
enabled	导入后是否直接启用	否	true
haikuModel / sonnetModel / opusModel	Claude 专属三档模型	否	claude-haiku-4-5

另外四种资源的要点：prompt必须带content提示词正文；mcp必须带apps（逗号分隔多个应用）和 JSON 格式的config；skill必须带owner/name格式的repo。

三种进阶玩法，链接还能这样用

Base64 完整配置。从 v3.8 起，config参数可塞入整份配置文件的 Base64 编码（Claude/Gemini 用 JSON，Codex 用 TOML），也能用configUrl指向一份远程配置，适合结构复杂的整套环境。

URL 参数覆盖配置。配置文件和 URL 参数同时存在时，以 URL 参数为准。于是团队可以共享一条不含密钥的链接，端点和模型统一锁死，每人导入时自己补上apiKey就行。

用量脚本跟着走。v3.9 起链接可携带usageScript、usageAutoInterval等参数，导入后新用户不用手动配置就有用量自动查询；注意usageEnabled默认是 false，脚本正文会完整显示在确认框里，不显式传 true 就只导入不启用，可在应用里手动打开。

这些坑，踩之前先知道

点链接没反应 → 链接本身不合规。协议目前只认v1这个 host 和/import这个路径，写错一个字符就会被直接拒收。拼完后先对照确认窗口预览检查；如果应用根本没弹出来，多半是协议没注册，重装一次 CC Switch 即可恢复。
确认窗口里密钥是打码的，链接本身却是明文。脱敏只发生在显示层，任何看到链接的人都能读到完整 apiKey。动作很明确：真实密钥别贴进公开链接和群公告，分享时让对方自己填 Key。
Base64 是编码不是加密。一条命令就能解出config里的全部内容，别拿它当安全手段；分享前想清楚这条链接会流到哪。
skill 只认 Claude 一家。且repo必须是owner/name两段式，少斜杠或多斜杠都会报错。
MCP 重复导入只改状态。config固定按 JSON 解析；同一台服务器已存在时，再导入只会更新它的启用状态，不会覆盖原有配置，别指望用链接批量改写。

谁适合花 10 分钟学它

如果你同时维护 Claude Code、Codex、Gemini 里两三个甚至全部，或者要给团队统一一套 AI 工具环境，这套协议值得掌握——它省下的是每次换配置、每次带新人时的重复劳动。

现在就去行动：打开仓库自带的 deplink.html，它内建链接生成器和 Base64 编解码器，填一份不含密钥的配置，生成一条链接，在自己的 CC Switch 里点开试一遍；想深挖解析细节，可以看 src-tauri/src/deeplink/parser.rs 和官方深度链接文档。

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

企业官网建设流程全解析