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

用户170854288885
8 阅读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：

npm install -g @openai/codex

验证安装：

codex --version
# codex-cli 0.121.0

就这么简单。

第二步：配置自定义Provider

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

创建配置文件 ~/.codex/config.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_keyAPI Key存放的环境变量名

设置API Key

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

第三步：验证

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

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支持哪种协议：

# 测试 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，把配置改为：

wire_api = "chat"

坑2：模型名不对

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

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

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

坑3：企业代理拦截

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

解决：绕过代理：

export no_proxy="*"
export NO_PROXY="*"

坑4：必须要有git仓库

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

mkdir test && cd test && git init

实用技巧

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

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

2. 指定工作目录

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

3. 后台运行长任务

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
文章
阅读
粉丝