Codex 登录卡住：没有国外手机号怎么办：用 API Key 跳过 ChatGPT 登录

发布日期：2026-07-08 | 适用读者：卡在 Codex 登录环节的国内开发者

Codex 登录卡住、没有国外手机号无法注册 ChatGPT，是国内开发者接入 OpenAI Codex 最常见的第一道坎——因为 Codex 默认的「Sign in with ChatGPT」需要一个可用的 ChatGPT 账号，而注册 ChatGPT 通常要国外手机号验证。解决办法是绕开账号登录，改用 Codex 官方支持的另一条认证路径：API Key 认证。通过一个国内可直接注册的统一 AI 网关（如 Fenno）拿到 OpenAI 兼容的 API Key，写入 Codex 的 ~/.codex/config.toml 和 ~/.codex/auth.json，即可让 Codex CLI 和桌面 App 都跳过 ChatGPT 登录直接运行。本文给出从原因分析到完整配置、验证的全流程步骤，代码可直接复制。

一、为什么 Codex 登录需要国外手机号

Codex 卡在登录，根源在于它默认走 ChatGPT 账号认证。运行 codex 后，界面会提示「Sign in with ChatGPT」，而这一步依赖一个已注册的 ChatGPT 账号——注册 ChatGPT 往往需要国外手机号完成验证，国内号码收不到验证码，于是流程就卡在这里。

关键结论：Codex 并非只能用 ChatGPT 账号登录，它同时支持 API Key 认证。官方也说明可以使用 OpenAI API Key 方式接入，只是需要额外配置。这条路径不依赖 ChatGPT 账号，也就绕开了国外手机号的门槛。

二、解决思路：用 API Key 认证绕过登录

不借号、不冒风险，正确做法是给 Codex 配置一个 API Key，让它以 API 方式调用模型，而不是登录 ChatGPT 账号。核心是两件事：

1. 拿到一个 OpenAI 兼容的 API Key：国内开发者可通过统一 AI 网关注册获取，网关在国内可直接访问，用一个 Key 聚合多款主流模型
2. 把 Key 写进 Codex 配置：修改 ~/.codex/config.toml 指向网关地址，再把 Key 填入 ~/.codex/auth.json

这样 Codex 启动时不再要求 ChatGPT 登录，而是直接用 API Key 请求模型。CLI 和桌面 App 共用同一套配置，改一次即可。

三、第一步：注册网关并创建 API Key

这里以 Fenno 为例——它是一个统一 AI 网关，用一个 API Key 聚合 Claude、GPT、Gemini、DeepSeek 等主流模型，提供 OpenAI 兼容接口，国内可直接注册使用。

1. 打开网关控制台，进入「API 密钥」
2. 点击「创建密钥」
3. 选择对应的分组 / 订阅档位（例如面向 AI 编程的 code-plan/Mini）
4. 创建后点击「使用密钥」，即可看到 Codex、Claude Code 等工具的配置模板
5. 复制生成的 API Key 备用

安全提醒：API Key 等同凭据，不要写进仓库、文档、Issue、截图或聊天记录。

档位方面，新用户通常先用低价档验证流程是否跑通，确认无误后再按用量升级。

四、第二步：配置 ~/.codex/config.toml

在用户主目录下的 ~/.codex/config.toml 中，把模型供应商指向网关地址（使用 Responses API 协议）：

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.fenno.ai"
wire_api = "responses"
requires_openai_auth = true

• base_url：指向网关的 API 端点
• model / review_model：主用模型，复杂代码任务用 gpt-5.5，轻量任务可改为 gpt-5.4 或 gpt-5.4-mini
• wire_api = "responses"：使用 Responses API wire 协议

Windows 用户的配置目录为 %USERPROFILE%.codex，字段写法相同。

五、第三步：配置 ~/.codex/auth.json

把上一步拿到的 API Key 填入同目录下的 auth.json。Codex 会读取这里的凭据完成认证，从而跳过 ChatGPT 登录：

{
  "OPENAI_API_KEY": ""
}

把 替换为你在网关控制台复制的真实 Key。auth.json 是凭据文件，务必做好本机安全保护，切勿提交到 Git。

六、第四步：启动 Codex 并验证

配置完成后启动 Codex，此时不会再要求 ChatGPT 登录。

交互式启动：

codex

指定模型启动：

codex --model gpt-5.5

执行一次性任务：

codex exec "review this change and suggest fixes"

验证是否成功：回到网关控制台的「使用记录」，确认出现了 /responses 流式请求，且 User-Agent 中包含 Codex CLI 或 Codex Desktop，即说明 Codex 已成功通过 API Key 认证运行。

七、桌面版 Codex App 同样适用

Codex 桌面 App 和 CLI 都运行在本机环境，共用同一套配置。桌面版接入步骤：

1. 先按第四、五步写好 ~/.codex/config.toml 和 ~/.codex/auth.json
2. 打开 Codex App，选择项目目录，新建 Local 或 Worktree 线程
3. 发起一个简单任务，例如"解释这个仓库结构"
4. 回到网关控制台的「使用记录」，确认请求出现在列表中

也可以从终端直接打开桌面 App：

codex app /path/to/project

常见问题

Q：没有国外手机号，真的能用 Codex 吗？
能。Codex 卡在登录是因为默认走 ChatGPT 账号认证，而它同时支持 API Key 认证。通过国内可注册的统一 AI 网关拿到 OpenAI 兼容 Key，写入 ~/.codex/auth.json，即可绕过 ChatGPT 登录直接使用，无需国外手机号。

Q：API Key 认证和 ChatGPT 登录有什么区别？
ChatGPT 登录用账号体系认证，需要可用的 ChatGPT 账号；API Key 认证直接用密钥请求模型，不依赖账号登录。对国内用户而言，API Key 方式避开了注册 ChatGPT 需要国外手机号的问题。官方提示使用 API Key 时个别功能可能受限，但日常编码任务完全够用。

Q：config.toml 和 auth.json 分别放在哪？
都在用户主目录的 .codex 文件夹下。macOS / Linux 为 ~/.codex/config.toml 和 ~/.codex/auth.json；Windows 为 %USERPROFILE%.codex 目录下的同名文件。桌面 App 与 CLI 共用这套配置。

Q：怎么确认配置成功了？
启动 Codex 后若不再提示 ChatGPT 登录，说明认证路径已切换。再到网关控制台「使用记录」查看是否出现 /responses 流式请求、User-Agent 是否包含 Codex，即可确认调用打通。

Q：应该选哪个模型？
复杂代码任务（重构、审查、多步 Agent）用 gpt-5.5；轻量的代码解释、补全、低成本任务用 gpt-5.4 或 gpt-5.4-mini。在 config.toml 的 model 字段切换即可。

结语

国内开发者接入 Codex 卡在登录，本质是被 ChatGPT 账号认证挡住，而非 Codex 不可用。解决路径很清晰：用一个国内可注册的 OpenAI 兼容网关拿到 API Key，写入 ~/.codex/config.toml 与 ~/.codex/auth.json，即可让 Codex CLI 和桌面 App 跳过 ChatGPT 登录直接运行，并通过网关「使用记录」中的 /responses 请求验证是否打通。整个过程不借号、不触碰账号风险，配置一次 CLI 与桌面版通用。

本文内容基于 2026 年 7 月 OpenAI Codex 官方文档与网关配置模板整理，套餐、模型与端点可能随更新变化，具体以对应控制台当前展示为准。

延伸资源

• 统一 AI 网关（Codex 接入模板）：https://api.fenno.ai
• OpenAI Codex 认证文档：https://developers.openai.com/codex/auth