概述
CodeBuddy 是腾讯云提供的 AI 编码助手，使用 OpenAI Chat 协议。通过修改其模型配置文件，将请求指向 Memory 的 Proxy 服务后，CodeBuddy 即可获得团队记忆、技能与知识的注入能力。
前置条件
开始配置前，请确认已满足以下条件：
1. Memory Hub 已部署并可正常访问。
2. 已在 Memory Hub 的 API Key 页面获取以下两项信息：
客户端接入地址：找到 CodeBuddy 对应的地址，单击复制。
User Key：以
sk-mem- 开头的密钥，用于身份认证。3. 已安装 CodeBuddy。
配置步骤
CodeBuddy 的接入配置集中在
~/.codebuddy/models.json 文件中，通过 baseURL 与 apiKey 两个字段完成配置。说明：
~ 表示当前登录用户的主目录，例如 Windows 下为 C:\\Users\\用户名，macOS / Linux 下为 /home/用户名 或 /Users/用户名。步骤一：配置接入地址
编辑
~/.codebuddy/models.json，将模型的 baseURL 字段设置为从 Memory Hub 复制的 CodeBuddy 接入地址：{"models": [{"name": "memory-proxy","baseURL": "http://127.0.0.1:8096/codebuddy/default","apiKey": "sk-mem-xxxxxxxxxxxxxxxx"}]}
上述参数的含义如下：
参数 | 作用 | 是否需要修改 |
name | 自定义的模型标识名称，显示在 CodeBuddy 的模型选择列表中，仅用于辨认，不影响实际功能。可任意取名，如 memory-proxy、memory 等 | 否 |
baseURL | Memory 的接入地址 | 是，粘贴从 Memory Hub 复制的地址 |
apiKey | 用于身份认证的 User Key | 是，粘贴从 Memory Hub 获取的密钥 |
说明：
登录 Memory Hub，进入 API Key 页面，找到 DeepSeek Harness 对应的客户端接入地址与 User Key。
步骤二：配置认证密钥
将
apiKey 字段的值设置为从 Memory Hub 获取的 User Key，将 sk-mem-xxxxxxxxxxxxxxxx 替换为实际的 User Key。启动并完成首次初始化
1. 启动 CodeBuddy，选择刚配置的
memory-proxy 模型。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：创建技能。常见问题
现象 | 可能原因 | 解决方法 |
模型列表未显示新配置 | models.json 格式错误或未重启 | 检查 JSON 语法是否合法，重启 CodeBuddy 后重试 |
发送消息后提示连接失败 | 接入地址不正确或 Proxy 未启动 | 确认 Proxy 服务正常运行，检查 baseURL 是否与 Memory Hub 页面一致 |
发送消息后无选择器弹出 | User Key 无效或过期 | 重新从 Memory Hub 复制 User Key，更新 apiKey 字段 |
