Codex 令牌交换失败 403 怎么解决？按错误后缀定位登录拒绝

遇到 Token exchange failed: token endpoint returned status 403 Forbidden，先保留这行后面的完整错误，再决定怎么处理。浏览器授权完成、终端仍等待，先查回调是否到达；终端已经报令牌交换 403，就应查看响应正文和实际运行环境；正文明确写国家、地区或工作区限制时，停止重复登录，转向资格核验或管理员。 换浏览器、清缓存和设备码登录各有适用条件，不能互相替代。

403 的含义是响应这一请求的服务器拒绝执行。它不保证拒绝来自 OpenAI 源站，也不直接说明代理、账号或令牌是哪一个出了问题；中间代理也可能返回 403。HTTP 403 的定义还明确指出，拒绝原因可以与凭据无关，不应自动用同一凭据重复请求。

先对照完整错误，找到下一动作

这里的关键是失败发生在哪一步，而不是看到 403 就套一条代理命令。浏览器是否成功、请求是否收到 HTTP 响应、响应由谁生成，需要分开记录。

在真正报错的环境收集线索

先在原终端记录版本和认证状态：

codex --version
codex login status

如果报错来自 IDE 或桌面应用，另一个终端里的状态只能作比较：它可能不在同一主机、不继承同一组变量，甚至使用了不同的 CODEX_HOME。WSL、容器和 SSH 尤其要写清楚“浏览器在哪台机器，Codex 进程在哪台机器”。版本与安装有疑问时，按原安装方式检查 Codex CLI，不要照抄论坛里的版本号反复升降级。

codex login status 用于确认当前认证方式。CLI 命令说明说退出码为 0 表示有凭据，并不表示服务端接受了凭据，也不表示任务能完成。因此“status 成功”只能是中间检查。

直接执行 codex login 时，当前官方说明会在配置的日志目录写入 codex-login.log。已有登录日志可用来核对先后顺序，别只截取最后一行。分享前删除授权码、访问及刷新令牌、设备码、Cookie、API key、完整回调 URL、代理用户名密码与内部地址；保留时间、短错误码、请求 ID 和目标主机名即可。登录日志说明

安全比较环境变量，不打印代理密码

下面是 macOS、Linux、WSL 或容器中有 Python 3 时可用的本地摘要。它只报告变量是“已设置”还是“未设置”，不读取认证文件、不发请求，也不显示变量值：

python3 - <<'PY'
import os

names = (
    "HTTP_PROXY", "HTTPS_PROXY", "ALL_PROXY", "NO_PROXY",
    "http_proxy", "https_proxy", "all_proxy", "no_proxy",
    "CODEX_CA_CERTIFICATE", "SSL_CERT_FILE", "CODEX_HOME",
    "OPENAI_API_KEY", "CODEX_ACCESS_TOKEN",
)
for name in names:
    state = "已设置" if os.environ.get(name) else "未设置"
    print(f"{name}: {state}")
PY

这个摘要可帮助比较宿主机与容器，或两个启动终端的差异；“已设置”仍不证明配置正确，另一个终端的输出也不能代替正在失败的应用进程。需要确认实际代理地址时，由你或网络管理员在本机查看，别把完整环境变量导出到公开工单。上面的输出逻辑只做过含合成敏感值的离线检查，未用它完成真实登录。

浏览器成功，终端没收到回调：选设备码或 SSH

浏览器授权后还要把结果返回 Codex，Codex 才能继续交换令牌。远程主机或容器里的回调监听器，与本机浏览器可能不在同一可达环境。这种情况下，先修复回调，不必去改账号凭据。

官方无头登录说明优先建议设备码认证，目前标为 beta。先确认设备码登录已开启：个人账号在 ChatGPT 安全设置启用，工作区账号需要管理员允许。然后在实际运行 Codex 的终端使用：

codex login --device-auth

打开终端给出的官方链接，在自己的浏览器里完成授权并输入这次生成的一次性代码。只处理你自己刚发起的登录，不接收别人发来的设备码。成功判断是原终端完成登录，不是另一台设备出现一个成功页面。

设备码改掉的是对本地浏览器回调的依赖。若它仍返回国家、账号或工作区拒绝，应按对应限制处理；它不会修复任意出站连接错误，也不会授予原本没有的服务权限。

如果设备码不可用，而你获准从本机 SSH 到远程主机，可以使用官方给出的回调转发方式。下面假设使用文档中的默认回调端口 1455：

# 在有浏览器的本机执行，替换 user@remote
ssh -L 1455:localhost:1455 user@remote

进入这个 SSH 会话后，在远程主机运行：

codex login

再用本机浏览器打开远程终端打印的授权地址。隧道把本机回调送到远程监听器；1455 是回调端口，不是代理端口。如果实际监听端口不同，先核对终端提示和当前官方说明，不把监听器暴露到公网。

