一、前置条件
开始配置前,请确认已满足以下条件:
1. Memory Hub 已部署并可正常访问。
2. 已在 Memory Hub 的 API Key 页面获取以下两项信息:
·客户端接入地址:找到 Codex 对应的地址,单击复制。
·User Key:以 sk-mem- 开头的密钥,用于身份认证。
3. 已安装 Codex。
二、配置步骤
Codex 的接入配置集中在 ~/.codex/config.toml 文件中,通过 base_url 与 experimental_bearer_token 两个字段完成配置。
注意:说明:
注意:文件位置:~ 表示当前登录用户的主目录,例如 Windows 下为 C:\\Users\\用户名,macOS / Linux 下为 /home/用户名 或 /Users/用户名。
三、步骤一:配置接入地址
编辑 ~/.codex/config.toml,将 base_url 设置为从 Memory Hub 复制的 Codex 接入地址:
base_url = "http://127.0.0.1:8096/codex/default"experimental_bearer_token = "sk-mem-xxxxxxxxxxxxxxxx"
| 参数 | 作用 | 是否需要修改 |
| base_url | Memory 的接入地址 | 是,粘贴从 Memory Hub 复制的地址 |
| experimental_bearer_token | 用于身份认证的 User Key | 是,粘贴从 Memory Hub 获取的密钥 |
注意:说明:
注意:登录 Memory Hub,进入 API Key 页面,找到 DeepSeek Harness 对应的客户端接入地址与 User Key。
四、步骤二:配置认证密钥
将 experimental_bearer_token 的值设置为从 Memory Hub 获取的 User Key,将 sk-mem-xxxxxxxxxxxxxxxx 替换为实际的 User Key。
五、启动并完成首次初始化
1. 在终端启动 Codex:
codex
2. 发送任意消息(例如 hi),Proxy 会依次返回以下选择器(按钮形式):
·是否关联团队资产(Associate team assets?):选择 Yes 注入团队上下文,选择 No 跳过。
·选择团队(Team):仅存在一个团队时会自动跳过。
·选择 Agent:在所选团队下选择 Agent。
·选择任务(Task):首行是虚拟的 "No task" 条目。
3. 完成选择后,Agent 会进行自我介绍,并在后续每轮对话中自动注入以下上下文:会话上下文(<session_context>)、可用的技能列表(<available_skills>)与用户画像记忆(<tdai_profile_memory>)。
4. 初始化完成后,可在聊天中输入以下斜杠命令使用相关能力:
·mem:help:查看记忆命令的帮助。
·mem:sync:同步记忆。
·mem:create-skill:创建技能。
六、常见问题
| 现象 | 可能原因 | 解决方法 |
| 启动后连接失败 | config.toml 格式错误或接入地址不正确 | 检查 TOML 语法是否合法,确认 base_url 是否与 Memory Hub 页面一致 |
| 发送消息后无选择器弹出 | User Key 无效或过期 | 重新从 Memory Hub 复制 User Key,更新 experimental_bearer_token |
| 提示需要进入计划模式 | Codex 首轮需进入计划模式(Plan mode) | 按提示进入计划模式后,选择器会正常弹出 |