Claude Code

Claude Code 是 Anthropic 官方的 CLI agent,也是我自己维护这个 relay 的主力工作台。跟 Cursor 的区别是:它自带工具执行能力,所以 Memory Tool 在这里是真正能用起来的。

适合谁

  • 在终端里做开发、运维、数据处理
  • 需要多步自动化(读文件 → 搜索 → 改代码 → 跑测试 → 提 PR)
  • 想让 Claude 记住项目上下文,下次直接接着干

配置步骤

Claude Code 的接入方式非常干净,只需要改两个环境变量。在 ~/.zshrc(或 ~/.bashrc)里加:

export ANTHROPIC_BASE_URL="https://api.hyper-ailab.com"
export ANTHROPIC_API_KEY="sk-relay-xxx"   # 在 /app/keys 生成

然后 source ~/.zshrc,直接运行 claude:

claude

Claude Code 会用这两个变量初始化客户端,你会看到跟官方一样的交互界面,只不过底层请求全走 HyperAI Relay(可以在 /app/usage 实时看到)。

如果你不想改全局 shell 环境,也可以用 Claude Code 的项目级配置,在仓库根目录创建 .claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hyper-ailab.com",
    "ANTHROPIC_API_KEY": "sk-relay-xxx"
  }
}

这样团队里其他人 clone 下来就能直接用(记得把 .claude/settings.json 的真实 key 行改成本地环境变量占位,别直接把 key 提交到 git)。

Memory 怎么用

Claude Code 默认会把 memory_20250818 作为可用 tool 传给 Claude,也就是说:

  • 你不需要写任何代码,直接跟 Claude 聊天,它自己会判断哪些信息值得存
  • 你可以显式说:"记住:我习惯用 uv 管理 Python,不用 pip",Claude 会主动调 memory tool,把这条信息 create 到你的 Memory 里
  • 下次你再开一个新会话,Claude 会先 view Memory 目录,然后读相关条目,表现出"它认识你"的感觉
  • 想知道它到底存了什么,去 /app/memories 白盒浏览,每条都能看、能删、能导出

这是我现在唯一长期用的工作流 —— Cursor 写代码 + Claude Code 跑工作流 + 两边共享同一份 Memory。

常见问题

Q:我的 Claude Code 里没看到 memory tool 被调用? A:Claude 只会在它认为有必要时才调。你可以明确请求:"请先 view 一下 /memories,看看我之前存过什么,然后再回答。"它就会触发一次。

Q:Memory 会被别的 agent 看到吗? A:不会。Memory 绑定到 API Key 背后的 user_id,默认同一个账户下所有会话共享,跨账户硬隔离。

Q:Claude Code 的文件工具有限制吗? A:我们是透明代理,Claude Code 的 Read / Write / Bash / WebFetch 全部不经过 relay(它们是 client 本地执行的)。relay 只转发对 Anthropic 的消息请求,所以工具调用的安全边界跟你本地 Claude Code 一致。

Q:我希望每个项目一个独立 Memory 怎么做? A:现阶段 Memory 是用户级的,没有 workspace 维度。但你可以在 /memories 根下建 project-A/ project-B/ 子目录,让 Claude 按项目分组存。这种 namespace 模式我们已经开始推(详见 Memory 使用食谱)。

下一步