云同步

在任何机器上访问完整、统一的 AI 编程历史

Contextify Cloud 会在你的各台机器之间同步已建立索引的 Claude Code 和 Codex 历史记录，这样你在一台 Mac 上做过的工作，在另一台上也能搜索到。

3 步完成连接

开始之前：以下步骤使用 Contextify Mac 应用，请先安装并打开它（参阅 Mac 快速入门）。在 Linux 上，请改在终端运行 contextify cloud setup 来连接 Cloud；详见 Linux 指南。

打开“Settings → Cloud”

选择托管版 Contextify Cloud，然后点击 Connect this Mac（连接这台 Mac）。

想运行自己的服务器？请按照自托管快速入门操作。
登录

输入你想用于 Contextify Cloud 的邮箱地址，然后在浏览器中完成登录。如果账号或工作空间尚不存在，完成验证时会创建。
让应用保存这台设备

登录成功后，应用会为这台 Mac 保存一个设备凭据。托管流程从不要求你手动粘贴 API 密钥。

打开“Cloud”标签页。这里会显示提供方、已连接的设备、你的账号和当前同步状态。

本地历史记录较多的 Mac 会先为这些历史记录建立索引，因此在本地处理完成前，云同步可能暂时处于延后状态。如果首次运行耗时较长，请参阅导入与同步。

同步会上传 Contextify 已在这台 Mac 上建立索引的 AI 历史记录，并从你的其他机器拉取对应的更新。它读取的是本地历史记录，不是服务器之间的传输。

同步到你的账号：Contextify 已在这台 Mac 上建立索引的项目、对话和对话记录条目，以及把它们关联在一起的设备元数据。

保留在这台 Mac 上：Contextify 尚未建立索引的任何内容、你排除在同步之外的项目，以及你的账号、成员身份、计费信息和 API 密钥。

在托管版和自托管之间切换不会改动旧服务。Cloud 切换指南列出了具体哪些内容会迁移。

同步卡住了，或者状态显示离线？先看云同步故障排查，其中介绍了各种状态，以及托管版和自托管的检查步骤。

最后更新：2026 年 5 月 31 日