Codex桌面客户端拥有强大代码读写、项目自动化能力，但原生版本存在插件锁定、会话管理受限、模型选择单一等使用阻碍。Codex++作为开源外部增强启动器，通过无侵入注入方式补齐原生短板，同时支持接入Agnes AI免费全模态模型，文本、图像、视频能力均可零成本调用。本文拆解安装流程、核心功能、Agnes接入配置与落地场景，降低AI工具使用门槛。

📌 一、项目基础概览

✨ 1.1 工具定位

Codex++开源仓库地址：https://github.com/BigPizzaV3/CodexPlusPlus，

采用Rust+Tauri技术栈，全程不修改Codex原始程序文件，依托Chromium DevTools Protocol动态注入增强脚本，Windows、macOS双平台适配。 Agnes AI官网：https://platform.agnes-ai.com

✨ 1.2 原生vs增强对比表

✨ 1.3 两大核心价值

1. 修复原生交互短板，补齐会话、插件、多供应商管理缺失功能；
2. 兼容OpenAI标准接口，一键接入Agnes免费全模态大模型，减少Token开销。

📌 二、分步安装教程

✨ 2.1 前置准备

1. 安装官方Codex客户端，完成一次基础启动确保程序完整；
2. 前往Codex++ Releases页面下载对应系统安装包：
   • Windows：CodexPlusPlus-windows-x64-setup.exe
   • Mac Intel：macos-x64.dmg
   • Mac M系列：macos-arm64.dmg

✨ 2.2 Codex++安装操作

1. Windows：双击安装包跟随向导完成，自动生成桌面双快捷方式；
2. macOS：拖拽DMG内程序至应用文件夹，若提示损坏，终端执行修复命令：

sudo xattr -rd com.apple.quarantine "/Applications/Codex++.app"
sudo xattr -rd com.apple.quarantine "/Applications/Codex++ 管理工具.app"

1. 安装完成生成两类入口：

• Codex++：静默启动入口，日常开发直接双击；
• Codex++管理工具：用于模型配置、日志查看、功能开关、版本更新。

✨ 2.3 Agnes账号与密钥获取

1. 访问Agnes平台完成手机号/邮箱注册，全程无需绑卡；
2. 侧边栏打开API密钥栏目，点击创建，复制生成sk开头密钥妥善留存；
3. 记录接口地址：https://apihub.agnes-ai.com/v1。

📌 三、Agnes模型接入配置

✨ 3.1 基础供应商配置

1. 完全退出Codex所有进程（含托盘后台程序）；
2. 打开Codex++管理工具，左侧选择「注入/供应商配置」，点击新增；
3. • 配置名称：Agnes Free
   • 接入模式：纯API
   • Base URL：https://apihub.agnes-ai.com/v1
   • API Key：平台复制的sk密钥
   • 测试主模型：agnes-image-2.1-flash
   • 上游协议：Chat Completions参数填写规范：

4. 保存配置，选中该服务商设为当前使用，点击重启Codex++。

✨ 3.2 多模态Skill部署

文本模型配置完成后，图像、视频需通过Skill扩展调用：

1. 下载Agnes配套技能包，解压至本地.agents/skills目录；
2. 系统环境变量补充对应参数（Windows PowerShell示例）：

setx AGNES_API_KEY "你的密钥"
setx AGNES_BASE_URL "https://apihub.agnes-ai.com/v1"
setx NO_PROXY "localhost,127.0.0.1,::1"

1. 重启程序后，对话内发送指令即可调用生图、生视频能力。

✨ 3.3 常见连通问题处理

1. 鉴权报错：核对密钥无多余空格，确认密钥未过期；
2. 模型不存在：核对模型名称为agnes-2.0-flash，不可自定义修改；
3. 本地请求超时：添加本地地址免代理环境变量，重启程序生效。

📌 四、核心实用功能

✨ 4.1 插件全量解锁

原生使用API密钥登录时插件栏灰色不可用，Codex++启动后自动解锁全部内置插件，网页抓取、代码调试、文件读写类工具均可正常启用，解除前端区域限制。

✨ 4.2 会话精细化管理

1. 删除功能：会话列表悬停出现删除按钮，删除自动备份，误操作支持恢复；
2. 导出迁移：单条/批量对话导出Markdown，支持会话跨项目移动；
3. 时间线视图：Timeline面板梳理对话脉络，长项目快速定位历史问答。

✨ 4.3 多供应商灵活切换

可同时保存Agnes、DeepSeek、硅基流动等多套API配置，一键切换模型来源，切换过程保留全部本地会话，无需重复记录需求。

✨ 4.4 多模态免费能力落地

1. 文本模型：1M上下文灰度上线，适配长文档解析、批量代码生成、复杂Agent任务；
2. 图像模型：最高4K分辨率输出，支持图生图、背景替换、证件照制作；
3. 视频模型：720P/1080P原生音画同步生成，支持分镜头脚本控制短片内容。

📌 五、落地适用场景

✨ 5.1 程序开发场景

痛点：高频代码调试、项目重构产生大量Token消耗； 方案：接入Agnes免费文本模型，自动生成脚手架、排查漏洞、撰写接口文档，不限量调用减少成本支出。

✨ 5.2 视觉素材生产

痛点：海报、产品图生成工具多按次计费； 方案：通过Skill调用免费4K图像模型，批量制作电商主图、宣传插画，支持多比例画布输出。

✨ 5.3 短视频内容创作

痛点：视频生成工具音画分离，后期剪辑耗时； 方案：文字直接生成带原生音效宣传短片，分镜头指令控制运镜与剧情，适合科普、产品推广素材。

✨ 5.4 企业知识库处理

痛点：数万字业务文档解析消耗高额模型费用； 方案：依托百万上下文窗口完整读取内部资料，自动提炼摘要、生成结构化分析报告。

📌 结尾

Codex++以轻量化无侵入方案补齐Codex原生交互短板，可视化多模型配置大幅降低第三方API接入难度。部署流程简单，硬件适配门槛低，适合长期高频AI任务使用，可优先完成账号注册与工具部署体验完整能力。

#Codex增强工具 #免费多模态API #AI开发实操 #Codex++教程

转载请注明：拈花古佛 » 用到爽！这一Codex增强神器居然还有很多人不知道？短时间狂砍27.5K star