ai-memory用Copilot和OpenAI OAuth：零API Key配置订阅账号指南

ai-memory用Copilot和OpenAI OAuth：零API Key配置订阅账号指南

【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory

ai-memory是一款为 AI 编程 CLI（如 Claude Code、Codex、Cursor 等）提供长期记忆的开源工具，它能自动把每次会话沉淀为可检索的记忆页面，并支持在不同 Agent 厂商之间做无缝交接（handoff）。启用 LLM 智能整理功能通常需要配置 AI 服务，但本指南教你用已有的 ChatGPT 订阅（OpenAI OAuth）或 GitHub Copilot 订阅完成登录，全程不需要申请任何 API Key，零额外成本上手。

📋 为什么用订阅账号代替 API Key

用OPENAI_API_KEY按 token 计费固然直接，但对多数个人开发者来说，你其实已经买了 ChatGPT Plus/Pro 或 GitHub Copilot 订阅。ai-memory 内置了两种 OAuth 登录通道，直接复用这些订阅：

两种方式都通过一条auth login命令完成浏览器授权，令牌自动存到本地auth.json并自动刷新，不会过期后失效。

🔑 方式一：OpenAI OAuth 三步登录 ChatGPT 订阅

openai-oauth走的是 ChatGPT/Codex 的 Responses 后端，完全不经过api.openai.com，也不需要OPENAI_API_KEY。

第 1 步：执行登录命令

ai-memory auth login openai-oauth

终端会打印一个授权 URL（https://auth.openai.com/codex/device），在浏览器打开、登录你的 ChatGPT Pro/Plus 账号并确认授权。

第 2 步：等待令牌写入

命令会轮询授权状态，成功后把 refresh token 写入<data_dir>/auth.json，之后访问令牌自动续期，无需再次登录。

第 3 步：指定 Provider 启动服务

export AI_MEMORY_LLM_PROVIDER=openai-oauth

💡 Docker 用户注意：登录命令要和服务器容器使用同一个数据卷，令牌才会落在同一位置。详见 docs/install.md 的 "OpenAI OAuth / Codex" 章节。

🐙 方式二：GitHub Copilot 订阅认证

已有 Copilot 订阅的用户，登录流程更简单：

ai-memory auth login copilot

命令默认使用 GitHub Copilot 公开的**设备码流程（Device Flow）**客户端 ID：终端显示 URL 和验证码，浏览器中授权后完成。ai-memory 把 GitHub user token 存入同一个auth.json，并自动换取短期 Copilot API token、到期前刷新——原始 GitHub token 永远不会直接发给 Copilot 接口，安全性有保证。

非交互部署（如 CI 或远程服务器）可以改用环境变量：

export AI_MEMORY_LLM_PROVIDER=copilot export COPILOT_GITHUB_TOKEN=<你的GitHub令牌>

两条实现源码分别在 crates/ai-memory-llm/src/openai_oauth.rs 和 crates/ai-memory-llm/src/copilot.rs，登录命令的入口在 crates/ai-memory-cli/src/commands/auth.rs，感兴趣可以溯源查看。

⚙️ 最佳实践：选对模型，省得飞起

订阅账号有速率限制，而 ai-memory 的 LLM 工作（会话整理、lint、explore）本质是摘要任务，不是高难推理。官方建议选小而快的模型：

# 例如给 openai-oauth 指定 mini 级模型 export AI_MEMORY_LLM_MODEL=gpt-5-mini

把高推理能力的模型留给你的编程 Agent 本身，记忆系统用 mini/Haiku 级别就绰绰有余，对订阅额度的消耗也小得多。

🔍 验证登录与退出

# 查看令牌是否存在、是否有效 ai-memory auth status # 不再需要时清除令牌 ai-memory auth logout openai-oauth ai-memory auth logout copilot

Docker 场景下在容器内执行同一命令即可：

docker exec -it ai-memory ai-memory auth status

🧰 常见问题速查

• 授权后提示超时？默认有超时保护，重新执行auth login即可；远程 Docker 主机上请在容器内运行登录命令（docker exec -it ai-memory ai-memory auth login openai-oauth）。
• 令牌存在哪里？<data_dir>/auth.json，与服务器共享同一数据卷时容器内外一致。
• 能用 OpenAI 兼容端点吗？可以，openai-compatProvider 支持 Ollama、vLLM、LM Studio 等，但那属于另一条配置路线，详见 docs/install.md。
• 配置文件模板在哪？参考 crates/ai-memory-cli/templates/config.default.toml。

✅ 总结

至此，你已经掌握了 ai-memory 零 API Key 的完整配置路径：一条登录命令接入订阅账号，让长期记忆服务跑在你已有的订阅之上，告别按量计费的账单焦虑。

【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory