Never lose context.Never start over.

开始使用

为每一次代码任务，找回真正相关的项目记忆。从 Codex 切换到 Claude Code，也不必重新解释背景，新 Agent 会自动恢复项目架构、历史决定与工作要求。

memorax-code 安装引导设计
安装流程拆分

你想让我们在 网页修改 中构建什么？

检查 memorax-code 的安装流程，给出可落地的拆分方案和下一步。
正在检查安装流程…
耗时 4 分钟 40 秒

当前 postinstall 约 1303 行，同时承担配置、交互、客户端检测、插件与 Hook 变更、Backend 启动和检查，职责过重。

结论 拆分 setup / provision / reconcile postinstall 只保留必要的非交互机械动作 
npm install -g @memorax/memorax-code
└─ install CLI only

memorax-code setup
├─ collect User ID / language
├─ call provisioning API
├─ save returned Key
├─ configure Codex / Claude Code
└─ start Backend + verify status
MEMORAX · MEMORY SAVED · 3

01Decision显式 setup，不依赖 TTY

02Boundary配置与 Agent 接入分离

03Entrysetup.ts · postinstall.js

Ready for another agent
Claude CodeCLI · waiting for context

alex@mac memorax-code % claude -c

Welcome back Alex!Claude Code v2.1.0Sonnet 4.6 · Claude Max~/Projects/memorax-code

继续安装流程设计，根据 Codex 保存的决定接着实现。

●I'll restore the project context first.● Skill(memorax-code)
　└─ Successfully loaded skill

●Bash(memorax-cli search --query "安装流程设计")└─ Found 3 relevant memories

MEMORAX · MEMORY RECALLED · 3

01Decision显式 setup，不依赖 TTY

02Boundary配置与 Agent 接入分离

03Entrysetup.ts · postinstall.js

Context restored into this session

●Bash(git status --short --branch)└─ ## main · working tree clean

●

Context restored.I'll continue from setup.ts without changing the existing Key flow.

›Try "continue implementing setup.ts"
? for shortcuts⏵⏵ accept edits on · shift+tab to cycle

01 / 三个强对比案例

从重复摸索，到带着经验继续

同一类代码任务，有 Memory 时从已经验证的判断继续；没有 Memory 时，只能再次搜索、推测和试错。

复用已经验证的经验

第一次任务已经证明，过早转换 UNSET 会引发回归。Memory 让后续任务从这条判断继续，而不是再走一次错误路径。

OFF
用时 13:38 · 1 次重试
ON
用时 7:04 · 0 次重试

换一个 Session，也沿用你的规则

Agent 不再用默认的英文提交，而是自动取回用户约定：新增功能使用 feat，标题与正文保持中文。

OFF
再次纠正 · 1 次
ON
直接符合 · 0 次纠正

上下文压缩后，仍找得到“为什么”

经历两次 Compact 后，不从当前代码反推通用理由，而是取回当时保存的设计依据，并用现状完成验证。

OFF
宽泛推测 · 无依据
ON
准确召回 · 可追溯
同一个任务不同的执行路径
OFF从头摸索
任务方案测试完成失败
RETRY
01 $ rg -n "UNSET|Context.invoke" 02 src/click/core.py 03 def test_callback_never_receives_unset(): 04 result = runner.invoke(cli, []) 05 assert result.output == "None" 06 $ PYTHONPATH=src .venv/bin/pytest -q 07 FAIL Sentinel.UNSET != None × 08 retry: preserve state until public boundary 09 $ rg -n "process_value|default|required" 10 PASS callback + default + required ✓
ON从记忆继续
任务召回测试完成
MEMORY ON
01 $ rg -n "UNSET|Context.invoke" 02 MEMORY UNSET is click-private state 03 never expose it to callback / type_cast 04 boundary: Parameter.process_value 05 missing = value is UNSET 06 value = self.type_cast_value(...) 07 $ PYTHONPATH=src .venv/bin/pytest -q 08 PASS 3/3 tasks · retry 0 ✓ 09 RUN UNSET 全部复用同一条规则

02 / 快速开始

开始使用 MemoraX Code

