企业官网建设流程全解析

多设备同步AI工具配置：CC Switch云同步与WebDAV设置完整教程

【免费下载链接】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 是一款跨平台桌面 All-in-One 助手，统一管理 Claude Code、Codex、OpenCode、OpenClaw、Grok Build 与 Hermes Agent 等 AI 编程工具的供应商配置。它内置的WebDAV 云同步功能，可把数据库（全部 Provider 配置）和技能包同步到云端，实现多设备同步——办公电脑配好的配置，回家打开笔记本一键恢复，不再需要手动复制粘贴 API Key。本教程将带你完成 CC Switch 云同步与 WebDAV 设置的完整配置。

为什么需要多设备同步 AI 工具配置？

如果你同时使用多台电脑写代码，下面这些场景你一定不陌生：

CC Switch 的云同步功能通过 WebDAV 或 S3 兼容存储解决以上问题：所有配置打包成带版本号的数据库快照，上传到云端，任意设备下载即可完整恢复。

CC Switch 云同步会同步哪些内容？

进入设置页面（左上角 ⚙️ 按钮，或Cmd/Ctrl + ,），即可看到「WebDAV 云同步」区域：

一次同步会包含两类内容：

1. 数据库：所有 Provider 配置（API Key、Base URL、模型）、MCP 服务器、提示词等全部核心数据；
2. 技能包：所有自定义技能（Skills）。

自 v3.12.0 起，同步采用协议 v2 + db-v6 双层版本控制，可自动识别旧版云端路径并平滑迁移到新版路径，详见发布说明。

WebDAV 云同步配置步骤（推荐新手）

WebDAV 是最省心的方案：坚果云、Nextcloud、群晖 NAS 等常见服务都内置 WebDAV 支持，无需额外安装。

第一步：打开同步面板并选择服务商

打开设置 → WebDAV 云同步，面板顶部有「同步方式」选择器（WebDAV / S3 兼容存储，两者互斥）。选择服务商后会自动填充服务器地址模板：

💡 修改 URL 后若不再匹配预设模板，面板会自动切回「自定义」模式。

第二步：填写账户信息并保存

需要填写的字段很少：

• 服务器地址：上表已自动填充（可手动微调）；
• WebDAV 账户：如坚果云为邮箱账号；
• WebDAV 密码：坚果云请填写「安全选项 → 第三方应用密码」；
• 远程根目录：默认cc-switch-sync，建议保持默认；
• 同步配置名（Profile）：默认default，详见下文进阶用法。

点击「保存配置」后会自动执行一次连接测试，成功则提示"配置已保存，连接正常"。

第三步：上传、下载与自动同步

面板下方提供三个核心操作：

• ⬆️ 上传到云端：把本机配置打包上传。若云端已有数据，会先弹出确认框展示云端快照的设备名、上传时间和路径，提示"将覆盖云端已有的同步数据"；
• ⬇️ 从云端下载：在新设备上恢复配置，恢复前会展示云端快照详情并提示"将覆盖本地所有数据和技能配置"，请务必确认；
• 🔁 自动同步：开启后每次数据库变更都会自动上传。首次开启需二次确认，防止误操作。

注意：自动同步失败时会显示"上次自动同步失败"的原因（通常是网络问题），系统会在后续变更时自动重试，不会丢数据。

这就是你即将同步的 Provider 配置，换设备后下载快照即可完整恢复：

S3 兼容存储：面向 NAS 和云存储用户的进阶方案

如果你有 AWS、阿里云、腾讯云等对象存储账号，可在「同步方式」中切换为S3 兼容存储（与 WebDAV 互斥，切换时会自动禁用另一方）。内置服务商预设：

AWS S3 建议使用 IAM Access Key，并授予s3:PutObject/GetObject/HeadObject权限。填写存储桶、密钥后，测试连接、上传下载、自动同步的操作流程与 WebDAV 完全一致。

进阶技巧：用 Profile 隔离多套环境

「同步配置名（Profile）」默认是default，实际同步路径形如cc-switch-sync/v2/db-v6/default。你可以为不同用途设置不同 Profile，例如：

• work：只放工作供应商，配合公司的坚果云企业空间；
• personal：放个人订阅账号，同步到家庭 NAS。

两台设备使用相同 Profile 才能互相同步，相当于天然的"配置分组"功能。

常见问题

Q：下载恢复会删除本地现有配置吗？A：会覆盖本地所有数据和技能配置。建议在覆盖前先用设置页的备份功能导出快照。

Q：提示"远端数据版本不兼容"怎么办？A：说明云端快照的协议版本与当前版本不匹配（当前支持协议 v2 / db-v6）。先升级本机和上传设备的 CC Switch 到最新版本再试。

Q：坚果云连接一直失败？A：99% 是用了登录密码。请到坚果云「安全选项」生成「第三方应用密码」并重新填写。

相关文档与源码

• 云同步前端面板：WebdavSyncSection.tsx
• WebDAV 传输实现：webdav.rs
• 同步打包逻辑：webdav_sync.rs
• 自动同步守护逻辑：webdav_auto_sync.rs
• 同步协议定义：sync_protocol.rs
• 设置页使用手册：1.5 个性化配置

按照以上步骤完成 CC Switch 的 WebDAV 设置后，你的 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