CC Switch ccswitch:// 深度链接协议实操指南:一条链接,5 步导入 AI 提供商配置

CC Switch ccswitch:// 深度链接协议实操指南:一条链接,5 步导入 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-switchCC Switch 的 ccswitch:// 深度链接协议,把一份完整的提供商配置——端点、API Key、模型——打包进一条可点击的链接里。你换 Claude Code 或 Codex 的供应商、给团队统一编码环境、把配好的参数丢给新同事,都不用再逐格手填。下文按组装链接 → 点开导入 → 读懂参数 → 组合进阶的路径实操一遍,当前版本 3.20.3。先想清楚:这个协议替你省什么换设备重配。新装一台电脑,原来手填端点、贴密钥、选模型的 10 个字段,现在是一条链接点完的事。配置在脑子里、聊天记录里都能变成链接,不再依赖手动记忆。团队统一环境。你定好端点和模型,生成一条不带密钥的链接发出去,每人只需补自己的apiKey。端点、模型天然一致,不会有人填错一个斜杠。给新成员兜底。对方连 CC Switch 都没用过也没关系,确认窗口会把链接内容完整摆出来,看一眼就知道导入了什么,不像口头交代容易漏项。五步跑通第一次导入装好 CC Switch(版本 3.20.3 及以上)。应用首次启动即完成ccswitch://协议注册,无额外配置。组装链接。两种方式:打开仓库根目录的 deplink.html,选provider填表单,页面直接生成并附带 Base64 编解码器;或按下一节的模板手写。在浏览器地址栏粘贴链接回车(或点击含该协议的超链接)。首次会弹出是否打开外部应用,选允许。确认窗口打开,完整列出名称、端点、模型,API Key 只显示前 4 位其余打码。核对后点导入。提供商立刻出现在列表中;链接带enabledtrue的话,它同时成为该应用当前生效的供应商。把链接拆开看一条真实可用的 provider 导入链接长这样:ccswitch://v1/import?resourceproviderappclaudename测试提供商endpointhttps://api.example.com/v1apiKeysk-xxxxmodelclaude-sonnet-4-5iconclaude结构分三段:协议头ccswitch://、版本路径v1/import(解析器只认这两个,写错直接拒绝,源码见 src-tauri/src/deeplink/parser.rs)、以及?后的键值参数。必填的只有resource、app、name三个;endpoint和apiKey要么在 URL 里,要么藏在config参数里,二者必须至少有一处给到,否则导入报错。参数作用什么时候用示例值resource资源类型,provider / prompt / mcp / skill 四选一每条链接必带providerapp目标应用,provider 支持 claude / codex / gemini / grokbuild / opencode / openclaw / hermesprovider、prompt 必带claudename提供商名称provider 必带测试提供商endpointAPI 端点,英文逗号分隔可写多个,第一个为主端点必带(或在 config 中)https://api.example.com/v1apiKeyAPI 密钥必带(或在 config 中)sk-xxxxmodel默认模型;不写时各应用有自己的缺省值想锁定模型时claude-sonnet-4-5haikuModel / sonnetModel / opusModel给 Claude 单独指定三档模型只定制 Claude 时claude-opus-4homepage提供商官网缺省时程序会从端点自动推断,一般不用填https://example.comicon内置图标名,自动转小写想让卡片显示对应 logo 时claudeenabled导入后是否立即切换为当前供应商,只认 true/false希望导完即生效truenotes备注想在列表里留说明时团队备用线路configBase64 编码的完整配置,Claude/Gemini 用 JSON、Codex 用 TOML,格式由 configFormat 声明字段多到手写 URL 放不下时eyJlbnYiOi...configFormat声明 config 的格式,缺省按 json 解析与 config 搭配toml进阶:让一条链接干更多活完整配置走 Base64。把 Claude 的 env 块、Codex 的 config.toml 整段编码进config,一次带上自定义头、超时等非标准字段;URL 里仍保留name供确认窗口展示。URL 参数优先级高于 config。同一字段两处都有时,以 URL 参数为准。这就是团队无密钥链接的玩法:共享一份含端点和模型的 config,每人追加自己的apiKey。多端点容灾。endpoint用逗号写多个地址,第一个成为主端点,其余自动注册为该提供商的自定义备用端点。用量脚本随行。带usageScript(Base64 编码的 JavaScript)给新供应商配好用量查询。注意默认是关的,必须显式写usageEnabledtrue才启用,usageAutoInterval设自动查询间隔(分钟,0 为关)。另外三种资源。resourceprompt传 Base64 的 Markdown 正文;resourcemcp用apps逗号多选目标应用,config固定按 JSON 解析;resourceskill只支持 Claude,repo必须写成owner/name。出问题时:高频问题速查Q:链接里的密钥泄露了怎么办?链接本身是明文,打码只发生在确认窗口这一层。真实密钥别贴进公开渠道,分享时留空apiKey让对方自己补。Q:Base64 是不是加密?不是。config一条 base64 解码命令就能还原全文,分享前想清楚里面有什么。Q:报 Invalid path 或 Unsupported protocol version?协议目前只认v1和/import。host 写成别的版本、路径拼错,都会在校验阶段被拒,不会进确认窗口。Q:提示 Remote config URL is not yet supported?configUrl参数已定义但远程拉取尚未实现,目前只能用内联的config,把文件内容贴进去编码。Q:skill 链接发给用 Codex 的同事,能导吗?不能。skill 解析时目标应用被硬编码为 Claude,且repo缺斜杠或不是owner/name格式会直接报 Invalid repo format。Q:同一个 MCP 服务器重复导入会覆盖吗?不会。服务器已存在时,重复导入只更新启用状态,原配置保持不动。一条链接替代十个手填字段,是这套协议最实在的价值。现在就打开仓库里的 deplink.html,用表单生成一条不带密钥的 provider 链接,在自己装好 CC Switch 的机器上点开,确认窗口出现的那一刻,你就已经走通了全流程。【免费下载链接】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），仅供参考