导读：还在为 AI 编程助手「记性差」而头疼？每次新建对话都要重复交代项目背景，团队成员之间的上下文无法同步，协作效率大打折扣。今天介绍一个开源工具 OneContext，它被称为「AI Agent 的自管理上下文层」，能让你的 Claude Code、Codex 等编程助手跨会话、跨设备记住一切，甚至可以通过链接分享上下文，让别人直接接手你的工作。

想象这样一个场景：你花了两个小时和 Claude Code 梳理清楚项目的架构、依赖关系和核心逻辑，第二天想继续推进，却发现：对话历史已经丢失，AI 完全不记得昨天聊了什么。。。然后不得不从头开始。这不是个例，而是所有深度使用 AI 编程助手的人的共同痛点。

OneContext 正是为解决这一问题而生。

它构建了一个跨会话、跨设备、跨编程代理的持久化上下文层。你在 OneContext 中打开 Claude Code 或 Codex，它会自动将你的对话轨迹和项目上下文记录下来。当你启动新的对话或新的代理时，只需要加载这个上下文，它就能「无缝衔接」之前的工作。更炸裂的是，你可以生成一个链接分享给队友，对方点击后就能直接「接管」你正在做的项目，AI 会记住你之前所有的沟通和决策。

技术实现：Git + 文件系统的巧妙组合

你可能会好奇，这种「记忆能力」到底是怎么做到的？根据作者在 arXiv 发表的论文（https://arxiv.org/abs/2508.00031），OneContext 的核心机制很简单：用 Git 做时间维度的管理，用文件系统做空间维度的管理。它记录你与 AI 交互的完整轨迹，但并不会把这些信息全部塞进上下文窗口。

这就好比一个文件夹系统：AI 默认只看到「文件夹名称」（即项目的高层摘要），只有当需要具体细节时才会「点开文件夹」查看里面的文件。这种设计让上下文窗口的占用与传统的 single memory.md 方案几乎相同，只有当 AI 主动深入某个模块时才会加载更多内容。作者透露，正是这种轻量级设计，让 Claude Code 在 SWE-Bench 测试中的性能提升了约 13%。

快速上手：三步开始使用

OneContext 的安装和使用非常简洁，不需要复杂的配置，开发者可以在几分钟内完成部署。

安装命令：

npm i -g onecontext-ai

前置要求：

• Node.js >= 16
• Python 3.8+（支持 uv、pipx、pip3、pip 任一包管理器）
• 系统限制：目前仅支持 macOS

启动方式：

安装完成后，在终端执行 onecontext 即可启动。OneContext 提供了三个等效命令供你选择：onecontext-ai、onecontext 和 oc，你可以根据习惯自由使用。

常用命令示例：

# 查看版本onecontext version# 查看帮助onecontext --help# 更新版本onecontext update

如果遇到命令未识别的情况，可以尝试运行 onecontext doctor --fix-upgrade && onecontext update 进行修复，或使用 npm rebuild onecontext-ai 重建软链接。

市面上已经有不少 AI 上下文管理工具，但 OneContext 的差异化在于它兼顾了完整性与轻量性。它不丢失细节，但也不浪费 token，它支持协作，而且设计足够简洁。更重要的是，它的性能提升已经在标准测试中得到验证（13% 的 SWE-Bench 提升）。

作者在产品介绍中写道：「我为自己开发了这个工具，但现在没有它我没法工作，所以觉得有责任分享出来。」

项目地址与资源：

• GitHub 仓库：https://github.com/TheAgentContextLab/OneContext
• 技术论文：https://arxiv.org/abs/2508.00031
• 安装方式：npm i -g onecontext-ai，然后 onecontext
• 系统要求：macOS

参考资料：https://x.com/JundeMorsenWu/status/2020161412593774922