技能介绍

要解决什么问题

在国内用 Codex 往往卡在 OpenAI 登录与网络；同时 Agnes AI 提供文本、图片、视频等多模态 API，但 Codex++ 的安装、DMG 架构选择、以及「Responses API → Chat Completions」的代理链路很容易配错。本技能把「下版本、装应用、接供应商、验连通」串成可执行的流程，减少手改 config.toml 却每次被覆盖的情况。

技能如何工作

环境检测：识别 Apple Silicon / Intel，从 GitHub Releases 拉取对应 CodexPlusPlus-{version}-macos-*.dmg；网络受限时可走镜像，并在下载后确认 DMG 路径再继续安装。
供应商配置（核心）：优先通过 Codex++ 管理工具 GUI 添加 Agnes AI：Base URL 为 https://apihub.agnes-ai.com/v1，上游协议选 Chat Completions（勿选 Responses API），保存后必须点该行的 「使用」 并 重启 Codex++。
无 GUI 时的自动化：在关闭 Codex 相关进程后，写入 ~/.codex-session-delete/settings.json；运行时 wire_api 只能是 "responses"，base_url 指向本地代理 http://127.0.0.1:57321/v1，由代理把请求转成 Chat Completions 再访问 Agnes。
验收：API 返回含 choices；界面绿点、可选 agnes-2.0-flash、对话有回复即链路正常。

适用边界与注意点

平台：文档明确为 macOS；需自备 Agnes API Key，且首次原版 Codex 登录可能仍要短暂能访问 OpenAI。
常见坑：勿把 platform.agnes-ai.com 当 API 地址；纯 API 模式应设 requires_openai_auth = false；只改 ~/.codex/config.toml 往往无效，应以 settings.json / 管理工具为准。Agnes 免费档可能 429，稍等重试即可。

截图预览

使用场景

在 macOS 上想用 Codex 辅助写代码，但无法稳定访问 OpenAI，需要安装 Codex++ 并把对话后端切到 Agnes AI。
已在 https://platform.agnes-ai.com 拿到 API Key，需要按本机架构下载对应 DMG，并在管理工具里完成供应商添加与「使用」激活。
希望在 Codex++ 模型列表里使用 agnes-2.0-flash 或图文/视频类模型，而不是依赖 OpenAI 官方端点。
安装或改配置后出现 wire_api 报错、界面红点或 BadRequestError，需要按本地代理与 settings.json 字段逐项核对连通性。

适合人员

在 Mac 上用 Codex 做代码补全与对话、但网络或账号无法长期直连 OpenAI 的应用/后端工程师。
已注册 Agnes AI、希望用免费多模态 API，却不想对照多篇博客手工下载 DMG 和改 JSON 的个人开发者。
要为同事交付可运行的 Codex++ 客户端、需要区分 Apple Silicon 与 Intel 安装包并统一供应商配置的团队内 IT 或负责人。
曾手改 ~/.codex/config.toml 发现重启即被覆盖，需要弄清管理工具与 ~/.codex-session-delete/settings.json 谁才是生效配置的维护者。