Codex入门教程：从安装部署到API中转配置实战

为什么需要「中转站」：Codex 登录的三道门槛

Codex 目前主要有两种登录方式。官方路径是使用 ChatGPT 账号，但视频作者明确提醒，这条路对国内用户存在三个现实门槛：国外信用卡、国外手机号，以及科学上网。其中「国外手机号」被他形容为"会难倒99%的同学"——很多人并非一开始就被拦下，而是在某次突然触发手机验证码时才卡住。

正因如此，教程推荐了一条更现实的路径：通过第三方 API 中转站接入。作者坦言，中转站本身存在跑路风险，"我得诚实地跟你们讲"，但这并不妨碍它成为低门槛体验 Codex 的方式。

API 中转站是一种第三方代理服务：它在服务端持有上游模型厂商（如 OpenAI）的正式 API Key，再向终端用户分发可用的密钥与调用额度，从而让用户绕开官方账号注册与支付环节。其技术原理是把请求转发到上游接口，因此用户只需配置 base_url 指向中转站地址即可。但这也意味着用户的数据和付费都经过第三方，存在服务突然关停、密钥失效甚至卷款跑路的风险，且通常不具备官方的使用条款与数据保护承诺。

注册与充值：先小额试水

进入中转站后，第一步是注册账号密码，然后进入充值页面。教程给出了两种充值模式：

• 按量付费：充十块二十块即可起步
• 订阅制：作者自己使用的是每月一百零九元的版本

作者的实操建议非常明确：新手先按量付费充十块八块，"先玩，玩明白了玩舒服了"再考虑订阅。他甚至提到有同学一个月充十块钱就懒得玩了，也有人一百零九元的额度都不够用。至于为什么强调小额，作者的原则是——即使对方跑路，十块二十块的损失也不心疼。

创建密钥并配置本地环境

充值完成后，在控制台左上角点击创建密钥，名称可随意填写。这里有一个容易被忽略的细节：分组必须与购买套餐一致。按量付费用户选择「公开使用余额」对应的分组，包月用户选择包月分组，否则后续在客户端里会出问题。

创建好后点击「使用密钥」，会得到一段配置代码。教程的核心操作就是：把这段代码复制下来，写入本地的 config.toml 文件。

找到配置文件路径

Windows 用户需要定位到用户目录下的 .codex 文件夹，具体路径为 C盘 → Users → 你的用户名 → .codex → config.toml。教程中演示时，用户名目录因个人命名而异，作者本人是中文姓氏命名的文件夹。找到后右键选择用记事本打开即可编辑。

粘贴配置的关键位置

首次安装的用户打开 config.toml 时，文件内容很少。需要把密钥页面复制的代码粘贴到文件开头位置，其中涉及 model 和 base_url 两项配置。

粘贴完成后保存退出。回到客户端，把 API 密钥填入对应输入框，点击「立即使用」。首次进入时会有一个初始化空间的过程，作者提示大约需要二三十秒，"保持一点耐心"。

config.toml 是 Codex CLI 等工具的本地配置文件，采用 TOML（Tom's Obvious, Minimal Language）格式，以 键 = 值 的形式描述运行参数。文中涉及的 model 用于指定调用的模型名称，base_url 用于把 API 请求地址从官方端点改为中转站地址。除这两项外，配置文件中通常还可包含 model_provider、审批策略、沙箱级别等选项。由于 TOML 对节（[section]）和键值位置敏感，粘贴时若覆盖了已有的表头或放在错误的节下，客户端就可能读不到配置，这也是要求粘贴到文件开头的原因。

整体耗时与适用人群

按作者的演示，整个安装部署流程大约十分钟即可完成。这套方案的定位很清楚：面向没有代码基础、不想折腾海外支付和手机验证的用户。代价是需要接受中转站的稳定性风险，并对小额充值保持平常心。

需要提醒的是，配置过程中分组选择错误、粘贴位置不对，是新手最常遇到的两个坑。前者影响鉴权，后者直接导致客户端读不到模型配置。照着路径一步步走，基本不会出问题。

核心要点

1. 官方登录有门槛：国外信用卡、国外手机号、科学上网三项缺一不可，手机号验证是最容易卡住的环节。
2. 中转站是低门槛替代方案：但存在跑路风险，作者建议小额按量付费先行体验。
3. 分组必须与套餐匹配：按量付费选余额分组，包月选包月分组，否则客户端会出问题。
4. 配置核心是 config.toml：把密钥页面代码粘贴到 Windows 用户目录下 .codex/config.toml 文件开头。
5. 整体流程约十分钟：首次初始化需等待二三十秒，无需代码基础。