Codex客户端接入Agnes-2.0-Flash教程：实现免费使用多模态大模型AI编程
最近不少朋友都在问，有没有办法让 Codex 客户端接入第三方模型，实现低成本甚至免费使用 AI 编程能力。
实测下来，通过 CC-Switch 与 Agnes AI 的组合，可以非常方便地将 Agnes-2.0-Flash 接入到 Codex 客户端中，实现代码生成、代码补全、项目分析等功能。而且 Agnes-2.0-Flash 目前免费使用，特别适合新手入门 Codex。
今天就整理一下完整配置过程。
一、效果展示
在这里插入图片描述
配置完成后，Codex 即可直接调用 Agnes-2.0-Flash 模型进行编程辅助：
代码生成、Bug修复、代码解释、项目重构、SQL生成、前端页面开发、Node.js开发、Vue项目辅助……整体体验与官方接口基本一致。
二、准备工作
在这里插入图片描述
1. 下载Codex客户端
官方下载地址：
https://codexdown.cn/
下载安装完成后先不要着急配置。
2. 下载CC-Switch
下载地址：
| 软件 | 下载地址 |
|---|---|
| CC-Switch | https://pan.quark.cn/s/d348a6526104 |
下载后解压并运行。
3. 注册Agnes AI账号
注册地址：
https://platform.agnes-ai.com/login
注册并登录账号。
三、获取API Key
在这里插入图片描述
登录后台后进入：
API密钥
或者直接访问：
https://platform.agnes-ai.com/settings/apiKeys
如果页面中还没有 API Key：
点击：
创建新密钥
创建新的 Key。创建完成后复制备用。
在这里插入图片描述
例如：
sk-xxxxxxxxxxxxxxxxxxxxxxxx
四、配置CC-Switch
第一步：打开OpenAI配置页面
启动 CC-Switch 后，点击顶部 OpenAI 图标，然后点击右上角新增供应商。
第二步：创建自定义供应商
预设供应商选择自定义配置。
第三步：填写API Key
向下滚动页面，找到 API Key 输入框，将刚刚复制的 Agnes API Key 粘贴进去。
sk-xxxxxxxxxxxxxxxx
第四步：开启本地路由映射
在这里插入图片描述
这一步非常关键。找到“需要本地路由映射”选项，打开开关。否则 Codex 无法正常调用模型。
五、添加Agnes模型
配置完 API Key 后继续操作。
获取模型列表
在这里插入图片描述
点击“模型映射”，然后选择“获取模型列表”。系统会自动读取当前账号可用模型。
添加模型
点击“添加模型”。
在这里插入图片描述
实际请求模型
这里选择 Agnes-2.0-Flash。当然也可以选择其他支持的模型。
在这里插入图片描述
本文以 Agnes-2.0-Flash 为例。
保存模型
点击右下角“添加”，完成模型创建。
在这里插入图片描述
六、开启本地路由
在这里插入图片描述
很多朋友配置到这里发现无法使用，原因就是本地路由没有开启。进入“设置” → “本地路由”，打开以下两个开关：
路由总开关
开启
Codex开关
开启
最终状态应为：
路由总开关：开启
Codex路由：开启
七、切换到新创建的渠道
在这里插入图片描述
返回 CC-Switch 主界面，切换到刚刚创建的渠道。例如名为“Agnes”或你自定义的渠道。部分版本可能显示为“siliconflow”，只要是刚才创建的渠道即可。
八、重启Codex客户端
最后一步。关闭 Codex 客户端，然后重新启动。这样 Codex 才能重新加载本地袋里配置。
九、测试是否成功
打开 Codex 输入：
使用Vue2写一个分页组件
或者：
帮我分析当前项目结构
如果能够正常返回结果，说明配置已经成功。
配置流程图
注册 Agnes AI
↓
获取 API Key
↓
安装 CC-Switch
↓
OpenAI → 新增供应商 → 自定义配置
↓
填写 API Key
↓
开启本地路由映射
↓
获取模型列表 → 添加 Agnes-2.0-Flash
↓
设置 → 本地路由 → 开启路由总开关 → 开启Codex开关
↓
切换新渠道
↓
重启 Codex
↓
配置完成
总结
通过 Codex + CC-Switch + Agnes AI 的组合，可以快速让 Codex 客户端接入 Agnes-2.0-Flash 模型，实现高质量 AI 编程体验。
整个配置流程并不复杂：
- 安装 Codex 客户端
- 安装 CC-Switch
- 获取 Agnes API Key
- 创建自定义供应商
- 开启本地路由映射
- 添加 Agnes-2.0-Flash
- 打开本地路由总开关和 Codex 开关
- 重启 Codex
完成后即可在 Codex 中直接使用 Agnes 模型进行代码生成、项目分析和开发辅助。
相关链接
| 资源 | 地址 |
|---|---|
| Codex客户端下载 | https://codexdown.cn/ |
| CC-Switch下载 | https://pan.quark.cn/s/d348a6526104 |
| Agnes AI注册 | https://platform.agnes-ai.com/login |
| API Key管理 | https://platform.agnes-ai.com/settings/apiKeys |
对于平时主要开发 Vue、UniApp、Node.js、Express、React 项目的同学，这套方案能够显著提升日常开发效率。后续如果有更多好用的 AI 编程工具，也会持续分享实测教程。