官方还列出“在有浏览器的机器上登录，再复制自己的认证缓存”的后备方案，但它只适用于确实存在文件缓存、目标机器受信任且组织允许安全传输的情况。使用系统凭据存储时不一定有可复制文件，CODEX_HOME 改过时路径也不同。需要这条路线时按官方缓存复制条件操作，不能复制别人的令牌，也不能借复制缓存规避目标环境的政策。

已收到交换 403：分别查网络拒绝、地区与工作区

回调到达并不表示交换一定能通过。接下来应看错误正文与网络记录，判断是哪一方明确拒绝了请求。响应是 HTML 拦截页时，页面标识与代理请求 ID 可提供网络侧线索；JSON 中的短错误码可提供服务侧线索。仅凭格式或一行日志，仍不足以确认根因或响应者身份。

企业代理或“发送 URL 出错”：核对实际进程的出站路径

让网络管理员根据时间、目标主机名、代理请求 ID 核对是否拦截认证请求，以及当前进程是否使用了批准的网络路径。浏览器能打开 ChatGPT，不证明 WSL、容器或 IDE 里的 Codex 能走同一路径。NO_PROXY 也不能盲目加入所有认证域名：回环请求和必须经过企业代理的出站交换是两件事。

旧教程中的“Codex 一律忽略系统代理，只读环境变量”不宜作为通用判断。官方更新记录已经记录登录与启动请求的系统代理回退支持；这说明应同时考虑系统设置和进程环境，但不代表任意版本、平台或 403 都会被回退机制修好。比较网络时保留版本与启动方式，以实际错误和批准路径的结果为准。

如果完整错误链是证书不受信任，且公司确实使用 TLS 检查或私有根证书，先向安全团队取得批准的 PEM 证书包。官方的文档示例是：

# 仅用于已确认的企业 CA 场景，替换为批准的 PEM 文件
export CODEX_CA_CERTIFICATE=/path/to/corporate-root-ca.pem
codex login

未设置 CODEX_CA_CERTIFICATE 时，Codex 回退使用 SSL_CERT_FILE；这些 CA 设置适用于登录、HTTPS 与安全 WebSocket。自定义 CA 说明

证书链失败与收到 HTTP 403 是不同信号。补证书后仍出现同一拒绝，需要继续查看响应，不应继续添加陌生证书或关闭 TLS 校验。

“国家、地区或领土不受支持”：停止换代理，核对官方资格

这类明确后缀需要资格核验，清登录缓存不会授予支持地区资格。先确认错误属于哪个服务：ChatGPT 登录、OpenAI Platform API，还是另一个供应商的请求。然后到 OpenAI 帮助中心查看对应服务当前的支持国家与地区说明。不同服务的名单不能互相替代，使用中文界面也不说明所在地符合资格。

如果你认为这是误判，向 OpenAI 支持提交出错时间与时区、服务名称、运行环境、脱敏错误正文和请求 ID，请支持确认当前访问条件。不要提供凭据或完整回调地址，也不要用借用账号、伪造所在地或更换出口绕过限制。只有资格与允许的访问条件明确后，再尝试原认证路线；本文不列一个未经本轮直接核验的国家清单。

工作区或管理员拒绝：本地缓存不能覆盖允许列表

先确认浏览器选中了预期账号与工作区。受管理的本地客户端，管理员可以在系统 requirements.toml 或 macOS MDM 要求中设置 allowed_login_methods、allowed_chatgpt_workspaces、cli_auth_credentials_store 与 chatgpt_base_url。这些本地认证要求在加载凭据、获取云策略之前生效；用户的 forced_login_method 和 forced_chatgpt_workspace_id 也必须服从要求。本地认证管理说明

可执行的下一步是请管理员核对：你的工作区是否在允许列表里，允许 ChatGPT 还是 API 登录，当前成员是否有相应产品权限，设备码是否被允许，以及日志中的网络政策提示由哪一层产生。没有匹配工作区时 ChatGPT 登录不可用；只有 API 认证被允许时，才可考虑 API 路线。所有登录方式都不可用时，客户端会拒绝启动。

不要自行改管理策略或反复换账号来试。管理员确认或调整相应条件后，再用同一工作区、同一环境复验；Workspace routing is unavailable 本身不足以证明是服务事故、网络拦截或本机缓存中的某一个。

什么时候才该退出重登或更换认证方式

如果错误指向失效登录态，或者你确认当前存储的账号、工作区与预期不符，并且网络与管理要求允许这条路线，可以做一次受控重登：

codex logout
codex login
codex login status

这里用的是默认浏览器 ChatGPT 登录。退出会清除当前存储的凭据，CLI 与 IDE 扩展共享登录缓存，一处退出会影响另一处。ChatGPT 会话通常在使用中自动刷新令牌，所以“用了很久”本身不证明缓存已经过期。认证状态与缓存说明

凭据也不一定在 ~/.codex/auth.json：

