AiMaMi Codex 管理工具是一款面向 OpenAI Codex 用户的开源桌面应用,主要用于集中管理账号与额度、历史会话、MCP、Skills、自定义指令,以及第三方模型和中转服务的智能路由。
Codex 现在已经不只有 CLI。OpenAI 已经推出完整的桌面端,并将 Codex 整合进新版 ChatGPT 桌面应用,可以按项目管理线程、并行运行 Agent、查看代码 Diff,也支持 Worktree 等开发流程。
所以今天再看 AiMaMi,它的定位并不是“给 Codex 补一个 GUI”,而是把重点放在 Codex 本地配置、账号额度、模型 Provider、智能路由、线程数据库和 MCP / Skills 管理这些更偏底层的工作上。
AiMaMi 基于 Tauri 2、React 和 Rust 开发,会直接读取和修改 ~/.codex 下的 Codex 本地数据,并将自己的应用数据保存在 ~/.codex/codexmate/。它不是 OpenAI 官方产品,也不会替代 Codex 本身,更像是围绕现有 Codex 环境增加一层管理工具。
AiMaMi Codex 管理工具现在主要解决什么?
官方 Codex 桌面端已经能很好地完成写代码、运行 Agent 和管理项目,但有些事情依然更适合单独做一个管理层。
比如同时维护多个 Codex 账号、查看不同账号的额度状态、配置第三方模型、修复异常线程、批量管理 MCP 或 Skills,这些工作往往会涉及 auth.json、TOML、JSON、SQLite 以及 AGENTS.md 等本地文件。
AiMaMi 做的,就是尽量把这些操作搬进图形界面。
AiMaMi 和官方 Codex App 有什么区别?
两者现在并不是简单的替代关系。
官方 Codex 更偏向实际开发工作:打开项目、运行 Agent、并行处理任务、查看修改内容和继续历史线程。
AiMaMi 更偏向维护 Codex 环境:账号与额度、Provider、中转模型、智能路由、线程数据库、MCP、Skills、自定义指令以及配置诊断。
如果只使用一个 ChatGPT 账号和官方模型,官方 Codex App 本身通常已经够用。
如果你的 ~/.codex 下面已经堆了不少配置,或者同时维护多个账号、MCP 和模型 Provider,AiMaMi 才会更容易体现价值。
AiMaMi 主要有哪些功能?
会话管理:查看、整理和修复 Codex 历史线程
AiMaMi 可以读取 Codex 本地线程索引,把不同项目下的历史会话集中展示,并提供分析、批量清理和线程修复等操作。
这项功能现在不只是单纯“浏览历史记录”。
近几个版本一直在处理智能路由切换后线程不可见、Provider 不一致、SQLite 被其他程序占用等问题,并提供对应的诊断和修复能力。
对于长期使用 Codex、已经积累大量线程的用户,这部分比早期版本实用得多。
MCP、Skills 与 AGENTS.md 集中管理
MCP 和 Skills 也可以直接在 AiMaMi 中管理,包括添加、启用、备份和恢复,不需要每次手动修改配置文件。
自定义指令方面,AiMaMi 主要管理 ~/.codex/AGENTS.md 中由它维护的内容,并提供预览和回滚。
这类功能最大的作用不是增加 Codex 能力,而是降低频繁手改配置文件带来的出错概率。
智能路由:把第三方模型接进 Codex 工作流
模型路由目前已经成为 AiMaMi 比较核心的功能之一。
它可以配置第三方 Provider 和中转服务,并通过协议适配,让部分 Claude、DeepSeek 等模型进入 Codex 工作流,同时提供连通性测试、配置导入导出和路由诊断。
这里有一个很重要的使用条件:
Provider、中转服务与系统诊断
现在的 AiMaMi 已经不只是一个简单的模型切换器。
Provider 管理支持连接测试、导入导出和路由诊断;系统维护部分还可以检查路由配置、线程 Provider、虚拟账号残留和部分 Codex 配置异常。
近期版本也一直在提高 Windows 下线程数据库和智能路由的兼容性。
AiMaMi 1.2.6 有哪些变化?
本文更新时,GitHub Releases 最新正式版本为 AiMaMi 1.2.6,发布于 2026 年 8 月 2 日。
这一阶段的更新重点已经从单纯增加功能,转向提高智能路由和线程修复的稳定性。
1.2.x 这一轮比较明显的变化包括智能路由开启与关闭稳定性、线程恢复、虚拟账号切换、中转协议兼容、脱敏诊断报告,以及 Windows 设备兼容。
1.2.6 又进一步修复了 Windows 智能路由与线程修复问题,并补充部分 Claude 和 DeepSeek 协议适配。
项目官方同时提醒,使用新版 AiMaMi 前最好先把 Codex 更新到当前版本,否则智能路由、线程迁移和诊断功能可能出现兼容性问题。
账号和额度管理怎么用比较合适?
AiMaMi 可以集中查看账号状态和额度,并提供账号导入导出与自动切换功能。
官方项目说明中,自动切换的设计场景之一就是当前账号的 5 小时或周额度耗尽后,寻找其他可用账号并重新启动 Codex。
这项功能本身比较方便,但使用边界需要自己把握。
AiMaMi 现在是开源的吗?
是。
当前 AiMaMi GitHub 仓库以 Apache License 2.0 发布,仓库已经包含 React 前端、Tauri / Rust 后端、构建脚本以及相关项目文件。
官方也直接提供了源码构建方式:
git clone https://github.com/borawong/AiMaMi.git
cd AiMaMi
pnpm install
pnpm tauri dev
需要打包生产版本,也可以使用 pnpm tauri build。
所以早期版本文章里“账号、线程和智能路由属于私有闭源模块”“自己编译只能获得基础功能”的说法,现在已经不适合继续保留。
不过,开源并不等于所有使用场景都没有风险。
AiMaMi 会直接读取和修改 Codex 本地配置、账号信息和线程数据库;如果再配置第三方中转或模型 Provider,请求还会进入对应的第三方服务。企业或团队环境使用前,仍然建议结合当前源码、Provider 数据处理方式和内部安全要求自行评估。
macOS、Windows 和 Linux 怎么安装?
普通用户直接使用 GitHub Releases 提供的安装包即可,不需要提前安装 Node.js 或 Rust。
当前官方 Release 主要提供:
- macOS:Universal 安装包,同时支持 Apple Silicon 和 Intel,要求 macOS 12 或更高版本。
- Windows:x64 安装包,当前 Release 标注 Windows 10 / 11。
- Linux:项目 README 标记为部分工作流尽力支持,目前并不是主要 Release 平台。
已经安装 AiMaMi 的用户也可以直接通过应用内的“检查更新”进行 OTA 升级。
如果准备自己编译,则需要 Node.js、pnpm、Rust 和 Tauri 对应的系统依赖。
哪些 Codex 用户更适合 AiMaMi?
如果只是偶尔打开 Codex 写点代码,主要使用官方模型,而且几乎不碰 MCP、Provider 和本地配置,安装 AiMaMi 的必要性并不高。
它更适合已经把 Codex 当成长期开发环境的人。
例如手里同时跑着多个项目、积累了大量历史线程;需要维护多个 MCP 和 Skills;经常修改 AGENTS.md;或者需要在 Codex 中使用不同 Provider 和模型。
这也是现在 AiMaMi 和官方 Codex App 比较清楚的分工:Codex 负责干活,AiMaMi 更偏向维护 Codex 这套本地环境。
使用 AiMaMi 前需要知道的限制
AiMaMi 和 Codex 本地数据绑定比较深,所以 Codex 本身发生配置格式、线程数据库或协议变化时,AiMaMi 也需要跟着适配。
从近期多个版本的更新记录也能看到,智能路由、线程迁移和 Windows 兼容一直是项目持续修复的重点。
如果你高度依赖第三方模型路由,还需要考虑另一层依赖:AiMaMi 本地代理需要持续运行,对应的第三方 Provider 也必须保持可用。
涉及团队代码、商业项目或敏感数据时,不要因为工具是开源项目就默认数据链路没有风险。除了 AiMaMi 本身,还应该一起评估实际使用的 Codex、模型 Provider 和中转服务。
如果你还在找 Codex、Claude Code、本地模型和 AI 开发工作流相关工具,也可以继续查看本站整理的 AI 工具内容。
AiMaMi 项目主页与下载入口
免责声明:本文基于 AiMaMi GitHub 仓库、Release 更新记录与 OpenAI 官方公开资料整理。AiMaMi 为第三方独立项目,与 OpenAI 无隶属或官方合作关系。使用账号切换、第三方模型、中转 Provider 和 API 时,请遵守对应平台当前服务条款,并根据实际场景评估代码、账号信息和数据流向。

评论(0)