概述
Claude Code 是 Anthropic 官方提供的 AI 编码助手,通过终端命令行与编辑器交互,使用 Anthropic Messages 协议。将其连接至 Memory 的 Proxy 服务后,Claude Code 即可获得团队记忆、技能与知识的注入能力。
前置条件
开始配置前,请确认已满足以下条件:
1. Memory Hub 已部署并可正常访问。
2. 已在 Memory Hub 的 API Key 页面获取以下两项信息:
客户端接入地址:找到 Claude Code 对应的地址,单击复制。
User Key:以
sk-mem- 开头的密钥,用于身份认证。3. 已安装 Claude Code(可通过
npm install -g @anthropic-ai/claude-code 安装)。配置步骤
Claude Code 通过环境变量完成接入配置:
ANTHROPIC_BASE_URL 指定接入地址,ANTHROPIC_AUTH_TOKEN 指定认证密钥。步骤一:设置环境变量
在终端中执行以下两条命令:
export ANTHROPIC_BASE_URL="http://127.0.0.1:8096/claude-code/default"export ANTHROPIC_AUTH_TOKEN="sk-mem-xxxxxxxxxxxxxxxx"
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: GNU bash, version 5.2.21(1)-release (x86_64-pc-linux-gnu)
上述两个环境变量的含义如下:
环境变量 | 作用 | 是否需要修改 |
ANTHROPIC_BASE_URL | Memory 的接入地址,决定请求实际发送的目标。将示例中的地址替换为从 Memory Hub 复制的实际地址,末尾不要追加 /v1 | 是 |
ANTHROPIC_AUTH_TOKEN | 用于身份认证的 User Key,以 sk-mem- 开头。将示例中的占位值替换为从 Memory Hub 获取的实际密钥 | 是 |
说明:
登录 Memory Hub,进入 API Key 页面,找到 DeepSeek Harness 对应的客户端接入地址与 User Key。
步骤二:持久化环境变量(可选)
若希望每次启动终端自动生效,可将以上两条
export 命令追加到 ~/.zshrc 或 ~/.bashrc 中:echo 'export ANTHROPIC_BASE_URL="http://127.0.0.1:8096/claude-code/default"' >> ~/.zshrcecho 'export ANTHROPIC_AUTH_TOKEN="sk-mem-xxxxxxxxxxxxxxxx"' >> ~/.zshrc
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: GNU bash, version 5.2.21(1)-release (x86_64-pc-linux-gnu)
启动并完成首次初始化
1. 在终端启动 Claude Code:
claude
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:创建技能。常见问题
现象 | 可能原因 | 解决方法 |
启动后连接失败 | 环境变量未生效或接入地址不正确 | 确认当前终端已执行 export 命令,检查 ANTHROPIC_BASE_URL 是否与 Memory Hub 页面一致 |
发送消息后无选择器弹出 | User Key 无效或过期 | 重新从 Memory Hub 复制 User Key,更新 ANTHROPIC_AUTH_TOKEN |
环境变量重启后失效 | 未写入 shell 配置文件 | 将 export 命令追加到 ~/.zshrc 或 ~/.bashrc |