手把手教你在2026年搭建免费AI编程环境：Codex + 自定义Provider，实现零成本AI辅助开发

用户170854288885
4 阅读1分钟 
 作为一个穷学生/独立开发者，用不起官方API？这篇文章教你用第三方兼容API驱动OpenAI Codex
 CLI，实现和官方版一样的AI编程体验。

 ## 前言

 2026年，AI编程工具已经成了开发者的标配。OpenAI的Codex CLI、Cursor、Windsurf...但这些工具要么要ChatGPT
 Plus订阅（$20/月），要么要充API额度。

 **如果你和我一样预算有限，这篇教程就是为你准备的。**

 我将手把手带你：
 1. 安装 Codex CLI（OpenAI官方的终端AI编程工具）
 2. 接入第三方兼容API（成本只有官方的1/10甚至更低）
 3. 实现和官方版几乎一样的体验

 整个过程大概15分钟。

 ## 什么是Codex CLI？

 Codex CLI 是 OpenAI 在2025年开源的终端AI编程工具。它可以：
 - 直接在你的项目目录里读写代码
 - 自动执行命令、运行测试
 - 支持多轮对话式开发
 - 有沙箱机制，安全可控

 和Cursor相比，它是纯终端的，更轻量，而且免费开源。

 **一句话：它是你终端里的AI程序员。**

 ## 第一步：安装

 只需要Node.js：

 ```bash
 npm install -g @openai/codex
 ```

 验证安装：

 ```bash
 codex --version
 # codex-cli 0.121.0
 ```

 就这么简单。

 ## 第二步：配置自定义Provider

 这是最关键的一步。官方默认用OpenAI的API，但我们要换成第三方兼容API（比如OneAPI等中转服务）。

 创建配置文件 `~/.codex/config.toml`：

 ```toml
 # 使用自定义provider
 model_provider = "your-provider-name"
 model = "gpt-5.2_yfi"

 # 定义provider
 [model_providers.your-provider-name]
 name = "Your Provider"
 base_url = "https://your-api-endpoint.com/v1"
 wire_api = "responses"
 requires_openai_auth = true
 env_key = "OPENAI_API_KEY"
 ```

 ### 关键配置说明

 | 字段 | 说明 |
 |------|------|
 | `base_url` | 你的第三方API地址，必须兼容OpenAI格式 |
 | `wire_api` | 协议类型。`responses`用新Responses API，`chat`用Chat Completions API。**先确认你的API支持哪种**
 |
 | `requires_openai_auth` | 设为true才会读取API Key |
 | `env_key` | API Key存放的环境变量名 |

 ### 设置API Key

 ```bash
 # 写入 ~/.bashrc 持久化
 echo 'export OPENAI_API_KEY="your-key-here"' >> ~/.bashrc
 source ~/.bashrc
 ```

 ## 第三步：验证

 找一个git项目目录，运行：

 ```bash
 codex exec "给这个项目添加一个README"
 ```

 如果你看到类似下面的输出，就说明成功了：

 ```
 OpenAI Codex v0.121.0 (research preview)
 --------
 workdir: /path/to/your/project
 model: gpt-5.2_yfi
 provider: your-provider-name
 approval: never
 sandbox: read-only
 --------
 ```

 ## 常见踩坑记录

 ### 坑1：wire_api选错

 Codex默认用`responses`协议（OpenAI新的API格式）。如果你的第三方API不支持，会报错 `model_not_found` 或 `No
 available channel`。

 **解决**：先用curl测试你的API支持哪种协议：

 ```bash
 # 测试 Responses API
 curl -X POST "https://your-api/v1/responses" \
   -H "Authorization: Bearer YOUR_KEY" \
   -H "Content-Type: application/json" \
   -d '{"model":"gpt-5","input":"hello"}'

 # 测试 Chat Completions API
 curl -X POST "https://your-api/v1/chat/completions" \
   -H "Authorization: Bearer YOUR_KEY" \
   -H "Content-Type: application/json" \
   -d '{"model":"gpt-5","messages":[{"role":"user","content":"hello"}]}'
 ```

 哪个能用就设哪个。如果只有chat，把配置改为：

 ```toml
 wire_api = "chat"
 ```

 ### 坑2：模型名不对

 第三方API的模型名可能和官方不同。比如官方叫 `gpt-5`，你的API可能叫 `gpt-5.2_yfi`。

 **解决**：查询可用模型列表：

 ```bash
 curl "https://your-api/v1/models" \
   -H "Authorization: Bearer YOUR_KEY"
 ```

 ### 坑3：企业代理拦截

 如果你在公司网络，可能会遇到 `502 Bad Gateway`。

 **解决**：绕过代理：

 ```bash
 export no_proxy="*"
 export NO_PROXY="*"
 ```

 ### 坑4：必须要有git仓库

 Codex **拒绝在非git目录运行**。临时测试的话：

 ```bash
 mkdir test && cd test && git init
 ```

 ## 实用技巧

 ### 1. 全自动模式（不需要手动确认）

 ```bash
 codex exec --full-auto "重构这个文件的错误处理"
 ```

 ### 2. 指定工作目录

 ```bash
 codex exec -C /path/to/project "添加单元测试"
 ```

 ### 3. 后台运行长任务

 ```bash
 codex exec --full-auto "把所有Python文件加上类型注解" &
 ```

 ### 4. 查看可用模型定价

 ```
 gpt-5          输入 $0.0125/1K tokens  输出 $0.06/1K tokens  -> 较贵
 gpt-5.2_yfi    取决于第三方定价                               -> 通常便宜很多
 deepseek-chat  输入 $0.00014/1K tokens 输出 $0.00028/1K tokens -> 超便宜
 qwen-plus      输入 $0.001/1K tokens  输出 $0.002/1K tokens   -> 中等
 ```

 **省钱建议**：简单任务用便宜模型，复杂架构决策用贵模型。

 ## 对比：官方API vs 第三方

 | | 官方OpenAI | 第三方兼容API |
 |---|---|---|
 | gpt-5 单次对话 | ~$0.10-0.50 | ~$0.01-0.05 |
 | 月费用（中度使用） | $50-200 | $5-20 |
 | 延迟 | 低 | 略高 |
 | 功能完整性 | 100% | 可能缺少部分功能 |
 | 隐私性 | 高 | 取决于第三方 |

 ## 总结

 通过这篇文章，你学会了：

 1. 安装 Codex CLI
 2. 配置自定义Provider接入第三方API
 3. 解决常见配置问题
 4. 实用技巧提升效率

 **核心思路**：OpenAI的工具生态越来越开放，而第三方兼容API让成本大幅降低。善用这种组合，你就能以极低成本获得顶
 级的AI编程体验。

 如果你觉得有用，**点赞收藏**是对我最大的支持。有问题欢迎评论区交流！

 ---

 > 作者注：本人是AI编程工具的重度用户，将持续分享实用教程。关注我不迷路。
avatar
文章
阅读
粉丝