国内不限期免费使用Codex方案，支持生成图片和视频

前言

很多朋友想用 ChatGPT 家的 Codex（AI 编程助手）来提高效率，但现实很骨感——它是付费服务，对国内用户来说，还要考虑支付和访问的问题，门槛不低。

有没有办法国内也能用、还不限期免费地体验 Codex？还真有。核心思路是利用开源项目 Codex++，把 Codex 默认绑定的付费模型替换成免费的 API，这样图片生成、视频生成、写代码这些场景基本都能覆盖，而且不限期免费。本文就把这套方案完整记录下来。

原理：为什么能"免费换芯"

Codex 本身是个壳，真正干活的是它背后调用的模型。Codex++ 这个开源项目，作用就是解开 Codex 对模型的限制，让你能把模型指向任意兼容的 API。只要我们接一个免费的 API（本文用 Agnes AI），就等于给 Codex 换了一个"免费的大脑"，但操作界面、体验还是 Codex 那套。

所以整套流程可以拆成三件事：

装好 Codex（官方客户端）。
装好 Codex++（用来换模型的开源工具）。
申请一个 Agnes AI 免费 API Key，填进去。

准备工作

先把三样东西备齐。

1. 安装 Codex 客户端

Codex 是 OpenAI 的 AI 编程工具，官方地址：

https://chatgpt.com/zh-Hans-CN/codex/

在 Windows 上，可以直接从微软商店里搜索安装，很方便。

2. 安装 Codex++

Codex++ 是替换模型用的开源项目，地址：

https://github.com/BigPizzaV3/CodexPlusPlus

打开后按项目 README 的指引下载/安装即可。

3. 申请 Agnes AI 免费 API Key

Agnes AI 是一个提供免费 API 的平台。这里有个背景信息很关键：

Agnes AI 于 2026 年 6 月 1 日起，向全球开发者与创作者无限期免费开放旗下核心模型 API，包括文本模型 Agnes-2.0-Flash、图像模型 Agnes-Image-2.0-Flash，以及视频模型 Agnes-Video-V2.0。

也就是说，文本、图像、视频三类模型都免费，这正好覆盖我们要用的所有场景。

官方 API 平台地址：https://platform.agnes-ai.com/

登录后，在后台创建一个新的 API 密钥，复制备用。

使用教程

准备工作做完，开始配置和测试。

第 1 步：在 Codex++ 里配置 Agnes 供应商

打开 Codex++ 的供应商配置，添加一个供应商，按下面填：

名称：agnes
接入模式：纯 API
配置模型：agnes-2.0-flash
Base url：https://apihub.agnes-ai.com/v1
key：你的 API 密钥
上游协议：chatpletions
模型列表：从上游获取

填完保存。这一步相当于告诉 Codex++："以后 Codex 调用模型，都走 Agnes 这个免费接口"。

第 2 步：启动 Codex++

回到 Codex++ 主界面，先做安装维护，然后启动 Codex++，让配置生效。

第 3 步：测试是否接入成功

启动后，直接问 Codex 一句"你是什么模型"。如果它回答自己是 Agnes 的模型（或能识别出当前用的模型），说明接入成功了。

第 4 步：让 Codex 学会调用 Agnes 的图片 API

文本对话已经通了，但 Codex 默认调用的是 OpenAI 的图像模型，所以要让它学会调用 Agnes 的图片 API。这里用到 Codex 的技能（Skill）机制：

新建一个项目文件夹（在干净的项目里操作）。
在 Codex 里输入 / 打开 Browser 技能，先让它去读 API 文档。给它这条指令：
用浏览器打开这个地址：https://agnes-ai.com/doc/overview，找到图片生成模型的 API 文档，总结端点地址、请求格式和必要参数。
再用 / 打开 Skill Creator 技能，让它创建一个生图技能。指令：
根据你刚才学习的 agnes 图片 API，帮我创建一个生图技能，支持传入主题关键词批量生成图片保存到本地，同时生成 HTML 展示页面，API Key 从环境变量 AGNES_API_KEY 读取。

这样，Codex 就有了一个"生图技能"，以后就能按你的关键词批量出图了。

第 5 步：配置环境变量

创建技能时提到要从环境变量 AGNES_API_KEY 读 Key，所以要在系统里把 Key 设成这个环境变量。在 PowerShell 里执行设置环境变量的命令即可。

💡 设置环境变量后，建议重启一下 Codex，确保它读到新环境变量。

第 6 步：测试生图

告诉 Codex：环境变量已经设置好了，你测试一下，主题用大熊猫，生成 5 张。

它会调用刚创建的技能去生成 5 张大熊猫图片。过程中如果遇到问题，Codex 一般会自己排查解决。

第 7 步：创建视频生成技能

图片搞定了，视频也一样。用同样的方式，让 Codex 基于 Agnes 的视频 API 创建一个生成视频的技能。

第 8 步：测试图生视频

最后测试一下图生视频功能——拿刚生成的图（或任意一张图），让它基于图片生成一段视频，看效果是否满意。

到这一步，你的 Codex 就同时具备了"文本对话 + 生成图片 + 生成视频"的能力，而且用的是免费 API，国内也能用。

常见问题与排错

1. 接入后 Codex 仍报模型不可用 / 不知道是什么模型

检查供应商配置是否保存成功，模型名是否写成 agnes-2.0-flash（注意大小写）。
确认 Codex++ 已正常启动。

2. 生成图片时 Codex 还在走 OpenAI 模型

说明还没创建/启用 Agnes 的生图技能。确认完成了第 4 步"创建生图技能"。

3. 提示"找不到环境变量 AGNES_API_KEY"

确认环境变量名拼写正确（AGNES_API_KEY）。
设置后有没有重启 Codex？没有的话读不到新变量。

4. 生成很慢 / 失败

Agnes 免费 API 高峰期可能有延迟，稍等或重试。
检查 Key 是否有效、额度是否正常。

我的结论

这套方案实际用下来，最大的吸引力就是**"把付费的 Codex 换成了免费的大脑"**——界面和交互还是熟悉的 Codex，但背后跑的是 Agnes 的免费 API，文本、图片、视频都能用，国内也能顺畅访问，对想低成本体验 AI 编程助手的朋友非常友好。

要说注意点，主要是 Agnes 这类免费 API 在响应速度和稳定性上，通常不如付费大厂模型，适合日常轻量使用、学习体验；如果是要跑高强度生产任务，还是得考虑更稳定的付费方案。但对"先试试 Codex 到底能帮我干什么"这件事来说，这套免费方案性价比极高。

如果你也一直想试试 Codex，却被付费和国内访问拦住，不妨按上面的步骤搭一套，花半小时把 Codex 变成"国内不限期免费"的 AI 编程+生图+生视频助手。