安装 CLI，进入示例仓库，然后开始一次能延续项目上下文的代码对话。

支持的 AI Coding 客户端

支持 Codex

跨 Codex 任务恢复项目架构与历史决定。

OPTIONAL / DEMO 可跳过

安装完成后即可直接使用 MemoraX Code；以下内容仅用于体验跨会话记忆。

开始前 先准备示例仓库 复制并运行下面两行命令，然后从第 1 轮开始。
$ git clone https://github.com/SWE-agent/test-repo.git$ cd test-repo
按右侧演示操作
  1. 从第 1 轮开始，依次复制指令。
  2. 在 Coding Agent 中完成当前轮次。
  3. 第 4 轮前新建一个会话。
第 1 轮让它看懂仓库这一步会建立一份以后可以搜索的仓库记忆。
请使用 MemoraX Code 帮我构建 Repo Memory，只拉取最近 3 条 Issue、PR 和 Commit。
Coding Agent

Repo Memory 已构建并通过校验，包含项目入口及最近的 Issue、PR 和 Commit，可供后续任务检索。

第 2 轮让它回顾旧错误这一步会让以前遇到的问题参与当前检查。
请回顾一下 Repo Memory 最近的 Issue：以前第 0 个数字曾经算错。现在请避免同样的问题再次出现。
Coding Agent

已找回历史问题：tribonacci(0) 曾因 n - 1 索引读取错误值。当前实现已直接读取第 0 项，并验证 0、1、3、10。

第 3 轮让它记住这次修复这一步会保存已经确认过的原因、修复方法和测试方式。
请使用 MemoraX Code，记住这次的代码开发经验。
Coding Agent

已记住：零起始递推要先验证第 0 项，避免偏移索引，并保留 0、1、3、10 的边界测试。

新会话从这里开始现在请新建一个会话关闭当前对话，新建会话后再发送第 4 条指令。
第 4 轮新会话问它建议这一步用来确认新会话仍然能使用之前保存的经验。
请使用 MemoraX Code，回忆之前的开发经验，看看有哪些建议。
Coding Agent

已回忆：这个仓库的 Tribonacci 曾出现下标偏一位。建议继续保留边界测试，并优先运行相关测试。

03 / 四类 Memory

让每一种记忆， 在需要时准确出现。

MemoraX Code 分别沉淀编码经验、仓库知识、个人偏好与工作流程，只为当前任务召回真正相关的上下文。

Coding Memory

让工程经验沉淀为长期判断，保存真实代码任务中形成、可跨任务复用的工程经验。

Repo Memory

让仓库知识沉淀为长期理解，保存代码仓库的结构、模块关系与持续演变的关键证据。

Personal Memory

让个人偏好沉淀为协作习惯，保存跨项目适用的语言、语气、工具与稳定的交付方式。

Procedure Memory

让成熟流程沉淀为执行标准，保存已验证的方法、任务步骤、检查标准与发布门禁。

04 / 常见问题

FAQ

应该注册账号还是使用游客模式？

推荐先注册或登录 MemoraX 账号，再运行 memorax-code setup --existing-account。如果想先体验，可运行 memorax-code setup 开启 90 天游客模式，无需提前填写 API Key。将游客账号转为正式账号前，请先运行 memorax-code account --show-mark-id 获取 Mark ID，再使用该 Mark ID 注册；当前已注册账号暂不支持补绑 Mark ID。

它支持哪些 AI Coding 客户端？

当前 npm 预览版支持 Codex、Claude Code、DeepSeek Harness 与 OpenCode。客户端范围集中写在上方安装步骤中，不需要额外安装一套工作环境。

它是完全离线的吗？

MemoraX Code 采用 local-first（本地优先）设计，核心控制优先在本机完成。但为了支持跨会话的记忆检索和同步，部分经过筛选的代码记忆会上传并保存到 Memorax 服务器，因此它并不是完全离线的产品。

它会把每句话都保存下来吗？

不会。MemoraX Code 只关注值得长期保留的信息，并按 Coding、Repo、Personal 与 Procedure Memory 的边界分类。Procedure Memory 仍需用户明确授权后才会保存。