不用订阅 ChatGPT，不用绑定信用卡，用 API 中转站就能用上 Codex 的全部能力。
为什么你需要这篇教程？
OpenAI Codex CLI 是一个运行在终端里的 AI 编程助手——它能读懂你的项目代码、理解文件结构、帮你改代码、执行命令，像一个真正懂代码的搭档。
但问题来了：官方 Codex 依赖 OpenAI API，需要订阅或付费。对于个人开发者、学生或者只是想尝鲜的人来说，门槛不低。
这篇教程要解决的就是这个问题——API 中转站，免订阅、免绑卡，直接用上 Codex。而且新用户注册即可获得免费额度，完全零成本起步。
💡 注册 78Code 账号（邀请链接：https://api.78code.cc/register?aff=NC9Y），拿到 API Key，就能把 Codex 跑起来。注册即送免费额度，无需充值即可开始使用。
三步走：安装 → 配置 API → 启动。
步骤一：安装 Codex CLI
Codex 依赖 Node.js 18+ 和 Git。
1. 安装 Git（如已安装可跳过）
- Windows：下载 Git for Windows，全程默认选项安装
- macOS：
brew install git - Linux：
sudo apt install git（Ubuntu/Debian）或对应发行版命令
验证安装：
git --version2. 安装 Node.js（如已安装可跳过）
下载 Node.js LTS 长期支持版，按向导安装。
验证安装：
node -v && npm -v如果显示
v18.x.x或更高版本，说明已就绪。
3. 安装 Codex CLI
用 npm 全局安装：
npm install -g @openai/codex验证安装：
codex --version如果看到版本号，说明安装成功。
步骤二：配置 API（核心！免订阅的关键）
这一步是把 Codex 的 API 请求指向 78Code 中转站，而不是 OpenAI 官方。
⚠️ 重要：Codex 的 Base URL 需要
/v1后缀，与 Claude Code 不同。
方式一：使用 CC Switch（推荐，可视化配置）
CC Switch 是可视化 API 配置管理工具，支持 Claude Code、Codex、Gemini CLI 的统一配置管理。
- 下载 CC Switch（Windows/macOS 均支持）
- 打开 CC Switch，框架选 Codex
- 点击「添加配置」，选择「自定义配置」
- 请求地址填入：
https://api.78code.cc/v1 - 填写 API Key（在 78Code 控制台 创建，格式
sk-xxx） - 点击添加，重启终端
💡 新用户注册 78Code 后会赠送免费额度，API Key 创建后即可直接使用，无需预充值。
方式二：手动编辑配置文件
如果偏好手动配置，直接编辑 Codex 的配置文件。
macOS / Linux：
mkdir -p ~/.codex
touch ~/.codex/config.tomlWindows：进入 C:\Users\你的用户名\.codex，创建 config.toml（如看不到 .codex 文件夹，先在资源管理器开启「显示隐藏项目」）。
编辑 ~/.codex/config.toml，写入以下内容：
# 默认模型
model = "gpt-5-codex"
# 默认模型提供方（名称自定义，需与下方 [model_providers.xxx] 一致）
model_provider = "78code"
# 推理深度：low / medium / high
model_reasoning_effort = "medium"
# 禁用响应存储（保护隐私）
disable_response_storage = true
# 认证方式
preferred_auth_method = "apikey"
# 定义模型提供方
[model_providers.78code]
name = "78Code"
base_url = "https://api.78code.cc/v1"
wire_api = "responses"关键配置解读：
base_url：必须是https://api.78code.cc/v1（带/v1后缀）model_provider的名称要和[model_providers.xxx]的段名完全一致wire_api = "responses"表示使用 Codex 的 Responses API 协议
配置 API Key：
创建或编辑 ~/.codex/auth.json：
{
"OPENAI_API_KEY": "sk-你的78Code API密钥"
}💡 配置完一定要重启终端，让配置生效。
步骤三：启动 Codex
进入你的项目目录：
cd your-project-folder
codex首次启动会加载配置，成功后就可以在终端里和 Codex 对话了。
快速上手命令：
# 启动交互式会话
codex
# 单次任务（直接提问）
codex "解释一下这个项目的目录结构"
# 指定模型
codex --model gpt-5-codex "帮我写一个排序函数"进阶：推理深度调优
Codex 支持通过 model_reasoning_effort 控制推理深度：
| 深度 | 速度 | 适用场景 |
|---|---|---|
low |
快 | 简单代码生成、快速问答 |
medium |
中 | 日常开发任务（推荐） |
high |
慢 | 复杂算法、架构设计 |
在 ~/.codex/config.toml 中修改即可：
model_reasoning_effort = "high" # 全力以赴处理复杂任务常见问题排查
❌ 报错 403 Forbidden
原因：外接场景缺少 User-Agent 头。使用 CC Switch 接入第三方平台时，需在 Headers 中添加：
{
"Authorization": "Bearer sk-你的API密钥",
"User-Agent": "codex-cli/1.0 (external)"
}❌ 提示 "connection blocked" 或连接失败
检查 config.toml 中的 base_url 是否带 /v1 后缀（https://api.78code.cc/v1），以及 API Key 是否正确。
❌ codex: command not found
说明 npm 全局安装的路径未加入系统 PATH。尝试：
# 重新安装
npm install -g @openai/codex
# 或使用 npx
npx @openai/codex💰 免费额度用完了怎么办？
78Code 的免费额度足够完成基础测试和日常轻量开发。如需更多用量，可在 78Code 控制台按需充值，价格远低于官方订阅。
总结
| 步骤 | 关键动作 |
|---|---|
| ① 安装 | Node.js + npm install -g @openai/codex |
| ② 配置 API | base_url = "https://api.78code.cc/v1" + API Key |
| ③ 启动 | codex |
不用订阅、不用绑卡，三步跑通 Codex。新用户注册即送免费额度，真正零成本起步。
👉 注册 78Code 获取 API Key（含免费额度）：https://api.78code.cc/register?aff=NC9Y
如果这篇教程对你有帮助，欢迎分享给更多开发者！