用途：设置和诊断本地 agentmemory，包括 MCP、环境变量、端口与功能开关，适合初次接入或检查连接时使用。
配置来源：从环境变量和 ~/.agentmemory/.env（每行一个 KEY=value，无 export 前缀）读取；修改后需重启服务。
连接检查：先检查宿主机的 agentmemory MCP 连接；可用时读取 agentmemory://status，否则调用 memory_sessions（不创建数据）。握手成功不代表守护进程已启动。失败时检查 Node.js 20+ 和 agentmemory 状态；源码检出可先构建再执行 node dist/cli.mjs status。已安装运行时用 agentmemory（或 node dist/cli.mjs）启动，使用插件期间保持运行。
MCP 与认证：Codex 插件自带 MCP，agentmemory connect codex 是仅 MCP 安装的替代方案；两者同时配置需说明重复并让用户选择保留哪个。本地认证自动进行：先宿主机 AGENTMEMORY_SECRET，再 ~/.agentmemory/.env，最后守护进程生成的 ~/.agentmemory/secret。自定义端口需通过宿主环境传 AGENTMEMORY_URL 并重启 MCP 服务器。远程 URL 必须显式提供宿主机密钥，本地文件不会转发。非回环 URL 的认证桥接要求 HTTPS；回环 URL（localhost、127.0.0.0/8、[::1]）允许 HTTP。仅本地密钥从守护进程 .env 读取，其他设置不会被 MCP 宿主自动继承。
钩子：承诺自动捕获前先检查钩子支持与信任（Codex 中 /hooks）。connect codex --with-hooks 仅用于需要全局回退的宿主；原生与全局钩子重复会导致双重捕获。
可选增强：用户选定提供商后，在本地设置其密钥（不打印），并在 ~/.agentmemory/.env 启用 AGENTMEMORY_AUTO_COMPRESS=true、AGENTMEMORY_INJECT_CONTEXT=true。默认基础关键词召回无需 API 密钥；本地嵌入可选，需显式配置和下载模型，未启用前不要承诺向量搜索。耗 token 功能默认关闭，费用与工具使用频率成正比。工具可见性用 AGENTMEMORY_TOOLS=all（默认）或 core，然后重启守护进程并重连 MCP。
数据边界：数据保存在本地守护进程存储；启用的外部模型提供商可接收选定内容，启用前需说明。REST API 默认要求 Authorization: Bearer，未配置时生成本地密钥，可用 AGENTMEMORY_SECRET 覆盖。
端口：REST 固定 3111，流 3112，查看器 3113，引擎 49134；可用 --port <N> 或 --instance <N> 整体迁移。