Claude Code 与 CodeBuddy 接入

Claude Code 与 CodeBuddy 接入

本节摘要:五类框架接入里阻力最小的一类——Claude Code 与 CodeBuddy,它们走代理层路径,改一行 baseURL 即可拥有记忆。本节给出从零到第一次记忆会话的完整步骤,并说清这类「代理层接入」的特点:零改造但失去对上下文的精细控制。读完本节你能让最常见的两类 Coding Agent 立刻接入记忆。

一、为什么 Claude Code / CodeBuddy 用代理层

这两类 Agent 有个共同特点——它们是成熟产品,你不可能改它们的源码。所以只能用代理层(反向托管),而非 SDK(正向集成):

接入方式的选择逻辑
  能改 Agent 源码?
    ├─ 能 → SDK 接入(四步法,完全控制)
    └─ 不能 → 代理层接入(改 baseURL,零改造)
  
  Claude Code / CodeBuddy:不能改源码 → 代理层
​

关键概念:代理层接入的本质是「你接受代理替你做召回/捕获/工具/降级,换取不动 Agent 代码」。对 Claude Code 这种开箱即用的产品,这个交换非常划算——你不必为了记忆重写一个 Agent。

二、接入的标准步骤

Claude Code 接入代理层的标准步骤(概念性):

# 1. 三件套已跑起来(第1章),代理层在 8096

# 2. 配置 Claude Code 指向代理层
export ANTHROPIC_BASE_URL="http://localhost:8096"
export ANTHROPIC_AUTH_TOKEN="代理层签发的密钥"

# 3. 启动 Claude Code,正常使用
claude

# 4. 首次会话时,代理层返回 sessionInit 表单
#    选择 team / agent / task
#    后续请求自动带三元组

# 5. 正常对话,记忆在后台工作
​

CodeBuddy 的接入类似——它也是改 baseURL 指向代理层,具体参数名以 CodeBuddy 文档为准。

三、接入后的工作流

接入后,Claude Code 的工作流与平时几乎一样,只是「背后多了记忆」:

接入后的工作流
  你正常用 Claude Code(写代码/问问题)
    ↓ (每次请求)
  代理层八步管道(第8章)默默工作:
    ├─ 注入记忆(你团队的经验)
    ├─ 转发 LLM
    ├─ 回写对话(沉淀新记忆)
    └─ 上报可观测
    ↓
  Claude Code 答复你(带着团队记忆的智能答复)
  
  → 你感知不到代理层的存在(透明),只觉得「它怎么懂我们团队」
​

这就是「透明代理」的体验——你照常用 Agent,记忆在背后默默增强。唯一能感知到的是 sessionInit 那次表单(首次选 team/agent/task),之后完全无感。

💡 技巧:接入后,用第 1 章的「先说后问」方法验证记忆生效:先告诉它团队约定(如「禁止 ORM」),新会话再问相关问题,看它是否不问就用对。若生效,说明代理层八步管道在正常工作。

四、代理层接入的局限

代理层接入虽省心,但有局限——你失去对上下文的精细控制:

局限的权衡
  代理层:省心(零改造)+ 失控(黑盒)
  SDK:   可控(白盒)+ 费心(写代码)
  
  → 对「只想用记忆,不想折腾」的用户,代理层局限可接受
  → 对「要精细调控每一格上下文」的产品级需求,要 SDK
​

⚠️ 注意:代理层的 sanitize 规则不可控这一点,对敏感场景要注意——代理用固定规则清洗,如果你的对话有「规则没覆盖的特殊敏感信息」,可能被原样回写。高敏感场景建议用 SDK 自己定制 sanitize(第 9 章第 4 节)。

五、多 Agent 共用代理层

代理层支持多个 Agent 同时接入——你可以让 Claude Code 和 CodeBuddy 都指向同一个代理层,共享同一套记忆:

多 Agent 共用代理层
  Claude Code ──┐
                 ├──▶ 代理层(8096) ──▶ 核心服务(共享记忆)
  CodeBuddy  ──┘
  
  → 两个 Agent 共享团队记忆,各自有独立 Loadout
  → 在 Claude Code 里沉淀的经验,CodeBuddy 也能用(若可见性允许)
​

这是「团队多 Agent 共享经验」的基础设施——不同 Agent 框架,同一套记忆,通过代理层统一接入。第 11 章组队场景会用到这个能力:队伍里不同角色的 Agent 可以用不同框架,但共享团队记忆。

本节要点回顾

1. 为什么用代理层:Claude Code/CodeBuddy 不能改源码,只能反向托管(改 baseURL)。
2. 标准步骤:配 baseURL + 密钥 → 启动 → sessionInit 选三元组 → 正常用,记忆背后工作。
3. 透明体验:照常用 Agent,只觉「它懂团队」,感知不到代理层(除首次表单)。
4. 局限:召回/注入/降级/sanitize 都不可控(黑盒)——省心与失控的权衡。
5. 多 Agent 共用:多个 Agent 指向同一代理层,共享团队记忆——多框架统一接入的基础。

下一节看另一类接入——Hermes 适配器,它有熔断/背压/进程守护等长期运行保障。