• file：保存在 CODEX_HOME 下的 auth.json，默认目录是 ~/.codex。
• keyring：使用操作系统凭据存储，不可用时失败。
• auto：优先系统凭据存储，不可用时才回退到文件。
• ephemeral：只保留在当前进程内，进程结束后不能按持久缓存理解。

这些模式由 cli_auth_credentials_store 控制，管理员也可能强制指定。别用删除某个文件的结果推断全部缓存已清理，更不要先删除整个 ~/.codex。若进程环境选择了工作负载身份（workload identity），官方说明会拒绝 codex login 和 codex logout，应交由管理该环境的人处理。凭据存储与认证说明

可以用 API key 吗？可以换路线，但不能当作原登录已修好

本地 Codex 支持 ChatGPT 和 API key 认证。只有当你确实希望使用 OpenAI Platform、具备 API 权限且接受独立按量计费时，才切换；Codex cloud 仍要求 ChatGPT 登录，依赖工作区或云服务的功能也可能受限。两种认证方式的条件

已在当前环境安全提供 OPENAI_API_KEY 时，官方 CLI 示例通过标准输入传入 key：

printenv OPENAI_API_KEY | codex login --with-api-key
codex login status

不要把真实 key 写成命令参数、贴进文章或工单。API 路线成功只证明另一条认证方式可用，不证明 ChatGPT 的令牌交换问题已恢复，也不能绕过地区或工作区限制。

如果你实际使用的是第三方网关，还需要确认凭据由谁签发、请求由谁接收。官方说明中，requires_openai_auth = true 会忽略 env_key；另一个供应商的 key 并不自动替代 OpenAI 登录。配置混用可参考Codex 的 Key、Base URL 与 Provider 选择，第三方端点的拒绝则找该供应商核对。

恢复后，在同一环境验证原本要用的路线

恢复要看三个结果：原终端或应用完成登录；codex login status 显示预期认证方式；在同一环境、同一工作区和原本要用的服务完成一个最小任务。不要用浏览器成功、换成 API key 成功，或另一台主机有缓存来替代最后一步。

在确认费用、权限与数据范围允许后，可以启动 Codex，发送一个不包含仓库、客户或账号数据的短任务，例如“只回复 AUTH_OK，不要调用工具”。这一步会访问服务，API key 路线可能计费；它是读者获准后的验证动作，本文没有实际执行登录、退出或收费请求。

如果最小任务仍报 403，但令牌交换已经完成，应保存这次请求的新错误，转向服务权限、工作区或供应商配置排查。单次短任务成功也只证明这次认证和基本请求可用，不保证所有模型、工具和云端功能都可用。

一次改变一个条件即可：例如管理员修正允许列表，或者修复回调拓扑。记录“改变前失败在哪一步，改变后在哪一步成功”，不要同时清浏览器、换网络、换账号和改版本，否则恢复后也不知道原因。

仍然失败，提交这份脱敏记录

正文明确指向资格或管理员限制时直接找相应负责人；其余情况，在允许的路径上尝试有依据的修改后仍出现相同失败，就带着记录求助。可由 OpenAI 帮助中心进入支持渠道，并查看服务状态页是否有相关事件；没有公告也不能排除个别账号或网络问题。

时间与时区：<实际失败时间>
Codex 版本：<版本输出>
运行位置：<本机 / WSL / 容器 / SSH，CLI / IDE / 桌面应用>
预期认证：<ChatGPT / API key / 组织提供的其他方式>
浏览器授权：<完成 / 未完成 / 未知>
回调：<到达 / 未到达 / 未知>
令牌交换：<完整错误的脱敏文本与短错误码>
响应标识：<请求 ID 或代理请求 ID，如有>
网络条件：<批准的代理 / 企业 TLS 检查 / 其他已确认条件>
唯一修改：<这次改了什么>
结果：<仍在同一步失败 / 登录完成 / 后续请求失败>

保留证据能让支持人员判断该核对网络、身份还是工作区。auth.json、操作系统凭据、访问令牌、设备码和完整回调 URL 都不能作为附件公开分享。

常见问题

为什么浏览器显示成功，Codex 还报令牌交换 403？

浏览器授权完成后，Codex 还要收到回调并完成令牌交换。终端仍等待时先查回调可达性；终端明确收到交换 403 时，查看该次响应正文与运行环境。成功页面不能证明后两步完成。官方登录流程

设备码登录能解决所有 403 吗？

不能。它适合没有浏览器或回环回调不可达的场景，且需要个人安全设置或工作区管理员启用。它不取消账号、地区、工作区及网络访问条件。设备码登录条件

login status 返回 0，为什么任务仍失败？

0 只表示凭据存在。仍需确认认证方式正确，并在原环境完成获准的最小请求；请求失败时按其完整错误继续排查。CLI status 的含义

报国家或地区不支持，清 auth.json 有用吗？

清文件不会改变服务资格，而且凭据可能存于系统凭据存储。先在 OpenAI 帮助中心核对对应服务当前规则；认为误判时联系支持。未明确允许的访问条件前，停止连续重试。