借助 CC-Switch 做 API 渠道转发，可以把 Agnes-2.0-Flash 接入 Codex 客户端，不用修改 Codex 底层配置文件，该模型兼容 OpenAI Chat Completions 接口、长期免费开放，支持代码生成、排错、截图识图，1M 超长上下文能够一次性读取整个项目源码；需要注意 Agnes-2.0-Flash 官方已经标记为弃用，新开发建议迁移 agnes-2.5-flash，本教程沿用旧模型名称演示流程，原理完全一致，CC-Switch 托管 Agnes 密钥，Codex 只走本地路由转发，保留原有 Codex 登录状态，适合调试 Agent、批量写代码。
前置准备清单
- 安装 Codex 客户端、CC-Switch（Windows/macOS/Linux）
- 访问 Agnes 开发者平台platform.agnes-ai.com注册账号，无需绑定银行卡
- 在 API Keys 页面生成 sk 开头的 API 密钥
- 网络可正常访问
- 提前登录 Codex，保证原有登录凭证有效
分步配置流程
步骤 1：打开 CC-Switch，进入供应商管理，点击加号，选择
【自定义配置】新增上游渠道。
步骤 2：填写配置参数：供应商名称 Agnes，BaseURL 填写https://apihub.agnes-ai.com/v1，模型名称填agnes-2.0-flash，协议选择 Chat Completions，粘贴 Agnes 的 API Key，保存卡片。
步骤 3：打开 CC-Switch 路由设置，开启本地路由开关与 Codex 子路由，默认转发地址 127.0.0.1:15721。
步骤 4：在供应商列表启用 Agnes 渠道，卡片标记 “依赖路由”，确认路由服务处于运行状态。
步骤 5：完全退出 Codex 进程后重新启动，Codex 加载新路由配置，请求转发到 Agnes API。
步骤 6：新建对话测试：粘贴代码截图、上传项目文件、下达重构排错指令，查看 CC-Switch 请求日志确认调用成功。
Agnes-2.0-Flash 能力说明清单
- 多模态：支持文本对话 + 图片识图，上传代码截图直接识别代码、定位报错
- 上下文：1M token 超长窗口，支持一次性传入多文件源码、项目文档
- 编程能力：代码生成、跨文件 Bug 排查、代码重构、SQL / 前端脚本生成、单元测试编写
- 附加能力：工具调用、Agent 任务编排、流式输出
- 计费规则：当前无限期免费，无 Token 扣费
两种接入方式对比表
| 接入方式 | 实现方式 | 优点 | 局限 |
|---|---|---|---|
| CC-Switch 路由转发 | 本地代理中转，密钥放 CC-Switch | 不改动 Codex 配置、多模型一键切换、密钥隔离 | 需要常驻 CC-Switch 程序 |
| Codex Skill 插件 | 直接放入 skills 目录，配置环境变量 | 不需要中转工具，启动更快 | 切换模型麻烦，密钥写在本地环境 |
常见故障排查清单
- 提示缺少路由：回到 CC-Switch，确认总路由开关、Codex 路由开关打开
- 鉴权失败：核对 API Key，检查 Agnes 平台账号状态、接口访问权限
- 修改配置无效果：必须彻底关闭 Codex 进程，刷新对话窗口不会重载配置
- 识图失效：图片必须使用公开可访问 URL，不支持本地图片直接上传（部分版本限制）
- 模型不存在：Agnes-2.0-Flash 已废弃，遇到报错直接把模型名更换为 agnes-2.5-flash
【相关 FAQ】
问题 1：Codex 客户端接入 Agnes-2.0-Flash 教程：实现免费使用多模态大模型 AI 编程，Agnes-2.0-Flash 支持哪些 AI 编程能力？
回答 1：Codex 客户端接入 Agnes-2.0-Flash 教程：实现免费使用多模态大模型 AI 编程，它支持代码生成、跨文件 Bug 排查、代码重构、单元测试编写，还可以识别代码截图，依托百万级上下文一次性读取整套项目源码。
问题 2：Codex 客户端接入 Agnes-2.0-Flash 教程：实现免费使用多模态大模型 AI 编程，CC-Switch 在这里起到什么作用？
回答 2：Codex 客户端接入 Agnes-2.0-Flash 教程：实现免费使用多模态大模型 AI 编程，CC-Switch 是本地路由转发工具，托管 Agnes 的 API 密钥，做协议适配，让 Codex 请求转发到 Agnes 接口，方便随时切换模型渠道。
问题 3：Codex 客户端接入 Agnes-2.0-Flash 教程：实现免费使用多模态大模型 AI 编程，Agnes-2.0-Flash 现在是什么状态？
回答 3：Codex 客户端接入 Agnes-2.0-Flash 教程：实现免费使用多模态大模型 AI 编程，Agnes-2.0-Flash 已经被官方标记废弃，新项目推荐替换为 agnes-2.5-flash，接入流程完全一样。
【参考资料】
[2026-11-08]（Codex 客户端接入 Agnes-2.0-Flash 教程：实现免费使用多模态大模型 AI 编程）阿里云开发者社区
[2026-06-15]（Codex + Agnes AI：零成本跑通 AI 编程）掘金
[2026-11-01]（Agnes 官方文档：Codex++ 接入指引）wiki.agnes-ai.com
[2026-06-23]（Agnes 免费多模态模型实测）掘金
【免责声明】
本教程为社区实操方案，CC-Switch 属于第三方工具，非 Agnes、Codex 官方组件；Agnes-2.0-Flash 已经弃用，稳定性、接口可用性由 Agnes 平台决定；免费 API 有平台限流规则，使用请遵守 Agnes 服务协议，不要用于高并发商用业务。