---
title: "安装 Mem0 Codex 插件"
summary: "从 mem0ai/mem0 安装 mem0@mem0-plugins。捆绑服务使用本地 Python stdio，需要 Python 3.10+ 和 MEM0_API_KEY。"
category: skills
level: starter
surfaces: [cli, app, ide]
tags: ["插件", "Mem0", "MCP", "记忆"]
canonical: /tips/mem0-codex-plugin/
---

# 安装 Mem0 Codex 插件

从 mem0ai/mem0 安装 mem0@mem0-plugins。捆绑服务使用本地 Python stdio，需要 Python 3.10+ 和 MEM0_API_KEY。

Mem0 插件用 marketplace 加 mem0ai/mem0，再 plugin add mem0@mem0-plugins。官方 Codex 页推荐先加 GitHub marketplace，再装 `mem0@mem0-plugins`。Mem0 **还不在** OpenAI 精选目录里，桌面 Plugin Directory 搜不到就先跑 marketplace add。这不是 Nowledge Mem 的 `nowledge-mem@nowledge-community`，也不是本机 `nmem`。

密钥从 [app.mem0.ai/dashboard/api-keys](https://app.mem0.ai/dashboard/api-keys) 拿，现行前缀是 `m0-`，不要用旧 token。`MEM0_API_KEY` 必须在**启动 Codex 的那个进程**里。Dock / 开始菜单打开的桌面读不到刚改的 zshrc。插件要 `python3`（3.10+）。

在**普通终端**装，不要在 Codex TUI 里跑：

```bash
export MEM0_API_KEY=YOUR_MEM0_API_KEY
codex plugin marketplace add mem0ai/mem0
codex plugin add mem0@mem0-plugins
```

清单 `.agents/plugins/marketplace.json` 的 name 是 `mem0-plugins`，插件 name 是 `mem0`，source.path 是 `./integrations/codex-plugin`。当前版本 0.3.1。`codex plugin list` 应看到 installed, enabled。0.154 起可先检查当前会话；未显示插件时再新开会话。HTTP 冷启动不是这条：插件 `.mcp.json` 是 **stdio**，command 是 `python3`，args 是 `./core/mcp_server.py`，`cwd` 是 `.`（相对插件根）。它把 `MEM0_API_KEY` 等名字列进 `env_vars` 转发，不要把 `m0-` 写进 TOML。钩子写在插件 `hooks/hooks.json`，**不要**再跑通用仓里的 `install_codex_hooks.py`。

升级：

```bash
codex plugin marketplace upgrade
```

卸插件：`codex plugin remove mem0@mem0-plugins`。连市场一起删：`codex plugin marketplace remove mem0-plugins`。

只要远程 MCP、不要钩子和六条技能时，可使用官方 Option B：

```bash
codex mcp add mem0 --url https://mcp.mem0.ai/mcp/ --bearer-token-env-var MEM0_API_KEY
```

```toml
[mcp_servers.mem0]
url = "https://mcp.mem0.ai/mcp/"
bearer_token_env_var = "MEM0_API_KEY"
```

用户配置中的服务名是 `mem0`，不是其它客户端的 `mem0-mcp`。URL **带**尾斜杠 `/mcp/`。这是 bearer，**不要** `codex mcp login mem0`。已经装了 `mem0@mem0-plugins` 就**不要**再叠这张 `mem0` 表，避免工具名称冲突。

Codex Cloud 的 Secret 只给 setup 脚本，agent 阶段会被清掉。MCP 每次工具调用都要密钥，把 `MEM0_API_KEY` 写成 Environment Variable。Cloud 临时容器也跑不了插件钩子，Cloud 走 Option B。

验证：Option A 问它搜最近一次项目决定；Option B 问它列出 Mem0 entities。写记忆、删记忆保留操作审批。

网页 Cloud 不读取 `~/.codex/config.toml`，要用环境里的 Option B。配置后重新打开会话。用 `codex mcp get mem0`：插件路径看 command 是 python3；Option B 看 url 是 `https://mcp.mem0.ai/mcp/`。

## 来源

- [Mem0 · Codex](https://docs.mem0.ai/integrations/codex)
- [Mem0 · MCP Server](https://docs.mem0.ai/platform/mem0-mcp)
- [mem0ai/mem0 Codex plugin](https://github.com/mem0ai/mem0/tree/main/integrations/codex-plugin)