概述
Codex 是 OpenAI 官方提供的 AI 编码助手,使用 OpenAI Responses 协议。通过修改其配置文件,将请求指向 Memory 的 Proxy 服务后,Codex 即可获得团队记忆、技能与知识的注入能力。
前置条件
开始配置前,请确认已满足以下条件:
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) | 按提示进入计划模式后,选择器会正常弹出 |