GUIDE · 通用
Codex 怎么用免费 API：Groq / 硅基流动 / OpenRouter 接入教程
OpenAI Codex 默认走官方 API 要花钱，但它支持自定义模型提供商。本文教你用 Groq、硅基流动、OpenRouter 的免费额度接入 Codex，零成本用上 AI 编程。
- 适用对象
- 想用 Codex 写代码、但不想付 API 费用的人
- 预计用时
- 约 10 分钟
- 最后核实
准备
- 已安装 Codex CLI（
npm install -g @openai/codex） - 一个免费模型平台的 API Key（Groq / 硅基流动 / OpenRouter 任选其一，本站都有领取指南）
步骤
选一家免费额度平台，拿到 API Key
三家都行，按需选：
- Groq：推理速度最快，免费 tier 有速率限制，适合轻量使用。在 Groq Console 注册拿 Key。
- 硅基流动：国内访问快，有免费额度，模型多。在 硅基流动 注册拿 Key。
- OpenRouter：聚合平台，
:free后缀的模型免费。在 OpenRouter 注册拿 Key。
本站首页的「免费模型」分类里有这几家的实时额度信息，先去领。
配置 Codex 使用自定义提供商
Codex 的配置文件在
~/.codex/config.toml。打开（没有就新建），按你选的平台填：用 Groq：
```toml
model_provider = "groq"
model = "llama-3.3-70b-versatile"[model_providers.groq]
name = "Groq"
base_url = "https://api.groq.com/openai/v1"
env_key = "GROQ_API_KEY"
```用硅基流动：
```toml
model_provider = "siliconflow"
model = "Pro/deepseek-ai/DeepSeek-V3"[model_providers.siliconflow]
name = "SiliconFlow"
base_url = "https://api.siliconflow.cn/v1"
env_key = "SILICONFLOW_API_KEY"
```用 OpenRouter（免费模型）：
```toml
model_provider = "openrouter"
model = "deepseek/deepseek-chat:free"[model_providers.openrouter]
name = "OpenRouter"
base_url = "https://openrouter.ai/api/v1"
env_key = "OPENROUTER_API_KEY"
```模型名以各平台官方文档为准，免费模型会变，去模型列表页确认。
设置环境变量，启动 Codex
把 Key 设成环境变量（以 Groq 为例，其他平台同理换变量名）：
```bash
export GROQ_API_KEY="你的 Key"
codex
```看到 Codex 正常启动、能对话，就说明接通了。建议把
export写进~/.bashrc或~/.zshrc，免得每次重开终端都要设。免费额度的三个坑
- 速率限制：免费 tier 都有 RPM/TPM 限制，Codex 连续调用大任务时可能被限流，报错 429 就等一会儿。
- 模型会变：免费模型列表经常调整，之前能用的
:free模型可能下架，定期去平台的模型页确认。 - 别把 Key 提交到仓库：和所有 API Key 一样，泄露会被盗刷。用环境变量，别写死在配置文件里分享出去。
注意事项
- Codex 的
model_provider配置支持任何 OpenAI 兼容接口，原理和 Cherry Studio 接入是一样的（本站另有一篇 Cherry Studio / Cursor 接入指南）。 - 如果某家平台的免费额度用完了，换一家继续用就行，配置改两行。
常见问题
Codex 一定要用 OpenAI 的 API 吗？
不用。Codex 支持通过 model_provider 配置任意 OpenAI 兼容的第三方接口，本文的三家免费平台都能接。
哪家免费额度最适合 Codex？
看需求：要速度选 Groq（但限流严）；要模型多、国内访问快选硅基流动；要一个 Key 试多家选 OpenRouter 的 :free 模型。三家可以换着用。
提示 429 是什么意思？
触发了免费 tier 的速率限制（RPM/TPM）。等一分钟再试，或者换一家平台。如果是 401 则是 Key 错了，检查环境变量。
相关优惠
信息来源
- OpenAI Codexgithub.com/openai/codex
- Groq Consoleconsole.groq.com/
- SiliconFlow 模型广场cloud.siliconflow.cn/models
- OpenRouter 模型列表openrouter.ai/models
最后核实日期：2026-10-08 · 政策可能随时调整，请以官方页面为准